Store 
| Products & Services | Solutions | Academia | Support | User Community | Company |
 |
Download Product Updates | | |  |
Get Pricing | | | |
Trial Software |
| Documentation → Model-Based Calibration |
| Products & Services | Solutions | Academia | Support | User Community | Company |
|
Download Product Updates | | | |
Get Pricing | | | |
Trial Software |
| Documentation → Model-Based Calibration |
| Contents | Index |
| Learn more about Model-Based Calibration |
| On this page… |
|---|
When you open the Model Browser part of the Model-Based Calibration Toolbox product, there is a single node, the project (named Untitled), in the model tree. This node is automatically selected.
When the project node in the model tree is selected at any time, the following functionality is available. This state is called project level. When you start you are automatically at project level, as there are not yet any other nodes to select.
See Overview of Modeling with the Model-Based Calibration Toolbox Product to find information about using the Model Browser.
Note The node selected in the model tree determines what appears in the menus and panes of the rest of the Model Browser. |
This pane contains a hierarchical structure showing all the models created within the current project. See Model Tree for a detailed description of the information contained in this pane.
All data sets loaded in the current project are displayed in the Data Sets pane (whether in use for modeling or not).
You can select a data set (by clicking it) and then
Delete it by pressing the Delete key.
Rename it, by clicking again or pressing F2 (as when selecting to rename in Windows Explorer), then editing the name.
Open it by double-clicking. Double-clicking a data set opens the Data Editor; unless it is already associated with a test plan, see below. See The Data Editor.
Note All data sets loaded are visible at the project node and appear in the Data Sets pane. However, they are not necessarily used by any test plan child nodes of that project until you select them within a particular test plan. For example, with a data set loaded at the project node, when you switch to a new test plan node, the Data Sets pane at top right displays 'No Data is selected' until you use the Data Wizard to attach data to that test plan. See Data Selection Wizard. |
The same data set can be used by many test plans within a project, although each individual test plan can only ever use one data set (and one validation data set).
When you have associated a data set with a test plan, a new data set icon (with a name specific to that test plan) appears here in the Data Sets pane. The same data set may be used by several test plans, at which you may have applied different filters, groupings or edits, and so each time you associate a data set with a new test plan a new icon appears here. You cannot edit these test plan-specific data sets at project level, you must edit them from the associated test plan.
The Notes pane contains a list box showing all previous notes on the current project. You use notes to record changes within a project, perhaps by different users, over time.
You add new notes by clicking the Add new
note button
in the toolbar, or by pressing the Insert key
after selecting the Notes pane by clicking. Notes
automatically have the user login name and the date.
You edit notes (only the user that created them can edit them; user names must match) by select-clicking or by pressing F2 when selected (as when selecting to rename in Windows Explorer). Edited notes have updated time and date fields.
You remove notes by selecting them and pressing Delete (but only the same user that created them can delete them).
Notes are automatically added to the project when it is modified (for example, the initial "Created by <username>" note). These notes (listed as user "info") cannot be deleted or edited.
You generate new test plans from the Test Plans list pane by clicking the New button. See Test Plans.
This pane is the Test Plans list pane at startup but changes depending on the level in the model tree that is selected. The list box always displays all the child nodes of whichever node is currently selected in the tree in the All Models pane, and always contains three buttons: New, Delete, and Select.
Note Double-clicking any item within this pane changes the view directly to that node. (This is equivalent to selecting that node in the model tree.) You can also use the Delete and Insert keys to remove or add new test plans (select a test plan first). |
The Test Plans list becomes the Response Models list, the Local Models list, the Response Features list, and the Models list as you select the nodes at subsequent levels of the model tree. In each case this pane displays the immediate child nodes of the current node selected. You can use the buttons to delete selected nodes or create new nodes.
The feature added by clicking New always corresponds to the list items. For example, clicking New when the pane shows a list of test plans adds a new test plan. Clicking New when the pane shows a list of response features opens the Response Features dialog box, as shown in the following example. The response features you can add are model-specific. This example shows the response features available for a polyspline model.
For example, if you choose f(x + datum) and enter 10 in the Value edit box, the new response feature tracks the datum +10. For a torque/spark polyspline model, the datum is MBT (maximum brake torque); so the new response feature is MBT + 10 degrees of spark angle. This allows you to create response features that have engineering interest.
The response features available depend on the model type. For more details on which response features are available, see each model type under Local Model Setup.
You can use the Select button to select the best child node, but only when the child nodes are local models, response features, or submodels of response features. In each case clicking the Select button takes you to a selection window where you can compare the child nodes. See Selecting Models.
Hints about using the Model Browser appear here. You can scroll through more tips using the buttons at the bottom, and you can snap this pane closed or open by clicking the "snapper point" where the cursor changes if you roll the mouse over it.
This is how the toolbar appears when you first start the toolbox. The last two Data buttons are grayed out; the Edit data object and Copy data object buttons are not enabled until a data set has been loaded.
All the toolbar items are duplicated under the menus except New Note.
For the Project buttons, see the File menu.
For the Data buttons, see the Data menu.
New Note adds a note to the Notes pane.
The New and Delete node buttons are duplicated in the File menu. In both cases, their function depends on the node selected in the model tree. In every case, New generates a new child node of the one currently selected, and Delete removes the current node (and all its children).
The Up One Level button moves the current selection (and hence all the views) one level up the model tree. For example, if a test plan node is selected, clicking this button moves one level up to the project node.
Two buttons, Delete and Up One Level, are grayed out at startup because the default selection in the model tree is the project node, so there are no levels above, and you cannot delete the project node (although you can replace it with a new one).
The print icon is only enabled in views with plots, for example, the local node, response feature nodes, and response nodes after selection of a best two-stage models (response nodes are blank until then).
The Help button opens the Help Browser and displays the appropriate help documentation for the current view in your Model Browser.
Note The File menu remains constant in each Model Browser view. The New child node function always creates a new child node, and the Delete current node function always deletes the current node. These change according to which node in the model tree is currently selected. |
New Project opens a new project file. You are prompted to save or lose the current project.
Open Project opens a file browser to select the project to open.
Save Project and Save Project As save the project with all the models it contains as a .mat file.
New Test Plan opens a dialog box with the choice of One-Stage or Two-Stage test plans, or you can browse for other test plans. The New (child node) menu option always creates a new child node of whichever node is selected in the model tree.
At startup, the project node is automatically selected, so the appropriate child node is a new test plan.
Note File > New changes depending on which node in the model tree is selected. In each case the option offers a new child node immediately below the one currently selected, that is, a New Test Plan (if a project node is selected), a New Response Model (from a test plan) or a New Model child node (from a one-stage response). For two-stage models you can add a New Local Model (from a response node), a New Response Feature (from a local node) and a New Model from a response feature node. |
Export Models brings up the Export Models dialog box. This allows you to export any models selected in the tree (along with their child nodes, in some cases) to the MATLAB workspace, to file for importing into CAGE, or to Simulink software. See Exporting Models.
Delete "Untitled" Like the New item in this menu, this option changes depending on which node in the model tree is selected. This menu item deletes whichever node is currently selected in the model tree (along with any child nodes), and the appropriate name appears here.
Clean Up Tree From any modeling node where a best model has been selected (from the child nodes), you can use this to delete all other child nodes. Only the child nodes selected as best remain.
Preferences brings up the MBC File Preferences dialog box, in which you can specify default locations for projects, data, models, and templates. You can also edit and save user information: name, company, department and contact details. This information is saved with each project level note, and you can use this to trace the history of a project.
Print is only enabled in views with plots — not test plan or project level.
1,2,3,4: A list of the four most recent project files, including their pathnames.
Close Exits from the Model Browser part of the toolbox (CAGE and MATLAB are unaffected).
New Data — Opens the Data Editor. See The Data Editor.
Copy Data — Copies the selected data set.
Edit Data — Opens the Data Editor to enable data editing.
Delete Data — Deletes the selected data set.
Tip of the Day — Choose to display or hide the tips pane.
Note Information — Opens a dialog box where you can decide which categories of information to display for each project note. You can specify user information for display with notes by using File > Preferences.
Depending on which toolbox windows are open, a list appears under this menu and whichever window is selected is brought to the front. The Window menu remains throughout the Model Browser.
The Help menu remains consistent throughout the Model Browser.
MBC Help — Opens the Model-Based Calibration Toolbox Roadmap with links to the help tutorials and the indexed help pages.
Context Help — Depending on what part of the Model Browser is currently active, Context Help links to different places in the Help files.
About MBC — Displays version notes.
 | Projects and Test Plans | Model Tree |  |
Includes the most popular MATLAB recorded presentations with Q&A sessions led by MATLAB experts.
| © 1984-2009- The MathWorks, Inc. - Site Help - Patents - Trademarks - Privacy Policy - Preventing Piracy - RSS |
