Object ‘Trace’

Symbol:

This object is used for configuring a trace. At application runtime, it provides commands for controlling data recording and displaying the recorded data as a trace diagram. It is also for data navigation.

Editor ‘Trace’

• (1): View of the trace configuration
  • Configuration: Configuration
  • Add variable: Add variable
• (2): Trace diagram in multi-channel display at runtime

View of the trace configuration

This view provides an overview of the current trace configuration where you can edit the configuration. Double-clicking a variable opens the Trace Configuration dialog box and shows the respective configuration in Variable Settings.

The following commands and context menu commands are also provided:

Configuration	The Trace Configuration dialog box opens with the selected top node. The configuration for data recording is displayed on the right below Record Settings for quick configuration.
Add variable	The Trace Configuration dialog box opens with a new and blank entry in the trace configuration. The new entry is displayed on the right below Variable Settings for quick configuration.
	Drop-down list opens with the Hide instance paths command.
Hide instance paths	Toggles the display of the variable list : Display with complete instance path (for example, PLC_PRG.iCounter)

Context menu

Add variable	The Trace Configuration dialog box opens with a new and blank entry in the trace configuration. The new entry is displayed on the right below Variable Settings for quick configuration.
Delete variable	The variable that is selected in the view is removed from the configuration.
Visible	Toggles the visibility of the selected variable in the trace diagram : Graph of variables is visible in the trace diagram.
Display	The Y-axis Display Settings dialog box opens.
Configuration	The Trace Configuration dialog box opens with the Record Settings.

See also

• Dialog ‘Trace Configuration’
• ddf400a3393bd8b8c0a8640e01a80e0c

Trace diagram at runtime

At application runtime, CODESYS populates and updates the trace buffer with the recorded samples, and then it displays the recorded data in the trace diagram as a graph over time. If you close the trace editor, the buffer will be freed.

Use menu commands for controlling data recording. You can navigate the data by means of menu commands, keyboard shortcuts, and mouse input.

See also

• Operating the Data Recording
• Navigating into Trace Data

Navigating the trace diagram with the mouse

In the trace diagram, you can navigate data by using the mouse to scroll and zoom.

Requirement	Mouse Input	Mouse Symbol	Effect
	Drag the graph along the x-axis.		Horizontal scrolling of the trace graph along the time axis.
	Hold down the Ctrl key and drag the graph along the y-axis.		Vertical scrolling of the trace graph along the y-axis.
Multi Channel disabled Mouse Zooming	Stretch a box.		CODESYS zooms to the box.
	Move the mouse wheel backwards.		CODESYS compresses the x-axis like the Compress command ( ).
	Move the mouse wheel forwards.		CODESYS stretches the x-axis like the Stretch command ( ).
	Hold down the Ctrl key and move the mouse wheel backwards.		CODESYS compresses the y-axis.
	Hold down the Ctrl key and move the mouse wheel forwards.		CODESYS stretches the y-axis
Multi Channel enabled	Click into a trace diagram.		The trace diagram is selected.
One or two trace cursors are provided.	Drag the triangle of a trace cursor to another position.		Horizontal moving of the trace graph along the time axis.
Two trace cursors are provided.	Click the gray trace cursor.		The gray trace cursor is black and therefore selected.

See also

• Command ‘Mouse Zooming’

Navigating the trace diagram with the keyboard

Requirement	Keyboard shortcuts	Effect
	Left Arrow Right Arrow	CODESYS scrolls the trace graph along the x-axis.
	Ctrl+Left Arrow Ctrl+Right Arrow	CODESYS scrolls the trace graph along the x-axis in large intervals
	Up Arrow Down Arrow	CODESYS scrolls the trace graph along the y-axis.
	Ctrl+Up Arrow Ctrl+Down Arrow	CODESYS scrolls the trace graph along the y-axis in large intervals
Multi Channel enabled	Up Arrow Down Arrow	CODESYS scrolls the trace graph along the x-axis in the selected trace diagram.
Multi Channel enabled	Ctrl+Up Arrow Ctrl+Down Arrow	CODESYS scrolls the trace graph along the x-axis in the selected trace diagram in large intervals.
One or two trace cursors are provided.	Alt+Left Arrow Alt+Right Arrow	CODESYS scrolls the trace graph along the x-axis in the selected trace diagram.
One or two trace cursors are provided.	Ctrl+Alt+Left Arrow Ctrl+Alt+Right Arrow	CODESYS scrolls the trace graph along the x-axis in the selected trace diagram in large intervals.
	-	CODESYS compresses the x-axis like the Compress command ( ).
	+	CODESYS stretches the x-axis like the Stretch command ( ).
Multi Channel disabled	Ctrl+-	CODESYS stretches the x-axis
Multi Channel disabled	Ctrl++	CODESYS stretches the y-axis
Multi Channel enabled	Ctrl+-	CODESYS compresses the y-axis of the selected trace diagram
Multi Channel enabled	Ctrl++	CODESYS stretches the y-axis of the selected trace diagram
Multi Channel enabled	Tab	Selection of the next lower trace diagram
One or two trace cursors are provided.	Left Arrow Right Arrow	CODESYS moves the black trace cursor.
One or two trace cursors are provided.	Ctrl+Left Arrow Ctrl+Right Arrow	CODESYS moves the black trace cursor in large intervals.
One or two trace cursors are provided.	Shift+Left Arrow Shift+Right Arrow	CODESYS moves the gray trace cursor.
One or two trace cursors are provided.	Ctrl+Shift+Left Arrow Ctrl+Shift+Right Arrow	CODESYS moves the gray trace cursor in large intervals.

See also

• Command ‘Multi Channel’
• Command ‘Cursor’
• Application in Runtime Mode