# :MHIStogram Subsystem

:MHIStogram Commands

- :MHIStogram Subsystem
- :MHIStogram:ANNotations
- :MHIStogram:ASCii:DATA?
- :MHIStogram:BINS
- :MHIStogram:DIMensions
- :MHIStogram:DISPlay
- :MHIStogram:INCRement?
- :MHIStogram:INTeger:DATA?
- :MHIStogram:ORIGin?
- :MHIStogram:POINts?
- :MHIStogram:SCALe
- :MHIStogram:SOURce:LOCation

Use the :MHIStogram subsystem commands to configure up to four available measurement histograms. Measurement histograms are generated from the statistical analysis of measurement results. You can view a histogram of any measurement as long as it is active and its results are numeric.

A Measurement Histogram

Although measurement results already have statistics, histograms give you a visual representation of the measurement results and they provide additional statistics (Peak-Peak, Mode, and others). You can control the resolution of histogram statistics by changing the number of bins used in the histogram.

When Measure One is selected for a measurement, the histogram acquires one scalar measurement result per acquisition. When Measure All is selected for a measurement, the histogram acquires N scalar measurement results per acquisition where N is the number of edges on which the measurement was made.

The measurement histogram database is reset when the Clear button is clicked or when the vertical scale, offset, horizontal position, horizontal scale, or trigger settings are changed.

The four histograms are identified by the `{1:4}` in the `MHIStogram{1:4}` command. These command provide control for the equivalent features in the Measurement Histograms dialog box. To return measurements from the MHist Stats results table, use the `Waveform Histogram Commands` series of commands.

The `:MHIStogram:SOURce:LOCation` command selects the measurement source by its number in the top-to-bottom order of the Measurement results window.

To return the histogram database, use the `:MHIStogram:ASCii:DATA?` query to return an ASCII list of comma separated values. Or, use the `:MHIStogram:INTeger:DATA?` query to return a binary block of 32 bit integers. The data values for both of these queries are the hit counts for each histogram bin (bucket).

To return the center of the first histogram bin (bucket), use the `:MHIStogram:ORIGin?` query.

To return the width of each histogram bin (bucket), use the `:MHIStogram:INCRement?` query.