Attributes
attributes.py - Contains the ID of all attributes belongs to the module.
- class nirfmxvna.attributes.AttributeID(value)[source]
Bases:
EnumThis enum class contains the ID of all attributes belongs to the module.
- AUTO_IF_BANDWIDTH_SCALING_ENABLED = 13631558
Specifies whether IF Bandwidth is automatically scaled down to account for the increased VNA receiver noise at low frequencies. This attribute will automatically set to False when
PULSE_MODE_ENABLEDattribute is set to True.Consider disabling automatic IF Bandwidth scaling by setting this attribute to False if you want faster measurement speed but with higher measurment noise at low frequencies.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is True.
Name (Value)
Description
False (0)
Disables automatic IF Bandwidth scaling that compensates for the increased VNA receiver noise at low frequencies.
True (1)
Enables automatic IF Bandwidth scaling that compensates for the increased VNA receiver noise at low frequencies.
- AVERAGING_COUNT = 13631496
Specifies the number of times each measurement is repeated and averaged-over. This attribute is used only when you set the
AVERAGING_ENABLEDattribute to True.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 10.
- AVERAGING_ENABLED = 13631495
Specifies whether to enable measurement averaging.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is False.
Name (Value)
Description
False (0)
Disables measurement averaging.
True (1)
Enables measurement averaging. You can set number of times each measurement is repeated and averaged-over using the Averaging Count attribute.
- CORRECTION_CALIBRATION_CALKIT_ELECTRONIC_ORIENTATION = 13631518
Specifies the orientation of the vCal fixture ports with respect to vCal ports.
Use “portA:portname, portB:portname” format to specify vCal orientation.
When using NI-PXIe 5633 without an NI switch module, if vCal orientation is not specified, it is assumed to be “portA:port1, portB:port2”.
When using NI-PXIe 5633 with an NI switch module, you must set vCal orientation for all the specified
CORRECTION_CALIBRATION_PORTS.The default value is an empty string.
- CORRECTION_CALIBRATION_CALKIT_ELECTRONIC_RESOURCE_NAME = 13631507
Specifies the resource name of the electronic calibration module (vCal) used for calibration. This attribute is used only when you set the
CORRECTION_CALIBRATION_CALKIT_TYPEattribute to Electronic. Supported Electronic Calkit Modules: NI CAL-5501Use “port::all” as the selector string to specify the same resource name for all VNA ports. Use “port::<portname>” as the selector string to read this attribute for a specific VNA port.
Note
Currently, RFmxVNA only supports the use of same calkit type (and the same calkit) for all calibration ports in a guided calibration procedure.
The default value is an empty string.
- CORRECTION_CALIBRATION_CALKIT_MECHANICAL_NAME = 13631508
Specifies the name of the mechanical calkit used for calibration. This attribute is used only when you set the
CORRECTION_CALIBRATION_CALKIT_TYPEattribute to Mechanical.You must set a valid calkit name. Use
calkit_manager_get_calkit_ids()method to get list of available mechanical calkits.Note
Currently, RFmxVNA only supports the use of same calkit type and same calkit name for all calibration ports in a guided calibration procedure.
Use “port::all” as the selector string to specify the same calkit name for all VNA ports. Use “port::<portname>” as the selector string to read this attribute for a specific VNA port.
The default value is an empty string.
- CORRECTION_CALIBRATION_CALKIT_TYPE = 13631506
Specifies the type of calkit used for calibration.
Use “port::all” as the selector string to specify the same calkit type for all VNA ports. Use “port::<portname>” as the selector string to read this attribute for a specific VNA port.
Note
Note that, currently, RFmxVNA only supports the use of same calkit type (and the same calkit) for all calibration ports in a guided calibration procedure.
The default value is Electronic.
Name (Value)
Description
Electronic (0)
Perform calibration using an electronic calkit module. Supported Electronic Calkit Modules: NI CAL-5501.
Mechanical (1)
Perform calibration using discrete cal standards from a mechanical calkit.
- CORRECTION_CALIBRATION_CONNECTOR_TYPE = 13631505
Specifies the connector type of the DUT. The specified connector type must be supported by the calkit that you selected for calibration.
Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port. Use “port::all” to configure same connector type for VNA ports.
The default value is an empty string.
- CORRECTION_CALIBRATION_ESTIMATED_THRU_DELAY = 13633536
Returns the estimated Thru Delay when Thru Method is set to Undefined Thru.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
- CORRECTION_CALIBRATION_METHOD = 13631509
Specifies the calibration method.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is SOL.
Name (Value)
Description
SOL (0)
Full 1-port calibration using atleast three distinct reflection standards, typically named Short, Open and Load.
SOLT (1)
Full 2-port calibration by performing two SOL calibrations on the two ports using atleast three distinct reflection standards, and a Thru cal using a transmission standard connecting the two ports. Use Thru Method attribute to select a suitable Thru cal procedure.
TRL (2)
Full 2-port calibration using a Thru, at least one Line, and one Reflect standard (Thru-Reflect-Line). The Thru standard can be an flush Thru or can have non-zero length (LRL, Line-Reflect-Line). The Reflect standard has to be identical for both ports. If multiple lines with different lengths are defined, the measurement automatically splits the measurement frequency range into segments and picks the line standard with appropriate length for each segment. The reference impedance of the calibration is the characteristic impedance of the Line(s).
- CORRECTION_CALIBRATION_PORTS = 13631504
Specifies the ports that are selected for calibration. Use comma-separated list of ports to specify multiple ports.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is an empty string.
- CORRECTION_CALIBRATION_STEP_COUNT = 13631513
Returns the total number of manual connection steps required to perform the selected calibration routine.
For example, if you use NI CAL-5501 electronic calkit to calibrate NI PXIe-5633 by using SOLT calibration method, querying this attribute will return 1, indicating that you only need to perform 1 manual connection to complete the SOLT cal. Similarly, if you calibrate the same system using a mechanical calkit containing a Short, Open, Load and Thru discrete cal standards, then querying this attribute will return 7, indicating that you must perform 7 distinct manual connections to complete the SOLT cal.
You must configure all the calibration related attributes and call
calibration_initiate()method before you query this attribute.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
- CORRECTION_CALIBRATION_STEP_DESCRIPTION = 13631514
Returns the description for the specified calibration step. You can use the description for each calibration step to determine which mechanical cal standard or electronic calkit module should you connect to which VNA port(s).
Use “calstep<n>” as the selector string to read this attribute.
You must configure all the calibration related attributes and call
calibration_initiate()method before you query this attribute.
- CORRECTION_CALIBRATION_THRU_COAX_DELAY = 13631512
Specifies the delay of the Thru mechanical standard when
CORRECTION_CALIBRATION_CALKIT_TYPEattribute is set to Mechanical and Thru Method attribute is set to Auto or Undefined Thru. This value is expressed in seconds.Use this attribute to specify an approximate delay value of an unknown-thru cal standard. Measurement uses this value to eliminate the uncertainty of ± 180 degrees in the estimated phase response of the Thru.
If you set this attribute to 0, the VNA automatically determines the delay of the Thru. You only need to set this attribute to an approximate non-zero delay value when Max Frequency Step Size > 1/(2 x Thru Delay). Here, Frequency Step Size refers to the difference between 2 consecutive frequency points in the set of frequencies sorted in ascending order.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 0 s.
- CORRECTION_CALIBRATION_THRU_METHOD = 13631511
Specifies the Thru calibration method when
CORRECTION_CALIBRATION_METHODattribute is set to SOLT.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is Auto.
Name (Value)
Description
Auto (0)
Measurement selects the appropriate Thru calibration method based on the value you specified for Calkit Type attribute. If Calkit Type is Electronic, then Delay Thru Using Defined Thru is selected. If Calkit Type is Mechanical, then Undefined Thru is selected.
Defined Thru (1)
The Thru definition from calkit definition is used based on the value you specified for Calkit Type attribute. If Calkit Type is Electronic, the Thru definition from the electronic calkit EPROM is used. If Calkit Type is Mechanical, the Thru definition from the calkit definition file is used.
Flush Thru (2)
Indicates a direct connection of the test ports when Calkit Type is Mechanical. The measured Thru is treated as flush Thru ignoring the Thru definition from the Calkit file. This method is not supported when Calkit Type is Electronic.
Undefined Thru (3)
Indicates connection of a Thru without a stored definition when Calkit Type is Mechanical. The measured Thru is treated as unknown Thru ignoring the Thru definition from the Calkit file. If a delay is configured, the delay will be utilized for the calibration. This method is not supported when Calkit Type is Electronic.
vCal Thru as Unknown Thru (5)
The Thru from the electronical Calkit is used for Thru measurement during calibration. The Thru definirion from vCal EPROM is used as a phase reference for the Thru characterization during calibration. This method is not supported when Calkit Type is Mechanical.
- CORRECTION_ENABLED = 13631499
Specifies whether to enable error correction for VNA measurement.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is False.
Name (Value)
Description
False (0)
The measurement disables error corection.
True (1)
The measurement enables error correction.
- CORRECTION_INTERPOLATION_ENABLED = 13631576
Specifies whether to enable interpolation of error terms for corrected VNA measurement. This attribute is used only when you set the
CORRECTION_ENABLEDattribute to True.Specifies whether to enable interpolation of error terms for corrected VNA measurement. If set to True, the interpolated error terms are used for each measurement frequency point, for which error terms do not exist in the calset, provided that minimum calset frequency <= measurement frequency and <= maximum calset frequency.
The impact of interpolation on the accuracy of the VNA measurements strongly depends on the measurement conditions and can range from severe degradation to no degradation at all. In case the phase difference between two consecutive error terms e[n-1], e[n] exceeds 180deg, the interpolation will lead to large measurement errors.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is True.
Name (Value)
Description
False (0)
The measurement disables interpolation of error terms for error correction.
True (1)
The measurement enables interpolation of error terms for error correction.
- CORRECTION_PORT_EXTENSION_AUTO_FREQUENCY_MODE = 13631612
Specifies the frequency mode over which the delay and loss (optional) values are determined.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is Sweep.
Name (Value)
Description
Sweep (0)
Sets the frequency mode to Sweep. Configured sweep range is used to determine the phase and loss values.
User (1)
Sets the frequency mode to User Span. User-defined span is used to determine the phase and loss values.
- CORRECTION_PORT_EXTENSION_AUTO_LOSS_ENABLED = 13631610
Specifies whether to determine both the frequency-dependent losses (Loss1 and Loss2) and the frequency-independent loss (DC Loss) during automatic port extension. Typically, the frequencies located at one-quarter and three-quarters of the configured sweep range are used as the f1 and f2 values.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is True.
Name (Value)
Description
False (0)
Disable the loss estimation in automatic port extension.
True (1)
Enable the loss estimation in automatic port extension.
- CORRECTION_PORT_EXTENSION_AUTO_REGULARIZATION_ENABLED = 13631611
Specifies whether the compensated trace should be regularized to ensure it remains at or below 0 dB. Fixture mismatch can sometimes cause S11 or S22 measurements to exceed 0 dB, which may introduce numerical instability when using the resulting S-parameters. This attribute is used only when you set the
CORRECTION_PORT_EXTENSION_AUTO_LOSS_ENABLEDattribute to True.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is True.
Name (Value)
Description
False (0)
Disable the regularization of the compensated trace in automatic port extension.
True (1)
Enable the regularization of the compensated trace in automatic port extension.
- CORRECTION_PORT_EXTENSION_AUTO_START_FREQUENCY = 13631613
Specifies the start frequency of the user span. This attribute is used only when you set the
CORRECTION_PORT_EXTENSION_AUTO_FREQUENCY_MODEattribute to User Span. This value is expressed in Hz.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 1 GHz.
- CORRECTION_PORT_EXTENSION_AUTO_STOP_FREQUENCY = 13631614
Specifies the stop frequency of the user span. This attribute is used only when you set the
CORRECTION_PORT_EXTENSION_AUTO_FREQUENCY_MODEattribute to User Span. This value is expressed in Hz.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 2 GHz.
- CORRECTION_PORT_EXTENSION_DC_LOSS = 13631529
Specifies the frequency-independent loss to compensate as part of the port extension. This attribute is used only when you set the
CORRECTION_PORT_EXTENSION_ENABLEDattribute to True. This value is expressed in dB.Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port. Use “port::all” to configure same value of DC loss for all VNA ports.
The default value is 0 dB.
- CORRECTION_PORT_EXTENSION_DC_LOSS_ENABLED = 13631528
Specifies whether to compensate for the frequency-independent loss as part of the port extension. This attribute is used only when you set the
CORRECTION_PORT_EXTENSION_ENABLEDattribute to True.Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port. Use “port::all” to configure for all VNA ports.
The default value is False.
Name (Value)
Description
False (0)
The measurement disables the compensation of DC Loss of the port extension.
True (1)
The measurement compensates for the DC loss based on the value of Port Extension DC Loss (dB) specified by you.
- CORRECTION_PORT_EXTENSION_DELAY = 13631527
Specifies the port extension electrical delay. This value is expressed in seconds. This attribute is used only when you set the
CORRECTION_PORT_EXTENSION_ENABLEDattribute to True.Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port. Use “port::all” to configure the same delay value for all VNA ports.
The default value is 0 s.
- CORRECTION_PORT_EXTENSION_DELAY_DOMAIN = 13631583
Specifies whether port extension utilizes delay-based or distance-velocity factor-based definition. This attribute is used only when you set the
CORRECTION_PORT_EXTENSION_ENABLEDattribute to True.Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port. Use “port::all” to configure for all VNA ports.
The default value is Delay.
Name (Value)
Description
Delay (0)
The port extension is specified in terms of its electrical delay.
Distance (1)
The port extension is specified in terms of its physical length.
- CORRECTION_PORT_EXTENSION_DISTANCE = 13631584
Specifies the port extension delay in physical length. This value is expressed in meters by default. The unit can be chosen by setting the
CORRECTION_PORT_EXTENSION_DISTANCE_UNITattribute. This attribute is used only when you set theCORRECTION_PORT_EXTENSION_ENABLEDattribute to True andCORRECTION_PORT_EXTENSION_DELAY_DOMAINattribute to Distance.Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port. Use “port::all” to configure the same distance value for all VNA ports.
The default value is 0 m.
- CORRECTION_PORT_EXTENSION_DISTANCE_UNIT = 13631585
Specifies the unit of the port extension delay in physical length. This attribute is used only when you set the
CORRECTION_PORT_EXTENSION_ENABLEDattribute to True andCORRECTION_PORT_EXTENSION_DELAY_DOMAINattribute to Distance.Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port. Use “port::all” to configure the same distance unit for all VNA ports.
The default value is Meters.
Name (Value)
Description
Meters (0)
The port extension physical length is expressed in meters.
Feet (1)
The port extension physical length is expressed in feet.
Inches (2)
The port extension physical length is expressed in inches.
- CORRECTION_PORT_EXTENSION_ENABLED = 13631526
Specifies whether to enable port extension.
Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port. Use “port::all” to configure for all VNA ports.
The default value is False.
Name (Value)
Description
False (0)
The measurement disables port extension.
True (1)
The measurement enables port extension.
- CORRECTION_PORT_EXTENSION_LOSS1 = 13631579
Specifies the frequency-dependent loss, Loss1 in dB, to compensate as part of port extension.
If the DC loss and one additional frequency loss, Loss1 at the frequency F1 is known, the total loss at frequency f can be approximated by:
L (f) = DC Loss + ((Loss1 - DC Loss) x (f / f1)^0.5)
This attribute is used only when you set the
CORRECTION_PORT_EXTENSION_ENABLEDattribute to True and theCORRECTION_PORT_EXTENSION_LOSS1_ENABLEDattribute is set to True. This value is expressed in dB.Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port. Use “port::all” to configure same value of Loss1 for all VNA ports.
The default value is 0 dB.
- CORRECTION_PORT_EXTENSION_LOSS1_ENABLED = 13631577
Specifies whether to compensate for the frequency-dependent loss, Loss1, as part of the port extension. This attribute is used only when you set the
CORRECTION_PORT_EXTENSION_ENABLEDattribute to True.Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port. Use “port::all” to configure for all VNA ports.
The default value is False.
Name (Value)
Description
False (0)
The measurement disables the compensation of Loss1 of the port extension.
True (1)
The measurement compensates for the Loss1 based on the configured value of Port Extension Loss1 (dB).
- CORRECTION_PORT_EXTENSION_LOSS1_FREQUENCY = 13631578
Specifies the frequency at which Loss1 is applied and compensated. This attribute is used only when the
CORRECTION_PORT_EXTENSION_ENABLEDattribute is set to True and theCORRECTION_PORT_EXTENSION_LOSS1_ENABLEDattribute is set to True. This value is expressed in Hz.Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port. Use “port::all” to configure Loss1 Frequency for all VNA ports.
The default value is 0 Hz.
- CORRECTION_PORT_EXTENSION_LOSS2 = 13631582
Specifies the frequency-dependent loss, Loss2 in dB, to compensate as part of the port extension.
If in addition to the DC loss and frequency-dependent loss at one frequency (Loss1 at the frequency f1), the loss at a second frequency, Loss2 at frequency f2 is also known, the total loss at frequency f can be approximated by:
L (f) = DC Loss + ((Loss1 - DC Loss) x (f / f1)^b)
, where b = log[(abs((Loss1 - DC Loss) / (Loss2 - DC Loss)))] / log(f1 / f2)
This attribute is used only when you set the
CORRECTION_PORT_EXTENSION_ENABLEDattribute to True, theCORRECTION_PORT_EXTENSION_LOSS1_ENABLEDattribute is set to True and theCORRECTION_PORT_EXTENSION_LOSS2_ENABLEDattribute is set to True. This value is expressed in dB.Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port. Use “port::all” to configure same value of Loss2 for all VNA ports.
The default value is 0 dB.
- CORRECTION_PORT_EXTENSION_LOSS2_ENABLED = 13631580
Specifies whether to compensate for the frequency-dependent loss, Loss2, as part of the port extension. This attribute is used only when you set the
CORRECTION_PORT_EXTENSION_ENABLEDattribute to True and theCORRECTION_PORT_EXTENSION_LOSS1_ENABLEDattribute is set to True.Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port. Use “port::all” to configure for all VNA ports.
The default value is False.
Name (Value)
Description
False (0)
The measurement disables the compensation of Loss2 of the port extension.
True (1)
The measurement compensates for the Loss2 based on the configured value of Port Extension Loss2 (dB).
- CORRECTION_PORT_EXTENSION_LOSS2_FREQUENCY = 13631581
Specifies the frequency at which Loss2 is applied and compensated. This attribute is used only when the
CORRECTION_PORT_EXTENSION_ENABLEDattribute is set to True, theCORRECTION_PORT_EXTENSION_LOSS1_ENABLEDattribute is set to True and theCORRECTION_PORT_EXTENSION_LOSS2_ENABLEDattribute is set to True. This value is expressed in Hz.Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port. Use “port::all” to configure Loss2 Frequency for all VNA ports.
The default value is 0 Hz.
- CORRECTION_PORT_EXTENSION_VELOCITY_FACTOR = 13631586
Specifies the speed of light in the port extension medium relative to speed of light in vacuum. Velocity Factor of 1 represents speed of light in vacuum. This attribute is used in conjuction with
CORRECTION_PORT_EXTENSION_DISTANCEattribute to compute electrical delay. This value is unitless. This attribute is used only when you set theCORRECTION_PORT_EXTENSION_ENABLEDattribute to True andCORRECTION_PORT_EXTENSION_DELAY_DOMAINattribute to Distance.Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port. Use “port::all” to configure the same velocity factor for all VNA ports.
The default value is 1.
- CORRECTION_PORT_SUBSET_ENABLED = 13631502
Specifies whether to enable correction for a subset of ports for which calibration data is avaialble in the calset. This attribute is used only when you set the
CORRECTION_ENABLEDattribute to True.Enable this attribute to exclude subset of calset ports from measurement error correction, to achieve faster measurement speed by avoiding extra acquisitions. Use
CORRECTION_PORT_SUBSET_FULL_PORTSandCORRECTION_PORT_SUBSET_RESPONSE_PORTSto specify the list of subset ports to be included in the measurement error correction.The default value is False.
Name (Value)
Description
False (0)
The measurement disables port-subsetting for error correction.
True (1)
The measurement enabes port-subsetting for error correction.
- CORRECTION_PORT_SUBSET_FULL_PORTS = 13631503
Specifies the subset of ports, that are selected for full N-Port correction, where N is the number of ports specified in this attribute. Use comma-separated list of ports to specify multiple ports. The configured measurement is full N-Port corrected if both the measurement receiver and source port are specified using this attribute. The configured measurement is one-path two-port corrected if one of the measurement ports is specified using this attribute and another is specified using
CORRECTION_PORT_SUBSET_RESPONSE_PORTS. Measurements involving the ports outsideCORRECTION_PORT_SUBSET_FULL_PORTSandCORRECTION_PORT_SUBSET_RESPONSE_PORTSreturn error.This attribute is used only when you set the
CORRECTION_ENABLEDattribute to True andCORRECTION_PORT_SUBSET_ENABLEDattribute to True.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is an empty string.
For example, when performing S11 error-corrected measurement for a 1-port DUT using a 2-port VNA and a 2-port calset, VNA generally acquires data by setting the source to port1 first and then to port2. In this case, to achieve faster measurement speed, set this attribute to port1, which lets the VNA acquire data using only source port1 and skips acquiring data with source port2.
- CORRECTION_PORT_SUBSET_RESPONSE_PORTS = 13631609
Specifies the subset of ports, that are selected for one-path two-port error correction. Use comma-separated list of ports to specify multiple ports. The configured measurement is one-path two-port corrected if both measurement ports are specified using this attribute. Alternatively, measurement is also one-path two-port corrected if one of the measurement port is specified using this attribute and another is specified using
CORRECTION_PORT_SUBSET_FULL_PORTS. Measurements involving the ports outside theCORRECTION_PORT_SUBSET_RESPONSE_PORTSandCORRECTION_PORT_SUBSET_FULL_PORTSreturn error.This attribute is used only when you set the
CORRECTION_ENABLEDattribute to True andCORRECTION_PORT_SUBSET_ENABLEDattribute to True.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is an empty string.
For example, when performing S21 error-corrected measurement for a 2-port DUT using a 2-port VNA and a 2-port calset, VNA generally acquires data by setting the source to port1 first and then to port2. To perform S21 one-path two-port error corrected measurement and to achieve faster measurement speed, set this attribute to port1, port2. VNA then acquires data using source port1 and skips acquiring data with source port2.
- CW_FREQUENCY = 13631594
Specifies the frequency at which measurements are performed. This attribute is used only when you set the
SWEEP_TYPEattribute to CW Time. This value is expressed in Hz.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 1 GHz.
- DIGITAL_EDGE_TRIGGER_EDGE = 13631556
Specifies the edge of the digital-signal used to assert a digital edge trigger. This attribute is used only when you set the
TRIGGER_TYPEattribute to Digital Edge.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is Rising Edge.
Name (Value)
Description
Rising Edge (0)
The trigger asserts on the rising edge of the digital-signal.
Falling Edge (1)
The trigger asserts on the falling edge of the digital-signal.
- DIGITAL_EDGE_TRIGGER_SOURCE = 13631555
Specifies the terminal name used as the source for asserting a digital edge trigger. This attribute is used only when you set the
TRIGGER_TYPEattribute to Digital Edge.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default of this attribute is “” (empty string).
- DWELL_TIME = 13631494
Specifies the time for which the analyzer waits before acquiring the signal for each measurement point. Use dwell time when measuring devices with substantial electrical lengths, requiring compensation for the delay between frequency changes at the generator and their observation at the analyzer. This value is expressed in seconds.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 0 s.
- FREQUENCY_LIST = 13631490
Specifies the frequency values for the configured measurements. The frequencies must be in ascending order and must not contain duplicates. This attribute is used only when you set the
SWEEP_TYPEattribute to List. This value is expressed in Hz.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is an empty array.
- GROUND_TERMINATED_PORTS = 13639693
Specifies the selection of ports to be ground terminated in case of SM2 devices. The ports passed to this attribute will be mutually exclusive to the ports passed to the Selected Ports attribute.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
- IF_BANDWIDTH = 13631492
Specifies the digital IF filter bandwidth. This value is expressed in Hz.
NI PXIe-5633 supports the following IF Bandwidths: 1, 2, 3, 5, 7, 10, 20, 30, 50, 70, 100, 200, 300, 500, 700, 1k, 2k, 3k, 5k, 7k, 10k, 20k, 30k, 50k, 70k, 100k, 200k, 300k, 500k, 700k, 1M, 2M, 3M, 5M, 7M, 10M, 15M. If you set IF Bandwidth to an unsupported value, RFmx automatically coerces to the smallest supported IF Bandwidth greater than or equal to the value you set. If you set IF Bandwidth to a value higher than the maximum supported value, RFmx automatically coerces it to maximum supported IF Bandwidth.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 100 kHz.
- INDEX_EVENT_LEVEL = 13631592
Specifies the trigger level for the Index event. This event indicates that the analyzer has completed all acquisitions for the signal.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is Active Low.
For example, when measuring S-Parameters for a DUT with event polarity set to Active Low, the index event polarity remains HIGH until VNA completes all the acquisitions for the DUT and then switches to LOW.
Name (Value)
Description
Active High (0)
Event level is HIGH when analyzer has completed all the acquisitions for the signal.
Active Low (1)
Event level is LOW when analyzer has completed all the acquisitions for the signal.
- INDEX_EVENT_OUTPUT_TERMINAL = 13631590
Specifies the destination terminal name for the Index event. This event indicates that the analyzer has completed all acquisitions for the signal. Use
INDEX_EVENT_LEVELto define the polarity.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default of this attribute is “” (empty string).
- INDEX_EVENT_TERMINAL_NAME = 13631591
Returns the fully qualified signal name as string.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default of this attribute is “” (empty string).
- IQ_ACQUISITION_TIME = 13635597
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
- IQ_MEASUREMENT_ENABLED = 13635594
- IQ_RECEIVER_PORT = 13635599
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
- IQ_RESULTS_CORRECTION_STATE = 13635609
Returns the error correction state of the VNA IQ measurement.
Use “iq<n>” as the selector string to read this attribute.
Name (Value)
Description
None (0)
Error correction is not applied.
Corrected (1)
Error correction is applied without interpolation using the error terms from the calset.
Interpolated (2)
Error correction is applied with error terms for at least one sweep point interpolated from the calset error terms.
Settings Modified (3)
Settings during the measurment differ from those used during calibration.
- IQ_SOURCE_PORT = 13635600
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
- LIMITED_CONFIGURATION_CHANGE = 13639691
Specifies the set of attributes that are considered by NI-RFmx in the locked signal configuration state.
If your test system performs the same measurement repeatedly, enabling this attribute will help achieve faster measurements. When you set this attribute to a value other than Disabled, the RFmx driver will use an optimized code path and skip some checks.
You can also use this attribute to lock a specific instrument configuration for a signal so that every time that you initiate the signal, RFmx applies the RFmxInstr attributes from a locked configuration.
NI recommends you use this attribute in conjunction with named signal configurations. Create named signal configurations for each measurement configuration in your test program and set this attribute to a value other than Disabled for one or more of the named signal configurations. This allows RFmx to precompute the acquisition settings for your measurement configurations and re-use the precomputed settings each time you initiate the measurement. You do not need to use this attribute if you create named signals for all the measurement configurations in your test program during test sequence initialization and do not change any RFInstr or personality attributes while testing each device under test. RFmx automatically optimizes that use case.
Specify the named signal configuration you are setting this attribute in the Selector String input.
The default value is Disabled.
Name (Value)
Description
Disabled (0)
This is the normal mode of RFmx operation. All configuration changes in RFmxInstr attributes or RFmxVNA attributes will be applied during RFmx Commit.
No Change (1)
Signal configuration and RFmxInstr configuration are locked after the first Commit or Initiate of the named signal configuration. Any configuration change thereafter either in RFmxInstr attributes or personality attributes will not be considered by subsequent RFmx Commits or Initiates of this signal. Use No Change if you have created named signal configurations for all measurement configurations but are setting some RFmxInstr attributes. Refer to the Limitations of the Limited Configuration Change Property topic for more details about the limitations of using this mode.
- NUMBER_OF_POINTS = 13631571
Specifies the number of points at which measurements are performed. This attribute is used only when you set the
SWEEP_TYPEattribute to Linear or CW Time.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 201.
- NUMBER_OF_SEGMENTS = 13631489
Specifies the number of sweep segments. This attribute is used only when you set
SWEEP_TYPEattribute to SegmentIf you increase this attribute value from N to N+K, then existing N segments are not affected but K new segments are added. If you reduce number of segments from N to N-K, then last K segments are deleted without affecting the remaining N-K segments.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 1.
- POWER_LEVEL = 13631491
Specifies the power level for the VNA source port. This value is expressed in dBm.
Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port. Use “port::all” to configure same power level for all VNA ports.
The default value is -10 dBm.
- PULSE_ACQUISITION_AUTO = 13631545
Specifies whether, based on
PULSE_MODULATOR_WIDTH, the measurement automatically sets appropriatePULSE_ACQUISITION_DELAYandPULSE_ACQUISITION_WIDTH. This attribute is used only when you setPULSE_MODE_ENABLEDattribute to True.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is True.
Name (Value)
Description
False (0)
The Pulse Acquisition Delay and Pulse Acquisition Width attributes are not automatically set by the measurement. The values that you set for these attributes are used by the measurement.
True (1)
The measurement uses the Pulse Modulator Width attribute to automatically set appropriate values for Pulse Acquisition Delay and Pulse Acquisition Width attributes. Pulse Acquisition Delay is set as the sum of Pulse Modulator Delay and approximately 20% of the Pulse Modulator Width, and Pulse Acquisition Width is set to approximately 75% of the Pulse Modulator Width.
- PULSE_ACQUISITION_DELAY = 13631546
Specifies the delay in the start of the pulse acquisition relative to the pulse trigger. Pulse trigger can be internal or external. When you set
PULSE_TRIGGER_TYPEto None then the VNA creates appropriate periodic pulse triggers internally. This attribute is used only when you setPULSE_MODE_ENABLEDattribute to True andPULSE_ACQUISITION_AUTOattribute to False. This value is expressed in seconds.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 0 s.
- PULSE_ACQUISITION_WIDTH = 13631547
Specifies the acquisition-time per point for pulse measurements. This attribute is used only when you set
PULSE_MODE_ENABLEDattribute to True andPULSE_ACQUISITION_AUTOattribute to False. This value is expressed in seconds.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 0 s.
- PULSE_DIGITAL_EDGE_TRIGGER_SOURCE = 13631540
Specifies the source of the digital edge pulse trigger. This attribute is used only when you set the
PULSE_MODE_ENABLEDattribute to True and set thePULSE_TRIGGER_TYPEattribute to Digital Edge.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default of this attribute is “” (empty string).
- PULSE_GENERATOR_DELAY = 13631552
Specifies the delay between the pulse trigger and digital pulse generated by the selected Pulse Generator. You must set the value of the this attribute such that Delay +
PULSE_GENERATOR_WIDTHattribute does not exceedPULSE_PERIODattribute. This value is expressed in seconds.Use “pulsegen<n>” as the selector string to configure or read this attribute.
The default value is 0 s.
- PULSE_GENERATOR_ENABLED = 13631550
Specifies whether to enable a pulse generator. This attribute is used only when you set
PULSE_MODE_ENABLEDattribute to True.Use “pulsegen<n>” as the selector string to configure or read this attribute.
The default value is False.
Name (Value)
Description
False (0)
Disables the selected pulse generator.
True (1)
Enables the selected pulse generator.
- PULSE_GENERATOR_EXPORT_OUTPUT_TERMINAL = 13631551
Specifies the destination terminal for an exported Pulse Generator. This attribute is used only when you set
PULSE_MODE_ENABLEDattribute to True andPULSE_GENERATOR_ENABLEDattribute to True.Use “pulsegen<n>” as the selector string to configure or read this attribute.
The default value is Do not export signal.
- PULSE_GENERATOR_TERMINAL_NAME = 13631568
Returns the fully qualified signal name as a string.
The standard format of the returned fully qualified signal name is /ModuleName/vna/0/Pulse0Event, where ModuleName is the name of your device in MAX.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
- PULSE_GENERATOR_WIDTH = 13631553
Specifies the pulse width of the selected pulse generator. You must set the values of the
PULSE_GENERATOR_DELAYattribute andPULSE_GENERATOR_WIDTHattribute such that Delay + Width does not exceed the value ofPULSE_PERIODattribute. This value is expressed in seconds.Use “pulsegen<n>” as the selector string to configure or read this attribute.
The default value is 100us.
- PULSE_MODE_ENABLED = 13631537
Specifies whether to use pulsed RF signal as stimulus and/or export pulse generator digital signals.
To perform measurements in pulse mode, start by setting this attribute to True. Next, configure basic pulse attributes like
PULSE_PERIOD,PULSE_MODULATOR_WIDTH.When you set
PULSE_TRIGGER_TYPEto None, where VNA generates a pulse trigger internally. Pulse Trigger is used to control the timing of the RF pulse modulator. Additionally pulse trigger is used as timing reference for all the pulse generator digital signals that you enabled.You can override the internal pulse trigger to an external pulse trigger by setting
PULSE_TRIGGER_TYPEto Digital Edge.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is False.
Name (Value)
Description
False (0)
Disables pulse mode operation. VNA pulse modulator and pulse generators are disabled.
True (1)
Enables pulse mode operation.
- PULSE_MODULATOR_DELAY = 13631543
Specifies the delay between the pulse trigger digital edge and the rising edge of the RF pulse. This attribute is used only when you set
PULSE_MODE_ENABLEDattribute to True. This value is expressed in seconds.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 0 s.
- PULSE_MODULATOR_WIDTH = 13631544
Specifies the Pulse Width of the pulsed RF signal. Pulse is in HIGH state for a duration equal to the Pulse Width, and remains in the LOW state for the rest of the Pulse Period. This attribute is used only when you set
PULSE_MODE_ENABLEDattribute to True. This value is expressed in seconds.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 100 us.
- PULSE_PERIOD = 13631541
Specifies the time interval after which the pulse repeats. This attribute is used only when you set the
PULSE_MODE_ENABLEDattribute to True. If you setPULSE_TRIGGER_TYPEattribute to Digital Edge, pulses are generated only when an external pulse digital edge trigger is received by the VNA. This value is expressed in seconds.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 1 ms.
- PULSE_TRIGGER_TYPE = 13631539
Specifies the pulse trigger type. This attribute is used only when you set the
PULSE_MODE_ENABLEDattribute to True.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is None.
Name (Value)
Description
None (0)
Based on the Pulse Period value that you set, the VNA creates an appropriate periodic pulse trigger internally. Pulse Trigger is used to control the timing of the RF pulse modulator. Additionally pulse trigger is used as timing reference for all the pulse generator digital signals that you enabled.
Digital Edge (1)
Uses an external digital edge trigger as the pulse trigger.
- READY_FOR_TRIGGER_EVENT_LEVEL = 13631589
Specifies the trigger level for the Ready For Trigger event. This event indicates to an external device responsible for sending triggers that the VNA is ready to receive the trigger.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is Active Low.
The
TRIGGER_MODEyou configure determines the number of triggers needed for the VNA to complete the measurement. It also affects how often the ready for trigger event changes polarity. For example, when measuring S11 and S22 using a 2-port VNA withTRIGGER_TYPEset to Digital or Software, and the ready for trigger event polarity set to Active Low, the polarity behavior for variousTRIGGER_MODEwill be as follows: 1.TRIGGER_MODEis Signal: the VNA waits for only one instance of the trigger to be asserted before acquiring all data points. When VNA is ready to receive the trigger, the ready event polarity is LOW and switches to HIGH after a trigger is asserted.2.
TRIGGER_MODEis Sweep: the VNA waits for one instance of the trigger to be asserted before acquiring all data points that share a source port. When VNA is ready to receive the first trigger, the ready event polarity is LOW and switches to HIGH after the first trigger is asserted. The polarity remains HIGH until VNA completes all the acquisitions that require VNA port 1 as the source. When VNA is ready to receive the second trigger, the ready event polarity switches to LOW. Upon assertion of the second trigger, the polarity switches to HIGH.3.
TRIGGER_MODEis Point: the VNA waits for one instance of the trigger to be asserted before acquiring each data point. When VNA is ready to acquire a data point, the ready event polarity is LOW, and switches to HIGH after a trigger is asserted. The polarity remains HIGH until VNA is ready to acquire the next data point.4.
TRIGGER_MODEis Segment with segmented sweep across two frequency segments: the VNA waits for one instance of the trigger to be asserted before acquiring all data points within a segment that share a source port. When VNA is ready to receive the first trigger, the ready event polarity is LOW and switches to HIGH after the first trigger is asserted. The polarity remains HIGH until the VNA completes all the acquisitions for the first segment that require VNA port 1 as the source, and until the VNA is ready to receive the second trigger. When VNA is ready to receive the second trigger, the ready event polarity switches to LOW. Upon assertion of the second trigger, the polarity switches to HIGH. The polarity remains HIGH until VNA completes all the acquisitions for the second segment that require VNA port 1 as the source. The VNA is then ready to receive the second trigger, at which point the ready event polarity switches to LOW. Upon assertion of the second trigger, the polarity switches to HIGH and remains HIGH until the VNA completes all acquisitions for the second segment that require VNA port 1 as the source. The ready event polarity follows the same behavior for the third and fourth trigger instances, which are required to complete all acquisitions for the first and second segments that require VNA port 2 as the source, respectively.Name (Value)
Description
Active High (0)
Event level is HIGH when analyzer is ready to receive trigger.
Active Low (1)
Event level is LOW when analyzer is ready to receive trigger.
- READY_FOR_TRIGGER_EVENT_OUTPUT_TERMINAL = 13631587
Specifies the destination terminal name for the Ready For Trigger event. This event indicates to an external device responsible for sending triggers that the VNA is ready to receive the trigger. Use
READY_FOR_TRIGGER_EVENT_LEVELto define the polarity.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default of this attribute is “” (empty string).
- READY_FOR_TRIGGER_EVENT_TERMINAL_NAME = 13631588
Returns the fully qualified signal name as string.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default of this attribute is “” (empty string).
- RESULT_FETCH_TIMEOUT = 13680640
Specifies the time, in seconds, to wait before results are available. Set this value to a time longer than expected for fetching the measurement. A value of -1 specifies that the RFmxVNA waits until the measurement is complete.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 10.
- SEGMENT_DWELL_TIME = 13631567
Specifies the dwell time for the selected segment. This attribute is used only when you set the
SWEEP_TYPEattribute to Segment andSEGMENT_DWELL_TIME_ENABLEDattribute to True. This value is expressed in seconds.Dwell Time specifies the time for which the analyzer waits before acquiring the signal for each measured frequency point. Use dwell time when measuring devices with substantial electrical lengths, requiring compensation for the delay between frequency changes at the generator and their observation at the analyzer.
Use “segment::<segmentnumber>” as the selector string to configure or read this attribute for a specific segment. Use “segment::all” as the selector string to configure this attribute for all segments.
The default value is 0 s.
- SEGMENT_DWELL_TIME_ENABLED = 13631566
Specifies whether VNA performs measurements using the same dwell time value for all segments or uses different dwell time for each segment. This attribute is used only when you set the
SWEEP_TYPEattribute to Segment.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is False.
Name (Value)
Description
False (0)
All segments are measured with the dwell time that you specify using Dwell Time attribute.
True (1)
The selected segment is measured with the dwell time that you specify using Segment Dwell Time attribute.
- SEGMENT_ENABLED = 13631535
Specifies whether to enable the selected segment for the sweep. This attribute is used only when you set
SWEEP_TYPEattribute to SegmentUse “segment::<segmentnumber>” as the selector string to configure or read this attribute for a specific segment.
The default value is False.
Name (Value)
Description
False (0)
Disables the selected segment.
True (1)
Enables the selected segment.
- SEGMENT_IF_BANDWIDTH = 13631563
Specifies the digital IF filter bandwidth for the selected segment. This attribute is used only when you set the
SWEEP_TYPEattribute to Segment andSEGMENT_IF_BANDWIDTH_ENABLEDattribute to True. This value is expressed in Hz.NI PXIe-5633 supports the following IF Bandwidths: 1, 2, 3, 5, 7, 10, 20, 30, 50, 70, 100, 200, 300, 500, 700, 1k, 2k, 3k, 5k, 7k, 10k, 20k, 30k, 50k, 70k, 100k, 200k, 300k, 500k, 700k, 1M, 2M, 3M, 5M, 7M, 10M, 15M. If you set this attribute to an unsupported value, RFmx automatically coerces to the smallest supported IF Bandwidth greater than or equal to the value you set. If you set IF Bandwidth to a value higher than the maximum supported value, RFmx automatically coerces it to maximum supported IF Bandwidth. Use “segment::<segmentnumber>” as the selector string to configure or read this attribute for a specific segment. Use “segment::all” as the selector string to configure this attribute for all segments.
The default value is 100 kHz.
- SEGMENT_IF_BANDWIDTH_ENABLED = 13631562
Specifies whether VNA performs measurements using the same digital IF filter bandwidth for all segments or uses different digital IF filter bandwidth for each segment. This attribute is used only when you set the
SWEEP_TYPEattribute to Segment.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is False.
Name (Value)
Description
False (0)
All segments are measured with the digital IF filter bandwidth that you specify using IF Bandwidth(Hz) attribute.
True (1)
The selected segment is measured with the digital IF filter bandwidth that you specify using Segment IF Bandwidth(Hz) attribute.
- SEGMENT_NUMBER_OF_FREQUENCY_POINTS = 13631574
Specifies the number of frequency points measured in the selected segment. This attribute is used only when you set the
SWEEP_TYPEattribute to Segment.Use “segment::<segmentnumber>” as the selector string to configure or read this attribute for a specific segment.
The default value is 21.
- SEGMENT_POWER_LEVEL = 13631561
Specifies the source power level for the selected segment. This attribute is used only when you set the
SWEEP_TYPEattribute to Segment andSEGMENT_POWER_LEVEL_ENABLEDattribute to True. This value is expressed in dBm.Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port for segment0. Use “port::all” to configure this attribute for all VNA ports for segment0. Use “segment::<segmentnumber>/port::<portname>” as the selector string to configure or read this attribute for a specific segment and for a specific VNA port. Use “segment::all/port::all” as the selector string to configure this attribute for all segments and for all VNA ports.
The default value is -10 dBm.
- SEGMENT_POWER_LEVEL_ENABLED = 13631560
Specifies whether VNA performs measurements using the same source power level for all segments or uses different source power level for each segment. This attribute is used only when you set the
SWEEP_TYPEattribute to Segment.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is False.
Name (Value)
Description
False (0)
All segments are measured with the source power level that you specify using Power Level attribute.
True (1)
The selected segment is measured with the source power level that you specify using Segment Power Level attribute.
- SEGMENT_START_FREQUENCY = 13631572
Specifies the lowest frequency of the selected segment at which measurements are performed. This attribute is used only when you set the
SWEEP_TYPEattribute to Segment. This value is expressed in Hz.Use “segment::<segmentnumber>” as the selector string to configure or read this attribute for a specific segment.
The default value is 1 GHz.
- SEGMENT_STOP_FREQUENCY = 13631573
Specifies the highest frequency of the selected segment at which measurements are performed. This attribute is used only when you set the
SWEEP_TYPEattribute to Segment. This value is expressed in Hz.Use “segment::<segmentnumber>” as the selector string to configure or read this attribute for a specific segment.
The default value is 2 GHz.
- SEGMENT_TEST_RECEIVER_ATTENUATION = 13631565
Specifies the test receiver attenuation for the selected segment. This attribute is used only when you set the
SWEEP_TYPEattribute to Segment andSEGMENT_TEST_RECEIVER_ATTENUATION_ENABLEDattribute to True. This value is expressed in dB.The receiver that measures the scattered waves traveling away from the DUT port and towards the VNA port is referred to as the Test Receiver. VNA uses Test Receiver Attenuation to attenuate the RF signal before it reaches the downconverting mixer on the path towards the Test Receiver. Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port for segment0. Use “port::all” to configure this attribute for all VNA ports for segment0. Use “segment::<segmentnumber>/port::<portname>” as the selector string to configure or read this attribute for a specific segment and for a specific VNA port. Use “segment::all/port::all” as the selector string to configure this attribute for all segment and for all VNA ports.
The default value is 0 dB.
- SEGMENT_TEST_RECEIVER_ATTENUATION_ENABLED = 13631564
Specifies whether VNA performs measurements using the same test receiver attenuation for all segments or uses different test receiver attenuation for each segment. This attribute is used only when you set the
SWEEP_TYPEattribute to Segment.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is False.
Name (Value)
Description
False (0)
All segments are measured with the test receiver attenuation that you specify using Test Receiver Attenuation attribute.
True (1)
The selected segment is measured with the test receiver attenuation that you specify using Segment Test Receiver Attenuation attribute.
- SOURCE_POWER_MODE = 13639692
Specifies whether to make VNA measurements with source turned off.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is Auto.
Name (Value)
Description
Auto (0)
The source is turned on when making the measurement.
Off (1)
The source is turned off for all the ports when making the measurements.
- SPARAMS_FORMAT = 13635589
Specifies the format of S-Parameter measurement.
Use “sparam<n>” as the selector string to configure or read this attribute.
The default value is Magnitude.
Name (Value)
Description
Magnitude (0)
Sets the format of the selected S-Parameter to Magnitude. You can specify SParams Magnitude Units.
Phase (1)
Sets the format of the selected S-Parameter to Phase. Phase values are expressed in degrees. Phase can be represented in various, mathematically equivalent ways such as phase wrapped between the range [-180, 180) degrees, or phase can be represented in an unwrapped manner. You can specify the phase representation by configuring Sparams Phase Trace Type.
Complex (2)
Sets the format of the selected S-Parameter as complex numbers in cartesian co-ordinates.
SWR (3)
Sets the format of the selected S-Parameter to Standing Wave Ratio (SWR). SWR is a unitless quantity.
Smith Impedance (4)
Sets the format of the selected S-Parameter to Smith Impedance. S-Parameter values are transformed into impedence values. Impedence values are expressed in ohms. You can use these values to plot on a Smith Chart.
Smith Admittance (5)
Sets the format of the selected S-Parameter to Smith Admittance. S-Parameter values are transformed into admittance values. Admittance values are expressed in siemens. You can use these values to plot on an Inverted Smith Chart.
Polar (6)
Sets the format of the selected S-Parameter as complex numbers in polar co-ordinates, where the radial axis (i.e., magnitude of the complex numbers) is always in linear scale and angular axis (phase) is represented in degrees and always wrapped between ±180 deg.
Group Delay (7)
Sets the format of the selected S-Parameter to Group Delay. Group delay represents the time it takes for the signal to pass through a device under test. The delay is expressed in seconds. Group delay vs. frequency is derived from phase vs. frequency response. At a given frequency point, group delay is computed by selecting two nearby frequency points and taking the ratio of the phase difference to the frequency separation between them. The frequency separation between the two selected points is called the group delay aperture. You can control the aperture by first configuring SParams Group Delay Aperture Mode and once the mode is selected, you can set the aperture by configuring SParams Group Delay Aperture Points, SParams Group Delay Aperture Percentage or SParams Group Delay Aperture Frequency Span. For example, if the number of aperture points is equal to 3, then group delay at a nth frequency point is computed by selecting the (n-1)th frequency point and (n+1)th frequency point.
- SPARAMS_GROUP_DELAY_APERTURE_FREQUENCY_SPAN = 13635615
Specifies the group delay aperture in terms of the frequency separation between the two frequency points selected for group delay computation for all S-Parameters for which
SPARAMS_FORMATattribute is set to Group Delay andSPARAMS_GROUP_DELAY_APERTURE_MODEattribute is set to Frequency Span.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 50 MHz.
- SPARAMS_GROUP_DELAY_APERTURE_MODE = 13635612
Specifies the aperture mode to be used for the computation of group delay for all S-Parameters for which
SPARAMS_FORMATattribute is set to Group Delay.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is Points.
Name (Value)
Description
Points (0)
Sets group delay aperture mode to Points. You can specify the aperture in terms of the number of frequency points by configuring SParams Group Delay Aperture Points.
Percentage (1)
Sets group delay aperture mode to Percentage. You can specify the aperture in terms of the frequency separation expressed in percentage by configuring SParams Group Delay Aperture Percentage.
Frequency Span (2)
Sets group delay aperture to Frequency Span. You can specify the aperture in terms of the frequency separation by configuring SParams Group Delay Aperture Frequency Span.
- SPARAMS_GROUP_DELAY_APERTURE_PERCENTAGE = 13635614
Specifies the group delay aperture in terms of the frequency separation between the two frequency points selected for group delay computation, where separation is expressed as a percentage of the total measurement frequency range for all S-Parameters for which
SPARAMS_FORMATattribute is set to Group Delay andSPARAMS_GROUP_DELAY_APERTURE_MODEattribute is set to Percentage.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 5 %.
- SPARAMS_GROUP_DELAY_APERTURE_POINTS = 13635613
Specifies the group delay aperture in terms of the number of frequency points that separates the two frequency points for all S-Parameters for which
SPARAMS_FORMATattribute is set to Group Delay andSPARAMS_GROUP_DELAY_APERTURE_MODEattribute is set to Points. You must set the value of this attribute between 2 and the total number of frequency points in the measurement frequency range.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 11.
- SPARAMS_MAGNITUDE_UNITS = 13635590
Specifies the magnitude units for all S-Parameters for which you set
SPARAMS_FORMATattribute to Magnitude.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is dB.
Name (Value)
Description
dB (0)
Sets S-Parameter magnitude units to dB.
Linear (1)
Sets S-Parameter magnitude units to linear such that S-Parameters are reported in linear scale (V/V).
- SPARAMS_MATH_ACTIVE_MEASUREMENT_MEMORY = 13635611
Specifies the active measurement memory for performing mathematical operations when several measurement memories are associated with the configured S-Parameter. If only one measurement memory is associated with the configured S-Parameter, that measurement memory will be used for mathematical operations.
Use “sparam<n>” as the selector string to configure or read this attribute.
- SPARAMS_MATH_FUNCTION = 13635610
Specifies the mathematical operation between the configured S-Parameter and its active measurement memory. All mathematical operations are applied on complex data before being formatted.
Use “sparam<n>” as the selector string to configure or read this attribute.
The default value is Off.
Name (Value)
Description
Off (0)
No mathematical operation is performed.
Add (1)
Data in measurement memory is added to S-Parameter data.
Subtract (2)
Data in measurement memory is subtracted from S-Parameter data.
Multiply (3)
S-Parameter data is multiplied by the data in measurement memory.
Divide (4)
S-Parameter data is divided by the data in measurement memory.
- SPARAMS_MEASUREMENT_ENABLED = 13635584
Specifies whether to enable the Sparams measurement.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is False.
- SPARAMS_NUMBER_OF_SPARAMETERS = 13635586
Specifies the number of S-Parameters to measure.
Note1: S-Parameters of a N-port DUT can be represented by N^2 canonical S-Parameters viz. S11, S12,…,S1N, S21, S22,…,S2N, SN1, SN2,…,SNN such that B = S A where S denotes the S-Parameter matrix with Sij being the element in the ithrow and jthcolumn. Similarly A denotes the matrix composed of the incident waves. Element Aij denotes the wave parameter aiji.e., wave measured at the reference reciever on port <i> with port <j> as the source. Similarly B denotes the matrix composed of the scatterred waves. Element Bij denotes the wave parameter biji.e., wave measured at the test reciever on port <i> with port <j> as the source.
You can configure each measured S-Parameter in RFmxVNA SParams measurement to be returned in one of several supported formats using
SPARAMS_FORMATattribute. Example1: If you want to fetch magnitude and phase information of S11, then set Number of S-Parameters attribute to 2, then for both SParam indices 0 and 1, set Parameter attribute to “S11”. Then setSPARAMS_FORMATattribute to Magnitude for Sparam index 0 and to Phase for SParam index 1.Note2: You can set many SParam indices to share the same Parameter and Format attribute values making them duplicates of each other.
If you increase this attribute value from N to N+K, then existing N SParams are not affected but K new SParams are added. If you reduce number of SParams from N to N-K, then last K SParams are deleted without affecting the remaining N-K SParams.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 1.
- SPARAMS_PHASE_TRACE_TYPE = 13635591
Specifies the phase type for all S-Parameters for which
SPARAMS_FORMATattribute is set to Phase. Phase can be represented in two mathematically equivalent ways viz. phase wrapped between the range [-180, 180) degrees, and phase can be represented in an unwrapped manner.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is Wrapped.
Name (Value)
Description
Wrapped (0)
The reported S-Parameter phase is wrapped between -180 degress to +180 degrees.
Unwrapped (1)
The reported S-Parameter phase is unwrapped.
- SPARAMS_RECEIVER_PORT = 13635587
Specifies the receiver port name of the S-Parameter. S-Parameter is denoted by “S_<receiver port name>_<source port name>”.
For example, to measure S21, set this attribute to “port2”.
Use “sparam<n>” as the selector string to configure or read this attribute.
The default value is “port1”.
- SPARAMS_RESULTS_CORRECTION_LEVEL = 13635616
Returns the level of error correction applied to the specified S-Parameter measurement.
Use “sparam<n>” as the selector string to read this attribute.
Name (value)
Description
Uncorrected
Correction is not applied to the configured S-Parameter.
N-Port
Full N-Port correction is applied to the configured S-Parameter, where N refers to the number of VNA ports involved in the correction.
1-Path
One Path Two Port correction is applied to the configured transmission measurement. Refer to
CORRECTION_PORT_SUBSET_RESPONSE_PORTSattribute for more information about one-path two-port correction.
- SPARAMS_RESULTS_CORRECTION_STATE = 13635608
Returns the error correction state of the VNA S-Parameter measurement.
Use “sparam<n>” as the selector string to read this attribute.
Name (Value)
Description
None (0)
Error correction is not applied.
Corrected (1)
Error correction is applied without interpolation using the error terms from the calset.
Interpolated (2)
Error correction is applied with error terms for at least one sweep point interpolated from the calset error terms.
Settings Modified (3)
Settings during the measurment differ from those used during calibration.
- SPARAMS_SNP_DATA_FORMAT = 13635603
Specifies the format in which the measured S-parameters are saved in a SnP file.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is Auto.
Name (Value)
Description
Auto (0)
RFmx automatically selects the appropriate SnP Data Format based on the value specified for SParams Format attribute. If you set SParams Format to Complex or SWR or Smith Impedence or Smith Admittance or Group Delay, S-parameters are saved in the Real-Imaginary format. If you set SParams Format to Magnitude, S-parameters are saved as either Log Magnitude-Angle or Linear Magnitude-Angle according to SParams Magnitude Units. If you set SParams Format to Phase or Polar, S-parameters are saved as Linear Magnitude-Angle by default.
Log Magnitude-Angle (1)
All available S-parameters are represented as a pair of columns - first column stores magnitude of a S-Parameter in log scale (dB) and second column stores phase of the S-Parameter in degrees.
Real-Imaginary (2)
All available S-parameters are represented as a pair of columns - first column stores real part of the complex-valued S-Parameter and second column stores imaginary part.
Linear Magnitude-Angle (3)
All available S-parameters are represented as a pair of columns - first column stores magnitude of a S-Parameter in linear scale (V/V) and second column stores phase of the S-Parameter in degrees.
- SPARAMS_SNP_PORTS = 13635605
Specifies the ports for which the measured S-parameters are saved to file.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
- SPARAMS_SNP_USER_COMMENT = 13635604
Specifies a string that is incorporated into saved SnP file. You can specify any arbitrary string to add any meta information that you may want to store along with the measured S-Parameters data in SnP file. RFmx automatically adds a special token(!) at the start of this string such that any standard SnP file parsers would ignore this line. Additionally, multiline comments are allowed and each line is appended with the next line escape character.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
- SPARAMS_SOURCE_PORT = 13635588
Specifies the source port name of the S-Parameter. S-Parameter is denoted by “S_<receiver port name>_<source port name>”.
For example, to measure S21, set this attribute to “port1”.
Use “sparam<n>” as the selector string to configure or read this attribute.
The default value is “port1”.
- START_FREQUENCY = 13631569
Specifies the lowest frequency at which measurements are performed. This attribute is used only when you set the
SWEEP_TYPEattribute to Linear. This value is expressed in Hz.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 1 GHz.
- STOP_FREQUENCY = 13631570
Specifies the highest frequency at which measurements are performed. This attribute is used only when you set the
SWEEP_TYPEattribute to Linear. This value is expressed in Hz.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 2 GHz.
- SWEEP_DELAY = 13631493
Specifies the time for which VNA waits before it starts acquiring data for each sweep. Total delay for acquiring the first point in each sweep is sum of this delay and
DWELL_TIME. This value is expressed in seconds.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 0 s.
- SWEEP_SEQUENCE = 13631533
Specifies the sequence of acquisitions for various frequency points and source ports.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is Standard.
Name (Value)
Description
Standard (0)
Acquisitions for all frequency points are completed with the first source port before moving to the next source port. For example, if there are three frequency points f1, f2 and f3 and two source ports, port1 and port2, then the sweep sequence will be (f1, port1), (f2, port1), (f3, port1), (f1, port2), (f2, port2), (f3, port2).
Point (1)
All acquisitions for a frequency point are completed with all required source ports, before moving to the next frequency point. For example, if there are three frequency points f1, f2 and f3 and two source ports, port1 and port2, then the sweep sequence will be (f1, port1), (f1, port2), (f2, port1), (f2, port2), (f3, port1), (f3, port2).
- SWEEP_TYPE = 13631534
Specifies the sweep type for the measurement.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is List.
Name (Value)
Description
List (0)
The frequency is swept in arbitrary frequency steps.
Linear (1)
The frequency is swept in equidistant steps over the frequency range.
Segment (2)
The frequency is swept in frequency sub-sweeps, called segments. For each segment, you can define independent values for settings like IF bandwidth, dwell time, source power level and test receiver attenuation.
CW Time (4)
The sweep is performed repeatedly on a single frequency and the measurement results are displayed versus time.
- TEST_RECEIVER_ATTENUATION = 13631498
Specifies the attenuation that the VNA uses to attenuate the RF signal before it reaches the downconverting mixer on the path towards the Test Receiver. The receiver that measures the scattered waves traveling away from the DUT port and towards the VNA port is referred to as the Test Receiver. This value is expressed in dB.
Use “port::<portname>” as the selector string to configure or read this attribute for a specific VNA port. Use “port::all” to configure same test receiver attenuation for all VNA ports.
The default value is 0 dB.
- TRIGGER_DELAY = 13631600
Specifies the delay between the instance when the analyzer receives a trigger and the instance when it starts acquiring.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 0 s.
- TRIGGER_MODE = 13631557
Specifies the trigger mode. Trigger Mode decides how many data points are acquired for each asserted trigger.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is Signal.
Name (Value)
Description
Signal (0)
VNA waits for asserting only one instance of trigger before acquiring all data points for the configured measurements in the RFmxVNA Signal namespace. You can specify the RFmxVNA Signal name using Selector Strings attribute.
Sweep (1)
All data points that share a source port are acquired after VNA asserts one instance of the trigger. For example, when you measure S11 and S22 at 10 frequency points using a 2-port VNA, after asserting the first instance of trigger, the device completes all acquisitions that require VNA port 1 as source. Upon asserting the second trigger, the device completes all acquisitions that require VNA port 2 as source.
Point (2)
VNA acquires only one data point for each trigger instance that it asserts. For example, when you measure S11 and S22 at 10 frequency points using a 2-port VNA, the device will assert a total of 20 trigger instances to complete all acquisitions.
Segment (3)
When Sweep Type attribute is set to Segment, all data points within a segment that share a source port are acquired after VNA asserts one instance of the trigger. For example, when measuring S11 and S22 using a 2-port VNA across 2 frequency segments, each containing 4 frequency points, after the first trigger is asserted, the device completes all acquisitions in the first segment that require VNA port 1 as source. Upon asserting the second trigger, the device completes all acquisitions in the second segment that require VNA port 1 as source. On the third trigger, the device completes all acquisitions in the first segment that require VNA port 2 as source. On the fourth trigger, the device completes all acquisitions in the second segment that require VNA port 2 as source. Therefore, a total of 4 triggers are required to complete all acquisitions of both segments for both source ports.
- TRIGGER_TYPE = 13631554
Specifies the trigger type.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is None.
Name (Value)
Description
None (0)
No trigger is configured.
Digital Edge (1)
The trigger is asserted when a digital edge is detected. You can specify the source of the digital edge using the Digital Edge Source attribute.
Software (2)
The trigger is asserted when you send a software trigger. Use RFmxVNA Send Software Edge Trigger method to send a software trigger. RFmx ignores Software Edge Trigger when performing Calibration.
- WAVES_FORMAT = 13639686
Specifies the format for wave measurement.
Use “wave<n>” as the selector string to configure or read this attribute.
Use RFmxVNA Waves Fetch Y Data to fetch the waves.
The default value is Magnitude.
Name (Value)
Description
Magnitude (0)
Sets the format for the selected wave to Magnitude. You can specify Wave Magnitude Units.
Phase (1)
Sets the format of the selected wave to Phase. Phase values are expressed in degrees. Phase can be represented in various, mathematically equivalent ways such as phase wrapped between the range [-180, 180) degrees, or phase can be represented in an unwrapped manner. You can specify the phase representation by configuring Wave Phase Trace Type.
Complex (2)
Sets the format for the selected wave as complex numbers in cartesian co-ordinates.
SWR (3)
Sets the format for the selected wave to Standing Wave Ratio (SWR). SWR is a unitless quantity.
Smith Impedance (4)
Sets the format for the selected wave to Smith Impedance. The measured values of the wave are transformed into impedence values. Impedence values are expressed in ohms. You can use these values to plot on a Smith Chart.
Smith Admittance (5)
Sets the format for the selected wave to Smith Admittance. The measured values of the wave are transformed into admittance values. Admittance values are expressed in siemens. You can use these values to plot on an Inverted Smith Chart.
Polar (6)
Sets the format for the selected wave as complex numbers in polar co-ordinates, where the radial axis (i.e., magnitude of the complex numbers) is always in linear scale and angular axis (phase) is represented in degrees and always wrapped between ±180 deg.
Group Delay (7)
Sets the format of the selected wave to Group Delay. Group delay represents the time it takes for the signal to pass through a device under test. The delay is expressed in seconds. Group delay vs. frequency is derived from phase vs. frequency response. At a given frequency point, group delay is computed by selecting two nearby frequency points and taking the ratio of the phase difference to the frequency separation between them. The frequency separation between the two selected points is called the group delay aperture. You can control the aperture by first configuring Waves Group Delay Aperture Mode and once the mode is selected, you can set the aperture by configuring Waves Group Delay Aperture Points, Waves Group Delay Aperture Percentage or Waves Group Delay Aperture Frequency Span. For example, if the number of aperture points is equal to 3, then group delay at a nth frequency point is computed by selecting the (n-1)th frequency point and (n+1)th frequency point.
- WAVES_GROUP_DELAY_APERTURE_FREQUENCY_SPAN = 13639704
Specifies the group delay aperture in terms of the frequency separation between the two frequency points selected for group delay computation for all waves for which
WAVES_FORMATattribute is set to Group Delay andWAVES_GROUP_DELAY_APERTURE_MODEattribute is set to Frequency Span.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 50 MHz.
- WAVES_GROUP_DELAY_APERTURE_MODE = 13639701
Specifies the aperture mode to be used for the computation of group delay for all waves for which
WAVES_FORMATattribute is set to Group Delay.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is Points.
Name (Value)
Description
Points (0)
Sets group delay aperture mode to Points. You can specify the aperture in terms of the number of frequency points by configuring Waves Group Delay Aperture Points.
Percentage (1)
Sets group delay aperture mode to Percentage. You can specify the aperture in terms of the frequency separation expressed in percentage by configuring Waves Group Delay Aperture Percentage.
Frequency Span (2)
Sets group delay aperture to Frequency Span. You can specify the aperture in terms of the frequency separation by configuring Waves Group Delay Aperture Frequency Span.
- WAVES_GROUP_DELAY_APERTURE_PERCENTAGE = 13639703
Specifies the group delay aperture in terms of the frequency separation between the two frequency points selected for group delay computation, where separation is expressed as a percentage of the total measurement frequency range for all waves for which
WAVES_FORMATattribute is set to Group Delay andWAVES_GROUP_DELAY_APERTURE_MODEattribute is set to Percentage.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 5 %.
- WAVES_GROUP_DELAY_APERTURE_POINTS = 13639702
Specifies the group delay aperture in terms of the number of frequency points that separates the two frequency points for all waves for which
WAVES_FORMATattribute is set to Group Delay andWAVES_GROUP_DELAY_APERTURE_MODEattribute is set to Points. You must set the value of this attribute between 2 and the total number of frequency points in the measurement frequency range.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 11.
- WAVES_MAGNITUDE_UNITS = 13639687
Specifies the magnitude units for all waves for which
WAVES_FORMATattribute is set to Magnitude.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is dBm.
Name (Value)
Description
dBm (0)
Sets wave magnitude units to dBm.
dBmV (1)
Sets wave magnitude units to dBmV.
dBuV (2)
Sets wave magnitude units to dBuV.
dBmA (3)
Sets wave magnitude units to dBmA.
W (4)
Sets wave magnitude units to watts.
V (5)
Sets wave magnitude units to volts.
A (6)
Sets wave magnitude units to ampere.
- WAVES_MEASUREMENT_ENABLED = 13639680
Specifies whether to enable the Waves measurement.
You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is False.
- WAVES_NUMBER_OF_WAVES = 13639682
Specifies the number of waves to be measured.
If you increase this attribute value from N to N+K, then existing N Waves are not affected but K new Waves are added. If you reduce number of Waves from N to N-K, then last K Waves are deleted without affecting the remaining N-K Waves. You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 1.
- WAVES_PHASE_TRACE_TYPE = 13639688
Specifies the phase type for all waves for which
WAVES_FORMATattribute is set to Phase. Phase can be represented in two mathematically equivalent ways viz. phase wrapped between the range [-180, 180) degrees, and phase can be represented in an unwrapped manner.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.
The default value is Wrapped.
Name (Value)
Description
Wrapped (0)
The reported wave phase is wrapped between -180 degress to +180 degrees.
Unwrapped (1)
The reported wave phase is unwrapped.
- WAVES_RECEIVER = 13639683
Specifies whether to measure the wave on the reference receiver or the test receiver of the Wave Receiver Port.
Incident and scattered waves are denoted by “a_<receiver port name>_<source port name>” and “b_<receiver port name>_<source port name>” respectively. On a receiver port, the a and b waves are measured using Reference receiver and Test receiver respectively.
For example, to measure “b21”, set this attribute to Test (0),
WAVES_RECEIVER_PORTto “port2” andWAVES_SOURCE_PORTto “port1”.Use “wave<n>” as the selector string to configure or read this attribute.
The default value is Test.
Name (Value)
Description
Test (0)
Measures the wave on the test receiver.
Reference (1)
Measures the wave on the reference receiver.
- WAVES_RECEIVER_PORT = 13639684
Specifies the receiver port name for wave measurement.
Incident and scattered waves are denoted by “a_<receiver port name>_<source port name>” and “b_<receiver port name>_<source port name>” respectively. On a receiver port, the a and b waves are measured using Reference receiver and Test receiver respectively.
For example, to measure “b21”, set
WAVES_RECEIVERto Test (0), set this attribute to “port2” andWAVES_SOURCE_PORTto “port1”.Use “wave<n>” as the selector string to configure or read this attribute.
The default value is “port1”.
- WAVES_RESULTS_CORRECTION_LEVEL = 13639705
Returns the level of error correction applied to the specified wave measurement.
Use “wave<n>” as the selector string to read this attribute.
Name (value)
Description
Uncorrected
Correction is not applied to the configured wave.
Wave
1-Port correction is applied to the configured Wave.
- WAVES_RESULTS_CORRECTION_STATE = 13639699
Returns the error correction state of the VNA Waves measurement.
Use “wave<n>” as the selector string to read this attribute.
Name (Value)
Description
None (0)
Error correction is not applied.
Corrected (1)
Error correction is applied without interpolation using the error terms from the calset.
Interpolated (2)
Error correction is applied with error terms for at least one sweep point interpolated from the calset error terms.
Settings Modified (3)
Settings during the measurment differ from those used during calibration.
- WAVES_SOURCE_PORT = 13639685
Specifies the source port name for wave measurement.
Incident and scattered waves are denoted by “a_<receiver port name>_<source port name>” and “b_<receiver port name>_<source port name>” respectively. On a receiver port, the a and b waves are measured using Reference receiver and Test receiver respectively.
For example, to measure “b21”, set
WAVES_RECEIVERto Test (0),WAVES_RECEIVER_PORTto “port2” and set this attribute to “port1”.Use “wave<n>” as the selector string to configure or read this attribute.
The default value is “port1”.
- X_AXIS_VALUES = 13631575
Returns an array of frequency values when you perform measurements with
SWEEP_TYPEattribute set to List or Linear or Segment or an array of time values when you perform measurements withSWEEP_TYPEattribute set to CW Time.You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.