| Contents | Index |

| On this page… |
|---|
Warn if machine contains redundant constraints Warn if number of initial constraints is unstable Display machines after updating diagram Show animation during simulation |
Configure the mechanical settings for an entire SimMechanics model.
This pane appears only if your model contains at least one block from the Simscape product or a product based on the Simscape product, such as the SimMechanics product.
The settings in this pane are saved only if your model contains at least one SimMechanics block.
Require SimMechanics software to warn you if your model has more constraints than necessary.
Default: on
SimMechanics software warns you if your model has too many constraints.
SimMechanics software does not warn you if your model has too many constraints.
Use this option to check if your model has too many and possibly conflicting constraints. Inconsistent constraints cause the model simulation to stop with an error.
| Parameter: WarnOnRedundantConstraints |
| Type: string |
| Value: 'on' | 'off' |
| Default: 'on' |
| Application | Setting |
|---|---|
| Debugging | On |
| Traceability | On |
| Efficiency | No impact |
| Safety precaution | On |
Configuring Methods of Solution: Avoiding Simulation Failures
Require SimMechanics software to warn you if small changes to your model's initial state lead to changes in the number of constraints.
Default: off
SimMechanics software warns you if your model's constraints are unstable against small changes to its initial state.
SimMechanics software does not warn you if your model's constraints are unstable against small changes to its initial state.
Use this option to check if your model has:
Too many and possibly conflicting constraints
Too few constraints, leaving the model underdetermined
Either condition prevents SimMechanics software from successfully simulating your model.
| Parameter: WarnOnSingularInitialAssembly |
| Type: string |
| Value: 'on' | 'off' |
| Default: 'off' |
| Application | Setting |
|---|---|
| Debugging | On |
| Traceability | On |
| Efficiency | No impact |
| Safety precaution | On |
Configuring Methods of Solution: Avoiding Simulation Failures
Require Simulink to mark any Joint blocks in closed loops that it cuts during simulation.
Default: off
Simulink marks the icons of any Joint blocks that it cuts during simulation.
Simulink does not mark the icons of any Joint blocks, whether the blocks are cut during simulation or not.
SimMechanics software chooses the Joint to cut in each closed loop unless you enter your preference in one of the Joint dialogs. To do so, go to the Axes tab of that Joint dialog's Parameters area and select the Mark as the preferred cut joint check box.
This parameter applies only if your SimMechanics model contains at least one closed loop.
| Parameter: ShowCutJoints |
| Type: string |
| Value: 'on' | 'off' |
| Default: 'off' |
| Application | Setting |
|---|---|
| Debugging | On |
| Traceability | On |
| Efficiency | No impact |
| Safety precaution | No impact |
Enable a model-wide static view in the SimMechanics visualization window.
Default: off
Enable a static display of all machines in your model that also have machine-specific visualization enabled. The view refreshes when you select Update Diagram in the model's Edit menu.
Disable static display for all machines in your model.
Enable or disable, and configure, visualization for each machine in your model in the Visualization pane of the machine's Machine Environment block.
All other visualization controls appear in the individual Body block dialogs or on the visualization window itself.
Visualization is enabled for each machine in your model by the Visualize machine check box of the machine's Machine Environment block.
| Parameter: VisOnUpdateDiagram |
| Type: string |
| Value: 'on' | 'off' |
| Default: 'off' |
| Application | Setting |
|---|---|
| Debugging | No impact |
| Traceability | No impact |
| Efficiency | No impact |
| Safety precaution | Off |
Starting Visualization and Simulation: Setting Up Visualization
Enable model-wide animation in the SimMechanics visualization window.
Default: off
Enables model-wide animation in the visualization window for all machines in your model with machine-specific visualization also enabled. The animation starts when you start model simulation.
Disables model-wide animation in the visualization window for all machines in your model.
Enable or disable, and configure, visualization for each machine in your model in the Visualization pane of the machine's Machine Environment block.
All other visualization controls appear in the individual Body block dialogs or on the SimMechanics visualization window itself.
Visualization is enabled for each machine in your model by the Visualize machine check box of the machine's Machine Environment block.
| Parameter: VisDuringSimulation |
| Type: string |
| Value: 'on' | 'off' |
| Default: 'off' |
| Application | Setting |
|---|---|
| Debugging | No impact |
| Traceability | No impact |
| Efficiency | Off |
| Safety precaution | Off |
Starting Visualization and Simulation: Setting Up Visualization
Suppress display of Body coordinate systems on bodies in the SimMechanics visualization window, unless the CS ports associated with the Body coordinate systems are also visible on the Body blocks in the model.
Default: off
Suppresses display of Body coordinate systems on bodies in the visualization window, if the associated CS ports are not visible on the Body blocks in the model.
Enables display of all Body coordinate systems on bodies in the visualization window, whether or not the associated CS ports are visible on the Body blocks in the model.
Enable or disable, and configure, visualization for each machine in your model in the Visualization pane of the machine's Machine Environment block.
All other visualization controls appear in the individual Body block dialogs or on the visualization window itself.
Visualization is enabled for each machine in your model by the Visualize machine check box of the machine's Machine Environment block.
| Parameter: ShowOnlyPortCS |
| Type: string |
| Value: 'on' | 'off' |
| Default: 'off' |
| Application | Setting |
|---|---|
| Debugging | Off |
| Traceability | Off |
| Efficiency | On |
| Safety precaution | No impact |
Starting Visualization and Simulation: Setting Up Visualization
Set default color of all bodies in a model visualized in the SimMechanics visualization window.
Specify the color value with the MATLAB Graphics ColorSpec [r g b], where r, g, and b specify red, green, and blue color components.
Default: [1 0 0] (red)
Configure visualization for each machine in your model in the Visualization pane of the machine's Machine Environment block.
All other visualization controls appear in the individual Body block dialogs or on the visualization window itself.
Visualization is enabled for each machine in your model by the Visualize machine check box of the machine's Machine Environment block.
| Parameter: DefaultBodyColor |
| Type: string |
| Value: '[r g b]', where r, g, and b are real numbers between 0 and 1, inclusive |
| Default: '[1 0 0]' |
| Application | Setting |
|---|---|
| Debugging | No impact |
| Traceability | No impact |
| Efficiency | No impact |
| Safety precaution | No impact |
Starting Visualization and Simulation: Setting Up Visualization
Set default body geometry of all bodies visualized in the SimMechanics visualization window.
Specify the geometry by one of these choices:
Convex hull from body coordinate system (CS) locations
Equivalent ellipsoid from body mass properties
Default: Convex hull from body CS locations
Configure visualization for each machine in your model in the Visualization pane of the machine's Machine Environment block.
All other visualization controls appear in the individual Body block dialogs or on the visualization window itself.
Visualization is enabled for each machine in your model by the Visualize machine check box of the machine's Machine Environment block.
| Parameter: MDLBodyVisualizationType |
| Type: string |
| Value: 'Convex hull from body CS locations' | 'Equivalent ellipsoid from mass properties' |
| Default: 'Convex hull from body CS locations' |
| Application | Setting |
|---|---|
| Debugging | No impact |
| Traceability | No impact |
| Efficiency | No impact |
| Safety precaution | No impact |
Starting Visualization and Simulation: Setting Up Visualization
![]() | Configuration Parameters | Mechanical Import | ![]() |

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 |