Multiple Simulations

Run multiple simulations from the Simulink Editor

Since R2021b

Description

The Multiple Simulations panel allows you to set up multiple simulations for a block parameter that you want to vary, for example, for a parameter sweep, or for Monte Carlo simulations. You can select a block parameter in the model canvas and specify values that you want to use for the simulations. You can also specify variables for the simulations. With the Multiple Simulations panel, you can provide configurations such as Use Parallel to run your simulations in parallel. To run the simulations that you have set up, first, select the design study, and then in the Simulink^® Toolstrip, on the Simulation tab, click the Run All button. Once the simulations are complete, you can view and manage the results in the Simulation Manager.

×

Open the Multiple Simulations

• To open the Multiple Simulations panel, navigate to the Prepare section on the Simulink toolstrip. In the Inputs & Parameter Tuning section, click Multiple Simulations .

Examples

• Multiple Simulations Panel: Simulate for Different Values of Stiffness for a Vehicle Dynamics System

Parameters

New Design Study File — Option to start a new design study file

MLDATX file

Option to start a new design study file or a new Multiple Simulations panel session. New design study file or a session. Creating a new design study file prompts you to create a new session and confirms if you want to save and close the current session.

New Design Study — Option to add a new design study to the current file

design study object

Option to add a new design study in the current, open MLDATX file. adds a new design study field to the existing table of design studies in the Multiple Simulations panel.

Specifications — Option to add simulation specifications

design study object

Option to add different parameters and values, sets of faults, or any combination of parameters and values, sets of defaults, and variables for multiple simulations.

• To add a new block parameter, click .

• To add new variables, click .

• For the block parameters or variables that you add, you can use parameter combinations. Parameter combinations allow you to specify either an exhaustive combination or a sequential combination of the parameters. By default, all parameters at the top level are combined exhaustively.

• To add a set of fault values, click

Run Options — Option to run in parallel

parallel

Select the Use Parallel to run the multiple simulations on parallel workers. This option is only available with a Parallel Computing Toolbox™ license.

Programmatic Use

parsim(in)

parsim(in) is the command line equivalent syntax for running multiple simulations.

More About

Design Study

In the panel, you can click the right most button to create a new design study. A new design study object is added to the panel. The name of this design study is automatically populated. To change the name, double click the name and enter your preferred name. A design study is an object that allows you to set up simulations. Once you configure and set up the values for the simulations, you can select this design study and click Run All on the Simulink Toolstrip to run the simulations.

Parameter Combinations

For the block parameters or variables that you add, you can use parameter combinations. Parameter combinations allow you to specify either an exhaustive combination or a sequential combination of the parameters. By default, all parameters at the top level are combined exhaustively.

To create an exhaustive combination, select block parameters. Then, from the parameter combinations drop-down list , select Exhaustive combination. An exhaustive combination is denoted by and creates all possible combinations from the parameter values. For example, one parameter and another parameter has five values, an exhaustive combination creates a total of 10x5=50 different combinations.

To create a sequential combination, select the block parameters. Then, from the parameter combinations drop-down list , select Sequential combination. For example, if you have two properties that each specify ten different values, sequential combination creates total of ten different simulations, one for each set of values. A sequential combination is denoted by and combines values sequentially. The number of values specified for each parameter must be the same. You can choose the sequence in which parameters are combined.

Version History

Introduced in R2021b