CALCulate:TRANsform:HISTogram Subsystem

Example

This example enables an automatically scaled, 100-bin histogram of 1000 DCV measurements. It then returns the computed histogram, including the lower and upper range values, the total measurement count, and the bin data.

CONF:VOLT:DC 10,0.001
SAMP:COUN 1000
CALC:TRAN:HIST:RANG:AUTO ON
CALC:TRAN:HIST:POIN 100
CALC:TRAN:HIST:STAT ON
INIT
*WAI
CALC:TRAN:HIST:ALL?

Typical Response: +9.99383828E+00,+1.00513398E+01,+1000,<102 bin counts>

The above response indicates 102 bin counts because the histogram includes bins for values below and above the histogram range.

CALCulate:TRANsform:HISTogram:ALL?
CALCulate:TRANsform:HISTogram:DATA?

The ALL form of the query returns a comma-separated list of the lower and upper range values, the number of measurements, and the bin data collected since the last time the histogram data was cleared. The DATA form returns only the bin data.

Parameter	Typical Return
(none)	See Example.
See Example.

• The bin data includes the following, in order:
• The number of measurements less than the lower range value
• The number of measurements in the each of the bins, starting at the lower range value bin
• The number of measurements greater than the upper range value
• Range values are real numbers returned in the form +1.00000000E+00. The number of measurements and bin data are signed, positive integers returned in the form +100.

CALCulate:TRANsform:HISTogram:CLEar[:IMMediate]

Clears the histogram data and restarts histogram ranging if it is enabled (CALCulate:TRANsform:HISTogram:RANGe:AUTO ON).

Parameter	Typical Return
(none)	(none)
Clear the histogram data: CALC:TRAN:HIST:CLE

• Does not clear measurements in reading memory.
• To clear statistics, limits, histogram data, and measurement data, use CALCulate:CLEar[:IMMediate].

CALCulate:TRANsform:HISTogram:COUNt?

Returns the number of measurements collected since the last time the histogram was cleared.

Parameter	Typical Return
(none)	+87
Return the number of measurements used to compute the current histogram: CALC:TRAN:HIST:COUN?

CALCulate:TRANsform:HISTogram:POINts {<value>|MIN|MAX|DEF}
CALCulate:TRANsform:HISTogram:POINts? [{MIN|MAX|DEF}]

Sets the number of bins between the lower and upper range values for the histogram. Two additional bins always exist: one for measurements below the lower range and one for measurements above the upper range.

Parameter	Typical Return
{10|20|40|100|200|400|MIN|MAX|DEF}. Default: 100.	+100
See Example.

• You can specify the lower and upper range values using CALCulate:TRANsform:HISTogram:RANGe:{LOWer|UPPer}. Lower and upper range values are computed automatically if CALCulate:TRANsform:HISTogram:RANGe:AUTO is ON.
• This parameter is set to its default value after a Factory Reset (*RST) or Instrument Preset (SYSTem:PRESet).

CALCulate:TRANsform:HISTogram:RANGe:AUTO {ON|1|OFF|0}
CALCulate:TRANsform:HISTogram:RANGe:AUTO?

Enables or disables automatic selection of the histogram's lower and upper range values.

Parameter	Typical Return
{ON|1|OFF|0}. Default: ON.	0 (OFF) or 1 (ON)
See Example.

• ON: the instrument uses the first 1,000 measurements to set the lower and upper range values.
• OFF: the lower and upper range values are specified by CALCulate:TRANsform:HISTogram:RANGe:{LOWer|UPPer}.

• Setting the lower or upper range value (CALCulate:TRANsform:HISTogram:RANGe:{LOWer|UPPer) disables automatic selection of the lower and upper range values (CALCulate:TRANsform:HISTogram:RANGe:AUTO OFF).
• The instrument restarts automatic range value selection (if enabled) when INITiate, MEASure? or READ? is executed.
• This parameter is set to its default value after a Factory Reset (*RST) or Instrument Preset (SYSTem:PRESet).

CALCulate:TRANsform:HISTogram:RANGe:{LOWer|UPPer} {<value>|MIN|MAX|DEF}
CALCulate:TRANsform:HISTogram:RANGe:{LOWer|UPPer}? [{MIN|MAX|DEF}]

Sets the histogram's lower and upper range values. Setting the lower or upper range value (CALCulate:TRANsform:HISTogram:RANGe:{LOWer|UPPer) disables automatic selection of the lower and upper range values (CALCulate:TRANsform:HISTogram:RANGe:AUTO OFF).

Parameter	Typical Return
-1.0E+15 to -1.0E-15, or 0.0 (default) or +1.0E-15 to 1.0E+15	+1.00000000E+06
See Example.

• If automatic range value selection is enabled (CALCulate:TRANsform:HISTogram:RANGe:AUTO ON), the query returns the computed range value. If no histogram data exists, 9.91E37 (Not a Number) is returned.
• Lower and upper range values are computed automatically if CALCulate:TRANsform:HISTogram:RANGe:AUTO is ON.
• This parameter is set to its default value after a Factory Reset (*RST) or Instrument Preset (SYSTem:PRESet).

CALCulate:TRANsform:HISTogram[:STATe] {ON|1|OFF|0}
CALCulate:TRANsform:HISTogram[:STATe]?

Enables or disables histogram computation.

Parameter	Typical Return
{ON|1|OFF|0}. Default: OFF.	0 (OFF) or 1 (ON)
See Example.

• The instrument turns this setting OFF when the measurement function is changed or after *RST or SYSTem:PRESet.