Skip to Main Content Skip to Search
Product Documentation

SimMechanics Pane: General

SimMechanics Pane Overview

Configure the mechanical settings for an entire SimMechanics model.

Configuration

See Also

Warn if machine contains redundant constraints

Require SimMechanics software to warn you if your model has more constraints than necessary.

Settings

Default: on

On

SimMechanics software warns you if your model has too many constraints.

Off

SimMechanics software does not warn you if your model has too many constraints.

Tip

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.

Command-Line Information

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

Recommended Settings

ApplicationSetting
DebuggingOn
TraceabilityOn
EfficiencyNo impact
Safety precautionOn

See Also

Configuring Methods of Solution: Avoiding Simulation Failures

Warn if number of initial constraints is unstable

Require SimMechanics software to warn you if small changes to your model's initial state lead to changes in the number of constraints.

Settings

Default: off

On

SimMechanics software warns you if your model's constraints are unstable against small changes to its initial state.

Off

SimMechanics software does not warn you if your model's constraints are unstable against small changes to its initial state.

Tip

Use this option to check if your model has:

Either condition prevents SimMechanics software from successfully simulating your model.

Command-Line Information

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

Recommended Settings

ApplicationSetting
DebuggingOn
TraceabilityOn
EfficiencyNo impact
Safety precautionOn

See Also

Configuring Methods of Solution: Avoiding Simulation Failures

Mark automatically cut joints

Require Simulink to mark any Joint blocks in closed loops that it cuts during simulation.

Settings

Default: off

On

Simulink marks the icons of any Joint blocks that it cuts during simulation.

Off

Simulink does not mark the icons of any Joint blocks, whether the blocks are cut during simulation or not.

Tip

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.

Dependency

This parameter applies only if your SimMechanics model contains at least one closed loop.

Command-Line Information

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

Recommended Settings

ApplicationSetting
DebuggingOn
TraceabilityOn
EfficiencyNo impact
Safety precautionNo impact

See Also

Display machines after updating diagram

Enable a model-wide static view in the SimMechanics visualization window.

Settings

Default: off

On

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.

Off

Disable static display for all machines in your model.

Tips

Dependency

Visualization is enabled for each machine in your model by the Visualize machine check box of the machine's Machine Environment block.

Command-Line Information

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

Recommended Settings

ApplicationSetting
DebuggingNo impact
TraceabilityNo impact
EfficiencyNo impact
Safety precautionOff

See Also

Starting Visualization and Simulation: Setting Up Visualization

Show animation during simulation

Enable model-wide animation in the SimMechanics visualization window.

Settings

Default: off

On

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.

Off

Disables model-wide animation in the visualization window for all machines in your model.

Tips

Dependency

Visualization is enabled for each machine in your model by the Visualize machine check box of the machine's Machine Environment block.

Command-Line Information

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

Recommended Settings

ApplicationSetting
DebuggingNo impact
TraceabilityNo impact
EfficiencyOff
Safety precautionOff

See Also

Starting Visualization and Simulation: Setting Up Visualization

Show only port coordinate systems

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.

Settings

Default: off

On

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.

Off

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.

Tips

Dependency

Visualization is enabled for each machine in your model by the Visualize machine check box of the machine's Machine Environment block.

Command-Line Information

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

Recommended Settings

ApplicationSetting
DebuggingOff
TraceabilityOff
EfficiencyOn
Safety precautionNo impact

See Also

Starting Visualization and Simulation: Setting Up Visualization

Default body color (RGB)

Set default color of all bodies in a model visualized in the SimMechanics visualization window.

Settings

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)

Tips

Dependencies

Visualization is enabled for each machine in your model by the Visualize machine check box of the machine's Machine Environment block.

Command-Line Information

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]'

Recommended Settings

ApplicationSetting
DebuggingNo impact
TraceabilityNo impact
EfficiencyNo impact
Safety precautionNo impact

See Also

Starting Visualization and Simulation: Setting Up Visualization

Default body geometries

Set default body geometry of all bodies visualized in the SimMechanics visualization window.

Settings

Specify the geometry by one of these choices:

Default: Convex hull from body CS locations

Tips

Dependency

Visualization is enabled for each machine in your model by the Visualize machine check box of the machine's Machine Environment block.

Command-Line Information

Parameter: MDLBodyVisualizationType
Type: string
Value: 'Convex hull from body CS locations' | 'Equivalent ellipsoid from mass properties'
Default: 'Convex hull from body CS locations'

Recommended Settings

ApplicationSetting
DebuggingNo impact
TraceabilityNo impact
EfficiencyNo impact
Safety precautionNo impact

See Also

Starting Visualization and Simulation: Setting Up Visualization

  


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