IO And Other Plottable Data Items

Display options for plotable data items

The plots report plots non-summarized (over-time) per PE data items synchronized with the call stack. Plots report is available with full trace or sample data files with the pat_build -Drtenv=PAT_RT_SUMMARY=0 option. See pat_help plots and pat_help plots PAT_RT_SAMPLING_DATA for sample data collection environment variables.

Display Areas

Plots display has four display areas. The first three are aligned horizontally so that they are synchronized in time. From top to bottom they are:

• The Call Stack
• The Data Graph
• Time Scale
• Navigation, display control, status message area

The Call Stack

The call stack shows the function calls of the program running on the CPU, starting with 1 (usually main) at the top. For samp_pc_time experiments all functions are on one level.

The Data Graph

The data graph plots collected data over time, synchronized with the call stack. By default the first two plots are displayed. The plots displayed and the ordering can be controlled by clicking on the plots button in the lower left and selecting which plots to display. If no data is available, the plot will not be displayed and a message will be issued to the right of the PE:/Thread: entry boxes below.

Time Scale

The time scale shows the segment of the run time that is displayed. The amount of time displayed is controlled by the Zoom function; what segment of time is displayed is controlled by the scroll bar immediately below the time scale.

Navigation Controls

A carriage return or enter is required after entering data in the entry boxes.

Zoom Slider and Entry Box

Zoom is controlled by moving the slider or entering a number in the entry box.

Time Entry Box

Enter a time value to center the display on that time.

Function Name Entry Box/ Prev/Next Buttons

Enter a function name to center the display at the beginning of that call function. Use the zoom controls to better view short running functions. Use the Prev/Next buttons to navigate previous or next call of that function. All visible instances of the selected function are highlighted.

PE Selection Box

The PE selection box shows the PE where data was collected. Enter a PE number to see the data from a specific PE. Some data is either not available or not collected on every PE. If no data is collected on the selected PE during the time interval displayed the plot will be removed from the display.

Thread Selection Box

The thread selection box shows the thread where the data was collected. Enter a thread number to see the data from a specific thread. Some data is either not available or not collected on every thread. If no data is collected on the selected thread during the time interval displayed the plot will be removed from the display.

Plots Menu Button

Clicking on the plots button brings up a dialog box allowing selection and ordering of the plots in the display. Some plots may not display if no data is collected for that plot.