Data SCPI

M9370A / M9371A / M9372A / M9374A / M9375A

previous page next page

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.

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

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

previous page start next page