(7) CURSor command (Cursor setting and reading)

 

(1) Sets and queries the A and B cursor type.

Common

 

Syntax

 

 

command

query

 

:CURSor:MODE A$

:CURSor:MODE?

response

 

A$

A$ = OFF, TIME, VOLT, TRACe

         OFF, TRACe (FFT)

         OFF, Xcur, Ycur, TRACe (in X-Y format)

 

         TIME, Xcur: vertical cursor

         VOLT, Ycur: horizontal cursor

         TRACe: trace cursor

 

 

Explanation

 

 

Sets the A and B cursor type (vertical cursor, horizontal cursor, trace cursor).

Returns the current A and B cursor type as character data.

 

 

Example

 

 

:CURSor:MODE TIME

Sets vertical cursors.

 

 

When allowed

 

 

In all functions.

 

 

(2) Selects among, and queries, A, B and A & B cursors.

Common

 

Syntax

 

 

command

query

 

:CURSor:ABCUrsor A$

:CURSor:ABCUrsor?

response

 

A$

A$ = A, ORA, ORB, A_B

 

 

Explanation

 

 

Selects among A, B and A & B cursors.

Returns whether currently the A cursor, B cursor or both A & B cursors are in use, as character data.

 

 

Example

 

 

:CURSor:ABCUrsor A

Sets A cursor.

 

 

When allowed

 

 

In all functions.

 

 

(3) Sets and queries the channel for the A cursor.

Common

 

Syntax

 

 

command

query

 

:CURSor:ACHAnnel ch$

:CURSor:ACHAnnel?

response

 

ch$

ch$ = CH1 to CH4 (8835),

          CH1 to CH8, ALL(MEM, REC, R&M, RMS) (8835-01)

          CH1 to CH32, ALLH(REC,RMS), ALLL(REC,RMS), ALL(MEM) (8826)

          CH1 to CH16, ALL(MEM, REC, R&M, RMS) (8841, 8842)

          CH1 to CH16 (8720)

          X1 to X4 (in X-Y format: 8826, 8841, 8842, 8720)

 

 

Explanation

 

 

Sets the channel for the A cursor.

ALL, ALLL (only 8826) and ALLH (only 8826) can be set during use of the trace cursor and A cursor.

Returns the current A cursor channel as character data.

 

 

Example

 

 

:CURSor:ACHAnnel CH1

Sets the channel for the A cursor to channel 1.

 

 

When allowed

 

 

During use of the trace cursor or the horizontal cursor (except in FFT).

(On the 8826 in X-Y format, the vertical cursor as well)

 

 

(4) Sets and queries the channel for the B cursor.

Common

 

Syntax

 

 

command

query

 

:CURSor:BCHAnnel ch$

:CURSor:BCHAnnel?

response

 

ch$

ch$ = CH1 to CH4 (8835)

          CH1 to CH8 (8835-01)

          CH1 to CH32 (8826)

          CH1 to CH16 (8841, 8842, 8720)

          X1 to X4 (in X-Y format: 8826, 8841, 8842, 8720)

 

 

Explanation

 

 

Sets the channel for the B cursor.

Returns the current B cursor channel as character data.

 

 

Example

 

 

:CURSor:BCHAnnel CH1

Sets the channel for the B cursor to channel 1.

 

 

When allowed

 

 

During use of the trace cursor or the horizontal cursor (except in FFT).

(On the 8826 in X-Y format, the vertical cursor as well)

 

 

(5) Sets and queries the position of the A cursor.

Common

 

Syntax

 

 

command

query

 

:CURSor:APOSition A

:CURSor:APOSition?

response

 

A<NR1>

(line cursor (vertical), trace cursor)

A = 0 to (number of stored data values) (100 × recording length)

       0 to 400 (X-Y format)

       0 to 480 (X-Y format wide screen: 8826)

       0 to 320 (X-Y format wide screen: 8720)

       0 to 9999 : FFT (STR, ACR, CCR, IMP)

       0 to 400 : FFT (HIS, OCT)

       0 to 4000 : FFT (others)

 

(linecursor (horizontal))

A = 0 to 400

       0 to 480 (wide screen: 8826)

       0 to 639 (8841, 8842, 8720)

       0 to 320 (X-Y format wide screen: 8720)

 

 

Explanation

 

 

Sets the A cursor position.

Returns the current A cursor position as a numerical value in NR1 format.

 

 

Example

 

 

:CURSor:APOSition 1000

Move the A cursor position to 1000 points (10 DIV).

 

 

When allowed

 

 

In all functions.

 

 

(6) Sets and queries the position of the B cursor.

Common

 

Syntax

 

 

command

query

 

:CURSor:BPOSition A

:CURSor:BPOSition?

response

 

A<NR1>

Same as in APOSition.

 

 

Explanation

 

 

Sets the B cursor position.

Returns the current B cursor position as character data.

 

Example

 

 

:CURSor:BPOSition 1000

Move the B cursor position to 1000 points (10 DIV).

 

 

When allowed

 

 

In all functions.

 

 

(7) Queries the cursor readout value (t).

Common

 

Syntax

 

 

query

 

:CURSor:DTREad? A$

response

 

B$

A$ = A, B, B_A

B$ = the readout value (t)

 

 

Explanation

 

 

Returns the cursor readout value (t) as character data.

 

 

Example

 

 

query         :CURSor:DTREad? A

response  :CURSor:DTREad 5ms

Queries the A cursor readout value.

 

 

When allowed

 

 

During use of the trace cursor or the vertical cursor (except in FFT).

 

 

(8) Queries the cursor readout value (V).

Common

 

Syntax

 

 

query

 

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

response

 

B$ (,C$)

A$ = A, B, B_A

ch$ (only A$ = A)

ch$ = CH1 to CH4 (8835)

        CH1 to CH8 (8835-01)

        CH1 to CH32 (8826)

        CH1 to CH16 (8841, 8842, 8720)

B$ = the readout value (V, °C, με)

       (In the recorder and RMS recorder functions)

B$: maximum value

C$: minimum value

        (when the time axis is 5 s/DIV in the RMS recorder function, B$ only)

Trace in X-Y format

B$: voltage on the X-axis

C$: voltage on the Y-axis

 

 

Explanation

 

 

Returns the cursor readout value (V, °C, με) as character data.

 

 

Example

 

 

query         :CURSor:DVREad? A

response  :CURSor:DVREad 385

Queries the A cursor readout value.

 

 

When allowed

 

 

During use of the trace cursor or the horizontal cursor (except in FFT).

 

 

(9) Sets and queries the graph for the A and B cursors.

8835(A), 8835-01(A), 8826, 8841, 8842

 

Syntax

 

 

command

query

 

:CURSor:ABCHAnnel A$

:CURSor:ABCHAnnel?

response

 

A$

A$ = G1,G2

 

 

Explanation

 

 

Sets the graph for the A and B cursors when the display format is DUAL.

If the display format is SINGle or NYQuist, the cursor is displayed on graph 1, whatever setting is made with this command.

Returns the current graph setting for the A and B cursors as character data.

 

 

Example

 

 

:CONFigure:FORMat DUAL

:CURSor:ABCHAnnel G1

:CURSor:MODE TRACe

The A and B cursors are displayed on graph 1.

 

 

When allowed

 

 

In FFT.

 

 

(10) Queries the cursor readout position for FFT data.

8835(A), 8835-01(A), 8826, 8841, 8842

 

Syntax

 

 

query

 

:CURSor:DFREad? A$

response

 

B$,C$

A$ = A, B, B_A

B$ = readout position for x-axis data

C$ = readout position for y-axis data

 

 

Explanation

 

 

Returns the current cursor readout position for FFT data as character data.

 

 

Example

 

 

:CURSor:DFREad? A

The A cursor readout position is returned as character data.

 

 

When allowed

 

 

In FFT.