Main Content

Output options

Options to produce output values at specified times in variable-step simulation

Model Configuration Pane: Data Import/Export

Description

Select an option to produce output values at specified times in simulations that use a variable-step solver.

Consider using these options when a variable-step solver takes too large of a time step during simulation in a way that misses discontinuities or other system dynamics.

Dependencies

To enable this parameter, on the Solver pane, set the solver Type to Variable-step.

Settings

Refine output (default) | Produce additional output | Produce specified output only
Refine output

The solver produces additional output values based on the value you specify for the Refine factor parameter. By default, the refine factor is 1, and the simulation does not produce additional output values. When you specify a refine factor of 2, the simulation produces an additional output value midway between each simulation time step.

The solver does not take additional major time steps to produce the additional output values. Specifying a refine factor can provide more output points more efficiently than decreasing the maximum step size for the simulation.

Produce additional output

The solver produces additional output values by taking a major time step at each time you specify using the Output times parameter in addition to the major time steps determined by the solver.

Produce specified output only

The solver produces output values only at the simulation start time, simulation stop time, and the times you specify using the Output times parameter. The solver might take additional steps as required to accurately simulate the model and produce the output values for the specified times. However, logged simulation data contains values for only the specified times.

Recommended Settings

The table summarizes recommended values for this parameter based on considerations related to code generation.

ApplicationSetting
DebuggingNo impact
TraceabilityNo impact
EfficiencyNo recommendation
Safety precautionNo recommendation

Programmatic Use

Parameter: OutputOption
Value: 'RefineOutputTimes' | 'AdditionalOutputTimes' | 'SpecifiedOutputTimes'
Default: 'RefineOutputTimes'

Version History

Introduced before R2006a