<event_histogram>.delete <event_histogram>.list-providers
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

<event_histogram>.histogram

Synopsis

<event_histogram>.histogram [max] [max-table-width] ["sort-on-column"] [sort-order] [float-decimals] [border-style] [-show-all-columns] [-ignore-column-widths] [-verbose] [-no-row-column] [-no-footers]

Description

Prints a histogram of the events triggered during the simulation with information about the clock on which they where posted, event object, event class name, description, number of times the event was triggered, average interval between triggered events, and the step/cycle when the event was first triggered. For step events the average interval is calculated as total elapsed steps on the processor (when the command is run) divided by the number of triggered occurrences for that particular event. For cycle events, instead, the total elapsed cycles for the clock is used divided by the number of triggered occurrences.Below are the generic table arguments. The max argument selects how many rows that should be printed, default is 40. Use max = 0 to get the entire table.

The max-table-width argument specifies how many characters the table width is allowed to be. Default is zero, which means that Simics will get the current width of the terminal where the command is executed. Tables which initially become wider than this, will be shrunk down by splitting cells to multiple lines.

The sort-on-column argument allows the table to be sorted on certain column names, not all columns are allowed to be sorted on. If sort-on-column is not specified, the table may be sorted on a the column it finds most interesting or present the table unsorted.

The sort-order argument allows the sort-order to be changed, so either high values are listed first ('descending') or low values are listed first ('ascending'). If not selected, the default order is selected by the column which is being sorted upon.

The float-decimals argument can be used to print out more or less number of decimals on the floating point numbers in the table.

The border-style argument specifies how the borders for the table should look like. Possible values are borderless, ascii, thin and thick. Default is 'thin'.

The -show-all-columns flag possibly displays some hidden columns. Some autogenerated columns associated with another column are normally only displayed if that column is used for sorting. This flag enables all columns to be showed in the same table.

The -ignore-column-widths flag formats the table columns to be the max widths of the contents in the displayed rows. Consequently ignoring any explicitly set widths set in the columns.

The -verbose flag displays additional information of the table such as a description on what each column represents.

By default, an additional 'row' column is added to the far left, displaying each row's number. This can be suppressed with the -no-row-column flag. Note that footers uses the row column for the footer-names. Consequently, if the row column is removed, and footers are printed, another empty column is created instead.

Any columns have data which should be calculated and displayed in the footer, this will be printed by default. The footer can be suppressed with the -no-footers flag.

Provided By

event-histogram

See Also

<event_histogram>.clear
<event_histogram>.delete <event_histogram>.list-providers