"""attributes.py - Contains the ID of all attributes belongs to the module."""
from enum import Enum
[docs]
class AttributeID(Enum):
"""This enum class contains the ID of all attributes belongs to the module."""
TRIGGER_TYPE = 13631554
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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. |
+------------------+--------------------------------------------------------------------------------------------------------------------------+
"""
DIGITAL_EDGE_TRIGGER_SOURCE = 13631555
r"""Specifies the terminal name used as the source for asserting a digital edge trigger. This attribute is used only when
you set the :py:attr:`~nirfmxvna.attributes.AttributeID.TRIGGER_TYPE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default of this attribute is "" (empty string).
"""
DIGITAL_EDGE_TRIGGER_EDGE = 13631556
r"""Specifies the edge of the digital-signal used to assert a digital edge trigger. This attribute is used only when you
set the :py:attr:`~nirfmxvna.attributes.AttributeID.TRIGGER_TYPE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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. |
+------------------+----------------------------------------------------------------+
"""
TRIGGER_MODE = 13631557
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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_DELAY = 13631600
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 0 s.
"""
READY_FOR_TRIGGER_EVENT_OUTPUT_TERMINAL = 13631587
r"""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
:py:attr:`~nirfmxvna.attributes.AttributeID.READY_FOR_TRIGGER_EVENT_LEVEL` to 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default of this attribute is "" (empty string).
"""
READY_FOR_TRIGGER_EVENT_LEVEL = 13631589
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is **Active Low**.
The :py:attr:`~nirfmxvna.attributes.AttributeID.TRIGGER_MODE` you 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 with
:py:attr:`~nirfmxvna.attributes.AttributeID.TRIGGER_TYPE` set to **Digital** or **Software**, and the **ready for
trigger** event polarity set to **Active Low**, the polarity behavior for various
:py:attr:`~nirfmxvna.attributes.AttributeID.TRIGGER_MODE` will be as follows:
1.
:py:attr:`~nirfmxvna.attributes.AttributeID.TRIGGER_MODE` is **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.
:py:attr:`~nirfmxvna.attributes.AttributeID.TRIGGER_MODE` is **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.
:py:attr:`~nirfmxvna.attributes.AttributeID.TRIGGER_MODE` is **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.
:py:attr:`~nirfmxvna.attributes.AttributeID.TRIGGER_MODE` is **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. |
+-----------------+----------------------------------------------------------------+
"""
INDEX_EVENT_OUTPUT_TERMINAL = 13631590
r"""Specifies the destination terminal name for the Index event. This event indicates that the analyzer has completed all
acquisitions for the signal. Use :py:attr:`~nirfmxvna.attributes.AttributeID.INDEX_EVENT_LEVEL` to 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default of this attribute is "" (empty string).
"""
INDEX_EVENT_TERMINAL_NAME = 13631591
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default of this attribute is "" (empty string).
"""
INDEX_EVENT_LEVEL = 13631592
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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. |
+-----------------+--------------------------------------------------------------------------------------+
"""
SWEEP_TYPE = 13631534
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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. |
+--------------+--------------------------------------------------------------------------------------------------------------------------+
"""
FREQUENCY_LIST = 13631490
r"""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
:py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is an empty array.
"""
START_FREQUENCY = 13631569
r"""Specifies the lowest frequency at which measurements are performed. This attribute is used only when you set the
:py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 1 GHz.
"""
STOP_FREQUENCY = 13631570
r"""Specifies the highest frequency at which measurements are performed. This attribute is used only when you set the
:py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 2 GHz.
"""
CW_FREQUENCY = 13631594
r"""Specifies the frequency at which measurements are performed. This attribute is used only when you set the
:py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 1 GHz.
"""
NUMBER_OF_POINTS = 13631571
r"""Specifies the number of points at which measurements are performed. This attribute is used only when you set the
:py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 201.
"""
POWER_LEVEL = 13631491
r"""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.
"""
TEST_RECEIVER_ATTENUATION = 13631498
r"""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.
"""
IF_BANDWIDTH = 13631492
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 100 kHz.
"""
AUTO_IF_BANDWIDTH_SCALING_ENABLED = 13631558
r"""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
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_MODE_ENABLED` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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. |
+--------------+-------------------------------------------------------------------------------------------------------------------+
"""
SWEEP_SEQUENCE = 13631533
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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_DELAY = 13631493
r"""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 :py:attr:`~nirfmxvna.attributes.AttributeID.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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 0 s.
"""
DWELL_TIME = 13631494
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 0 s.
"""
NUMBER_OF_SEGMENTS = 13631489
r"""Specifies the number of sweep segments. This attribute is used only when you set
:py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute to **Segment**
If 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 1.
"""
SEGMENT_ENABLED = 13631535
r"""Specifies whether to enable the selected segment for the sweep. This attribute is used only when you set
:py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute to **Segment**
Use "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_START_FREQUENCY = 13631572
r"""Specifies the lowest frequency of the selected segment at which measurements are performed. This attribute is used only
when you set the :py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute 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
r"""Specifies the highest frequency of the selected segment at which measurements are performed. This attribute is used
only when you set the :py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute 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_NUMBER_OF_FREQUENCY_POINTS = 13631574
r"""Specifies the number of frequency points measured in the selected segment. This attribute is used only when you set
the :py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute 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_ENABLED = 13631560
r"""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
:py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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_POWER_LEVEL = 13631561
r"""Specifies the source power level for the selected segment. This attribute is used only when you set the
:py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute to **Segment** and
:py:attr:`~nirfmxvna.attributes.AttributeID.SEGMENT_POWER_LEVEL_ENABLED` attribute 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_IF_BANDWIDTH_ENABLED = 13631562
r"""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
:py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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_IF_BANDWIDTH = 13631563
r"""Specifies the digital IF filter bandwidth for the selected segment. This attribute is used only when you set the
:py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute to **Segment** and
:py:attr:`~nirfmxvna.attributes.AttributeID.SEGMENT_IF_BANDWIDTH_ENABLED` attribute 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_TEST_RECEIVER_ATTENUATION_ENABLED = 13631564
r"""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
:py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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. |
+--------------+--------------------------------------------------------------------------------------------------------------------------+
"""
SEGMENT_TEST_RECEIVER_ATTENUATION = 13631565
r"""Specifies the test receiver attenuation for the selected segment. This attribute is used only when you set the
:py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute to **Segment** and
:py:attr:`~nirfmxvna.attributes.AttributeID.SEGMENT_TEST_RECEIVER_ATTENUATION_ENABLED` attribute 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_DWELL_TIME_ENABLED = 13631566
r"""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
:py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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_DWELL_TIME = 13631567
r"""Specifies the dwell time for the selected segment. This attribute is used only when you set the
:py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute to **Segment** and
:py:attr:`~nirfmxvna.attributes.AttributeID.SEGMENT_DWELL_TIME_ENABLED` attribute 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.
"""
PULSE_MODE_ENABLED = 13631537
r"""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 :py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_PERIOD`,
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_MODULATOR_WIDTH`.
When you set :py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_TRIGGER_TYPE` to **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
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_TRIGGER_TYPE` 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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_TRIGGER_TYPE = 13631539
r"""Specifies the pulse trigger type. This attribute is used only when you set the
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_MODE_ENABLED` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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. |
+------------------+--------------------------------------------------------------------------------------------------------------------------+
"""
PULSE_DIGITAL_EDGE_TRIGGER_SOURCE = 13631540
r"""Specifies the source of the digital edge pulse trigger. This attribute is used only when you set the
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_MODE_ENABLED` attribute to **True** and set the
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_TRIGGER_TYPE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default of this attribute is "" (empty string).
"""
PULSE_PERIOD = 13631541
r"""Specifies the time interval after which the pulse repeats. This attribute is used only when you set the
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_MODE_ENABLED` attribute to **True**. If you set
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_TRIGGER_TYPE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 1 ms.
"""
PULSE_MODULATOR_DELAY = 13631543
r"""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 :py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_MODE_ENABLED` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 0 s.
"""
PULSE_MODULATOR_WIDTH = 13631544
r"""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
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_MODE_ENABLED` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 100 us.
"""
PULSE_ACQUISITION_AUTO = 13631545
r"""Specifies whether, based on :py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_MODULATOR_WIDTH`, the measurement
automatically sets appropriate :py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_ACQUISITION_DELAY` and
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_ACQUISITION_WIDTH`. This attribute is used only when you set
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_MODE_ENABLED` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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
r"""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 :py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_TRIGGER_TYPE` to **None** then the VNA
creates appropriate periodic pulse triggers internally. This attribute is used only when you set
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_MODE_ENABLED` attribute to **True** and
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_ACQUISITION_AUTO` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 0 s.
"""
PULSE_ACQUISITION_WIDTH = 13631547
r"""Specifies the acquisition-time per point for pulse measurements. This attribute is used only when you set
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_MODE_ENABLED` attribute to **True** and
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_ACQUISITION_AUTO` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 0 s.
"""
PULSE_GENERATOR_ENABLED = 13631550
r"""Specifies whether to enable a pulse generator. This attribute is used only when you set
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_MODE_ENABLED` attribute 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
r"""Specifies the destination terminal for an exported Pulse Generator. This attribute is used only when you set
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_MODE_ENABLED` attribute to **True** and
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_GENERATOR_ENABLED` attribute 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
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
"""
PULSE_GENERATOR_DELAY = 13631552
r"""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 + :py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_GENERATOR_WIDTH`
attribute does not exceed :py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_PERIOD` attribute. 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_WIDTH = 13631553
r"""Specifies the pulse width of the selected pulse generator.
You must set the values of the :py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_GENERATOR_DELAY` attribute and
:py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_GENERATOR_WIDTH` attribute such that Delay + Width does not exceed
the value of :py:attr:`~nirfmxvna.attributes.AttributeID.PULSE_PERIOD` attribute. This value is expressed in seconds.
Use "pulsegen<*n*>" as the selector string to configure or read this attribute.
The default value is 100us.
"""
X_AXIS_VALUES = 13631575
r"""Returns an array of frequency values when you perform measurements with
:py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE` attribute set to **List** or **Linear** or **Segment** or an
array of time values when you perform measurements with :py:attr:`~nirfmxvna.attributes.AttributeID.SWEEP_TYPE`
attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
"""
AVERAGING_ENABLED = 13631495
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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. |
+--------------+--------------------------------------------------------------------------------------------------------------------------+
"""
AVERAGING_COUNT = 13631496
r"""Specifies the number of times each measurement is repeated and averaged-over. This attribute is used only when you set
the :py:attr:`~nirfmxvna.attributes.AttributeID.AVERAGING_ENABLED` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 10.
"""
CORRECTION_ENABLED = 13631499
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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
r"""Specifies whether to enable interpolation of error terms for corrected VNA measurement. This attribute is used only
when you set the :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_ENABLED` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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_SUBSET_ENABLED = 13631502
r"""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 :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_ENABLED` attribute
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
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_SUBSET_FULL_PORTS` and
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_SUBSET_RESPONSE_PORTS` to 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
r"""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 :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_SUBSET_RESPONSE_PORTS`.
Measurements involving the ports outside :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_SUBSET_FULL_PORTS`
and :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_SUBSET_RESPONSE_PORTS` return error.
This attribute is used only when you set the :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_ENABLED`
attribute to **True** and :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_SUBSET_ENABLED` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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
r"""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
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_SUBSET_FULL_PORTS`. Measurements involving the ports
outside the :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_SUBSET_RESPONSE_PORTS` and
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_SUBSET_FULL_PORTS` return error.
This attribute is used only when you set the :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_ENABLED`
attribute to **True** and :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_SUBSET_ENABLED` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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.
"""
CORRECTION_PORT_EXTENSION_ENABLED = 13631526
r"""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_DELAY_DOMAIN = 13631583
r"""Specifies whether port extension utilizes delay-based or distance-velocity factor-based definition. This attribute is
used only when you set the :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_ENABLED` attribute 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_DELAY = 13631527
r"""Specifies the port extension electrical delay. This value is expressed in seconds. This attribute is used only when you
set the :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_ENABLED` attribute 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_DISTANCE = 13631584
r"""Specifies the port extension delay in physical length. This value is expressed in meters by default. The unit can be
chosen by setting the :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_DISTANCE_UNIT` attribute.
This attribute is used only when you set the
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_ENABLED` attribute to **True** and
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_DELAY_DOMAIN` attribute 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
r"""Specifies the unit of the port extension delay in physical length. This attribute is used only when you set the
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_ENABLED` attribute to **True** and
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_DELAY_DOMAIN` attribute 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_VELOCITY_FACTOR = 13631586
r"""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
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_DISTANCE` attribute to compute electrical delay.
This value is unitless. This attribute is used only when you set the
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_ENABLED` attribute to **True** and
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_DELAY_DOMAIN` attribute 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_EXTENSION_DC_LOSS_ENABLED = 13631528
r"""Specifies whether to compensate for the frequency-independent loss as part of the port extension. This attribute is
used only when you set the :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_ENABLED` attribute 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_DC_LOSS = 13631529
r"""Specifies the frequency-independent loss to compensate as part of the port extension. This attribute is used only when
you set the :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_ENABLED` attribute 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_LOSS1_ENABLED = 13631577
r"""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 :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_ENABLED` attribute
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
r"""Specifies the frequency at which Loss1 is applied and compensated. This attribute is used only when the
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_ENABLED` attribute is set to **True** and the
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_LOSS1_ENABLED` attribute 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_LOSS1 = 13631579
r"""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
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_ENABLED` attribute to **True** and the
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_LOSS1_ENABLED` attribute 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_LOSS2_ENABLED = 13631580
r"""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 :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_ENABLED` attribute
to **True** and the :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_LOSS1_ENABLED` attribute 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
r"""Specifies the frequency at which Loss2 is applied and compensated. This attribute is used only when the
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_ENABLED` attribute is set to **True**, the
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_LOSS1_ENABLED` attribute is set to **True** and
the :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_LOSS2_ENABLED` attribute 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_LOSS2 = 13631582
r"""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
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_ENABLED` attribute to **True**, the
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_LOSS1_ENABLED` attribute is set to **True** and
the :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_LOSS2_ENABLED` attribute 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_AUTO_LOSS_ENABLED = 13631610
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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
r"""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
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_AUTO_LOSS_ENABLED` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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_FREQUENCY_MODE = 13631612
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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_START_FREQUENCY = 13631613
r"""Specifies the start frequency of the user span. This attribute is used only when you set the
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_AUTO_FREQUENCY_MODE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 1 GHz.
"""
CORRECTION_PORT_EXTENSION_AUTO_STOP_FREQUENCY = 13631614
r"""Specifies the stop frequency of the user span. This attribute is used only when you set the
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_EXTENSION_AUTO_FREQUENCY_MODE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 2 GHz.
"""
CORRECTION_CALIBRATION_PORTS = 13631504
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is an empty string.
"""
CORRECTION_CALIBRATION_CONNECTOR_TYPE = 13631505
r"""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_CALKIT_TYPE = 13631506
r"""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_CALKIT_ELECTRONIC_RESOURCE_NAME = 13631507
r"""Specifies the resource name of the electronic calibration module (vCal) used for calibration. This attribute is used
only when you set the :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_CALIBRATION_CALKIT_TYPE` attribute to
**Electronic**.
**Supported Electronic Calkit Modules**: NI CAL-5501
Use "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_ELECTRONIC_ORIENTATION = 13631518
r"""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
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_CALIBRATION_PORTS`.
The default value is an empty string.
"""
CORRECTION_CALIBRATION_CALKIT_MECHANICAL_NAME = 13631508
r"""Specifies the name of the mechanical calkit used for calibration. This attribute is used only when you set the
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_CALIBRATION_CALKIT_TYPE` attribute to **Mechanical**.
You must set a valid calkit name. Use :py:meth:`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_METHOD = 13631509
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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_THRU_METHOD = 13631511
r"""Specifies the Thru calibration method when :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_CALIBRATION_METHOD`
attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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_CALIBRATION_THRU_COAX_DELAY = 13631512
r"""Specifies the delay of the Thru mechanical standard when
:py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_CALIBRATION_CALKIT_TYPE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 0 s.
"""
CORRECTION_CALIBRATION_STEP_COUNT = 13631513
r"""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 :py:meth:`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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
"""
CORRECTION_CALIBRATION_STEP_DESCRIPTION = 13631514
r"""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 :py:meth:`calibration_initiate` method
before you query this attribute.
"""
CORRECTION_CALIBRATION_ESTIMATED_THRU_DELAY = 13633536
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
"""
SPARAMS_MEASUREMENT_ENABLED = 13635584
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is **False**.
"""
SPARAMS_NUMBER_OF_SPARAMETERS = 13635586
r"""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 i\ :sup:`th`\ row and j\
:sup:`th`\ column. Similarly **A** denotes the matrix composed of the incident waves. Element Aij denotes the wave
parameter a\ :sub:`ij`\ i.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 b\
:sub:`ij`\ i.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 :py:attr:`~nirfmxvna.attributes.AttributeID.SPARAMS_FORMAT` attribute. 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 set :py:attr:`~nirfmxvna.attributes.AttributeID.SPARAMS_FORMAT`
attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 1.
"""
SPARAMS_RECEIVER_PORT = 13635587
r"""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_SOURCE_PORT = 13635588
r"""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".
"""
SPARAMS_FORMAT = 13635589
r"""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_MAGNITUDE_UNITS = 13635590
r"""Specifies the magnitude units for all S-Parameters for which you set
:py:attr:`~nirfmxvna.attributes.AttributeID.SPARAMS_FORMAT` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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_PHASE_TRACE_TYPE = 13635591
r"""Specifies the phase type for all S-Parameters for which :py:attr:`~nirfmxvna.attributes.AttributeID.SPARAMS_FORMAT`
attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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_GROUP_DELAY_APERTURE_MODE = 13635612
r"""Specifies the aperture mode to be used for the computation of group delay for all S-Parameters for which
:py:attr:`~nirfmxvna.attributes.AttributeID.SPARAMS_FORMAT` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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_POINTS = 13635613
r"""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 :py:attr:`~nirfmxvna.attributes.AttributeID.SPARAMS_FORMAT` attribute is set to **Group
Delay** and :py:attr:`~nirfmxvna.attributes.AttributeID.SPARAMS_GROUP_DELAY_APERTURE_MODE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 11.
"""
SPARAMS_GROUP_DELAY_APERTURE_PERCENTAGE = 13635614
r"""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 :py:attr:`~nirfmxvna.attributes.AttributeID.SPARAMS_FORMAT` attribute is set to **Group Delay**
and :py:attr:`~nirfmxvna.attributes.AttributeID.SPARAMS_GROUP_DELAY_APERTURE_MODE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 5 %.
"""
SPARAMS_GROUP_DELAY_APERTURE_FREQUENCY_SPAN = 13635615
r"""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 :py:attr:`~nirfmxvna.attributes.AttributeID.SPARAMS_FORMAT`
attribute is set to **Group Delay** and :py:attr:`~nirfmxvna.attributes.AttributeID.SPARAMS_GROUP_DELAY_APERTURE_MODE`
attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 50 MHz.
"""
SPARAMS_MATH_FUNCTION = 13635610
r"""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_MATH_ACTIVE_MEASUREMENT_MEMORY = 13635611
r"""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_RESULTS_CORRECTION_STATE = 13635608
r"""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_RESULTS_CORRECTION_LEVEL = 13635616
r"""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 |
| | :py:attr:`~nirfmxvna.attributes.AttributeID.CORRECTION_PORT_SUBSET_RESPONSE_PORTS` attribute for more information about |
| | one-path two-port correction. |
+--------------+--------------------------------------------------------------------------------------------------------------------------+
"""
SPARAMS_SNP_DATA_FORMAT = 13635603
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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_USER_COMMENT = 13635604
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
"""
SPARAMS_SNP_PORTS = 13635605
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
"""
WAVES_MEASUREMENT_ENABLED = 13639680
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is **False**.
"""
WAVES_NUMBER_OF_WAVES = 13639682
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 1.
"""
WAVES_RECEIVER = 13639683
r"""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)**,
:py:attr:`~nirfmxvna.attributes.AttributeID.WAVES_RECEIVER_PORT` to "port2" and
:py:attr:`~nirfmxvna.attributes.AttributeID.WAVES_SOURCE_PORT` to "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
r"""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 :py:attr:`~nirfmxvna.attributes.AttributeID.WAVES_RECEIVER` to **Test (0)**,
set this attribute to "port2" and :py:attr:`~nirfmxvna.attributes.AttributeID.WAVES_SOURCE_PORT` to "port1".
Use "wave<*n*>" as the selector string to configure or read this attribute.
The default value is "port1".
"""
WAVES_SOURCE_PORT = 13639685
r"""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 :py:attr:`~nirfmxvna.attributes.AttributeID.WAVES_RECEIVER` to **Test (0)**,
:py:attr:`~nirfmxvna.attributes.AttributeID.WAVES_RECEIVER_PORT` to "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".
"""
WAVES_FORMAT = 13639686
r"""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_MAGNITUDE_UNITS = 13639687
r"""Specifies the magnitude units for all waves for which :py:attr:`~nirfmxvna.attributes.AttributeID.WAVES_FORMAT`
attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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_PHASE_TRACE_TYPE = 13639688
r"""Specifies the phase type for all waves for which :py:attr:`~nirfmxvna.attributes.AttributeID.WAVES_FORMAT` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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_GROUP_DELAY_APERTURE_MODE = 13639701
r"""Specifies the aperture mode to be used for the computation of group delay for all waves for which
:py:attr:`~nirfmxvna.attributes.AttributeID.WAVES_FORMAT` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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_POINTS = 13639702
r"""Specifies the group delay aperture in terms of the number of frequency points that separates the two frequency points
for all waves for which :py:attr:`~nirfmxvna.attributes.AttributeID.WAVES_FORMAT` attribute is set to **Group Delay**
and :py:attr:`~nirfmxvna.attributes.AttributeID.WAVES_GROUP_DELAY_APERTURE_MODE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 11.
"""
WAVES_GROUP_DELAY_APERTURE_PERCENTAGE = 13639703
r"""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 :py:attr:`~nirfmxvna.attributes.AttributeID.WAVES_FORMAT` attribute is set to **Group Delay** and
:py:attr:`~nirfmxvna.attributes.AttributeID.WAVES_GROUP_DELAY_APERTURE_MODE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 5 %.
"""
WAVES_GROUP_DELAY_APERTURE_FREQUENCY_SPAN = 13639704
r"""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 :py:attr:`~nirfmxvna.attributes.AttributeID.WAVES_FORMAT` attribute is
set to **Group Delay** and :py:attr:`~nirfmxvna.attributes.AttributeID.WAVES_GROUP_DELAY_APERTURE_MODE` attribute 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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 50 MHz.
"""
WAVES_RESULTS_CORRECTION_STATE = 13639699
r"""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_RESULTS_CORRECTION_LEVEL = 13639705
r"""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. |
+--------------+------------------------------------------------------+
"""
IQ_MEASUREMENT_ENABLED = 13635594
r"""
"""
IQ_ACQUISITION_TIME = 13635597
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for information
about the string syntax for named signals.
"""
IQ_RECEIVER_PORT = 13635599
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for information
about the string syntax for named signals.
"""
IQ_SOURCE_PORT = 13635600
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for information
about the string syntax for named signals.
"""
IQ_RESULTS_CORRECTION_STATE = 13635609
r"""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. |
+-----------------------+---------------------------------------------------------------------------------------------------------------------+
"""
LIMITED_CONFIGURATION_CHANGE = 13639691
r"""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
<https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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. |
+---------------+--------------------------------------------------------------------------------------------------------------------------+
"""
SOURCE_POWER_MODE = 13639692
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ 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. |
+--------------+--------------------------------------------------------------------------+
"""
GROUND_TERMINATED_PORTS = 13639693
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
"""
RESULT_FETCH_TIMEOUT = 13680640
r"""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 <https://www.ni.com/docs/en-US/bundle/rfmx/page/selector-strings-net.html>`_ topic for
information about the string syntax for named signals.
The default value is 10.
"""