Calculate:Data Commands

Controls writing and reading PNA measurement data.

CALCulate:DATA

       | CUSTom

             | CATalog?

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

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

  • When writing corrected data, and correction is ON, it will be corrected again, resulting in meaningless data (Same behavior as SDATA).

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

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

 

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

Note: This command has been replaced by CALC:DATA: which can now be used with all PNA 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

Note: This command has been replaced by CALC:DATA:CAT which can now be used with all PNA 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:SNP? <n> Superseded

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

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

 Note: This command replaces CALC:DATA:SNP?. This command is more explicit regarding the data to be returned, and works for PNAs 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.

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

Note: This command replaces MMEM:STOR sNp. This command is more explicit regarding the data to be saved, and works for PNAs 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.

Examples

CALC:DATA:SNP:PORTs:Save '1,2,4','c:\users\public\network analyzer\documents\MyData.s3p';*OPC?

Return Type

Depends on FORMat:DATA

Default

Not Applicable