<probes>.list-kinds <probes>.new-attribute-probe
Simics Reference Manual  /  3 Commands  /  3.2 Command List  / 

<probes>.new-aggregate-probe

Synopsis

<probes>.new-aggregate-probe "name" ["display-name"] "probe" function ([ objects ... ] | list of objects) [width]

Description

Creates a new global probe with a name that will be the aggregate of all probes with the name probe using the function. The following aggregator functions are supported:

sum: All probe values are summed together. Valid probe types: float, fraction, histogram, int, int128.

min: The lowest value among the probe values is returned. For fraction-probes, if any denominator contains a zero value, the calculated sum returned is [0, 0]. Valid probe types: float, fraction, int, int128.

max: The highest value among probe values is returned. Valid probe types: float, fraction, int, int128.

arith-mean: The arithmetic mean is calculated for all the probe values. Valid probe types: float, fraction, int, int128.

weighted-arith-mean: The denominators are used as weights. Using these weights implies that the weighted arithmetic mean can be calculated by adding all numerators and denominators, producing a new fraction of these sums. For example, when calculating the mean instruction per cycles (IPC) on all processors (where the IPC per processor is represented as a fraction: instructions / cycles). With two processors having [20/30] and [40/50], the total IPC becomes [(20+40)/(30+50)] or [60/80] and the IPC value of 0.75. Valid probe types: fraction.

median: The median among the probe values is returned. Valid probe types: float, int, int128.

object-histogram: A histogram probe is created using the probe-owner-objects as key and their probe-values value. Valid probe types: float, int.

class-histogram: Similar to the object-histogram, but here the histogram uses the classname of the owner-object as key, and the value is the sum of the probe-values with the same class. Valid probe types: float, int.

The display-name can be used when presenting the probe in a monitor tool or similar.

The objects argument is optional, if used, only the specified objects will be part of the sum.

The display width (used by probe-monitors) can be set by the width argument. If not set it will default to 10 character for scalar probes and 40 for histograms.

Provided By

Simics Core
<probes>.list-kinds <probes>.new-attribute-probe