Skip to Main Content Skip to Search
Product Documentation

Simscape Pane: General

Simscape Pane Overview

The Editing Mode parameter controls the Simscape Editing Mode functionality, which allows you to open, simulate, and save models that contain blocks from add-on products in Restricted mode, without checking out add-on product licenses, as long as the products are installed on your machine. Simscape add-on products include SimDriveline™, SimElectronics®, SimHydraulics, and SimMechanics. Use this functionality to perform multidomain physical modeling and simulation while minimizing the number of required licenses.

The parameters in the Physical Networks Model-Wide Simulation Diagnostics section let you configure your preferences for solver-related warnings when you simulate models containing blocks from Simscape libraries.

The parameters in the Data Logging section let you log simulation data to workspace.

Configuration

This pane appears only if your model contains a block from the Simscape libraries (including Simscape add-on products).

See Also

Editing Mode

Set the editing mode of the model to either Full or Restricted.

Settings

Default: Full

Full

Sets the editing mode of the model to Full. In this mode, you can make any modifications to the model.

When you open a model in Full mode, the license manager checks out all the add-on product licenses for the blocks present in the model.

When you switch from Restricted to Full mode, the license manager checks whether the required add-on product licenses are available and checks them out. If some of the add-on product licenses are not available, the license manager issues an error and the model stays in Restricted mode.

Restricted

Sets the editing mode of the model to Restricted. In this mode, you can simulate the model, generate code, and make limited modifications.

When you open a model in Restricted mode, the license manager does not check out the add-on product licenses.

When you switch from Full to Restricted mode, all the add-on product licenses for the blocks present in the model remain checked out until the end of the MATLAB session.

Command-Line Information

Parameter: EditingMode
Type: string
Value: 'Full' | 'Restricted'
Default: 'Full'

See Also

Explicit solver used in model containing Physical Networks blocks

Specify whether or not the system will issue a warning or error upon simulation if the model uses an explicit solver.

Settings

Default: warning

warning

Makes the system issue a warning upon simulation if the model uses an explicit solver.

It is possible to choose any variable-step or fixed-step solver for models containing Simscape blocks. When you first create a model, the default Simulink solver is ode45. However, implicit solvers, such as ode14x, ode23t, and ode15s, are a better choice for a typical model. In particular, for stiff systems, implicit solvers typically take many fewer timesteps than explicit solvers, such as ode45, ode113, and ode1. To alert you to a potential issue, the system issues a warning when you use an explicit solver in a model containing Simscape blocks.

error

Makes the system issue an error upon simulation if the model uses an explicit solver.

If your model is stiff, and the use of explicit solvers undesirable, you may choose to select this option to avoid troubleshooting errors in the future.

none

Turns off issuing a warning or error upon simulation with explicit solver.

For models that are not stiff, explicit solvers can be effective, often taking fewer timesteps than implicit solvers. If you work with such models and use explicit solvers, select this option to turn off the warning upon simulation.

Command-Line Information

Parameter: ExplicitSolverDiagnosticOptions
Type: string
Value: 'warning' | 'error' | 'none'
Default: 'warning'

See Also

Switching from the Default Explicit Solver to Other Simulink Solvers

Zero-crossing control is globally disabled in Simulink

Specify whether or not the system will issue a warning or error upon simulation if the Zero-crossing control parameter in the Solver pane is set to Disable all, which means that zero-crossing control is globally disabled.

Settings

Default: warning

warning

Makes the system issue a warning upon simulation if zero-crossing control is globally disabled.

error

Makes the system issue an error upon simulation if zero-crossing control is globally disabled.

Command-Line Information

Parameter: GlobalZcOffDiagnosticOptions
Type: string
Value: 'warning' | 'error'
Default: 'warning'

See Also

Enabling or Disabling Simulink Zero Crossing Detection

Log simulation data

Specify whether or not the system logs simulation data to workspace.

Settings

Default: none

none

Performs no data logging upon simulation.

all

Upon simulating the model, logs all simulation data from Simscape blocks to a workspace variable specified by the Workspace variable name parameter.

Command-Line Information

Parameter: SimscapeLogType
Type: string
Value: 'none' | 'all'
Default: 'none'

See Also

How to Log Simulation Data

Workspace variable name

Specify the name of the workspace variable for simulation data logging.

Settings

Default: simlog

Command-Line Information

Parameter: SimscapeLogName
Type: string
Value: any valid value
Default: 'simlog'

See Also

How to Log Simulation Data

Decimation

Lets you limit data points being logged, by skipping time steps. Logs data points for the first time step and every nth time step thereafter, where n is the decimation factor.

Settings

Default: 1

Tips

Command-Line Information

Parameter: SimscapeLogDecimation
Type: numeric
Value: any positive integer value
Default: 1

See Also

How to Log Simulation Data

Limit data points

Specify that the number of data points logged to workspace is limited to the value corresponding to the number of simulation steps specified by the Data history (last N steps) parameter.

Settings

Default: on

On

Limits the number of data points exported to workspace to those for the number of steps specified by the Data history (last N steps) parameter.

Off

Does not limit the number of data points.

Tips

Command-Line Information

Parameter: SimscapeLogLimitData
Type: string
Value: 'on' | 'off'
Default: 'on'

See Also

How to Log Simulation Data

Data history (last N steps)

Specify the number of simulation steps to limit the number of data points output to workspace. The workspace variable defined by the Workspace variable name parameter contains the data points corresponding to the last N steps of the simulation, where N is the value you specify for the Data history (last N steps) parameter. If the simulation contains fewer steps than the number specified, the workspace variable contains the data points for the whole simulation.

Settings

Default: 5000

Tips

Command-Line Information

Parameter: SimscapeLogDataHistory
Type: numeric
Value: any positive integer value
Default: 5000

See Also

How to Log Simulation Data

  


Related Products & Applications

Learn more about Simulink through this collection of videos, articles, technical literature and the Getting Started with Simulink Guide.

 © 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS