get_histogram_result
Retrieve histogram statistics from a RIGOL oscilloscope with parsed values for sum, max, min, mean, and sigma. Enable histogram first and stop acquisition for a stable snapshot.
Instructions
Read the histogram statistics.
raw is always present: the response line exactly as the instrument sent it, e.g. "[Sum:30.37khits, Max:1.562V, Min:-999.9mV, ...]". stats holds the same values parsed, keyed by the instrument's own labels in snake_case: sum, peaks, max, min, pk_pk, mean, median, mode, bin_width, sigma, mean_plus_sigma, mean_plus2_sigma, mean_plus3_sigma. Every value is a number in base units - SI prefixes are already applied, so "30.37khits" comes back as 30370.0 - and the unit of a value that has one is in the matching _unit key ("hits", "V"); the sigma-multiple values are unitless and have no _unit key. warnings says so when part of the response could not be interpreted, and when the histogram is disabled: nothing is read in that case and raw comes back empty.
Enable the histogram with configure_histogram first, and stop the acquisition (stop) before reading if you need a stable snapshot.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_histogram_result"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||