Instrument memory (MEMory)


Read ASCII data in memory

Syntax

(Query)


:MEMory:ADATa? A

(Response)

X1,X2,X3,…<NR1>

A = 1 to 2000
Xi = Stored data (Unsigned 32 bit integer value)

Details

Reads the specified number of data values 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 values read.
Refer to the :MEMory:RATIo? command description regarding conversion of waveform data to physical values.
Data of computation channels such as waveform computation returns integral representation of floating point number (IEEE 754 format).
Logic channel returns integral representation of all channels (16 bits).

Example

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

:MEMory:ADATa? 10
(Reads 10 ASCII data values from memory.)

(Response)  :MEMORY:ADATA 3176,3176,3176,3186,3186,3186,3186,3186,3198,3198  (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:ADATa? 2000" 500 times is about 4 seconds.
(Running Microsoft Windows 10 (Ver 1511) on a 3.6GHz 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.




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 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.




Read ASCII data in memory

Syntax

(Query)


:MEMory:DVAData? A

(Response)

X1,X2,X3,…<NR1>

A = 1 to 2000
Xi = <Storage data>

Details

Reads the specified number (A) of data values from the memory pointer (channel and pointer offset) specified and returned by the :MEMory:DVPOint command.
The read pointer is incremented by the number of data values (words/bytes) read. This command cannot be executed while measuring.

Refer to the :MEMory:RATIo? command description regarding conversion to physical values.

Example

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

:MEMory:DVAData? 10
(Reads 10 ASCII data values from memory.)

(Response)  :MEMORY:DVADATA 3176,3176,3176,3186,3186,3186,3186,3186,3198,3198  (when headers are enabled)

Note

-

Usage
Conditions

Measurement is not taking place,
The memory read pointer is below the address of the stored data,
The DVM unit channe is that specified by :MEMory:DVPOint,
and stored data is present.




Query the amount of data stored

Syntax

(Query)


:MEMory:DVMAxpoint?

(Response)

A<NR1>

A = stored data bytes/words

Details

Returns the number of data bytes/words stored in memory.

Example

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

:MEMory:DVMAxpoint?
(Response)  :MEMORY:DVMAXPOINT 2500  (when headers are enabled)

Note

The number of stored data bytes/words depends on the channel specified with the :MEMory:DVPOint command.
The specified channel must be for the DVM unit.

Usage
Conditions

When not measuring




Set and query the output point for the storage data of the DVM unit

Syntax

(Command)

(Query)


:MEMory:DVPOint A$,B

:MEMory:DVPOint?

(Response)

A$,B<NR1>

A$ = CH1_1 to CH27_4
B = 0 to (Storage 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:DVPOint CH1_1,100
:MEMory:DVPOint?
(Response)  :MEMORY:DVPOINT CH1_1,100  (when headers are enabled)

Note

If there is no stored data, the read pointer cannot be set.
Argument A can be set only to a value less than that returned by the :MEMory:DVMAxpoint? command.
The specified channel must be for the DVM unit.

Usage
Conditions

When not measuring




Read stored data (measured values)

Syntax

(Query)


:MEMory:DVVData? A

(Response)

X1,X2,X3,…

A = 1 to 2000
Xi = <Storage data>

Details

Reads the number of data objects specified by A from the memory pointer (channel and pointer offset) specified and returned by the :MEMory:DVPOint command.
The read pointer is incremented by the number of data words read.
This command cannot be executed while measuring.

Scaled values are written and read when scaling is enabled.

Example

:MEMory:DVPOint CH1_1,0
(Selects channel CH1_1 and sets the pointer offset to 0 for the stored data.)

:MEMory:DVVData? 2
(Reads two data words from memory.)
(Response)  :MEMORY:DVVDATA -1.043727E+01,-1.043771E+01  (when headers are enabled)

Note

-

Usage
Conditions

measurement is not taking place.
the memory read pointer is below the address of the stored data,
the DVM unit channel is selected by :MEMory:DVPOint.




Read real-time data (measured values)

Syntax

(Query)


:MEMory:DVVReal? A$

(Response)

[When using MR8740 compatibility mode]
B

[When using MR6000 compatibility mode]
A$,B

A$ = CH1_1 to CH27_4
B = Physical values.

Details

Returns the physical value measured on channel A$ after acquiring data with the :MEMory:GETReal command.
The data obtained is the same as that for the :MEMory:DVVData? command.

Example

:MEMory:GETReal
(Causes the instrument to acquire real-time measurement values on all channels.)

:MEMory:DVVReal? CH1_1
(Response)  :MEMORY:DVVREAL 1.23000E-02  (when headers are enabled)

Note

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

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

-




Read logic data

Syntax

(Query)


:MEMory:LDATa? A

(Response)

X1,X2,X3,…<NR1>

A = 1 to 2000
Xi = <Storage data>

Details

Reads the specified (A) number of data bytes 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 bytes read.

The four subchannels in each logic channel group (A to D) are encoded in the lower four bits of the NR1 data bytes, as shown in the following example.


The decimal data value 10 = the binary value "0000000000001010".

Example

:MEMory:POINt L25,0
(Selects built-in logic channel and sets the index to 0 for the data stored in memory.)

:MEMory:LDATa? 10
(Returns 10 logic data.)
(Response)  :MEMORY:LDATA 1,2,3,4,5,6,7,8,9,10  (when headers are enabled)

Note

-

Usage
Conditions

measurement is not taking place,
the memory read pointer is below the address of the stored data,
the logic channel is specified by :MEMory:POINt
and the stored data is present.




Read real-time logic data

Syntax

(Query)


:MEMory:LREAl? A$

(Response)

B<NR1>

A$ = L25 to L27
B = 0 to 65535

Details

Returns the value measured on channel CH$ after acquiring the data with the :MEMory:GETReal command.
Data is returned in the same way as for :MEMory:LDATa?

Example

:MEMory:GETReal
(Causes the instrument to acquire real-time measurement values on all channels.)

:MEMory:LREAl? L25
(Response)  :MEMORY:LREAL 10  (when headers are enabled)

Note

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

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 CH27_4, L25 to L27, 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 CH27_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 CH27_4, L25 to L27
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 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.




Read real-time data (measured values)

Syntax

(Query)


:MEMory:VREAl? A$

(Response)

[When using MR8740 compatibility mode]
B

[When using MR6000 compatibility mode]
A$,B

A$ = CH1_1 to CH27_4
B = Physical values

Details

Returns the physical value measured on channel A$ after acquiring data with the :MEMory:GETReal command.
The data obtained is the same as that for the :MEMory:VDATa? command.

Example

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

:MEMory:REAL? CH1_1
(Response)  :MEMORY:REAL -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

-