Calculate:Data Commands


Controls writing and reading VNA measurement data.

These commands are Superseded by the CALCulate:MEASure:DATA commands.

CALCulate:DATA

       | CUSTom

             | CATalog?

       | MFData?

       | MSData?

       | SNP?

             | PORTs?

                  | SAVE

Click on a red keyword to view the command details.

Red is a superseded command.

See Also

Critical Note: CALCulate commands act on the selected measurement. You can select one measurement for each channel using Calc:Par:MNUM or Calc:Par:Select. Learn more.


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

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

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

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

  • For Measurement data, use FDATA, RDATA, 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.

See Critical Note

Parameters

 

 

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> 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.

 

RDATA

Complex measurement data.

Writes data to Data Access Map location Raw Measurement (access point 0), same as SDATA.

Note: Write access is forbidden on the standard channel if factory calibration is on (applies to ENA/PXI/Streamline, not to PNA); to disable factory calibration use SYST:FCOR:CHAN:COUP:STAT OFF command.

Reads data from Data Access Map location Raw Measurement (access point 0).

  • Returns TWO numbers per data point.

  • Returned numbers are uncorrected (regardless of correction state)

 

SDATA

Complex measurement data.

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

Note: Write access is forbidden on the standard channel if factory calibration is on (applies to ENA/PXI/Streamline, not to PNA); to disable factory calibration use SYST:FCOR:CHAN:COUP:STAT OFF command.

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

Note: Writing data to this access point, and then reading the data from this access point, will result in different values if correction or factory cal is ON.

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

 

SDIV

Complex data from Data Access Map location Normalization (5).

  • Returns TWO numbers per data point.

  • If normalization interpolation is ON and the number of points changes after the initial normalization, the divisor data will then be interpolated.

  • When querying the normalization divisor, you must first store a divisor trace using CALC:NORMalize[:IMMediate].

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

For 2-Port SOLT and TRL calibrations

Specify this <char>

to get or put this Error Term...

SCORR1

Forward Directivity

SCORR2

Forward Source Match

SCORR3

Forward Reflection Tracking

SCORR4

Forward Isolation

SCORR5

Forward Load Match

SCORR6

Forward Transmission Tracking

SCORR7

Reverse Directivity

SCORR8

Reverse Source Match

SCORR9

Reverse Reflection Tracking

SCORR10

Reverse Isolation

SCORR11

Reverse Load Match

SCORR12

Reverse Transmission Tracking

 

EXAMPLE

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

See another example using this command.

Return Type: Block data

Default - Not Applicable


CALCulate<cnum>:DATA:CUSTom <name>,<data> Superseded

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

Note: This command has been replaced by CALC:DATA: which can now be used with all VNA applications.

(Read-Write) Reads or writes data from a custom-named measurement buffer.

See Critical Note

Parameters

 

<cnum>

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

<name>

Name of the buffer to be read or written

<data>

Data to be read or written to the custom buffer. Format as one number per data point.

Examples

CALC:DATA:CUST 'VectorResult0',0,1,2,3,4,5 'Write

CALC:DATA:CUST? 'VectorResult0' 'Read

Query Syntax

CALCulate:DATA:CUSTom? <name>

Return Type

Depends on Form:Data

Default

Not Applicable


CALCulate<cnum>:DATA:CUSTom:CATalog?  Superseded

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

Note: This command has been replaced by CALC:DATA:CAT which can now be used with all VNA applications.

(Read-only) Reads the list of buffer names (comma separated list of string values) available from the selected parameter. Specify the measurement using CALCulate:PARameter:SELect.

See Critical Note

Parameters

 

<cnum>

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

Examples

CALC:DATA:CUST:CAT?

calculate:data:custom:catalog?

Return Type

String

Default

Not Applicable


CALCulate<cnum>:DATA:MFData? <measList>

Applicable Models: N522xB, N523xB, N524xB, E5080A, M948xA, P937xA

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

This command gets multiple 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.

<measList>

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? "1,2"

Return Type

Data Block

Default

Not Applicable


CALCulate<cnum>:DATA<data>:MSData? <measList>

Applicable Models: N522xB, N523xB, N524xB, E5080A, M948xA, P937xA

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

<measList>

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? "1,2"

Return Type

Data Block

Default

Not Applicable


CALCulate<cnum>:DATA:SNP? <n> Superseded

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

Note: This command has been replaced by CALC:DATA:SNP:PORTs?

(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 FORM:DATA <Real,64> or <ASCii, 0>

See Critical Note

Parameters

 

<cnum>

Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <cnum> 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:PAR:DEF MyMeasurement, S11

CALC:PAR:SEL MyMeasurement

CALC:DATA:SNP? 1

Return Type

Depends on FORMat:DATA.

Default

Not Applicable


CALCulate<cnum>:DATA:SNP:PORTs? <"x,y,z".>[, FAST]

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

Note: This command replaces CALC:DATA:SNP?. This command is more explicit regarding the data to be returned, and works for VNAs with multiport test sets.

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

See Critical Note

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

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.

[, FAST]

Reduce the saving time

:SENS:CORR:CACH:MODE should be set at ON.

The correction must cover all the ports of the SNP port list.

The active measurement must be a corrected S Parameter defined by the port list for the SNP requests.  EG: "S33" is not a proper selected measurement with CALC:DATA:SNP:PORTS? <1,2>

Examples

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

Return Type

Depends on FORMat:DATA

Default

Not Applicable


CALCulate<cnum>:DATA:SNP:PORTs:SAVE <"x,y,z">,<"filename">[, FAST]

Applicable Models: N522xB, N523xB, N524xB, M937xA, P937xA

Note: This command replaces MMEM:STOR sNp for standard channels (only). This command is more explicit regarding the data to be saved, and works for VNAs with multiport test sets.

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

See Critical Note

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.

[, FAST]

Reduce the saving time

:SENS:CORR:CACH:MODE should be set at ON.

The correction must cover all the ports of the SNP port list.

The active measurement must be a corrected S Parameter defined by the port list for the SNP requests.  EG: "S33" is not a proper selected measurement with CALC:DATA:SNP:PORTS? <1,2>

Examples

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

Return Type

Depends on FORMat:DATA

Default

Not Applicable


CALCulate<cnum>:MEASure<mnum>:RDATa? <char>

(Read-only) Returns receiver data for the selected measurement. To query measurement data, see CALC:DATA?

Critical Note: CALCulate commands act on the selected measurement. You can select one measurement for each channel using Calc:Par:MNUM or Calc:Par:Select. 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.

<char>

Choose from any physical receiver in the VNA.

For example: "A"

Also, REF - returns data for either R1 or R2 data depending on the source port of the selected measurement.

See the block diagram showing the receivers in VNA.

Note: Logical receiver notation is NOT allowed with this command. Learn more.

Example

INITiate:CONTinuous OFF
INITiate:IMMediate;*wai
CALC:MEAS:RDATA? A

CALCulate:RDATA? REF

Return Type

Depends on FORM:DATA command - Two numbers per data point

Default

Not Applicable

Notes:

Generally when you query the analyzer for data, you expect that the number of data values returned will be consistent with the number of points in the sweep.

However, if you query receiver data while the instrument is sweeping, the returned values may contain zeros. For example, if your request for receiver data is handled on the 45th point of a 201 point sweep, the first 45 values will be valid data, and the remainder will contain complex zero.

This can be avoided by synchronizing this request with the end of a sweep or putting the channel in hold mode.

Learn about Unratioed Measurements