untrace

Remove trace point in simulation debugging session

Syntax

untrace blk

Description

untrace blk removes the trace point for the block blk from the list of trace points for the current simulation debugging session. The software displays information about the block that corresponds to a trace point each time the 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 that corresponds to trace point to remove

(t)s:b | gcb

Block that corresponds to trace point to remove, specified using one of these options:

• (t)s:b — Block ID where t is the index of the task in which the block executes, s is the index of the system that contains the block, and b is the index of the block within the system

• gcb — Current block

Tips

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.