Quantcast

Documentation Center

  • Trial Software
  • Product Updates

Run Management

Run Management

The Fixed-Point Tool supports multiple runs. Each run uses one set of model settings to simulate the model or to derive or propose data types. You can:

  • Store multiple runs.

  • Specify custom run names.

  • Propose data types based on the results in any run.

  • Apply data type proposals based on any run.

  • Compare the results of any two runs.

  • Rename runs directly in the Fixed-Point Tool Contents pane.

You can easily switch between different run setups using shortcuts. Alternatively, you can manually manage runs.

Run Management with the Shortcut Editor

You can use shortcuts prior to simulation to configure the run name as well as to configure model-wide data type override and instrumentation settings. The Fixed-Point Tool provides:

  • Frequently used factory default shortcuts, such as Model-wide double override and full instrumentation, which sets up your model so that you can override all fixed-point data types with double-precision numbers and logs the simulation minimum and maximum values and overflows.

      Note:   You can set up user-defined shortcuts across referenced model boundaries. The factory default shortcuts apply only to the top-level model and so do not affect the settings of any referenced model.

  • The ability to add and edit custom shortcuts. The shortcuts are saved with the model so that you define them once and then reuse them multiple times. Use the Shortcut Editor to create or edit shortcuts and to add and organize shortcut buttons in the Fixed-Point Tool Shortcuts to set up runs pane.

      Note:   You can use user-defined shortcuts across referenced model boundaries.

Manual Run Management

You can also manually manage runs using the following settings:

  • In the Data collection pane, Store results in run.

    Provide a new run name before a simulation or collecting derived minimum and maximum values so that you do not overwrite existing runs.

  • In the Settings for selected system pane:

    • Fixed-point instrumentation mode

    • Data type override

    • Data type override applies to

Why Use Shortcuts to Manage Runs

Shortcuts provide a quick and easy way to set up data type override and fixed-point instrumentation settings run prior to simulation or range derivation. You can associate a run name with each shortcut. When you apply a shortcut, you change the data type override and fixed-point instrumentation settings of multiple systems in your hierarchy simultaneously.

Shortcuts:

  • Simplify the workflow. For example, you can collect a floating-point baseline in a clearly named run.

  • Provide the ability to configure data type override and instrumentation settings on multiple subsystems in the model hierarchy at the same time. This capability is useful for models that have a complicated hierarchy.

  • Are a convenient way to store frequently used settings and reuse them. This capability is useful when switching between different settings during debugging.

  • Provide a way to store the original fixed-point instrumentation and data type override settings for the model. Preserving these settings in a shortcut provides a backup in case of failure and a baseline for testing and validation.

When to Use Shortcuts to Manage Runs

To ...Use...

Autoscale your entire model

The factory default shortcuts. These defaults provide an efficient way to override the model with floating-point data types or remove existing data type overrides. For more information, see Propose Fraction Lengths Using Simulation Range Data.

Debug a model

Shortcuts to switch between different data type override and fixed-point instrumentation modes. For more information, see Debug a Fixed-Point Model.

Manage the settings on multiple systems in a model. For example, if you are converting your model to fixed point one subsystem at a time.

The Shortcut Editor to define your own shortcuts so that you can switch between different settings without manually changing individual settings each time.

Capture the initial settings of the model before making any changes to it.

The Shortcut Editor to capture the model settings and save them in a named run. For more information, see Capture Model Settings Using the Shortcut Editor.

Add Shortcuts

  1. On the Fixed-Point Tool Shortcuts to set up runs pane, click Add/Edit shortcuts.

  2. For each subsystem that you want to specify a shortcut for, on the Shortcut Editor Model Hierarchy pane, select the subsystem:

    1. In the Name of shortcut field, enter the shortcut name.

      By default, if Allow modification of run name is selected, the software sets the Run name to the shortcut name. You can manually override the name.

    2. Edit the shortcut properties.

Edit Shortcuts

  1. On the Fixed-Point Tool Shortcuts to set up runs pane, click Add/Edit shortcuts.

  2. In the Shortcut Editor, from the Name of shortcut list, select the shortcut that you want to edit.

    The editor displays the run name, fixed-point instrumentation settings, and data type override settings defined by the shortcut.

      Note:   You cannot modify the factory default shortcuts.

  3. If you do not want this shortcut to modify the existing fixed-point instrumentation settings on the model, clear Allow modification of fixed-point instrumentation settings.

  4. If you do not want this shortcut to modify the existing data type override settings on the model, clear Allow modification of data type override settings.

  5. If you do not want this shortcut to modify the run name on the model, clear Allow modification of run name.

  6. If you want to modify the shortcut for a subsystem:

    1. Select the subsystem.

    2. If applicable, set the Fixed-point instrumentation mode to use when you apply this shortcut.

    3. If applicable, set the Data type override mode to use when you apply this shortcut.

    4. If applicable, set the Run name to use when you apply this shortcut.

    5. Click Apply.

  7. Repeat step 6 to modify any subsystem shortcuts that you want.

  8. Optionally, if you want the Fixed-Point Tool to display a button for this new shortcut, use the right arrow to move the shortcut to the list of shortcuts to display. Use the up and down arrows to change the order of the shortcut buttons.

  9. Save the model to store the shortcut with the model.

Delete Shortcuts

To delete a shortcut from a model:

  1. On the Fixed-Point Tool Shortcuts to set up runs pane, click Add/Edit shortcuts.

  2. On the Shortcut Editor Manage shortcuts pane, in the Shortcuts table, select the shortcut that you want to delete.

  3. Click the Delete selected shortcut button, .

Capture Model Settings Using the Shortcut Editor

  1. On the Fixed-Point Tool Shortcuts to set up runs pane, click Add/Edit shortcuts.

  2. In the Shortcut Editor, create a new shortcut, for example, Initial subsystem settings.

    By default, if Allow modification of run name is selected, the software sets the Run name to the shortcut name. You can manually override the name.

  3. Verify that Allow modification of fixed-point instrumentation settings and Allow modification of data type override settings are selected.

  4. Click Capture system settings.

    The software sets the Fixed-point instrumentation mode, Data type override, and, if appropriate, Data type override applies to for the systems in the model hierarchy.

  5. Click Apply.

  6. Save the model to store the shortcut with the model.

Was this topic helpful?