trace

Display information about specified block each time block executes in simulation debugging session

Syntax

trace blk

Description

trace blk registers the block specified by blk as a trace point in the simulation debugging session. The software displays information about the block that corresponds to a trace point each time that block executes in the simulation debugging session.

• When you start the simulation debugging session programmatically, the information is displayed in the MATLAB^® Command Window.

• When you start the simulation debugging session using the Simulink^® Editor, the information is displayed in the Diagnostic Viewer.

You can use this function in a simulation debugging session started:

• Interactively, using the Simulink Toolstrip

• Programmatically, using the sldebug function

• Programmatically, using the sim function with the 'debug' name-value argument

Note

This function is available only for simulation debugging sessions started programmatically and for interactive simulation debugging sessions while paused within a time step.

Input Arguments

blk — Block to register as trace point

(t)s:b | gcb

Block to register as trace point, specified as one of these options:

• (t)s:b — Block with index b in system with index s and task with index t

• gcb — Current block

Tips

• To clear a registered trace point, use the untrace function.

• The software displays the level of information configured for the simulation debugging session. To specify the level of information to display, use the probe function.

• To start a simulation debugging session interactively, add one or more breakpoints to your model, and in the Breakpoints List, check that Pause within time step is selected. When the simulation pauses on a breakpoint, some of the programmatic debugging commands, such as the stop command, are available for use in the MATLAB Command Window.

Version History

Introduced before R2006a

R2024a: sldebug prompt in MATLAB Command Window indicates when simulation debugging session is paused within time step

When you start a simulation debugging session using the Simulink Editor, you can issue some programmatic simulation debugging commands, such as probe or stop, while the simulation is paused within a time step. The sldebug command prompt (sldebug>>) now replaces the MATLAB command prompt (>>) to indicate in the MATLAB Command Window when the simulation is paused within a time step. As in prior releases, you can issue both MATLAB commands and the supported simulation debugging commands at the sldebug command prompt.

For more information, see Simulink Debugging Programmatic Interface.