Instrument memory (MEMory)


Read binary data in memory

Syntax

(Query)


:MEMory:BDATa? A

(Response)

#0<binary data>

A = 1 to 8000 (Output number)

Details

Returns in binary format the specified number of data stored beginning at the location returned by the :MEMory:POINt command.
The data format is big-endian.
The read pointer is incremented by the specified number of data double words/bytes.
Refer to the :MEMory:RATIo? command description regarding conversion of waveform data to physical values.
Data of computation channels such as DSP and waveform computation returns integral representation of floating point number (IEEE 754 format).
Logic channel returns integral representation of all channels (16 bits).

The read data is structured as follows:
  (1) Initially: "#0" (Indicates binary format)
  (2) After "#0", the number of data double words specified by A is returned.

Example

:MEMory:POINt CH1_1,0
(Selects channel CH1-1 and sets the pointer offset to 0 for storing data in memory.)

:MEMory:BDATa? 10

(Response)  :MEMORY:BDATA #0...(Binary data)  (when headers are enabled)

Note

Binary data may include delimiter codes such as 0Ah or 0Dh.
If the PC software misinterprets such codes as data terminators, the PC will not handle the data correctly, so the PC software should always read the number of words specified by A.
A line feed code (LF or CR + LF) is not added at the end of the data.

When recording 1,000,000 points of 4 Vpp, 1kHz sine wave data using the 4V range, the time required to send the command ":MEMory:BDATa? 5000" 200 times is about 0.4 seconds.
(Running Microsoft Windows 10 (Ver 1511) on a 3.6 GHz i7 CPU and 16 GB RAM). Please note that these values are for reference only, and depend on the actual data transfer speed of the LAN connection.

Usage
Conditions

Providing that;
measurement is not taking place,
the memory read pointer is below the address of the stored data,
the channel is that specified by :MEMory:POINt.




Query FFT data

Syntax

(Query)


:MEMory:FFTData?

(Response)

A,B

A = x-axis data
B = y-axis data

Details

Returns FFT calculation results (x- and y-axis values) from the output point specified by :MEMory:FFTPOint.
The output point is automatically incremented every time this command is executed.
Continuous data is available by executing this command repeatedly.

Example

:MEMory:FFTPOint 1,100,1
:MEMory:FFTData?
(Response)  :MEMORY:FFTDATA +5.000000E-04,-8.130000E-05  (when headers are enabled)

Note

-

Usage
Conditions

-




Query FFT data quantity

Syntax

(Query)


:MEMory:FFTMaxpoint? A

(Response)

A<NR1>,B<NR1>

A = 1 to 8 (Calculation No.)
B = data points

Details

Returns the quantity of calculated data for the calculation number specified.

Example

:MEMory:FFTMaxpoint? 1
(Response)  :MEMORY:FFTMAXPOINT 1,4001  (when headers are enabled)

Note

The value of B depends on the selected FFT Analysis Mode and the FFT Calculation Points.

Usage
Conditions

-




Query overall FFT value

Syntax

(Query)


:MEMory:FFTOver? A

(Response)

A<NR1>,B

A = 1 to 8 (Calculation No.)
B = Overall value

Details

Returns the overall FFT value of the calculation.

Example

:MEMory:FFTOver? 1
(Response)  :MEMORY:FFTOVER 1,+6.120000E-05  (when headers are enabled)

Note

NONE is returned if there is no overall value.

Usage
Conditions

-




Query FFT peak value data

Syntax

(Query)


:MEMory:FFTPEak? A,B,C

(Response)

A<NR1>,B<NR1>,C<NR1>,D,E

A = 1 to 8 (Calculation No.)
B = 1 to 10 (Peak value No.)
C = 1 (Frame value No.)
D = x-axis data
E = y-axis data

Details

Returns the peak value for the calculation.

Example

:MEMory:FFTPEak? 1,1,1
(Response)  :MEMORY:FFTPEAK 1,1,1,+5.760000E+04,-1.076000E+02  (when headers are enabled)

Note

-

Usage
Conditions

-




Set or query FFT data output points

Syntax

(Command)

(Query)


:MEMory:FFTPOint A,B(,C)

:MEMory:FFTPOint?

(Response)

A<NR1>,B<NR1>,C<NR1>

A = 1 to 8 (Calculation No.)
B = 0 to (FFT Calculation Points - 1)
C = 1 (Frame value No.)

Details

Sets the FFT data output point to the calculation.
Returns the numerical value of the current FFT data output point.

Example

:MEMory:FFTPOint 1,100,1
:MEMory:FFTPOint?
(Response)  :MEMORY:FFTPOINT 1,100,1  (when headers are enabled)

Note

The value of B depends on the selected FFT Analysis Mode and the FFT Calculation Points.

Usage
Conditions

-




Capture real-time data

Syntax

(Command)


:MEMory:GETReal

Details

Causes the instrument to acquire real-time measurement values on all channels.

Example

:MEMory:GETReal

Note

-

Usage
Conditions

-




Query the amount of data stored

Syntax

(Query)


:MEMory:MAXPoint?

(Response)

A<NR1>

A = Number of stored data

Details

Returns the number of data stored in memory.

Example

:MEMory:MAXPoint?
(Response)  :MEMORY:MAXPOINT 2500  (when headers are enabled)

Note

-

Usage
Conditions

-




Set or query the memory read pointer

Syntax

(Command)

(Query)


:MEMory:POINt A$,B

:MEMory:POINt?

(Response)

A$,B<NR1>

A$ = CH1_1 to CH8_4, L1 to L8, W1 to W16, Z1 to Z16
B = 0 to (Number of stored data - 1)

Details

Sets the read pointer in instrument memory.
Returns the current memory read pointer location as a channel and pointer offset.

Example

:MEMory:POINt CH1_1,100
:MEMory:POINt?
(Response)  :MEMORY:POINT CH1_1,100  (when headers are enabled)

Note

If there is no stored data, the read pointer cannot be set.
Argument B can be set only to a value less than that returned by the :MEMory:MAXPoint? command.

When measuring with the real-time, valid values for "B" depend on the current waveform display.
"B" shows always the point from the head of stored data.

Usage
Conditions

-




Query the ratio and offset coefficients for converting stored data into physical values

Syntax

(Query)


:MEMory:RATIo? A$

(Response)

A$,B,C

A$ = CH1_1 to CH8_4
B = Ratio
C = Offset

Details

Returns coefficients for converting data read command into physical values.
The equation used to convert the data into physical values is:
(Physical value) = B * (Data) + C

Example

:MEMory:RATIo? CH1_1
(Response)  :MEMORY:RATIO CH1_1,+5.000000E-05,-1.024000E-01  (when headers are enabled)

Note

-

Usage
Conditions

Providing that;
Analog channel.
The stored data is present.
After measurement.




Read real-time data (measured values)

Syntax

(Query)


:MEMory:REAL? A$

(Response)

A$,B

A$ = CH1_1 to CH8_4, L1 to L8
B = Physical values

Details

Returns the physical value measured on channel A$ after acquiring data with the :MEMory:GETReal command.

Example

:MEMory:GETReal
(Fetch currently input data for all channels.)

:MEMory:REAL? CH1_1
(Response)  :MEMORY:REAL CH1_1,-3.000000E-04  (when headers are enabled)

Note

If the :MEMory:GETReal command is not executed before this command, returned values are undetermined.

Usage
Conditions

-




Read binary data in memory

Syntax

(Query)


:MEMory:RECBData? A

(Response)

#0<binary data>

A = 1 to 4000 (Output number)

Details

Returns in binary format the specified number of data stored beginning at the location returned by the :MEMory:RECPoint command.
The data format is big-endian.
The read pointer is incremented by the specified number of data double words/bytes.
Refer to the :MEMory:RATIo? command description regarding conversion of waveform data to physical values.
Data of computation channels such as DSP and waveform computation returns integral representation of floating point number (IEEE 754 format).
Logic channel returns integral representation of all channels (16 bits).

The read data is structured as follows:
  (1) Initially: "#0" (Indicates binary format)
  (2) After "#0", the number of data double words specified by A is returned.

Each data object consists of two words: the maximum and the minimum measurements during the sampling interval.
Maximum and minimum values during the first sampling interval, followed by maximum and minimum values during the second sampling interval, and so on.

Example

:MEMory:RECPoint CH1_1,0
(Selects channel CH1-1 and sets the pointer offset to 0 for the stored data.)

:MEMory:RECBData? 10
(Reads 10 samples (20 data words) of storage data.)

(Response)  :MEMORY:RECBDATA #0...(Binary data)  (when headers are enabled)

Note

Binary data may include delimiter codes such as 0Ah or 0Dh.
If the PC software misinterprets such codes as data terminators, the PC will not handle the data correctly, so the PC software should always read the number of words specified by A.
A line feed code (LF or CR + LF) is not added at the end of the data.

When recording 1,000,000 points of 4 Vpp, 1kHz sine wave data using the 4V range, the time required to send the command ":MEMory:RECBDATa? 4000" 250 times is about 0.6 seconds.
(Running Microsoft Windows 10 (Ver 1511) on a 3.6 GHz i7 CPU and 16 GB RAM). Please note that these values are for reference only, and depend on the actual data transfer speed of the LAN connection.

Usage
Conditions

Providing that;
measurement is not taking place,
the memory read pointer is below the address of the stored data,
the channel is that specified by :MEMory:POINt.
the envelope waveform is present.




Set or query the memory read pointer

Syntax

(Command)

(Query)


:MEMory:RECPoint A$,B

:MEMory:RECPoint?

(Response)

A$,B<NR1>

A$ = CH1_1 to CH8_4, L1 to L8, W1 to W16
B = 0 to (Number of stored data - 1)

Details

Sets the read pointer in instrument memory.
Returns the current memory read pointer location as a channel and pointer offset.

Example

:MEMory:RECPoint CH1_1,100
:MEMory:RECPoint?
(Response)  :MEMORY:RECPOINT CH1_1,100  (when headers are enabled)

Note

If there is no stored data, the read pointer cannot be set.
Argument B can be set only to a value less than that returned by the :MEMory:MAXPoint? command.

Usage
Conditions

Envelope waveform




Read stored data (measured values)

Syntax

(Query)


:MEMory:RECVData? A

(Response)

X1,Y1,X2,Y2,...

A = 1 to 1000
Xi, Yi = Physical values

Details

Reads the number of data objects specified from the memory pointer (channel and pointer offset) specified and returned by the :MEMory:RECPoint command.
The read pointer is incremented by the number of data words read.
Scaled values are written and read when scaling is enabled.

Each data object consist of two words: the maximum and the minimum measurements during the sampling interval.
For example, in the response X1, Y1, X2, Y2: the X1 and Y1 values comprise the first data object, in which X1 is the maximum value and Y1 is the minimum value measured during the first sampling interval.
Similarly, X2 and Y2 comprise the maximum and minimum values, respectively, measured during the second sampling interval. This command cannot be executed during startup.
* Scaled values are returned when scaling is enabled.

Example

:MEMory:RECPoint CH1_1,0
(Selects channel CH1-1 and sets the pointer offset to 0 for the stored data.)

:MEMory:RECVData? 2
(Reads two samples (four data words) of storage data.)

(Response)  :MEMORY:RECVDATA +4.355000E-02,+4.310000E-02,+4.405000E-02,+4.355000E-02  (when headers are enabled)

Note

When recording 1,000,000 points of 4 Vpp, 1kHz sine wave data using the 4V range, the time required to send the command ":MEMory:RECVDATa? 1000" 1000 times is about 16 seconds.
(Running Microsoft Windows 10 (Ver 1511) on a 3.6 GHz i7 CPU and 16 GB RAM). Please note that these values are for reference only, and depend on the actual data transfer speed of the LAN connection.

Usage
Conditions

Providing that;
measurement is not taking place,
the memory read pointer is below the address of the stored data,
the channel is that specified by :MEMory:RECPoint.
the envelope waveform is present.




Read stored data (measured values)

Syntax

(Query)


:MEMory:VDATa? A

(Response)

X1,X2,X3,...

A = 1 to 2000
Xi = Physical values

Details

Reads the number of data objects specified from the memory pointer (channel and pointer offset) specified and returned by the :MEMory:POINt command.
The read pointer is incremented by the number of data words read.
Scaled values are written and read when scaling is enabled.

Example

:MEMory:POINt CH1_1,0
(Selects channel CH1-1 and sets the pointer offset to 0 for the stored data.)

:MEMory:VDATa? 2
(Reads two data words from memory.)

(Response)  :MEMORY:VDATA +5.000000E-05,+4.000000E-05  (when headers are enabled)

Note

When recording 1,000,000 points of 4 Vpp, 1kHz sine wave data using the 4V range, the time required to send the command ":MEMory:VDATa? 2000" 500 times is about 9 seconds.
(Running Microsoft Windows 10 (Ver 1511) on a 3.6 GHz i7 CPU and 16 GB RAM). Please note that these values are for reference only, and depend on the actual data transfer speed of the LAN connection.

Usage
Conditions

Providing that;
measurement is not taking place,
the memory read pointer is below the address of the stored data,
the channel is that specified by :MEMory:POINt.