CURSor Commands (Cursor setting and reading)


Configure the number of and ability to move the A and B cursors


Syntax


(Command)
(Query)


:CURSor:ABCUrsor A$
:CURSor:ABCUrsor?

(response)

A$
A$ = A, ORA, ORB, A_B


Details


Select A, B or A&B cursors.
The current settings for the A, B, and A&B cursors are returned in the form of text data.

A    A cursor only
ORA   2 cursors AB and move A cursor
ORB   2 cursors AB and move B cursor
A_B   2 cursors and move both A and B cursors simultaneously


Example


:CURSor:ABCUrsor A
:CURSor:ABCUrsor?
(response)  :CURSOR:ABCURSOR A  (when headers are enabled)


Note


-


Usage
Conditions


ALL functions




Assign or query the Cursor A channel


Syntax


(Command)
(Query)


:CURSor:ACHAnnel CH$
:CURSor:ACHAnnel?

(response)

CH$
A$ = ALL, CH1 to , GR1 to GR8, Z1 to Z16, NO1(FFT),NO2(FFT)


Details


Specifies a channel or graph (GR in X-Y, NO in FFT) for Cursor A.
Returns the current Cursor A channel as a text string.
When CH$ = ALL, Cursor A applies to all channels.


Example


:CURSor:ACHAnnel CH1
:CURSor:ACHAnnel?
(response)  :CURSOR:ACHANNEL CH1  (when headers are enabled)


Note


-


Usage
Conditions


ALL functions




Set or query the position of Cursor A


Syntax


(Command)
(Query)


:CURSor:APOSition A
:CURSor:APOSition?

(response)

A<NR1>
A = Cursor position


Details


Specifies the position of Cursor A.
Returns the current position of Cursor A


Line cursor (vertical)


Trace cursor


Line cursor (horizontal)

Normal waveform

0 to the number of stored data points

0 to the number of stored data points

0 to 500

XY waveform

0 to 500

0 to the number of stored data points

0 to 500

FFT

-

0 to the number of data points - 1

-



FFT Analyze


data points

Storage Waveform, Impulse Response
Auto-Correlation, Cross Cor.

Sampling Points

Linear Spectrum, RMS Spectrum, Power Spectrum
Pow.Density, LPC(density), Transfer Func
Cross Power, Coherence Func, Phase Spectrum


2/5 number of Sampling Points

Histogram

400

1/1 Octave

6

1/3 Octave

16


Example


:CURSor:APOSition 1000
:CURSor:APOSition?
(response)  :CURSOR:APOSITION 1000  (when headers are enabled)


Note


-


Usage
Conditions


When the cursor is used.
ALL functions




Assign or query the Cursor B channel


Syntax


(Command)
(Query)


:CURSor:BCHAnnel CH$
:CURSor:BCHAnnel?

(response)

CH$
A$ = ALL, CH1 to , GR1 to GR8, Z1 to Z16, NO1(FFT),NO2(FFT)


Details


Specifies a channel or graph (GR in X-Y, NO in FFT) for Cursor B.
Returns the current Cursor B channel as a text string.
When CH$ = ALL, Cursor B applies to all channels.


Example


:CURSor:BCHAnnel CH1
:CURSor:BCHAnnel?
(response)  :CURSOR:BCHANNEL CH1  (when headers are enabled)


Note


-


Usage
Conditions


ALL functions




Set or query the position of Cursor B


Syntax


(Command)
(Query)


:CURSor:BPOSition A
:CURSor:BPOSition?

(response)

A<NR1>
A = Cursor position


Details


Specifies the position of Cursor B.
Returns the current position of Cursor B.


Line cursor (vertical)


Trace cursor


Line cursor (horizontal)

Normal waveform

0 to the number of stored data points

0 to the number of stored data points

0 to 500

XY waveform

0 to 500

0 to the number of stored data points

0 to 500

FFT

-

0 to the number of calculated data points - 1

-


Example


:CURSor:BPOSition 1000
:CURSor:BPOSition?
(response)  :CURSOR:BPOSITION 1000  (when headers are enabled)


Note


-


Usage
Conditions


When the cursor is used.
ALL functions




Query the cursor readout values of FFT data


Syntax


(Query)


:CURSor:DFREad? A,B$

(Response)

C$,D$
A = 1, 2
B$ = A, B, B_A
C$ = Readout value on x axis
D$ = Readout value on y axis


Details


Returns the cursor readout values of FFT data, as text strings:

C$ = Readout value on x axis
D$ = Readout value on y axis


Example


:CURSor:DFREad? 1,A
(Response)  :CURSOR:DFREAD 48.0kHz,-116.13dB   (when headers are enabled)


Note


-


Usage
Conditions


FFT




Query a cursor readout value (time)


Syntax


(Query)


:CURSor:DTREad? A$

(response)

B$
A$ = A, B, B_A
B$ = the readout value (time)


Details


Returns a cursor readout (time) value as a text string.

A  Cursor A
B  Cursor B
B_A  The value at Cursor B minus the value at Cursor A


Example


:CURSor:DTREad? A
(response)  :CURSOR:DTREAD 5ms  (when headers are enabled)


Note


Only trace cursor mode is available when the XY display format is selected.


Usage
Conditions


MEM, REC, XY
When the vertical or trace cursor mode is enabled




Query a cursor readout value (measured value)


Syntax


(Query)


:CURSor:DVREad? A$(,CH$)

(response)

B$(,C$)
A$ = A, B, B_A
CH$ = CH1 to , Z1 to Z16  (Time axis waveform)
B$, C$ = readout value
(Argument C$ is available with the Recorder function or for XY waveforms.)


Details


Returns a cursor readout (measured amplitude) value as a text string.

A  Cursor A
B  Cursor B
B_A  (The value at Cursor B minus the value at Cursor A)

B$

C$

REC waveform
(Trace cursor)

Maximum value

Minimum value

XY waveform
(Trace cursor)

X-axis data

Y-axis data

Other case

Measured value

-



Example


:CURSor:DVREad? A,CH1
(response)  :CURSOR:DVREAD 500.0mV  (when headers are enabled)


Note


-


Usage
Conditions


MEM, REC, XY
Normal waveform:  Vertical or trace cursor.
XY waveform:  Vertical, horizontal or trace cursor.




Set or query the position of Cursor A (time)


Syntax


(Command)
(Query)


:CURSor:TAPOSition A, (NO$)
:CURSor:TAPOSition?

(Response)

A<NR3>
NO$ : NO1 to NO16, MNO1 to MNO16 (number of numerical calculation)
A : (time [sec])


Details


Sets the position of A cursor. When NO$ is specified, assigns the position of A cursor to the value obtained by the addition of A (time) and the calculation result of NO$.
Returns the position of A cursor as NR3 value(time).


Example


:CURSor:TAPOSition 25E-6
:CURSor:TAPOSition?
(Response)  :CURSOR:TAPOSITION 2.5000E-05  (when headers are enabled)


Note


Results are stored as MNO1 to MNO16, When calculation is executed by ":CALCulate:MEASure MEMEXEC".


Usage
Conditions


MEM, REC




Set or query the position of Cursor B (time)


Syntax


(Command)
(Query)


:CURSor:TBPOSition B, (NO$)
:CURSor:TBPOSition?

(Response)

B<NR3>
NO$ : NO1 to NO16, MNO1 to MNO16 (number of numerical calculation)
B : (time[sec])


Details


Sets the position of B cursor. When NO$ is specified, assigns the position of B cursor to the value obtained by the addition of B (time) and the calculation result of NO$.
Returns the position of B cursor as NR3 value(time).


Example


:CURSor:TBPOSition 25E-6
:CURSor:TBPOSition?
(Response)  :CURSOR:TBPOSITION 2.5000E-05  (when headers are enabled)


Note


Results are stored as MNO1 to MNO16, When calculation is executed by ":CALCulate:MEASure MEMEXEC".


Usage
Conditions


MEM, REC




Select or query the cursor mode


Syntax


(Command)
(Query)


:CURSor:MODE A$
:CURSor:MODE?

(response)

A$
A$ = OFF, TIME, VOLT, TRACe, Xcur, Ycur


Details


Selects the cursor mode.
Returns the current cursor mode as a text string.

XY display format

Function: FFT

Other
display
format

Cursor: OFF

OFF

OFF

OFF

Vertical cursor

Xcur

-

TIME

Horizontal
cursor

Ycur

-

VOLT

Trace cursor

TRACe

TRACe

TRACe


Example


:CURSor:MODE TRACe
:CURSor:MODE?
(response)  :CURSOR:MODE TRACE  (when headers are enabled)


Note


-


Usage
Conditions


ALL functions