CALCulate Commands (Set and Query Calculations)


Query a calculation result.


Syntax


(Query)


:CALCulate:ANSWer? NO$,CH$

(Response)

A$,B<NR3>
NO$:NO1 to NO4
CH$:CH1 to CH4
A$:OFF, AVE, RMS, PP, MAX, MIN, MAXT, MINT, AREA, PERI, FREQ, XYAREA
B:calculation result, (NONE: no calculation result)


Details


Returns the calculation operator and result of specified numerical calculation NO$.

OFF  No calculation performed
AVE  Average value
RMS  RMS value
PP  Peak value
MAX  Maximum value
MIN  Minimum value
MAXT  Time to maximum value
MINT  Time to minimum value
AREA  Area value
PERI  Period
FREQ  Frequency
XYAREA  X-Y area value


Example


:CALCulate:ANSWer? NO1
(Response)  :CALCULATE:ANSWER NO1,-1.2345E-03  (when headers are enabled)


Note


-


Usage
Conditions


All functions




Select or query area setting for waveform calculations.


Syntax


(Command)
(Query)


:CALCulate:MEASArea A$
:CALCulate:MEASArea?

(Response)

A$
A$:ALL, A_B


Details


Selects whether numerical calculations apply to the whole waveform, or just to a specified portion (area).
Returns a text string indicating whether numerical calculations apply to the whole waveform or a specified portion (area).

ALL  Whole waveform
A_B  Waveform between A/B cursors


Example


:CALCulate:MEASArea ALL
:CALCulate:MEASArea?
(Response)  :CALCULATE:MEASAREA ALL  (when headers are enabled)


Note


Calculates all measured data in real time when Real-time Function is selected.


Usage
Conditions


All functions




Select or query whether to display normal, or split value.


Syntax


(Command)
(Query)


:CALCulate:MEASDisp A$
:CALCulate:MEASDisp?

(Response)

A$
A$:USUAL, SPLIT


Details


Sets display type of numerical calculation results.
The currently specified display type for numerical calculation results is returned as a character string.

USUAL  Normal value
SPLIT  Split value


Example


:CALCulate:MEASDisp USUAL
:CALCulate:MEASDisp?
(Response)  :CALCULATE:MEASDISP USUAL  (when headers are enabled)


Note


-


Usage
Conditions


REALTIME




Select or query a split-calculation method.


Syntax


(Command)
(Query)


:CALCulate:MEASKind A$
:CALCulate:MEASKind?

(Response)

A$
A$:NORMal, DIVide, REGularly


Details


Select or query a split-calculation method.
Returns the current setting of the time split calculation kind as character data.

NORMal  Save only the last calculation results.
DIVide  Calculation results for the specified time span are automatically saved.
REGularly  The calculation value for the specified split length portion is automatically saved from the specified divide time.


Example


:CALCulate:MEASKind NORMal
:CALCulate:MEASKind?
(Response)  :CALCULATE:MEASKIND NORMAL  (when headers are enabled)


Note


Auto Save function is available to be set up when [Calc(post meas.)], [Waveform + Calc] or [CSV + Calc] is selected on the HiCORDER.


Usage
Conditions


REALTIME




Set or query the calculation interval for split-calculation.


Syntax


(Command)
(Query)


:CALCulate:MEASLen day,hour,min
:CALCulate:MEASLen?

(Response)

day,hour,min<NR1>
day<NR1>:0 to 30
hour<NR1>:0 to 23
min<NR1>:0 to 59


Details


Sets the split calculation division length to a numerical value.
Returns the currently set value of the split calculation division length
as an NR1 numerical value.


Example


:CALCulate:MEASLen 0,1,0
(Sets the split calculation division length to 1hour.)

:CALCulate:MEASLen?
(Response)  :CALCULATE:MEASLEN 0,1,0  (when headers are enabled)


Note


The calculation interval is set to one minute with "CALCulate:MEASLen 0,0,0".


Usage
Conditions


REALTIME




Set or query the claculation Split time for split-calculation.


Syntax


(Command)
(Query)


:CALCulate:MEASReg hour,min
:CALCulate:MEASReg?

(Response)

hour,min<NR1>
hour<NR1>:0 to 23
min<NR1>:0 to 59


Details


Set or query the claculation Split time for split-calculation.
Returns the currently set value of the time split calculation regular time
as an NR1 numerical value.


Example


:CALCulate:MEASReg 0,0
(Sets the time split calculation regular time to 00:00.)

:CALCulate:MEASReg?
(Response)  :CALCULATE:MEASREG 0,0  (when headers are enabled)


Note


-


Usage
Conditions


REALTIME




Specify the function and channel(s) for a numerical calculation.


Syntax


(Command)

(Query)


:CALCulate:MEASSet NO$,A$,CH$ (,CH2$)(XYAREA)
:CALCulate:MEASSet? NO$

(Response)

A$,CH$
NO$:NO1 to NO4
A$:OFF, AVE, RMS, PP, MAX, MIN, MAXT, MINT,AREA, PERI, FREQ, XYARea
CH$:ALL, CH1 to CH4


Details


Defines numerical calculation NO$ by specifying a calculation function (A$) and channel.
Returns the calculation function and channel specified for NO$.

OFF  No calculation performed
AVE  Average value
RMS  RMS value
PP  Peak value
MAX  Maximum value
MIN  Minimum value
MAXT  Time to maximum value
MINT  Time to minimum value
AREA  Area value
PERI  Period
FREQ  Frequency
XYAREA  X-Y area value


Example


:CALCulate:MEASSet NO1,MAX,CH1
(Defines calculation NO1 to be the maximum value on channel 1.)

:CALCulate:MEASSet NO2,XYAREA,CH1,CH2
(Defines calculation NO2 to be the value of the area circumscribed by the X-Y waveform composed of channels 1 and 2.)

:CALCulate:MEASSet? NO1
(Response)  :CALCULATE:MEASSET NO1,MAX,CH1  (when headers are enabled)


Note


The following calculations are available when Real-time Function is selected.

AVE  Average value (Envelope mode is set to OFF)
PP  Peak value
MAX  Maximum value
MIN  Minimum value
MAXT  Time to maximum value
MINT  Time to minimum value


Usage
Conditions


All functions




Set or query the claculation Split Length for split-calculation.


Syntax


(Command)
(Query)


:CALCulate:MEASTime A
:CALCulate:MEASTime?

(Response)

A<NR3>(min)
A<NR3>:Split Length(min)


Details


Set or query the claculation Split Length for split-calculation.
Returns the currently set value of the split calculation division time
as an NR3 numerical value.


Example


:CALCulate:MEASTime 1.0
(Sets the split calculation division time to 1min.)

:CALCulate:MEASTime?
(Response)  :CALCULATE:MEASTIME +1.0000E+00  (when headers are enabled)


Note


The setting of division time might be limited by a set value of interval.

1min=1, 2min=2, 5min=5, 10min=10, 15min=15, 20min=20, 30min=30,
1hour=60, 2hour=120, 3hour=180, 4hour=240, 6hour=360, 8hour=480,
12hour=720, 1day=1440


Usage
Conditions


REALTIME




Set or query execution of numerical calculations.


Syntax


(Command)
(Query)


:CALCulate:MEASure A$
:CALCulate:MEASure?

(Response)

A$
A$:ON, OFF, EXEC


Details


Sets the numerical calculation execution state.
Returns a text indicator of the current numerical calculation execution state.
Calculation is performed when A$ = "EXEC".


Example


:CALCulate:MEASure ON
:CALCulate:MEASure EXEC
:CALCulate:MEASure?
(Response)  :CALCULATE:MEASURE ON  (when headers are enabled)


Note


The execution state is "ON" after calculation is executed by "EXEC".


Usage
Conditions


All functions