CURSor Commands (Cursor setting and reading)


Assign or query the Cursor A channel

8860, 8861


Syntax


(Command)
(Query)


:CURSor:ACHAnnel A$
:CURSor:ACHAnnel?

(Response)

A$
A$ = ALL, CHm_n, Z1 to Z16


Details


Specifies a channel for Cursor A.
Returns the current Cursor A channel as a text string.
When A$ = ALL, Cursor A applies to all channels.


Example


:CURSor:ACHAnnel CH1_1
:CURSor:ACHAnnel?
(Response)  :CURSOR:ACHANNEL CH1_1  (when headers are enabled)


Note


-


Usage
Conditions


MEM, REC, REAL, REC&MEM




Set or query the position of Cursor A

8860, 8861


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



Example


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


Note


When using Timebase 2 sampling data, argument A cannot always be set to 0 by sending the command ":CURSor:APOSition 0" because of the sampling time lag between Timebase 1 and 2.
If the specified value is outside of the displayable range, the position is corrected automatically.

Although there are always 100 samples per division (MEM, REC) for vertical line and trace cursors, this relationship does not apply to Timebase 2 sampling data, which depends on an independently specified sampling rate.


Usage
Conditions


When the cursor is used.
MEM, REC, REAL, REC&MEM




Assign or query the Cursor B channel

8860, 8861


Syntax


(Command)
(Query)


:CURSor:BCHAnnel A$
:CURSor:BCHAnnel?

(Response)

A$
A$ = ALL, CHm_n, Z1 to Z16


Details


Specifies a channel for Cursor B.
Returns the current Cursor B channel as a text string.
When A$ = ALL, Cursor B applies to all channels.


Example


:CURSor:BCHAnnel CH1_1
:CURSor:BCHAnnel?
(Response)  :CURSOR:BCHANNEL CH1_1  (when headers are enabled)


Note


-


Usage
Conditions


MEM, REC, REAL, REC&MEM




Set or query the position of Cursor B

8860, 8861


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



Example


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


Note


When using Timebase 2 sampling data, argument A cannot always be set to 0 by sending the command ":CURSor:BPOSition 0" because of the sampling time lag between Timebase 1 and 2.
If the specified value is outside of the displayable range, the position is corrected automatically.

Although there are always 100 samples per division (MEM, REC) for vertical line and trace cursors, this relationship does not apply to Timebase 2 sampling data, which depends on an independently specified sampling rate.


Usage
Conditions


When the cursor is used.
MEM, REC, REAL, REC&MEM




Query the cursor readout values of FFT data

8860, 8861


Syntax


(Query)


:CURSor:DFREad? A$,B

(Response)

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


Details


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

A$ = A  (Cursor A)
A$ = B  (Cursor B)
A$ = B_A  (The values of Cursor B minus Cursor A)


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)

8860, 8861


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$ = A  (Cursor A)
A$ = B  (Cursor B)
A$ = 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, REAL, REC&MEM
When the vertical or trace cursor mode is enabled.




Query a cursor readout value (measured value)

8860, 8861


Syntax


(Query)


:CURSor:DVREad? A$,CH$

(Response)

B$(,C$)
A$ = A, B, B_A
CH$ = CHm_n  (Normal waveform)
CH$ = NO1 to NO8  (XY waveform)
CH$ = Z1 to Z16  (Waveform calculation)
B$, C$ = the 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$ = A  (Cursor A)
A$ = B  (Cursor B)
A$ = 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_1
(Response)  :CURSOR:DVREAD 500.0mV  (when headers are enabled)


Note


-


Usage
Conditions


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




Select or query the length of the horizontal line of the trace cursor

8860, 8861


Syntax


(Command)
(Query)


:CURSor:LINE A$
:CURSor:LINE?

(Response)

A$
A$ = SHORT, LONG


Details


Selects the length of the horizontal line of the trace cursor.
Returns the current horizontal line selection for the trace cursor.

SHORT
LONG


Example


:CURSor:LINE LONG
:CURSor:LINE?
(Response)  :CURSOR:LINE LONG  (when headers are enabled)


Note


-


Usage
Conditions


All functions




Select or query the cursor mode

8860, 8861


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

Other display format

Cursor: OFF

OFF

OFF

Vertical cursor

Xcur

TIME

Horizontal cursor

Ycur

VOLT

Trace cursor

TRACe

TRACe



Example


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


Note


-


Usage
Conditions


All functions




Select or query the type of cursor movement

8860, 8861


Syntax


(Command)
(Query)


:CURSor:MOVE A$
:CURSor:MOVE?

(Response)

A$
A$ = EACH, ALL


Details


Selects the type of cursor movement.
Returns the current cursor movement setting.

EACH  (Sets the cursors (A & B) to move independently.)
ALL  (Sets the cursors (A & B) to move together.)


Example


:CURSor:MOVE ALL
:CURSor:MOVE?
(Response)  :CURSOR:MOVE ALL  (when headers are enabled)


Note


-


Usage
Conditions


All functions




Select or query the number of cursors

8860, 8861


Syntax


(Command)
(Query)


:CURSor:NUMber A
:CURSor:NUMber?

(Response)

A<NR1>
A = 1, 2


Details


Selects the number of cursors.
Returns the current number of cursors.

A = 1  (Cursor A only)
A = 2  (Cursors A and B)


Example


:CURSor:NUMber 2
:CURSor:NUMber?
(Response)  :CURSOR:NUMBER 2  (when headers are enabled)


Note


-


Usage
Conditions


All functions




Select or query the cursor sampling timebase

8860, 8861


Syntax


(Command)
(Query)


:CURSor:SAMPling A$
:CURSor:SAMPling?

(Response)

A$
A$ = S1, S2


Details


Selects the cursor sampling timebase.
Returns the current cursor sampling timebase.

S1  (Sampling Timebase 1)
S2  (Sampling Timebase 2)


Example


:CURSor:SAMPling S1
:CURSor:SAMPling?
(Response)  :CURSOR:SAMPLING S1  (when headers are enabled)


Note


-


Usage
Conditions


MEM




Select or query the cursor speed

8860, 8861


Syntax


(Command)
(Query)


:CURSor:SPEED A$
:CURSor:SPEED?

(Response)

A$
A$ = SLOW, MID, FAST


Details


Selects the cursor movement speed.
Returns the current cursor movement speed setting.

SLOW
MID
FAST


Example


:CURSor:SPEED FAST
:CURSor:SPEED?
(Response)  :CURSOR:SPEED FAST  (when headers are enabled)


Note


-


Usage
Conditions


All functions




Making settings and queries for the AB cursor operation

8860, 8861


Syntax


(Command)
(Query)


:CURSor:WAVESELect A$
:CURSor:WAVESELect?

(Response)

A$
A$ : REC, MEM


Details


Make settings to select the waveform window in the REC&MEM function for which to apply the AB cursor operation.
Query the settings that specify the waveform window in the REC&MEM function for which the AB cursor operation has been applied.

RECREC waveform
MEMMEM waveform


Example


:CURSor:WAVESELect REC
(Selects the REC waveform for which to apply the use of the AB cursor operation.)
:CURSor:WAVESELect?
(Response)  :CURSOR:WAVESELECT REC  (when headers are enabled)


Note


-


Usage
Conditions


REC&MEM




Set or query the X-Y (or FFT) waveform display format for a cursor

8860, 8861


Syntax


(Command)
(Query)


:CURSor:XYCUrsor A$,B
:CURSor:XYCUrsor? A$

(Response)

A$,B
A$ = A, B
B = 1 to 8


Details


Sets an X-Y (or FFT) waveform display format number for specified cursor A$.
Returns a character indicating cursor A$ and its X-Y (or FFT) waveform display format number as a numerical value.

A$ = A  (Cursor A)
A$ = B  (Cursor B)
B = XY or FFT format number as displayed on the "SHEET" screen


Example


:CURSor:XYCUrsor A,3
:CURSor:XYCUrsor? A
(Response)  :CURSOR:XYCURSOR A,3  (when headers are enabled)


Note


-


Usage
Conditions


MEM, FFT