Measure

Applicable Models: All (Read-Write) Sets or gets the parameter after conversion using the parameter conversion function, for the active trace of selected channel.
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>	Select from the following parameters after conversion: "OFF" "ZREFlection" - Specifies the equivalent impedance in reflection measurement. "ZTRansmit" - Specifies the equivalent impedance (series) in transmission measurement. "ZTSHunt" - Specifies the equivalent impedance (shunt) in transmission measurement. "YREFlection" - Specifies the equivalent admittance in reflection measurement. "YTRansmit" - Specifies the equivalent admittance (series) in transmission measurement. "YTSHunt" - Specifies the equivalent admittance (shunt) in transmission measurement. "INVersion" - Specifies the inverse S-parameter (1/S). "CONJugation" - Specifies the conjugate.
Examples	CALC:MEAS1:CONV:FUNC ZTSH calculate2:measure1:conversion:function conjugation
Query Syntax	CALCulate<cnum>:MEASure<mnum>:CONVersion:FUNCtion?
Return Type	Character
Default	"OFF"

CALCulate<cnum>:MEASure<mnum>:DEFine <string>

Applicable Models: All

(Write-only) Creates a measurement but does NOT display it, on an existing or new channel. When a new channel is created, any licensed measurement class can be used. Up to 580 measurements can be created.

Note that each display window can only display a limited number of traces. See Traces, Channels, and Windows on the VNA.

Use DISP:WIND:STATe to create a window if it doesn't already exist.
Use DISP:MEAS<mnum>:FEED<wnum> to display the measurement in window <wnum>.

This command replaces the following commands:

CALCulate:PARameter[:DEFine]

CALCulate:PARameter[:DEFine]:EXTended

CALCulate:CUSTom:DEFine

Parameters

<cnum>

Channel number of the new measurement. If unspecified, value is set to 1.

If the specified channel does not exist, then a channel of the specified type will be created. If no type of channel is specified, then a standard channel will be created.

If the specified channel exists, then the parameter will be added to the channel provided the existing channel supports the parameter (otherwise, an error will be generated).

<mnum>

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

If the specified measurement number is already in use, an error will be generated.

(String ) Measurement Parameter and optional measurement class name separated by a ":" (colon). For example, "S21:Gain Compression" creates an S21 measurement and selects the Gain Compression measurement class for the channel.

Note: If a measurement class of a channel does not support the defined measurement parameter, an error is generated.

Case sensitive.

For S-parameters:

Any S-parameter available in the VNA

Single-digit port numbers CAN be separated by "_" (underscore). For example: "S21" or "S2_1"

Double-digit port numbers MUST be separated by underscore. For example: "S10_1"

For ratioed measurements:

Any two VNA physical receivers separated by forward slash '/' followed by comma and source port.

For example: "A/R1, 3"

Learn more about ratioed measurements

See a block diagram showing the receivers in YOUR VNA.

For non-ratioed measurements:

Any VNA physical receiver followed by comma and source port.

For example: "A, 4"

Learn more about unratioed measurements.

See the block diagram showing the receivers in YOUR VNA.

Ratioed and Unratioed measurements can also use logical receiver notation to refer to receivers. This notation makes it easy to refer to receivers with an external test set connected to the VNA. You do not need to know which physical receiver is used for each test port. Learn more.

For ADC measurements:

Any ADC receiver in the VNA followed by a comma, then the source port.

For example: "AI1,2" indicates the Analog Input1 with source port of 2.

Learn more about ADC receiver measurements.

(string) - Choose from the following (click or scroll down to view valid measurement parameters for each measurement class)

"Standard"
"Scalar Mixer/Converter"
"Gain Compression"
"Noise Figure Cold Source"

(variant) Measurement names to create:

Meas Class	Measurement Name	Description
"Standard"	"S11", "S21", and so forth "A_1","A_2", and so forth	S-parameter name Unratioed parameter names with notation: "receiver_source port" See balanced parameter names
"Scalar Mixer/Converter"	For input port X and output port Y: "SCXY" "SCYX" "SXX" "SYY" "Ipwr" "RevIPwr" "Opwr" "RevOPwr"	Learn about SMC parameters Note: Input and output ports are set up using the Mixer Setup dialog. If the ports are not set up using the Mixer Setup dialog, then ports 1 and 2 are the default input and output ports and the only ports that can be used.
"Gain Compression" Learn more	GCA:
	"CompIn21"	Input power at the compression point.
	"CompOut21"	Output power at the compression point.
	"CompGain21"	Gain at the compression point.
	"CompS11"	Input Match at the compression point
	"RefS21"	Linear Gain
	"DeltaGain21"	CompGain21 -Linear Gain
	"S11", "S21", "S12", "S22"	Standard S-parameters; measured at port 1 and port 2
"Noise Figure Cold Source" Learn more	Noise Figure :
	"NF"	Noise figure
	"ENR"	Validate noise source measurements.
	"T-Eff"	Effective noise temperature.
	"DUTRNP" "DUTRNPI"	DUT noise power ratio. (Noise power expressed in Kelvin divided by 290).
	"SYSRNP" "SYSRNPI"	System noise power ratio
	"DUTNPD" "DUTNPDI"	DUT noise power density. (Noise power expressed in dBm/Hz).
	"SYSNPD" "SYSNPDI"	System noise power density.
	"OvrRng" (Opt 029 Only)	Indication that the noise receiver is being over powered.
	"T-Rcvr" (Opt 029 Only)	Temperature reading (in Kelvin) of the noise receiver board.
	"S11", "S21", "S12", "S22"	Standard S-parameters; measured with the port1 and port2 noise switches set for noise mode.
	"A_1","A_2" ...and so forth.	Unratioed parameters; with notation: "receiver, source port"
	"GammaOpt"	Optimum Complex Reflection Coefficient
	"Rn"	Noise Resistance
	"NFMin"	Minimum noise figure that occurs at GammaOpt

Examples

CALC1:MEAS2:DEF "S11" 'Defines an S11 measurement for channel 1, measurement number 2.

CALC4:MEAS3:DEF "S21:Gain Compression" 'Defines an S21 measurement for channel 4, measurement number 3, and creates a GCA channel.

CALC2:MEAS:DEF "R1,1:Standard" 'Defines an R1,1 measurement for channel 2, measurement number 1 (default), and creates a Standard channel.

Query Syntax

Not Applicable

Default

Not Applicable

CALCulate<cnum>:MEASure<mnum>:DELete <Mname>

Applicable Models: All (Write-only) Deletes the specified measurement.
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.
<Mname>	String - Name of the measurement
Examples	CALC:MEAS:DEL 'TEST' calculate2:measure2:delete 'test'
Query Syntax	Not Applicable
Default	Not Applicable

CALCulate:MEASure:DELete:ALL

Applicable Models: All (Write-only) Deletes all measurements on the VNA.
Parameters
Examples	CALC:MEAS:DEL:ALL
Query Syntax	Not Applicable
Default	Not Applicable

CALCulate<cnum>:MEASure<mnum>:EQUation:FAST <bool>

Applicable Models: All (Read-Write) Set and return equation editor trace update delay. This command delays updating the equation editor trace until all trace references have finished updating to ensure that all data is present. Note: This command does not work in application channels. In addition, this command does not work with the standard channel when the channel is in HOLD and then SINGLE sweeps are sent.
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.
<bool>	Choose from: OFF (0) Do not delay equation editor trace update. ON (1) Delay equation editor trace update.
Examples	CALC:MEAS:EQU:FAST 1 calculate2:measure1:equation:fast OFF
Query Syntax	CALCulate<cnum>:MEASure<mnum>:EQUation:FAST?
Return Type	Boolean
Default	OFF or 0

CALCulate<cnum>:MEASure<mnum>:EQUation[:STATe] <bool>

Applicable Models: All (Read-Write) Turns ON and OFF the equation on selected measurement for the specified channel. If the equation is not valid, then processing is not performed. Use CALC:EQUation:VALid? to ensure that the equation is valid.
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.
<bool>	ON (or 1) - turns equation ON. OFF (or 0) - turns equation OFF.
Examples	CALC:MEAS:EQU 1 calculate2:measure1:equation:state 0
Query Syntax	CALCulate<cnum>:MEASure<mnum>:EQUation[:STATe]?
Return Type	Boolean
Default	OFF (0)

CALCulate<cnum>:MEASure<mnum>:EQUation:TEXT <string>

Applicable Models: All (Read-Write) Specifies an equation or expression to be used on the selected measurement for the specified channel.
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.
<string>	Any valid equation or expression. See Equation Editor.
Examples	'Equation (includes '=') CALC:MEAS:EQU:TEXT "foo=S11/S21" 'Expression calculate2:measure1:equation:text "S11/S21"
Query Syntax	CALCulate<cnum>:MEASure<mnum>:EQUation:TEXT?
Return Type	String
Default	Not Applicable

CALCulate<cnum>:MEASure<mnum>:EQUation:VALid?

Applicable Models: All (Read-Only) Returns a boolean value to indicate if the current equation on the selected measurement for the specified channel is valid. For equation processing to occur, the equation must be valid and ON (CALC:EQU:STAT 1).
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.
Examples	CALC:MEAS:EQU:VAL? calculate2:measure1:equation:valid?
Return Type	Boolean 1 - equation is valid 0 - equation is NOT valid
Default	Not Applicable

CALCulate<cnum>:MEASure<mnum>:FORMat <char>

Applicable Models: All (Read-Write) Sets the display format for the measurement.
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: MLINear MLOGarithmic PHASe UPHase 'Unwrapped phase IMAGinary REAL POLar SMITh SADMittance 'Smith Admittance SWR GDELay 'Group Delay KELVin FAHRenheit CELSius PPHase 'Positive Phase
Examples	CALC:MEAS:FORM MLIN calculate2:measure1:format polar
Query Syntax	CALCulate<cnum>:MEASure<mnum>:FORMat?
Return Type	Character
Default	MLINear

CALCulate<cnum>:MEASure<mnum>:FORMat:UNIT <dataFormat>, <units>

Applicable Models: All (Read-Write) Sets and returns the units for the specified data format. Measurements with display formats other than those specified are not affected.
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.
<dataFormat>	Choose from: MLOG - Log magnitude MLIN - Linear magnitude
<units>	For unratioed MLOG measurements, choose from: DBM Units are displayed in dBm. 0 dBm = 0.001 watt DBMV Units are displayed in dBmV. 0 dBmV = 0.001 volt DBmV value depends on the reference impedance: dBmV = dBm + 30 + 10log10(Z0) DBMA Units are displayed in dBmA. 0 dBmA = 0.001 Ampere DBUV Units are displayed in dBuV. 0 dBuV = 1 uV DBuV value depends on the reference impedance: dBuV = dBm + 90 + 10log10(Z0) For unratioed MLIN measurements, choose from: W -Units are displayed in Watts V -Units are displayed in Volts A -Units are displayed in Amperes
Examples	CALC:MEAS:FORM MLOG, DBM calculate2:measure1:format mlog,dbmv
Query Syntax	CALCulate<cnum>:MEASure<mnum>:FORMat:UNIT? <dataFormat>
Return Type	Character
Default	MLOG, DBM

CALCulate<ch>:MEASure<mnum>:HOLD:CLEar

Applicable Models: All (Write-only) Resets the currently-stored data points to the live data trace and restarts the currently-selected Trace Hold type.
Parameters
<ch>	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.
Examples	CALC:MEAS:HOLD:CLE calculate2:measure1:hold:clear
Query Syntax	Not Applicable
Default	Not Applicable

CALCulate<ch>:MEASure<mnum>:HOLD:TYPE <value>

Applicable Models: All (Read-Write) Sets the type of trace hold to perform.
Parameters
<ch>	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.
<value>	Trace Hold type. Choose from: OFF - Disables the Trace Hold feature. MINimum - Sets Trace Hold to store the lowest measured data points. MAXimum - Sets Trace Hold to store the highest measured data points.
Examples	CALC:MEAS:HOLD:TYPE MAX calculate2:measure1:hold:type minimum
Query Syntax	CALCulate<ch>:MEASure<mnum>:HOLD:TYPE?
Return Type	Character
Default	OFF

CALCulate<cnum>:MEASure<mnum>:MATH:FUNCtion <char>

Applicable Models: All (Read-Write) Sets math operations on the currently selected measurement and the trace stored in memory. (There MUST be a trace stored in Memory. See CALC:MEAS:MATH MEM)
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>	The math operation to be applied. Choose from the following:

	NORMal	Trace data only
	ADD	Data + Memory
	SUBTract	Data - Memory
	MULTiply	Data * Memory
	DIVide	Data / Memory

Examples	CALC:MEAS:MATH:FUNC NORM calculate2:measure1:math:function subtract
Query Syntax	CALCulate<cnum>:MEASure<mnum>:MATH:FUNCtion?
Return Type	Character
Default	NORMal

CALCulate<cnum>:MEASure<mnum>:MATH:INTerpolate[:STATe]

Applicable Models: N522xB, N523xB, N524xB (Read-Write) Sets and reads the state of the memory data interpolation. Learn more.
Parameters
<cnum>	Channel number of the measurement. There must be a selected measurement on that channel. If unspecified, <ch> 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.
<bool>	Choose from: 0 - OFF - Turn memory data interpolation OFF. 1 - ON - Turn memory data interpolation ON.
Examples	CALC2:MEAS:MATH:INT 1
Query Syntax	CALCulate<ch>:MEASure<mnum>:MATH:INTerpolate?
Return Type	Boolean
Default	0

CALCulate<cnum>:MEASure<mnum>:MATH:MEMorize

Applicable Models: All (Write-only) Puts the currently selected measurement trace into memory. (Data-> Memory).
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.
Examples	CALC:MEAS:MATH:MEM calculate2:measure1:math:memorize
Query Syntax	Not applicable
Default	Not applicable

CALCulate<ch>:MEASure<mnum>:MIXer:XAXis <char>

Applicable Models: All (Read-Write) Sets or returns the swept parameter to display on the X-axis for the selected FCA and GCX measurement.
Parameters
<ch>	Any existing channel number. If unspecified, value 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>	Parameter to display on the X-axis. Choose from: INPUT - Input frequency span OUTPUT - Output frequency span LO_1 - First LO frequency span LO_2 - Second LO frequency span
Examples	CALC:MEAS:MIX:XAX INPUT calculate2:measure1:mixer:xaxis output See an example that creates, selects, and calibrates an SMC and VMC measurement using SCPI.
Query Syntax	CALCulate<ch>:MEASure<mnum>:MIXer:XAXis?
Return Type	Character
Default	OUTPUT

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

Applicable Models: All (Read-only) Returns receiver data for the selected measurement.
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 YOUR VNA. Note: Logical receiver notation is NOT allowed with this command. Learn more.
Example	GPIB.Write "INITiate:CONTinuous OFF" GPIB.Write "INITiate:IMMediate;*wai" GPIB.Write "CALCulate:MEASure2:RDATA? A" GPIB.Write "CALCulate:MEASure2:RDATA? REF"
Return Type	Depends on FORM:DATA - Two numbers per data point
Default	Not Applicable