Calculate:Data Commands

CALCulate:DATA:

   | MFData

   | MSData

CALCulate:MEASure:DATA:

| FDATa

| SDATa

| FMEMory

| SMEMory

| SNP?

| PORTs?

| SAVE

(Read-only) Gets the formatted data array of multiple traces (traces-n, m, .... to l) of the selected channel.

This command is allows to get several trace data with one command, while CALC:MEAS:DATA:FDAT returns only one trace with one command.

Note: If valid data is not calculated because of the invalid measurement, “1.#QNB” is read out.

Parameters

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

<data>

Indicates the array data (formatted data array) of NOP (number of measurement points)×2×(number of specified traces). Where n is an integer between 1 and NOP.

• Data (n×2-2) : Data (primary value) at the n-th measurement point.

• Data (n×2-1) : Data (secondary value) at the n-th measurement point. Always 0 when the data format is not the Smith chart format or the polar format.

The output trace data is listed according to the order of the specified trace number.

The index of the array starts from 0.

Note: If there is no array data of NOP (number of measurement point)×2 when setting a formatted data array, an error occurs when executed and the object is ignored.

<string>

Trace number. "n, m, l, ..." where n, m, l are 1 to the maximum trace number.

Note: Use comma for separator of trace number.

Examples

CALC:DATA:MFD

Return Type

Not Applicable

Default

Not Applicable

(Read-only) Gets the corrected data array of multiple traces (traces-n, m, .... to l) of the selected channel.

This command is allows to get several corrected data with one command, while CALC:MEAS:DATA:SDAT returns only one corrected data with one command.

Note: If valid data is not calculated because of the invalid measurement, “1.#QNB” is read out.

Parameters

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

<data>

Indicates the array data (corrected data array) of NOP (number of measurement points)×2×(number of specified traces). Where n is an integer between 1 and NOP.

• Data(n*2-2) : Real part of the data (complex number) at the n-th measurement point.

• Data(n*2-1) : Imaginary part of the data (complex number) at the n-th measurement point.

The output trace data is listed according to the order of the specified trace number.

The index of the array starts from 0.

Note: If there is no array data of NOP (number of measurement point)×2 when setting a corrected data array, an error occurs when executed and the object is ignored.

<string>

Trace number. "n, m, l, ..." where n, m, l are 1 to the maximum trace number.

Note: Use comma for separator of trace number.

Examples

CALC:DATA:MSD

Return Type

Not Applicable

Default

Not Applicable

Reads or writes Measurement data, Memory data or Normalization Divisor data from the Data Access Map location.

• For Measurement data, use FDATA or SDATA

• For Memory data, use FMEM or SMEM. When querying memory, you must first store a trace into memory using CALC:MATH:MEMorize.

• For Normalization Divisor (Receiver Power Cal error term) data, use SDIV.

• Use FORMat:DATA to change the data type (<REAL,32>, <REAL,64> or <ASCii,0>).

• Use FORMat:BORDer to change the byte order. Use “NORMal” when transferring a binary block from LabView or VEE. For other programming languages, you may need to "SWAP" the byte order.

Equation Editor Notes:

• When equation editor is active on a trace in a standard S-parameter channel, Calc:Data returns the data from the parameter on the trace that was measured last. For example, for the equation "S22 + S33 + S11”, then S33 is the last measured parameter because it uses source port 3.

• In applications, if equation editor is active and the original parameter for the trace is not requested anywhere in the channel, then zeros are returned. If the original parameter is being measured within the channel, then data for the original parameter is returned.

• In general, if an equation contains no measurement parameters, then data for the original parameter is returned.

Note: The Calc:Data SCORR command to read/write error terms is Superseded with SENS:CORR:CSET:DATA. SCORR commands do NOT accommodate greater than 12 error terms.

Parameters

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

<mnum>

Measurement number for each measurement. There must be a selected measurement on the trace. If unspecified, <mnum> is set to 1.

<char>

FDATA

Formatted measurement data to or from Data Access Map location. Display (access point 2).

• Corrected data is returned when correction is ON.

• Uncorrected data is returned when correction is OFF.

• Returns TWO numbers per data point for Polar and Smith Chart format.

• Returns one number per data point for all other formats.

• Format of the read data is same as the displayed format.

SDATA

Complex measurement data.

Writes data to Data Access Map location. Raw Measurement (access point 0).

• When writing corrected data, and correction is ON, it will be corrected again, resulting in meaningless data.

Reads data from Apply Error Terms (access point 1).

• Returns TWO numbers per data point.

• Corrected data is returned when correction is ON.

• Uncorrected data is returned when correction is OFF.

FMEM

Formatted memory data to or from Data Access Map location. Memory result  (access point 4).

• Returns TWO numbers per data point for Polar and Smith Chart format.

• Returns one number per data point for all other formats.

• Format of the read data is same as the displayed format.

• Returned data reflects the correction level (ON|OFF) when the data was stored into memory.

SMEM

Complex measurement data to or from Data Access Map location Memory  (access point 3).

• Returns  TWO numbers per data point.

• Returned data reflects the correction level (ON|OFF) when the data was stored into memory.

• Returned data reflects the correction level (ON|OFF) when the data was stored into memory.

Examples

CALC:MEAS:DATA:FDATA Data(x)
calculate2:measure2:data:sdata data(r,i)

See another example using this command.

Return Type

Block data

Default

Not Applicable

 (Read-only) Reads SNP data from the selected measurement for the specified ports. Learn more about SNP data.

This command is valid ONLY with standard S-parameter measurements.

Parameters

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

<mnum>

Measurement number for each measurement. There must be a selected measurement on the trace. If unspecified, <mnum> is set to 1.

<"x,y,z">

Comma or space delimited port numbers for which data is requested, enclosed in quotes.

SNP data can be output using several data formatting options. See MMEM:STOR:TRAC:FORM:SNP.

Examples

CALC:MEAS:DATA:SNP:PORTs? "1,2,4,5,7" 'read data for these ports

Return Type

Depends on FORM:DATA command

Default

Not Applicable

(Write-only) Saves SNP data from the selected measurement for the specified ports. Learn more about SNP data.

• The Normal vs Mixed Mode selection is NOT used as it is in the Choose Ports dialog. Instead, data is returned as it is displayed on the trace. If the selected measurement is Mixed Mode (balanced), then balanced data is returned. If the selected measurement is an S-parameter, then S-parameter data is returned.

• This command is valid ONLY with the Standard measurement class (NOT applications).

• Data that is not available is zero-filled.

• For sweeps with a large number of data points, always follow this command with *OPC? Learn more.

Parameters

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> is set to 1.

<mnum>

Measurement number for each measurement. There must be a selected measurement on the trace. If unspecified, <mnum> is set to 1.

<"x,y,z">

String - Comma or space delimited port numbers for which data is requested, enclosed in quotes.

<filename>

String - Path, filename, and suffix of location to store the SNP data.  The suffix is not checked for accuracy. If saving 2 ports, specify "filename.s2p"; If saving 4 ports, specify "filename.s4p.", and so forth.

SNP data can be output using several data formatting options. See MMEM:STOR:TRAC:FORM:SNP.

Examples

CALC:MEAS:DATA:SNP:PORTs:Save '1,2,4','D:\MyData.s3p';*OPC?

Return Type

Depends on FORM:DATA command

Default

Not Applicable

18-May-2016

First Release