Learn more about Model-Based Calibration

Test Plan Level

On this page…
Test Plan View Test Plan Level: Toolbar and Menus Designing Experiments

Test Plan View

When you select a test plan node (with the icon ) in the model tree, this view appears.

This example is a two-stage model. All test plan nodes (one- and two-stage) show this view with a block diagram of the test plan. The diagram provides a graphical interface so you can set up inputs and set up models by double-clicking the blocks in the test plan diagram. These functions can also be reached using the TestPlan menu.

The diagram has the following functionality for setting up the stages in hierarchical modeling. At present MBC only supports one- and two-stage models. You can reach these functions via the right-click context menu (on each block) or the menus:

1. Input Factor Setup — Setting the number of inputs for each stage of the model hierarchy.

2. Local Model Setup and Global Model Setup — Setting up the new default models for each stage in the model hierarchy.

3. Designing Experiments — Using the Design Editor.

   You can access the Design Editor via the right-click menus on the model blocks or the TestPlan menu (for a particular model—you must select a model or input block before you can design an experiment). View Design Data also opens the Design Editor where you can investigate the statistical design properties of the data.

   If the test plan already has a design, the design name is displayed in the right pane.

4. Loading Data from File and New Response Models and Datum Models.

   You can attach data to a new test plan by choosing TestPlan > Select Data or by double-clicking the Responses block in the diagram, which launches the Data Wizard (if the project already has data loaded).

   If a test plan already has data attached to it, you can reach the Data Selection views in the Data Editor using the Select Data toolbar button or the TestPlan menu item. In the Data Editor you can select data for modeling and match data to a design. For example, after the design changes, new data matching might be necessary. See Matching Data to Designs for details.

   If a test plan already has data attached to it, details of the data set (such as name, number of records) are displayed in the right pane.

5. Summary Statistics — Right-click on the global model block and select Summary Statistics to reach the Summary Statistics dialog box. In this dialog box you can choose which summary statistics you want displayed to help you evaluate models.

Other test plan level functionality includes:

• From the test plan level you can access the Boundary Constraint Modeling functionality from the toolbar or TestPlan menu. See Boundary Model Setup.

  If the test plan already has a boundary model, the right pane displays which boundary models are combined in the best boundary model, as shown in the example.

• You can save the current test plan as a template using the TestPlan > Make Template command or the toolbar button . This capability can be useful for speeding up creation of subsequent projects. See Creating New Test Plan Templates.

• You can attach validation data to your test plan using the TestPlan menu. You can use validation data with any model except response features. When you attach validation data to your test plan, Validation RMSE is automatically added to the summary statistics for comparison in the bottom list view of response models in the test plan. See Using Validation Data.

  If the test plan already has validation data attached to it, the name is displayed in the right pane.

The selected Model block is highlighted in yellow if a Setup dialog box is open; otherwise it is indicated by blocks at the corners. The selected Model block indicates the stage of the model hierarchy that is used by the following menu choices:

• Set Up Model

• Design Experiment

• View Design Data

• View Model

• Summary Statistics

The block diagram in the test plan view represents the hierarchical structure of models. Following is an example of a two-stage test plan block diagram.

See also Test Plan Level: Toolbar and Menus

Back to Top

Test Plan Level: Toolbar and Menus

The eight buttons on the left (project and node management, plus the Print and Help buttons) appear in every view level. See Project Level: Toolbar for details.

The right buttons change at different levels.

In the test plan level view, the right buttons are as follows:

• Design Experiment opens the Design Editor. Only available when a model or input has been selected in the test plan block diagram. You must specify the stage (local or global) you are designing for. See Designs.

• Select Data opens the Data Wizard, or opens the Data Selection views in the Data Editor if data sets have already been selected. See Data.

• Edit Boundary Constraint opens the Boundary Constraint Editor. See Boundary Model Setup.

• Make Template opens a dialog box to save the current test plan as a template, including any designs and response models. See Local Level.

Test Plan Level: Menus

File Menu.   Only the New (child node) and Delete (current node) functions change according to the node level currently selected. Otherwise the File menu remains constant. See File Menu.

Window Menu.   The Window menu remains throughout the Model Browser. It allows you to switch windows if there is more than one toolbox window open. See Window Menu.

Help Menu.   The Help menu remains the same throughout the Model Browser. You can always reach the MBC Toolbox Help Roadmap by selecting Help > MBC Help. The context help takes you to relevant Help pages, and Help > About MBCshows the version notes. See Help Menu.

Test Plan Menu.  

• Set Up Inputs — See Input Factor Setup.

• Set Up Model — See Local Model Setup and Global Model Setup.

  You can also reach these functions by double-clicking the input and model blocks in the test plan diagram, and both can only be used when a Model block is first selected in the diagram. You must specify the model to set up, local or global.

• Design Experiment — See The Design Editor.

  This is also available in the toolbar and in the right-click context menu on the blocks in the test plan diagram.

• Boundary Constraints — Opens the Constraint Modeling window. Also available in the toolbar. See Boundary Model Setup.

• New Data — Opens the Data Editor to load new data.

• Select Data — Opens the Data Selection views of the Data Editor.

  You can reach both these functions with the toolbar Select Data button. If no data is selected, this button opens the Data Wizard, and if a data set is already selected, it takes you straight to the Data Selection views. See Data.

• Validation Data Opens a wizard to select data for validation. See Using Validation Data.

• Make Template — Opens a dialog box for saving the current test plan as a new template, with or without designs and response models. Same as the toolbar button. See Creating New Test Plan Templates.

• Export Multimodels — This provides a smooth interface with the Multimodel Tradeoff in the CAGE browser part of Model-Based Calibration toolbox. Two global inputs are required (normally speed and load). This item is only enabled if you have set up a two-stage model with the correct number of inputs. This useful application for multiple models allows you to calibrate from local maps. See Local Model Class: Multiple Models for details.

View Menu (Test Plan Level).  

• Design Data — Opens the Design Editor. The view design facility enables you to investigate the statistical properties of the collected data. This provides access to all the Design Editor and design evaluation utility functions with the current design rather than the prespecified design (after data matching, the data points are used as the new design points). See The Design Editor.

  For two-stage models, viewing level 1 designs creates a separate design for each test.

• Model — Opens a dialog box showing the terms in the current model.

• Both of these are only available when a model or input block is selected in the test plan block diagram.

Back to Top

Designing Experiments

You can design experiments after setting up models. You can design experiments for both stages, local and global. You invoke the Design Editor in several ways from the test plan level:

• Right-click a Model block in the test plan diagram and select Design Experiment.

  You must select (by clicking) a stage to design for (first or second stage) or the following two options are not possible.

• Click the Design Experiment toolbar button .

• Select TestPlan > Design Experiment.

For an existing design, View > Design Data also launches the Design Editor (also in the right-click menu on each Model block). In this case you can only view the current data being used as a design at this stage. If you enter the Design Editor by the other routes, you can view all alternative designs for that stage.

See Designs.

Viewing Designs

The view design facility enables the user to investigate the statistical properties of the current data.

From the test plan node, select the model stage you are interested in by clicking, then choose View > Design Data. Alternatively, use the right-click menu on a Model block.

This provides access to all the Design Editor and design evaluation utility functions with the current data rather than the prespecified design. If you have done some data-matching to a design, each data point is used as a design point. You can now investigate the statistical properties of this design.

For two-stage models, viewing stage one (local model) designs creates a separate design for each test.

See The Design Editor or the step-by-step guide in Tutorial: Design of Experiment in the Getting Started documentation.

Back to Top

Test Plans

Designs

© 1984-2009- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS