Histogram View - 2022.1 English

Vitis Unified Software Platform Documentation: Embedded Software Development (UG1400)

Document ID
UG1400
Release Date
2022-04-26
Version
2022.1 English

The Histogram view displays the trace events (counters data) distribution with respect to time. When performance analysis is running, this view is dynamically updated as the events are received.

Figure 1. Histogram View

The controls on the view are described below.

Selection Start
Displays the start time of the current selection.
Selection End
Displays the end time of the current selection.
Window Span
Displays the current zoom window size in seconds.

The controls can be used to modify their respective value. After validation, the other controls and views will be synchronized and updated accordingly. To modify both selection times simultaneously, click link, which disables the Selection End control input.

The large (full) histogram, at the bottom, shows the event distribution over the trace. It also has a smaller semi-transparent orange window, with a cross-hair, that shows the current zoom window.

The smaller (zoom) histogram, on top right, corresponds to the current zoom window, a sub-range of the event set.

The x-axis of each histogram corresponds to the event timestamps. The start time and end time of the histogram range is displayed. The y-axis shows the maximum number of events in the corresponding histogram bars.

The vertical blue line(s) show the current selection time (or range). If applicable, the region in the selection range will be shaded.

The mouse actions that can be used to control the histogram are listed below.

Left-click
Sets a selection time
Left-drag
Sets a selection range
Shift+left-click or drag
Extend or shrink the selection range
Middle-click or CTRL+Left-click
Centers the zoom window
Middle-drag or CTRL+left-drag
Moves the zoom window
Right-drag
Sets the zoom window
SHIFT+Right-click or drag
Extend or shrink the zoom window
Mouse wheel up
Zoom in
Mouse wheel down
Zoom out

Hovering the mouse over an histogram bar pops up an information window that displays the start/end time of the corresponding bar, as well as the number of events it represents. If the mouse is over the selection range, the selection span in seconds is displayed.

The actions performed by various keystrokes when they are used in the Histogram view are listed below.

Left Arrow
Moves the current event to the previous non-empty bar.
Right Arrow
Moves the current event to the next non-empty bar.
Home
Sets the current time to the first non-empty bar.
End
Sets the current time to the last non-empty histogram bar.
Plus (+)
Zoom in
Minus (-)
Zoom out