Customize your ROCm Optiq project

Customize your ROCm Optiq project#

2025-12-10

5 min read time

Applies to Linux and Windows

You can customize the data views of an open trace file in ROCm Optiq, including display settings, saved trace selections, added bookmarks/annotations, and more.

Set a time range filter#

Set a time range filter in the Timeline View to limit the data displayed to a specific period. To set a time range filter, double-click a range in the Timeline View.

../_images/filter.png

Double-click in the Timeline View again to clear the selection.

../_images/time-range-filter.gif

The active time range filter applies to event and sample counter details in the Advanced Details section.

Save trace selections#

When there’s an active time range filter, select Edit > Save Trace Selection to trim the trace:

../_images/save-trace.png

This creates a new trace file containing only the events in the filter.

Add an annotation#

Annotations are customized notes you can add to any area of the Timeline View.

To add an annotation:

  1. Click + from the Annotations section of the toolbar:

    ../_images/add-annotation.png

    Annotations can also be added by right-clicking on the Timeline View and clicking the Add Annotation context menu option.

  2. The Annotation dialog displays. Provide a title and your note, then click Save to create the annotation.

    ../_images/save-annotation.png

    Once saved, the annotation displays on the timeline:

    ../_images/annotation-example.png

Tip

  • Edit or delete the annotation by clicking pen.

  • View the complete list of annotations in the Annotations tab of the Advanced Details section.

  • Check the Visibility option in the Annotations tab to toggle the visibility of individual annotations.

  • Clicking on a row in the annotations list brings the selected annotation into view.

Create bookmarks#

The current view on the timeline (scroll and zoom position) can be saved to a bookmark for quick navigation.

To create and use a bookmark:

  1. Click + in the book menu from the main Toolbar.

  2. Select the bookmark number to navigate to it.

Or:

  1. Press Ctrl + any key from 0 ‒ 9 to create a view bookmark. The bookmark saves to an index based on the number used and creates a shortcut.

  2. Press any key from 0 ‒ 9 to restore the view to a stored bookmark from that index number shortcut. For example, if you save a bookmark using Ctrl + 1, pressing 1 restores that bookmark.

Delete bookmarks#

  • To delete a bookmark, click X to delete a bookmark from the book menu.

  • Click Reset View to return the Timeline View to its original pan and zoom settings.

Change display settings#

You can change these global display settings for ROCm Optiq from the Settings menu:

  • The application theme display (Light or Dark mode).

  • The font scaling: either automatic based on the display DPI, or customized using the font size control:

    ../_images/settings.png

  • The time unit settings displayed on the Timeline View.

    ../_images/units.png

Customize timeline display options#

Customize display options for each track by clicking the gear icon in the track’s Description in the Timeline View:

../_images/track-gear.png

  • For event tracks, you can toggle between Color by name and Compact mode.

    • Color by name: Change the coloring method used to color the events.

    • Compact Mode: Shrink the event heights so that tall flame graphs can be displayed in a smaller area.

  • For sample counter tracks, you can toggle between Show Counter Boxes, Alternate Counter Coloring, and Highlight Y Range:

    • Show Counter Boxes: Display as a line only, or fill the area under the line as well.

    • Alternate Counter Coloring: If the area under the line is filled, alternate the fill color for each sample.

    • Highlight Y Range: Select an area of the graph to highlight. Choose the min and max range that you want to highlight. The tool highlights these values on the track region.

      ../_images/timeline-display-options.png

  • For sample counter tracks, you can set the min and max when showing the tracks:

    • Click on the value beside the min and max to set/change the scale range.

    • Click reset to restore the values to their default.

    ../_images/min-max.png

Set the flow rendering display mode#

Use the Flow buttons on the Toolbar to show and hide flow information on the Timeline View, or change the flow display mode from Render (fan) to Chain mode.

flow

Chain mode displays events in a linked sequence, emphasizing dependencies and execution order. This is useful when analyzing how operations are chained together across queues or streams.

../_images/chain-mode.png

Render mode shows events in a fan-out style, highlighting parallelism and branching. This helps visualize concurrency and how multiple operations originate from a single source.

../_images/fan-mode.png

Note

Chain mode and Render mode are visualization modes for relations; they don’t represent the actual kernel scheduling flow.

Show/hide panels#

The View menu can be used to show and hide application panels.

../_images/view.png

Save a project file#

Customizations made to tracks, bookmarks, and annotations can be persisted by saving the session as a project (.rpv file).

  • Select File > Save As to create a new project.

  • Select File > Save to overwrite the currently opened project.

Contents