Learn more about Model-Based Calibration

CAGE Import Tool

You can use the CAGE Import Tool to select items to import from any Model-Based Calibration Toolbox project file produced in CAGE or the Model Browser (.mat or .cag). This can greatly simplify setting up new projects, and also making changes to existing projects, for example to make use of new models in an existing optimization and calibration.

You can import Model Browser models from any project file or direct from the Model Browser when it is open. You can import the following CAGE items from any CAGE project: models (including feature and function models), variables, normalizers, tables, features, optimizations, datasets and tradeoffs.

You can replace suitable items in your current CAGE project with imported items. You can see if an item is replaceable in the Import dialog, where the Replace action becomes available.

Note that Model Browser models (but not CAGE models) must have exactly the same input names as the CAGE model you want to replace. You can replace models, variables, normalizers, tables and features. You cannot replace optimizations, datasets or tradeoffs. You cannot replace tables used in tradeoffs with tables of a different size.

To use the CAGE Import Tool:

1. Select File > Import From Project.

   The CAGE Import Tool appears.

2. You can choose a project file or import directly from the Model Browser if it is open.

   • If the Model Browser is open, the list is automatically populated with a list of available items in the open project.

   • To import from a file, click the Import From Project File button.

     A file browser dialog opens. Locate the desired file and click Open.

3. The CAGE Import Tool displays the available items. Select the items you want to import from the list. Press Ctrl+A to select all items, or Ctrl+click or Shift+click to select multiple items in the list.

   

   You can use the Find and Type controls to filter the item list:

   • If you are importing from a Model Browser project you can select Response, Point-by-point, Datum or Response Feature from the Type list to display a single model type only.

   • If you are importing from a CAGE project you can select Variable, Model, Normalizer, Table, Feature, Optimization, Dataset, or Tradeoff from the CAGE items in the Type list. For models the Subtype column displays whether a model item is an MBC model, function model or feature model.

   • Enter text in the Find edit box to find particular item names. You can also select the box to Match case

4. Click the Import Selected Items button.

5. The Import dialog opens displaying the items you selected for import.

   

   • To edit item names, double-click the column cells of the CAGE Item Name (or CAGE Model Name if importing models).

   • If it is not possible to replace items in the current CAGE session then Create new is displayed in the Action column. If it is possible to replace an item in the current CAGE session with an imported item, the Action column cell becomes a drop-down menu where you can select Replace or Create new. If an exact name match item is available to be replaced the Action drop-down menu automatically displays Replace. Change this to Create new if you do not want to replace the existing item.

   • When replacing items, double-click the CAGE Item Name column cells to open a dialog to select the correct item to replace.

   • Clear the View new item check box if you do not want CAGE to switch to the appropriate view for the top item in the import list when you dismiss the dialog. The CAGE Import Tool remains open either way.

   • Click OK to import the items.

6. Click the Close button to close the CAGE Import Tool when you have finished importing items.

See also:

• Importing and Exporting a Variable Dictionary

• Import Exported Models File

Variables and Models

Setting Up Variable Items

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