CALCulate:MEASure:DATA Commands

Controls writing and reading VNA measurement data.

CALCulate:MEASure:DATA

FDATa

FMEMory

SDATa

SMEMory

SNP?

       | PORTs?

             | SAVE

Click a keyword to view the command details.

See Also


(Write) CALCulate<cnum>:MEASure<mnum>:DATA:<char>,<data>

(Read) CALCulate<cnum>:MEASure<mnum>:DATA:<char>?

Applicable Models: All

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:MEAS: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).

Note: When querying FDATA, data is received in degrees. When setting phase using FDATA, the command expects the data in radians.

  • 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 memory 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

 


CALCulate<cnum>:MEASure<mnum>:DATA:SNP? <n>

Applicable Models: All

(Read-only) Reads SnP data from the selected measurement. Learn more about SnP data.

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

Notes

  • This command returns SNP data without header information, and in columns, not in rows as .SnP files. This means that the data returned from this command sends all frequency data, then all Sx1 magnitude or real data, then all Sx1 phase or imaginary data, and so forth.

  • To avoid frequency rounding errors, specify FORMat:DATA <Real,64> or <ASCii, 0>

 

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.

<n>

Amount of data to return. If unspecified, <n> is set to 2.  The number you specify must be less than or equal to the number of available ports on the VNA.

Choose from:

1 (S1P) returns 1-Port data for the active measurement if the active measurement is a reflection parameter such as S11 or S22. The behavior is UNDEFINED if the active measurement is a transmission parameter such as an S21.

2  (S2P)  returns data for the four 2 port parameters associated with the current measurement. Default. Data that is not available is zero-filled.

3  (S3P)  returns data for the nine 3 port parameters associated with the current measurement. Data that is not available is zero-filled.

4 (S4P)   returns data for the sixteen 4 port parameters associated with the current measurement.  Data that is not available is zero-filled.

SnP data can be output using several data formatting options.  See MMEM:STORe:TRACe:FORMat:SNP.

See also MMEM:STOR <file>.<snp>

Examples

CALC:MEAS1:DATA:SNP? 1

Return Type

Depends on FORMat:DATA.

Default

Not Applicable


CALCulate<cnum>:MEASure<mnum>:DATA:SNP:PORTs? <"x,y,z".>

Applicable Models: All

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

Notes

  • This command returns SNP data without header information, and in columns, not in rows as .SnP files. This means that the data returned from this command sends all frequency data, then all Sx1 magnitude or real data, then all Sx1 phase or imaginary data, and so forth.

  • To avoid frequency rounding errors, specify FORM:DATA <Real,64> or <ASCii, 0>

  • 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">

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:STORe:TRACe:FORMat:SNP.

Examples

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

Return Type

Depends on FORMat:DATA

Default

Not Applicable


CALCulate<cnum>:MEASure<mnum>:DATA:SNP:PORTs:SAVE <"x,y,z">,<filename>

Applicable Models: All

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

<"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, enclosed in quotes.  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:STORe:TRACe:FORMat:SNP.

Examples

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

Return Type

Depends on FORMat:DATA

Default

Not Applicable