Create and Reuse Modeling Templates

Create a Test Plan

You need to select a test plan to construct models or designs.

If you are designing an experiment, see Set Up Design Inputs.

If you want to fit models to data, see Fit Models to Data.

If you click Fit models or Design experiment in the Common Tasks pane, the dialog box guides you through the steps for setting up inputs and models. After setting up your designs or models, if you want more modeling options, you can access more controls using the test plan block diagram. See Edit Test Plan Definition.

Create and Reuse Test Plan Templates

Templates are useful for reusing similar modeling test plans. The procedures to model engines for calibrations are usually repeated for several different engine programs. The test plan template lets you reuse the setup for one test plan with another set of data, without redefining inputs, responses, and default model settings. You can alter the loaded test plan settings without restriction.

You can reuse testplans in the current project without needing to save them to a file. Simply select any current project test plan in the Fit Models or New Test Plan dialog boxes.

A list of test plan templates appears when you fit models or design an experiment.

Test plan templates store the following information:

• Modeling workflow — Whether the model is one- or two-stage or point-by-point, and the default models for each level, e.g., model types for local and global models.

• All response models (for example, torque, exhaust temperature, emissions) — If they were saved with the template (select the check box in the Test Plan Template Setup dialog box).

• Numbers and names of input factors to models.

• Summary Statistics for display (see Summary Statistics).

• Designs — If they were saved with the template (select the check box in the Test Plan Template Setup dialog box).

  The design for one type of engine might or might not be appropriate for a similar type of engine. You can redefine or modify the design using the Design Editor.

• No model child nodes are included, just the top level of the test plan (response models, and local and global models for two-stage models).

To create a test plan template, see Save a New Template.

To reuse your test plan template, see Reuse Stored Templates.

Save a New Template

From the test plan node that you want to make into a template:

• Click the Make Template toolbar button or select TestPlan > Make Template.

  The Test Plan Template Setup dialog box appears.

• If desired, change the name of the new template and choose whether to include designs and/or response models.

The templates are stored in the folder specified in the File > Preferences dialog box. Place your library of templates in your template folder for quick access when creating new test plans.

Reuse Stored Templates

Tip

You can reuse test plans in the current project without needing to save them to a file. Simply select any current project testplan in the Fit Models or New Test Plan dialog boxes.

• When you click Fit models or Design experiment in the Common Tasks pane, a list of templates appears in the Fit Models and New Test Plan dialog boxes.

  • You can select any test plan in the current project in the Templates pane.

  • The Templates pane displays all templates found in the Current Folder, unless you have set a templates folder in the Preferences dialog box (File menu).

    Use the Browse button if the required template is not in the folder.

  • To view some example templates, click Browse and select the matlab\toolbox\mbc\mbctraining folder.

• Click a template to view the settings. The number of stages, input factors, and responses are displayed. Modify if desired, for example, to add responses. Use stored templates in exactly the same way as the default templates.

• Click OK to use the selected test plan template.