Histogram

The histogram allows to graphically display the results of a simple classification of the samples of one signal as vertical bars. For the classification the numeric value of the sample is used. Therefore only numeric scalar data types and Status String Ref signals are supported. The samples to be classified are defined by the time range set in the histogram's time slider Control used for navigating on the time axis, including zooming functionality. bar. A change of the time range automatically triggers a recalculation.
The result of the classification is represented by the height of the vertical bar of each bucket. Additionally a figure above the bar indicates the number of samples within the bucket.

The tool tip of a bar lists the absolute number of samples, the relative share of its samples to all samples for the defined time range, the signal name and the file name.

You can perform the following actions:

• To define the Histogram properties
• To define the number of buckets and their value ranges

• To scroll or zoom the time range

• To delete the assigned signal

• To replace the assigned signal

To define the Histogram properties

The complete set of configuration possibilities for this instrument is available in the Properties docking window. There, the tooltips provide a detailed description of the properties and their possible options.

1. Do one of the following:

   • In the instrument, click .

     or

   • Select the instrument and press Alt+Enter.

     or

   • In the instrument, right-click and select Properties in the context menu.

To define the number of buckets and their value ranges

1. Open the instrument Properties window as described above.

2. In the Number of Buckets field, enter the desired number of classes for the histogram.

3. In the Interval Size field, enter the value for the width used for each bucket.

4. In the Center of First Bucket field, define the value which shall be used as center of the first bucket.

5. All changes are applied immediately.

The number of buckets and the interval size define the overall value range for the histogram.

If there are samples with a value outside the defined overall value range, optionally additional buckets on the left and right of the defined bucket will be shown. If there are samples that have a value that cannot be classified into the defined buckets, a new bucket for uncountable samples ("NaN") will be shown automatically. Examples are samples with an invalid flag, not a number (NaN), infinity (+INF, -INF) and for Status String Ref signals samples with a verbal value.

To scroll or zoom the time range

This can be done by using the time slider Control used for navigating on the time axis, including zooming functionality. bar.

For more information about synchronizing, scrolling, and zooming, see Time Navigation and Synchronization.

To delete the assigned signal

Open the Configuration Manager, mark the signal assigned to the histogram, and delete it via the context menu.

To replace the assigned signal

Just add the desired signal to the instrument by means of drag & drop or press the INSERT key.