Documentation

Sensitivity Analysis

Analyze cost function sensitivity to model parameters using design of experiments (DOE), Monte Carlo, and correlation techniques

Use Sensitivity Analysis to evaluate how the parameters and states of a Simulink® model influence the model output or model design requirements. You can evaluate your model in the Sensitivity Analysis tool, or at the command line. You can speed up the evaluation using parallel computing or fast restart. In the Sensitivity Analysis tool, after performing sensitivity analysis, you can export the analysis results to the Parameter Estimation or Response Optimization tools. To learn more about sensitivity analysis and its applications, see What is Sensitivity Analysis?

Graphical Tools

Sensitivity Analysis Tool Explore design space and determine most influential model parameters

Functions

sdo.sample Generate parameter samples
sdo.SampleOptions Parameter sampling options for sdo.sample
sdo.ParameterSpace Specify probability distributions for model parameters
makedist Create probability distribution object
truncate Truncate probability distribution object
sdo.scatterPlot Scatter plot of samples

Create Simulation Scenario

sdo.SimulationTest Simulation scenario description

Specify Time-Domain Requirements

sdo.requirements.SignalBound Piecewise-linear amplitude bound
sdo.requirements.SignalTracking Reference signal to track
sdo.requirements.StepResponseEnvelope Step response bound on signal
sdo.requirements.PhasePlaneEllipse Impose elliptic bound on phase plane trajectory of two signals
sdo.requirements.PhasePlaneRegion Impose region bound on phase plane trajectory of two signals

Specify Parameter Requirements

sdo.requirements.FunctionMatching Impose function matching constraint on variable
sdo.requirements.MonotonicVariable Impose monotonic constraint on variable
sdo.requirements.RelationalConstraint Impose relational constraint on pair of variables
sdo.requirements.SmoothnessConstraint Impose bounds on gradient magnitude of variable

Specify Frequency-Domain Requirements

sdo.requirements.BodeMagnitude Bode magnitude bound
sdo.requirements.ClosedLoopPeakGain Closed loop peak gain bound
sdo.requirements.GainPhaseMargin Gain and phase margin bounds
sdo.requirements.OpenLoopGainPhase Nichols response bound
sdo.requirements.PZDampingRatio Damping ratio bound
sdo.requirements.PZNaturalFrequency Natural frequency bound
sdo.requirements.PZSettlingTime Settling time bound
sdo.requirements.SingularValue Singular value bound
sdo.evaluate Evaluate cost function for samples
sdo.EvaluateOptions Cost function evaluation options for sdo.evaluate
sdo.getParameterFromModel Design variable for optimization
sdo.getStateFromModel Initial state for estimation from Simulink model
sdo.getModelDependencies List of model file and path dependencies
sdo.setValueInModel Set design variable value in model
sdo.analyze Analyze how model parameters influence cost function
sdo.AnalyzeOptions Analysis options for sdo.analyze

Topics

Evaluation Basics

What is Sensitivity Analysis?

Simulink Design Optimization™ software performs global sensitivity analysis.

Generate Parameter Samples for Sensitivity Analysis

This topic shows how to generate parameter samples for sensitivity analysis.

Analyze Relation Between Parameters and Design Requirements

Use visual and statistical analysis techniques to analyze the relationship between the parameters and design requirements.

Validate Sensitivity Analysis

You can validate sensitivity analysis by checking generated parameter values, evaluation results, and analysis results.

Write a Cost Function

Write a cost function for parameter estimation, response optimization, or sensitivity analysis. The cost function evaluates your design requirements using design variable values.

Identify Key Parameters for Estimation (GUI)

This example shows how to use sensitivity analysis to narrow down the number of parameters that you need to estimate when fitting a model.

Identify Key Parameters for Estimation (Code)

This example shows how to use sensitivity analysis to narrow down the number of parameters that you need to estimate to fit a model.

Design Exploration using Parameter Sampling (GUI)

This example shows how to sample and explore a design space using the Sensitivity Analysis tool.

Design Exploration using Parameter Sampling (Code)

This example shows how to sample and explore a design space.

Explore Design Reliability using Parameter Sampling (GUI)

This example shows how to use the Sensitivity Analysis tool to explore the behavior of a PI controller for a DC motor.

Speed Up Evaluation

Use Parallel Computing for Sensitivity Analysis

Specify model dependencies and use parallel computing for performing sensitivity analysis in the tool, or at the command line.

Use Fast Restart Mode During Sensitivity Analysis

This topic shows how to speed up sensitivity analysis using Simulink fast restart.

Use Accelerator Mode During Simulations

Simulink Design Optimization software supports Normal and Accelerator simulation modes.

Store Intermediate Data in the Tool

How to speed up evaluation in the tool by storing intermediate data

Sensitivity Analysis Tool Tasks

Specify Parameters for Design Exploration

This topic shows how to select parameters of a Simulink model for design exploration in the Sensitivity Analysis tool.

Specify Time-Domain Requirements

This topic shows how to specify time-domain requirements in the Sensitivity Analysis tool.

Specify Frequency-Domain Requirements

This topic shows how to specify frequency-domain requirements in the Sensitivity Analysis tool.

Preprocess Data

Perform preprocessing operations such as removing offsets and filtering the data before you use it.

Create Linearization I/O Sets

This example shows how to create a linearization input/output set in the Response Optimization tool or Sensitivity Analysis tool.

Evaluate Design Requirements

This topic shows how to evaluate your design requirements in the Sensitivity Analysis tool.

Use Sensitivity Analysis to Configure Estimation and Optimization

This topic shows how to use the results generated in the Sensitivity Analysis tool to configure parameter estimation or response optimization.

Interact with Plots in the Sensitivity Analysis Tool

This topic shows how to interact with and interpret plots generated in the Sensitivity Analysis tool.

Was this topic helpful?