Run Multiple Simulations

Provide collection of inputs to model and run multiple simulations with these inputs using the parsim function, the batchsim function, or the Multiple Simulations panel in Simulink^®

For workflows that involve multiple parallel simulations and logging of large data, you can use the parsim or batchsim function, or run the simulations with the Multiple Simulations panel in the Simulink Editor.

With a Parallel Computing Toolbox™ license, you can use the parsim function to run the simulations in parallel. The function distributes multiple simulations to parallel workers to speed up overall simulation time. Using the parsim function with Parallel Computing Toolbox allows you to automate the creation of parallel pools, identifies file dependencies, and manages build artifacts for accelerator and rapid accelerator simulations. The parsim function runs simulations in serial if a Parallel Computing Toolbox license is not available.

You can use the batchsim function with Parallel Computing Toolbox and MATLAB^® Parallel Server™ licenses. When you use the batchsim function, simulations are offloaded onto a compute cluster. You can open a separate MATLAB session to access the job and the results.

To get started, see Running Multiple Simulations and Run Parallel Simulations for a Thermal Model of a House Using parsim.

Objects

expand all

Run Multiple Large-Scale Simulations

`simulink.multisim.DesignStudy`	Create design study for multiple simulations (Since R2024a)
`simulink.multisim.ExternalInput`	Specify a range of external inputs (Since R2024a)
`simulink.multisim.Variable`	Specify a range of values for model variables (Since R2024a)
`simulink.multisim.ModelParameter`	Specify a range of values for model parameters (Since R2024a)
`simulink.multisim.BlockParameter`	Specify a range of block parameters (Since R2024a)
`simulink.multisim.Exhaustive`	Create an exhaustive parameter combination for specified parameter values (Since R2024a)
`simulink.multisim.Sequential`	Create a sequential parameter combination for specified parameter values (Since R2024a)

Run Multiple Simulations

`Simulink.SimulationInput`	Create `Simulink.SimulationInput` objects to make changes to model for multiple or individual simulations
`Simulink.Simulation.Variable`	Variables in `Simulink.SimulationInput` objects
`Simulink.Simulation.BlockParameter`	Block parameters in `Simulink.SimulationInput` objects

Access and Manage Simulation Outputs

`Simulink.Simulation.Future`	Create `Future` object for simulation
`Simulink.Simulation.Job`	`Simulink.Simulation.Job` object for batch simulations
`simulink.multisim.MultisimDatastore`	Create datastore for post-processing large-scale simulation results (Since R2025a)

Functions

expand all

Run Multiple Simulations

`batchsim`	Offload simulations to run on a compute cluster
`parsim`	Simulate dynamic system multiple times in parallel or serial

Configure Multiple Simulations

`applyToModel`	Apply configuration in `SimulationInput` object to model
`setBlockParameter`	Set block parameter values for simulation using `SimulationInput` or `Simulation` object
`setModelParameter`	Set model parameter values for simulation using `SimulationInput` or `Simulation` object
`setInitialState`	Specify initial state for simulation using `SimulationInput` or `Simulation` object
`setExternalInput`	Specify external input data for top-level input ports using `SimulationInput` or `Simulation` object
`setVariable`	Set variable values for simulation using `SimulationInput` or `Simulation` object
`setVariantConfiguration`	Set variant configuration for simulation using `SimulationInput` object (Since R2024a)
`getVariantConfiguration`	Get name of variant configuration from `SimulationInput` object (Since R2024a)
`validate`	Validate contents of `SimulationInput` object
`setPreSimFcn`	Specify MATLAB function to run before start of each simulation on `Simulink.SimulationInput` object
`setPostSimFcn`	Set MATLAB function to run after each simulation
`loadVariablesFromMATFile`	Load variables from MAT file into `Simulink.SimulationInput` object
`loadVariablesFromExternalSource`	Load variables from a custom file into `Simulink.SimulationInput` object (Since R2022b)
`getSimulationJobs`	Get all `Simulink.Simulation.Job` objects from cluster
`showContents`	View summary of specification in `SimulationInput` or `Simulation` object

Tools

Multiple Simulations	Run multiple simulations from the Simulink Editor (Since R2021b)
Simulation Manager	Monitor multiple simulations and visualize the simulation data

Topics

Running Multiple Simulations
Run multiple simulations from the parsim and batchsim commands, and the Multiple Simulations panel in Simulink Editor.
Run Parallel Simulations for a Thermal Model of a House Using parsim
Use a Simulink.SimulationInput object to run multiple parallel simulations command line workflow.
Run Parallel Simulations
Programmatically run model simulations in parallel.
Configure and Run Simulations with Multiple Simulations Panel
Learn about the Multiple Simulations panel in the Simulink Editor.
Comparison Between Multiple Simulation Workflows
Understand the similarities and differences between parsim, parsim with RunInBackground, and batchsim.
Analyze Results Using Simulation Manager
Use the Simulation Manager to visualize simulation data, analyze simulation results and trends.

Featured Examples

Use Multiple Simulations Panel to Run Design Study with Different Parameter Values

Use the Multiple Simulations panel in the Simulink® Editor to run multiple simulations with varying values of stiffness of the suspension for a road profile that has a sinusoidal shape.

Open Live Script

Parallel Simulations Using Parsim: Parameter Sweep in Normal Mode

Run multiple simulations of a Monte Carlo study in parallel by using Parallel Computing Toolbox™. Parallel execution leverages the multiple cores of your host machine to run many simulations more quickly. These simulations could also be run in parallel on computer clusters using the MATLAB® Parallel Server™. This example will work even if the Parallel Computing Toolbox™ or the MATLAB Parallel Server is not available, but the simulations will run in serial.

Open Model

Parallel Simulations Using Parsim: Parameter Sweep in Rapid Accelerator Mode

Open Model

Parallel Simulations Using Parsim: Test-Case Sweep

Run multiple Simulink® simulations corresponding to different test cases in the Signal Editor block using SimulationInput objects and the parsim command. The parsim command uses Parallel Computing Toolbox™, if it is available, to run simulations in parallel, otherwise the simulations are run in serial.

Open Model

Rapid Accelerator Simulations Using Parsim

The use of Rapid Accelerator in applications that require running parallel simulations for a range of input and parameter values.

Open Model

Multiple Simulations Workflow Tips

The goal of this example is to provide helpful tips for running multiple simulations using parallel simulation tools. This example will work even if the Parallel Computing Toolbox™ is not available, but the simulations will run in serial. We will be using the model sldemo_suspn_3dof.

Open Model