"""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."""
SELECTED_PORTS = 2109437
r"""Specifies the instrument port to be configured to acquire a signal. Use
:py:meth:`nirfmxinstr.session.Session.get_available_ports` method to get the valid port names.
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.
**Valid values**
+----------------+--------------------------------------------------------------------------------------------------------------------------+
| Name (value) | Description |
+================+==========================================================================================================================+
| PXIe-5830 | if0, if1 |
+----------------+--------------------------------------------------------------------------------------------------------------------------+
| PXIe-5831/5832 | if0, if1, rf<0-1>/port<x>, where 0-1 indicates one (0) or two (1) mmRH-5582 connections and x is the port number on the |
| | mmRH-5582 front panel |
+----------------+--------------------------------------------------------------------------------------------------------------------------+
| Other devices | "" (empty string) |
+----------------+--------------------------------------------------------------------------------------------------------------------------+
**Default values**
+---------------------+-------------------+
| Name (value) | Description |
+=====================+===================+
| PXIe-5830/5831/5832 | if1 |
+---------------------+-------------------+
| Other devices | "" (empty string) |
+---------------------+-------------------+
"""
CENTER_FREQUENCY = 2105345
r"""Specifies the carrier frequency of the RF signal that needs to be acquired. This value is expressed in Hz. The signal
analyzer tunes to this frequency.
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 hardware dependent.
"""
REFERENCE_LEVEL = 2105347
r"""Specifies the reference level which represents the maximum expected power of the RF input signal. This value is
expressed in dBm for RF devices and V\ :sub:`pk-pk`\ for baseband devices.
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 hardware dependent.
"""
EXTERNAL_ATTENUATION = 2105346
r"""Specifies the attenuation of a switch (or cable) connected to the RF IN connector of the signal analyzer. For more
information about attenuation, refer to the *Attenuation and Signal Levels* topic for your device in the *NI RF Vector
Signal Analyzers Help*. This value is expressed in dB.
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.
"""
REFERENCE_LEVEL_HEADROOM = 2109436
r"""Specifies the margin RFmx adds to the :py:attr:`~nirfmxdemod.attributes.AttributeID.REFERENCE_LEVEL` attribute. The
margin avoids clipping and overflow warnings if the input signal exceeds the configured reference level.
RFmx configures the input gain to avoid clipping and associated overflow warnings provided the instantaneous
power of the input signal remains within the Reference Level plus the Reference Level Headroom. If you know the input
power of the signal precisely or previously included the margin in the Reference Level, you could improve the
signal-to-noise ratio by reducing the Reference Level Headroom.
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.
**Supported devices: **PXIe-5668, PXIe-5830/5831/5832/5840/5841/5842/5860.
**Default values**
+------------------------------------+-------------+
| Name (value) | Description |
+====================================+=============+
| PXIe-5668 | 6 dB |
+------------------------------------+-------------+
| PXIe-5830/5831/5832/5841/5842/5860 | 1 dB |
+------------------------------------+-------------+
| PXIe-5840 | 0 dB |
+------------------------------------+-------------+
"""
TRIGGER_TYPE = 2105348
r"""Specifies the type of Reference Trigger to use for signal acquisition.
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 reference trigger is used for signal acquisition. |
+-------------------+--------------------------------------------------------------------------------------------------------------------------+
| Digital Edge (1) | A digital-edge trigger is used for signal acquisition. The source of the digital edge is specified using the Digital |
| | Edge Source attribute. |
+-------------------+--------------------------------------------------------------------------------------------------------------------------+
| IQ Power Edge (2) | An I/Q power-edge trigger is used for signal acquisition, which is configured using the IQ Power Edge Slope attribute. |
+-------------------+--------------------------------------------------------------------------------------------------------------------------+
| Software (3) | A software trigger is used for signal acquisition. |
+-------------------+--------------------------------------------------------------------------------------------------------------------------+
"""
DIGITAL_EDGE_TRIGGER_SOURCE = 2105349
r"""Specifies the source terminal for the digital-edge trigger. This attribute is applicable only when you set the
:py:attr:`~nirfmxdemod.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 hardware dependent.
"""
DIGITAL_EDGE_TRIGGER_EDGE = 2105350
r"""Specifies whether the signal analyzer detects a rising or falling edge on the digital-edge trigger signal. This
attribute is applicable only when you set the :py:attr:`~nirfmxdemod.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 signal. |
+------------------+--------------------------------------------------------+
| Falling Edge (1) | The trigger asserts on the falling edge of the signal. |
+------------------+--------------------------------------------------------+
"""
IQ_POWER_EDGE_TRIGGER_SOURCE = 2105351
r"""Specifies the channel from which the device monitors the trigger. This attribute is applicable only when you set the
:py:attr:`~nirfmxdemod.attributes.AttributeID.TRIGGER_TYPE` attribute to **IQ Power 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 hardware dependent.
"""
IQ_POWER_EDGE_TRIGGER_LEVEL = 2105352
r"""Specifies the power level at which the device triggers. This value is expressed in dB when you set the
:py:attr:`~nirfmxdemod.attributes.AttributeID.IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE` attribute to **Relative** and in dBm
when you set the IQ Power Edge Level Type attribute to **Absolute**. The device asserts the trigger when the signal
exceeds the level specified by the value of this attribute, taking into consideration the specified slope. This
attribute is used only when you set the :py:attr:`~nirfmxdemod.attributes.AttributeID.TRIGGER_TYPE` attribute to **IQ
Power 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 hardware dependent.
"""
IQ_POWER_EDGE_TRIGGER_LEVEL_TYPE = 2109439
r"""Specifies the reference for the :py:attr:`~nirfmxdemod.attributes.AttributeID.IQ_POWER_EDGE_TRIGGER_LEVEL` attribute.
This attribute is used only when you set the :py:attr:`~nirfmxdemod.attributes.AttributeID.TRIGGER_TYPE` attribute to
**IQ Power 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 **Absolute**.
+--------------+-----------------------------------------------------------------------------------------------------------+
| Name (Value) | Description |
+==============+===========================================================================================================+
| Relative (0) | The value of the IQ Power Edge Level attribute is relative to the value of the Reference Level attribute. |
+--------------+-----------------------------------------------------------------------------------------------------------+
| Absolute (1) | The IQ Power Edge Level attribute specifies the absolute power. |
+--------------+-----------------------------------------------------------------------------------------------------------+
"""
IQ_POWER_EDGE_TRIGGER_SLOPE = 2105353
r"""Specifies whether the device asserts the trigger when the signal power is rising or falling. The device asserts the
trigger when the signal power exceeds the specified level with the slope you specify. This attribute is used only when
you set the :py:attr:`~nirfmxdemod.attributes.AttributeID.TRIGGER_TYPE` attribute to **IQ Power 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 Slope**.
+-------------------+-------------------------------------------------------+
| Name (Value) | Description |
+===================+=======================================================+
| Rising Slope (0) | The trigger asserts when the signal power is rising. |
+-------------------+-------------------------------------------------------+
| Falling Slope (1) | The trigger asserts when the signal power is falling. |
+-------------------+-------------------------------------------------------+
"""
TRIGGER_DELAY = 2105354
r"""Specifies the trigger delay time. This value is expressed in seconds.
If the delay is negative, the measurement acquires pretrigger samples. If the delay is positive, the
measurement acquires post-trigger samples.
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 seconds.
"""
TRIGGER_MINIMUM_QUIET_TIME_MODE = 2105355
r"""Specifies whether the measurement computes the minimum quiet time used for triggering.
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 **Manual**.
+--------------+---------------------------------------------------------------------------------------------+
| Name (Value) | Description |
+==============+=============================================================================================+
| Manual (0) | The minimum quiet time for triggering is the value of the Trigger Min Quiet Time attribute. |
+--------------+---------------------------------------------------------------------------------------------+
| Auto (1) | The measurement computes the minimum quiet time used for triggering. |
+--------------+---------------------------------------------------------------------------------------------+
"""
TRIGGER_MINIMUM_QUIET_TIME_DURATION = 2105356
r"""Specifies the time duration for which the signal must be quiet before the signal analyzer arms the I/Q power edge
trigger. If you set the :py:attr:`~nirfmxdemod.attributes.AttributeID.TRIGGER_TYPE` attribute to **Rising Slope**, the
signal is quiet below the trigger level. If you set the IQ Power Edge Slope attribute to **Falling Slope**, the signal
is quiet above the trigger level. 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 of this attribute is hardware dependent.
"""
ADEMOD_MEASUREMENT_ENABLED = 2097209
r"""Specifies whether to enable analog demodulation measurements.
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.
"""
ADEMOD_AUDIO_MEASUREMENT_ENABLED = 2097216
r"""Specifies whether to enable the audio signal measurements, such as SINAD, SNR, THD and THD+Noise.
The default value is **True**.
+--------------+----------------------------------+
| Name (Value) | Description |
+==============+==================================+
| False (0) | Disables the audio measurements. |
+--------------+----------------------------------+
| True (1) | Enables the audio measurements. |
+--------------+----------------------------------+
"""
ADEMOD_MODULATION_TYPE = 2097166
r"""Specifies the analog modulation type of the signal that needs to be analyzed.
The default value is **AM**.
+--------------+---------------------------------------------------+
| Name (Value) | Description |
+==============+===================================================+
| AM (0) | The signal to be analyzed is amplitude modulated. |
+--------------+---------------------------------------------------+
| FM (1) | The signal to be analyzed is frequency modulated. |
+--------------+---------------------------------------------------+
| PM (2) | The signal to be analyzed is phase modulated. |
+--------------+---------------------------------------------------+
"""
ADEMOD_AM_CARRIER_SUPPRESSED = 2097154
r"""Specifies whether the carrier of the AM (amplitude modulated) signal is absent.
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 carrier of the AM signal is present. |
+--------------+------------------------------------------+
| True (1) | The carrier of the AM signal is absent. |
+--------------+------------------------------------------+
"""
ADEMOD_RBW_FILTER_TYPE = 2097168
r"""Specifies the shape of the digital RBW filter.
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 **Flat**.
+---------------------+------------------------------------------------------------------------------------------------------+
| Name (Value) | Description |
+=====================+======================================================================================================+
| None (0) | RBW filter is not applied on the acquired signal. |
+---------------------+------------------------------------------------------------------------------------------------------+
| Gaussian (1) | RBW filter has a Gaussian response. |
+---------------------+------------------------------------------------------------------------------------------------------+
| Flat (2) | RBW filter has a Flat response. |
+---------------------+------------------------------------------------------------------------------------------------------+
| Synch Tuned - 4 (3) | RBW filter has a response of a 4-pole synchronously-tuned filter. |
+---------------------+------------------------------------------------------------------------------------------------------+
| Synch Tuned - 5 (4) | RBW filter has a response of a 5-pole synchronously-tuned filter. |
+---------------------+------------------------------------------------------------------------------------------------------+
| RRC (5) | RRC |
| | filter with roll-off specified by the ADemod RBW RRC Alpha attribute is used as the RBW filter. |
+---------------------+------------------------------------------------------------------------------------------------------+
"""
ADEMOD_RBW_FILTER_BANDWIDTH = 2097169
r"""Specifies the bandwidth of the resolution bandwidth (RBW) filter to be applied to the acquired signal. 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 100 kHz.
"""
ADEMOD_RBW_FILTER_ALPHA = 2097170
r"""Specifies the roll-off factor of the root-raised cosine (RRC) filter.
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.1.
"""
ADEMOD_MEASUREMENT_INTERVAL = 2097165
r"""Specifies the signal acquisition time for the analog demodulation measurement. 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 10 ms.
"""
ADEMOD_CARRIER_CORRECTION_FREQUENCY_ENABLED = 2097162
r"""Specifies whether to correct the frequency error in the carrier when demodulating frequency-modulated (FM) or
phase-modulated (PM) signals.
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) | Does not correct the carrier frequency error. |
+--------------+-----------------------------------------------+
| True (1) | Corrects the carrier frequency error. |
+--------------+-----------------------------------------------+
"""
ADEMOD_CARRIER_CORRECTION_PHASE_ENABLED = 2097163
r"""Specifies whether to correct the carrier phase error when demodulating phase-modulated signals.
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) | Does not correct the carrier phase error. |
+--------------+-------------------------------------------+
| True (1) | Corrects the carrier phase error. |
+--------------+-------------------------------------------+
"""
ADEMOD_FM_DE_EMPHASIS = 2097164
r"""Specifies the time constant of de-emphasis filter, which compensates for the pre-emphasis filter in the FM transmitter.
This value is expressed in seconds.
The lowpass characteristic transfer function of the de-emphasis filter is as shown in the following equation:
*H*(*f*) = 1/(1+*j*(2*pi**f**τ)
where τ is the de-emphasis filter time constant. 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 seconds. No filter is applied on the demodulated signal when de-emphasis is set to 0.
"""
ADEMOD_AUDIO_FILTER_TYPE = 2097155
r"""Specifies the audio filter to be applied on the analog demodulated 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 **None**.
+-----------------+--------------------------------------------------------------------------------------------------------------------------+
| Name (Value) | Description |
+=================+==========================================================================================================================+
| None (0) | Does not use any audio filter. |
+-----------------+--------------------------------------------------------------------------------------------------------------------------+
| Custom (1) | Uses the filter specified by the Ademod Audio Filter Lower Cutoff attribute and the Ademod Audio Filter Upper Cutoff |
| | attribute. |
+-----------------+--------------------------------------------------------------------------------------------------------------------------+
| A - Weight (2) | Uses an A-weighted filter. |
+-----------------+--------------------------------------------------------------------------------------------------------------------------+
| B - Weight (3) | Uses a B-weighted filter. |
+-----------------+--------------------------------------------------------------------------------------------------------------------------+
| C - Weight (4) | Uses a C-weighted filter. |
+-----------------+--------------------------------------------------------------------------------------------------------------------------+
| CCITT (5) | Uses the filter specified by CCITT. |
+-----------------+--------------------------------------------------------------------------------------------------------------------------+
| ITU-R 468-4 (6) | Uses the filter specified by ITU-R 468-4. |
+-----------------+--------------------------------------------------------------------------------------------------------------------------+
"""
ADEMOD_AUDIO_FILTER_LOWER_CUTOFF_FREQUENCY = 2097156
r"""Specifies the lower cutoff frequency of the custom audio filter. This attribute is applicable only when you set the
:py:attr:`~nirfmxdemod.attributes.AttributeID.ADEMOD_AUDIO_FILTER_TYPE` attribute to **Custom**. 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 100.
"""
ADEMOD_AUDIO_FILTER_UPPER_CUTOFF_FREQUENCY = 2097157
r"""Specifies the upper cutoff frequency of the custom audio filter. This attribute is applicable only when you set the
:py:attr:`~nirfmxdemod.attributes.AttributeID.ADEMOD_AUDIO_FILTER_TYPE` attribute to **Custom**. 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 10,000.
"""
ADEMOD_AVERAGING_ENABLED = 2097158
r"""Specifies whether to enable averaging for the analog demodulation 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 is performed on a single acquisition. |
+--------------+--------------------------------------------------------------------------------------------------------------------------+
| True (1) | The analog demodulation measurement uses the ADemod Averaging Count attribute to calculate the number of acquisitions |
| | over which the measurement is averaged. Traces are not averaged. |
+--------------+--------------------------------------------------------------------------------------------------------------------------+
"""
ADEMOD_AVERAGING_COUNT = 2097159
r"""Specifies the number of acquisitions used for averaging when you set the
:py:attr:`~nirfmxdemod.attributes.AttributeID.ADEMOD_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.
"""
ADEMOD_AVERAGING_TYPE = 2097161
r"""Specifies the averaging 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 **Linear**.
+--------------+---------------------------------------------------------------------------------+
| Name (Value) | Description |
+==============+=================================================================================+
| Linear (0) | The averaged result is the mean value measured across multiple acquisitions. |
+--------------+---------------------------------------------------------------------------------+
| Max (1) | The averaged result is the maximum value measured across multiple acquisitions. |
+--------------+---------------------------------------------------------------------------------+
| Min (2) | The averaged result is the minimum value measured across multiple acquisitions. |
+--------------+---------------------------------------------------------------------------------+
"""
ADEMOD_ALL_TRACES_ENABLED = 2097171
r"""Specifies whether to enable the traces to be stored and retrieved after performing the analog demodulation 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.
"""
ADEMOD_RESULTS_MEAN_CARRIER_FREQUENCY_ERROR = 2097172
r"""Returns the mean of the measured carrier frequency offset. 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.
"""
ADEMOD_RESULTS_MEAN_CARRIER_POWER = 2097173
r"""Returns the mean of the measured carrier power. This value is expressed in dBm.
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.
"""
ADEMOD_RESULTS_MEAN_MODULATION_FREQUENCY = 2097174
r"""Returns the mean of the demodulated signal frequency. 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.
"""
ADEMOD_RESULTS_AVERAGE_SINAD = 2097175
r"""Returns the averaged signal-to-noise and distortion ratio of the demodulated signal. This value is expressed in dB.
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.
"""
ADEMOD_RESULTS_AVERAGE_THD_WITH_NOISE = 2097176
r"""Returns the averaged total harmonic distortion with noise of the demodulated signal, as a 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.
"""
ADEMOD_RESULTS_AVERAGE_THD = 2097177
r"""Returns the averaged total harmonic distortion of the demodulated signal, as a 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.
"""
ADEMOD_RESULTS_AVERAGE_SNR = 2097178
r"""Returns the averaged signal-to-noise ratio of the demodulated signal. This value is expressed in dB.
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.
"""
ADEMOD_RESULTS_AM_MODULATION_DEPTH_MEAN_STANDARD_DEVIATION = 2097179
r"""Returns the mean amplitude variation around the unmodulated carrier amplitude, as a percentage. If the carrier is
suppressed, the amplitude variation of the modulating signal is returned.
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.
"""
ADEMOD_RESULTS_AM_MODULATION_DEPTH_MEAN_HALF_PEAK_TO_PEAK = 2097180
r"""Returns the mean (peak-to-peak)/2 amplitude of the modulating signal, as a 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.
"""
ADEMOD_RESULTS_AM_MODULATION_DEPTH_MEAN_POSITIVE_PEAK = 2097181
r"""Returns the mean positive peak amplitude of the modulating signal, as a 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.
"""
ADEMOD_RESULTS_AM_MODULATION_DEPTH_MEAN_NEGATIVE_PEAK = 2097182
r"""Returns the mean negative peak amplitude of the modulating signal, as a 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.
"""
ADEMOD_RESULTS_AM_MODULATION_DEPTH_MEAN_RMS = 2097183
r"""Returns the mean RMS amplitude of the modulating signal, as a 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.
"""
ADEMOD_RESULTS_AM_MODULATION_DEPTH_MAXIMUM_STANDARD_DEVIATION = 2097184
r"""Returns the maximum modulation depth measured across multiple acquisitions, as a 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.
"""
ADEMOD_RESULTS_AM_MODULATION_DEPTH_MAXIMUM_HALF_PEAK_TO_PEAK = 2097185
r"""Returns the maximum (peak-to-peak)/2 amplitude of the modulating signal measured across multiple acquisitions, as a
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.
"""
ADEMOD_RESULTS_AM_MODULATION_DEPTH_MAXIMUM_POSITIVE_PEAK = 2097186
r"""Returns the maximum positive peak amplitude of the modulating signal measured across multiple acquisitions, as a
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.
"""
ADEMOD_RESULTS_AM_MODULATION_DEPTH_MAXIMUM_NEGATIVE_PEAK = 2097187
r"""Returns the maximum negative peak amplitude of the modulating signal measured across multiple acquisitions, as a
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.
"""
ADEMOD_RESULTS_AM_MODULATION_DEPTH_MAXIMUM_RMS = 2097188
r"""Returns the maximum RMS amplitude of the modulating signal measured across multiple acquisitions, as a 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.
"""
ADEMOD_RESULTS_FM_DEVIATION_MEAN_STANDARD_DEVIATION = 2097189
r"""Returns the mean frequency deviation around the nominal frequency of the FM carrier. 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.
"""
ADEMOD_RESULTS_FM_DEVIATION_MEAN_HALF_PEAK_TO_PEAK = 2097190
r"""Returns the mean (peak-to-peak)/2 frequency variation around the nominal frequency of the FM carrier. 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.
"""
ADEMOD_RESULTS_FM_DEVIATION_MEAN_POSITIVE_PEAK = 2097191
r"""Returns the mean positive peak frequency deviation of the frequency-modulated signal. 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.
"""
ADEMOD_RESULTS_FM_DEVIATION_MEAN_NEGATIVE_PEAK = 2097192
r"""Returns the mean negative peak frequency deviation of the frequency-modulated signal. 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.
"""
ADEMOD_RESULTS_FM_DEVIATION_MEAN_RMS = 2097193
r"""Returns the mean RMS frequency deviation of the frequency-modulated signal. 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.
"""
ADEMOD_RESULTS_FM_DEVIATION_MAXIMUM_STANDARD_DEVIATION = 2097194
r"""Returns the maximum frequency deviation of the frequency-modulated signal measured across multiple acquisitions. 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.
"""
ADEMOD_RESULTS_FM_DEVIATION_MAXIMUM_HALF_PEAK_TO_PEAK = 2097195
r"""Returns the maximum (peak-to-peak)/2 frequency variation around the nominal frequency of the FM carrier measured across
multiple acquisitions. 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.
"""
ADEMOD_RESULTS_FM_DEVIATION_MAXIMUM_POSITIVE_PEAK = 2097196
r"""Returns the maximum positive peak frequency deviation of the frequency-modulated signal measured across multiple
acquisitions. 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.
"""
ADEMOD_RESULTS_FM_DEVIATION_MAXIMUM_NEGATIVE_PEAK = 2097197
r"""Returns the maximum negative peak frequency deviation of the frequency-modulated signal measured across multiple
acquisitions. 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.
"""
ADEMOD_RESULTS_FM_DEVIATION_MAXIMUM_RMS = 2097198
r"""Returns the maximum RMS frequency deviation of the frequency-modulated signal measured across multiple acquisitions.
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.
"""
ADEMOD_RESULTS_PM_DEVIATION_MEAN_STANDARD_DEVIATION = 2097199
r"""Returns the mean phase deviation around the unmodulated carrier phase. This value is expressed in degrees.
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.
"""
ADEMOD_RESULTS_PM_DEVIATION_MEAN_HALF_PEAK_TO_PEAK = 2097200
r"""Returns the mean (peak-to-peak)/2 phase deviation around the unmodulated carrier phase. This value is expressed in
degrees.
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.
"""
ADEMOD_RESULTS_PM_DEVIATION_MEAN_POSITIVE_PEAK = 2097201
r"""Returns the mean positive peak phase deviation around the unmodulated carrier phase. This value is expressed in
degrees.
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.
"""
ADEMOD_RESULTS_PM_DEVIATION_MEAN_NEGATIVE_PEAK = 2097202
r"""Returns the mean negative peak phase deviation around the unmodulated carrier phase. This value is expressed in
degrees.
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.
"""
ADEMOD_RESULTS_PM_DEVIATION_MEAN_RMS = 2097203
r"""Returns the mean RMS phase deviation of the phase-modulated signal. This value is expressed in degrees.
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.
"""
ADEMOD_RESULTS_PM_DEVIATION_MAXIMUM_STANDARD_DEVIATION = 2097204
r"""Returns the maximum phase deviation around the unmodulated carrier phase, measured across multiple acquisitions. This
value is expressed in degrees.
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.
"""
ADEMOD_RESULTS_PM_DEVIATION_MAXIMUM_HALF_PEAK_TO_PEAK = 2097205
r"""Returns the maximum (peak-to-peak)/2 phase deviation around the unmodulated carrier phase, measured across multiple
acquisitions. This value is expressed in degrees.
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.
"""
ADEMOD_RESULTS_PM_DEVIATION_MAXIMUM_POSITIVE_PEAK = 2097206
r"""Returns the maximum positive peak phase deviation around the unmodulated carrier phase, measured across multiple
acquisitions. This value is expressed in degrees.
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.
"""
ADEMOD_RESULTS_PM_DEVIATION_MAXIMUM_NEGATIVE_PEAK = 2097207
r"""Returns the maximum negative peak phase deviation around the unmodulated carrier phase, measured across multiple
acquisitions. This value is expressed in degrees.
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.
"""
ADEMOD_RESULTS_PM_DEVIATION_MAXIMUM_RMS = 2097208
r"""Returns the maximum RMS phase deviation of the phase-modulated signal measured across multiple acquisitions. This value
is expressed in degrees.
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.
"""
DDEMOD_MEASUREMENT_ENABLED = 2101248
r"""Enables digital demodulation measurements.
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.
"""
DDEMOD_MODULATION_TYPE = 2101259
r"""Specifies the digital modulation type of the signal that needs to be analyzed.
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 **PSK**.
+--------------+---------------------------------------------------------------+
| Name (Value) | Description |
+==============+===============================================================+
| ASK (0) | The modulation type is amplitude-shift keying (ASK). |
+--------------+---------------------------------------------------------------+
| FSK (1) | The modulation type is frequency-shift keying (FSK). |
+--------------+---------------------------------------------------------------+
| PSK (2) | The modulation type is phase-shift keying (PSK). |
+--------------+---------------------------------------------------------------+
| QAM (3) | The modulation type is quadrature-amplitude modulation (QAM). |
+--------------+---------------------------------------------------------------+
| MSK (4) | The modulation type is minimum shift keying (MSK). |
+--------------+---------------------------------------------------------------+
| APSK (5) | The modulation type is amplitude phase-shift keying (APSK). |
+--------------+---------------------------------------------------------------+
"""
DDEMOD_M = 2101257
r"""Specifies the M-ary number, which is the number of distinct states that represent symbols in the complex baseband
modulated waveform.
The M-ary number is calculated using the following formula:
M = 2\ :sup:`^`\(bits per symbol)
Recommended values of M for the modulation types are as follows:
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 **4**.
+--------------+----------------------------+
| Name (Value) | Description |
+==============+============================+
| 2 (2) | The M-ary number is 2. |
+--------------+----------------------------+
| 4 (4) | The M-ary number is 4. |
+--------------+----------------------------+
| 8 (8) | The M-ary number is 8. |
+--------------+----------------------------+
| 16 (16) | The M-ary number is 16. |
+--------------+----------------------------+
| 32 (32) | The M-ary number is 32. |
+--------------+----------------------------+
| 64 (64) | The M-ary number is 64. |
+--------------+----------------------------+
| 128 (128) | The M-ary number is 128. |
+--------------+----------------------------+
| 256 (256) | The M-ary number is 256. |
+--------------+----------------------------+
| 512 (512) | The M-ary number is 512. |
+--------------+----------------------------+
| 1024 (1024) | The M-ary number is 1,024. |
+--------------+----------------------------+
| 2048 (2048) | The M-ary number is 2,048. |
+--------------+----------------------------+
| 4096 (4096) | The M-ary number is 4,096. |
+--------------+----------------------------+
"""
DDEMOD_SPECTRUM_INVERTED = 2101266
r"""Specifies whether to swap the acquired I and Q samples for demodulation.
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 acquired I and Q samples are used for demodulation as is. |
+--------------+------------------------------------------------------------------------------------+
| True (1) | The acquired I and Q samples are swapped before using the signal for demodulation. |
+--------------+------------------------------------------------------------------------------------+
"""
DDEMOD_PSK_FORMAT = 2101262
r"""Specifies the PSK format.
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 **Normal**.
+------------------------+--------------------------------------------------------------------------------------------------------------------------+
| Name (Value) | Description |
+========================+==========================================================================================================================+
| Normal (0) | Sets the modulation type to PSK. |
+------------------------+--------------------------------------------------------------------------------------------------------------------------+
| Offset QPSK (1) | Sets the modulation type to offset quadrature PSK (OQPSK). The ideal symbol timing of Q is offset by half of a symbol |
| | period from the ideal symbol timing of I. |
+------------------------+--------------------------------------------------------------------------------------------------------------------------+
| PI/4 - QPSK (2) | Sets the modulation type to pi/4 QPSK. In this modulation, each QPSK symbol is rotated by |
| | pi/4. |
+------------------------+--------------------------------------------------------------------------------------------------------------------------+
| PI/8 - 8PSK (3) | Sets the modulation type to pi/8-8 PSK. In this modulation, each 8 PSK symbol is rotated by pi/8. |
+------------------------+--------------------------------------------------------------------------------------------------------------------------+
| 3*PI/8 - 8PSK (4) | Sets the modulation type to 3*pi/8-8 PSK. In this modulation, each 8 PSK symbol is rotated by 3*pi/8. |
+------------------------+--------------------------------------------------------------------------------------------------------------------------+
| Shaped Offset QPSK (5) | Sets the modulation type to Shaped Offset QPSK.The ideal symbol timing of Q is offset by half of a symbol period from |
| | the ideal symbol timing of I and the waveform is shaped using frequency pulse filter. |
+------------------------+--------------------------------------------------------------------------------------------------------------------------+
"""
DDEMOD_DIFFERENTIAL_ENABLED = 2101253
r"""Specifies whether the symbols are differentially encoded. This attribute is applicable only to PSK and MSK modulation
types.
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 symbols are directly mapped onto the symbol map. |
+--------------+--------------------------------------------------------------------------------------------------------------------------+
| True (1) | In case of PSK modulation, the transition between two consecutive symbols is mapped onto the symbol map. In case of MSK |
| | modulation, the consecutive bits are XORed. |
| | Other modulation types do not have any impact. |
+--------------+--------------------------------------------------------------------------------------------------------------------------+
"""
DDEMOD_SYMBOL_RATE = 2101267
r"""Specifies the number of symbols transmitted in one second. 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 100 kHz.
"""
DDEMOD_NUMBER_OF_SYMBOLS = 2101261
r"""Specifies the number of symbols to be analyzed. The measurement acquires additional symbols to account for filter
delays.
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,000.
"""
DDEMOD_SAMPLES_PER_SYMBOL = 2101265
r"""Specifies the samples per symbol used to acquire the signal for the measurement.
*Sample rate* = *Symbol rate* * *Samples per symbol*.
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**.
"""
DDEMOD_EVM_NORMALIZATION_REFERENCE = 2101305
r"""Specifies the reference used to normalize the error vector magnitude (EVM).
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 **Peak**.
+--------------+--------------------------------------------------------------------------------------------------------------------------+
| Name (Value) | Description |
+==============+==========================================================================================================================+
| Peak (0) | The EVM is normalized to the peak magnitude of the reference symbols. |
+--------------+--------------------------------------------------------------------------------------------------------------------------+
| RMS (1) | The EVM is normalized to the RMS magnitude of the reference symbols. This value is applicable only to modulation types, |
| | such as quadrature-amplitude modulation (QAM). This value is expressed in which the symbols in the map do not have a |
| | constant amplitude. |
+--------------+--------------------------------------------------------------------------------------------------------------------------+
"""
DDEMOD_FSK_DEVIATION = 2101256
r"""Specifies the expected FSK frequency deviation At baseband frequencies, deviations for individual symbols are evenly
spaced in the interval [-*fd*, *fd*], where *fd* represents the frequency deviation. 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 15 kHz.
"""
DDEMOD_FSK_REFERENCE_COMPENSATION_ENABLED = 2101304
r"""Specifies whether the FSK deviation that you specify is used to compensate for gain errors and compute FSK error.
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) | Does not compensate for gain errors. |
+--------------+--------------------------------------+
| True (1) | Compensates for gain errors. |
+--------------+--------------------------------------+
"""
DDEMOD_APSK_R2_TO_R1_RATIO = 2101321
r"""Specifies the ratio of the magnitude of symbols on a ring(R2) to the magnitude of symbols on the inner ring(R1). It is
applicable for both 16-APSK and 32-APSK.
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.84. Valid values are from 2 to 8, inclusive.
"""
DDEMOD_APSK_R3_TO_R1_RATIO = 2101322
r"""Specifies the ratio of the magnitude of symbols on a ring(R3) to the magnitude of symbols on the inner ring(R1). It is
applicable for 32-APSK.
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.27. Valid values are from 3 to 12, inclusive.
"""
DDEMOD_SYMBOL_MAP_TYPE = 2101312
r"""Specifies whether the measurement uses the default symbol map or the map that you configure using the
:py:meth:`configure_symbol_map` 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 **Auto**.
+--------------+----------------------------------------------------------------------------------------+
| Name (Value) | Description |
+==============+========================================================================================+
| Auto (0) | Uses a default symbol map. |
+--------------+----------------------------------------------------------------------------------------+
| Custom (1) | Uses the map that you specify using the RFmxDemod DDemod Configure Symbol Map method . |
+--------------+----------------------------------------------------------------------------------------+
"""
DDEMOD_PULSE_SHAPING_FILTER_TYPE = 2101263
r"""Specifies the pulse-shaping filter used to transmit the signal. This attribute determines the measurement filter to be
used for analysis when you set the :py:attr:`~nirfmxdemod.attributes.AttributeID.DDEMOD_MEASUREMENT_FILTER_TYPE`
attribute to **Auto**.
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 **Root Raised Cosine**.
+----------------------------+--------------------------------------------------------------------------------------------------------------------------+
| Name (Value) | Description |
+============================+==========================================================================================================================+
| Rectangular (0) | The transmitted waveform is filtered using a rectangular filter. |
+----------------------------+--------------------------------------------------------------------------------------------------------------------------+
| Raised Cosine (1) | The transmitted waveform is filtered using a raised cosine filter. Specify the filter Alpha in the DDemod Pulse Shaping |
| | Filter Parameter attribute. |
+----------------------------+--------------------------------------------------------------------------------------------------------------------------+
| Root Raised Cosine (2) | The transmitted waveform is filtered using a root raised cosine filter. Specify the filter Alpha in the DDemod Pulse |
| | Shaping Filter Parameter attribute. |
+----------------------------+--------------------------------------------------------------------------------------------------------------------------+
| Gaussian (3) | The transmitted waveform is filtered using a Gaussian filter. Specify the filter bandwidth * sample duration in the |
| | DDemod Pulse Shaping Filter Parameter attribute. This filter is applicable only to FSK and MSK modulation types. |
+----------------------------+--------------------------------------------------------------------------------------------------------------------------+
| Custom (4) | The transmitted waveform is filtered using the coefficients that you specify in the RFmxDemod DDemod Configure Pulse |
| | Shaping Filter Custom Coefficients method. |
+----------------------------+--------------------------------------------------------------------------------------------------------------------------+
| Half Sine (5) | The transmitted waveform is filtered using a half sine filter. |
+----------------------------+--------------------------------------------------------------------------------------------------------------------------+
| Linearized GMSK - EDGE (6) | The transmitted waveform is filtered using an EDGE-specific linearized GMSK filter. |
+----------------------------+--------------------------------------------------------------------------------------------------------------------------+
| SOQPSK - TG (7) | The transmitted waveform is filtered using a SOQPSK - TG filter as defined in IRIG standard. |
+----------------------------+--------------------------------------------------------------------------------------------------------------------------+
"""
DDEMOD_PULSE_SHAPING_FILTER_PARAMETER = 2101264
r"""Specifies the rolloff factor for raised cosine and root-raised cosine filter that is used as pulse-shaping filter and
measurement filter respectively.
For Gaussian filter, this attribute specifies bandwidth * sample duration.
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.5.
"""
DDEMOD_MEASUREMENT_FILTER_TYPE = 2101258
r"""Specifies whether the measurement needs to compute the measurement filter based on the pulse-shaping filter type or
uses the custom measurement filter coefficients.
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 signal analyzer computes the measurement filter coefficients based on the pulse-shaping filter information that you |
| | specify in the DDemod Pulse Shaping Filter Type attribute. If the DDemod Pulse Shaping Filter Type attribute is set to |
| | Custom, the signal analyzer enables equalization. |
+--------------+--------------------------------------------------------------------------------------------------------------------------+
| Custom (1) | The signal analyzer uses the coefficients specified by RFmxDemod DDemod Configure Measurement Filter Custom |
| | Coefficients method. |
+--------------+--------------------------------------------------------------------------------------------------------------------------+
"""
DDEMOD_EQUALIZER_MODE = 2101254
r"""Specifies whether the measurement needs to perform equalization.
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 **Off**.
+--------------+--------------------------------------------------------------------------------------------------------------------------+
| Name (Value) | Description |
+==============+==========================================================================================================================+
| Off (0) | Equalization is not performed. |
+--------------+--------------------------------------------------------------------------------------------------------------------------+
| Train (1) | The adaptive feedforward equalizer is turned ON to compensate for the effect of the channel. You can set the initial |
| | coefficients to be used by the equalizer. If you do not specify the initial coefficients, an impulse is used. |
+--------------+--------------------------------------------------------------------------------------------------------------------------+
| Hold (2) | The filter that you specify using the RFmxDemod DDemod Configure Equalizer Initial Coefficients method is used as the |
| | channel filter, and it is applied before demodulating the acquired signal. |
+--------------+--------------------------------------------------------------------------------------------------------------------------+
"""
DDEMOD_EQUALIZER_FILTER_LENGTH = 2101302
r"""Specifies the length of the equalization filter to be computed. The length is specified in terms of symbols.
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 20.
"""
DDEMOD_EQUALIZER_TRAINING_COUNT = 2101303
r"""Specifies the number of iterations during which the equalizer adapts its coefficients in the training stage. After the
training stage, the measurement is performed over the specified number of averages.
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.
"""
DDEMOD_EQUALIZER_CONVERGENCE_FACTOR = 2101255
r"""Specifies the incremental step used by the equalizer to adapt to the channel during the training stage.
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.0001
"""
DDEMOD_SYNCHRONIZATION_ENABLED = 2101268
r"""Specifies whether the demodulator needs to search and synchronize the signal to a known reference sequence. The
reference sequence is the symbol representation of a defined set of bits known to be present in the transmitted signal.
If the synchronization is found in the demodulated signal, the measurement is performed from this point onward. If the
synchronization is not found, the entire signal is used 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 **False**.
+--------------+---------------------------------------------+
| Name (Value) | Description |
+==============+=============================================+
| False (0) | Does not search and synchronize the signal. |
+--------------+---------------------------------------------+
| True (1) | Searches and synchronizes the signal. |
+--------------+---------------------------------------------+
"""
DDEMOD_SYNCHRONIZATION_BITS = 2101279
r"""Specifies the synchronization bits used to create the reference sequence that must be located in the demodulated
signal. The synchronization bits are modulated based on the modulation type to create the reference sequence.
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.
"""
DDEMOD_SYNCHRONIZATION_MEASUREMENT_OFFSET = 2101300
r"""Specifies the offset, which is the location from which the signal is considered for further measurements. The offset is
specified in symbols of the reference sequence. This offset is not applicable when the synchronization bits are not
found.
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.
"""
DDEMOD_AVERAGING_ENABLED = 2101250
r"""Enables averaging for digital demodulation measurements.
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 is performed on a single acquisition. |
+--------------+--------------------------------------------------------------------------------------------------------------------------+
| True (1) | The measurement uses the value of the DDemod Averaging Count attribute for the number of acquisitions over which the |
| | measurement is averaged. The traces are not averaged. |
+--------------+--------------------------------------------------------------------------------------------------------------------------+
"""
DDEMOD_AVERAGING_COUNT = 2101251
r"""Specifies the number of acquisitions used for averaging when you set the
:py:attr:`~nirfmxdemod.attributes.AttributeID.DDEMOD_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.
"""
DDEMOD_SIGNAL_STRUCTURE = 2101313
r"""Specifies whether the signal is either a bursty signal or a continuous 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 **Continuous**.
+----------------+------------------------------------+
| Name (Value) | Description |
+================+====================================+
| Bursted (0) | The signal is a bursty signal. |
+----------------+------------------------------------+
| Continuous (1) | The signal is a continuous signal. |
+----------------+------------------------------------+
"""
DDEMOD_BURST_START_EXCLUSION_SYMBOLS = 2101314
r"""Specifies the number of symbols from the start of the burst trigger that is excluded from 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 0.
"""
DDEMOD_BURST_END_EXCLUSION_SYMBOLS = 2101315
r"""Specifies the number of symbols that is excluded from the measurement before the falling edge of the burst.
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.
"""
DDEMOD_IQ_OFFSET_REMOVAL_ENABLED = 2101316
r"""Specifies whether to remove the I/Q offset before the EVM 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 **True**.
+--------------+----------------------------------------------------------+
| Name (Value) | Description |
+==============+==========================================================+
| False (0) | The IQ offset is not removed before the EVM measurement. |
+--------------+----------------------------------------------------------+
| True (1) | The IQ offset is removed before the EVM measurement. |
+--------------+----------------------------------------------------------+
"""
DDEMOD_CFO_ESTIMATION_MODE = 2101317
r"""Specifies the carrier frequency offset estimation capability of the demodulator. If you select **Narrow**, coarse
carrier frequency offset estimation is disabled and only fine carrier frequency offset estimation is performed. This is
useful when analysing low SNR signals.
+--------------+------------------------------------------------------------------------------+
| Name (Value) | Description |
+==============+==============================================================================+
| Narrow (0) | The measurement disables coarse carrier frequency offset estimation. |
+--------------+------------------------------------------------------------------------------+
| Wide (1) | The measurement enables coarse and fine carrier frequency offset estimation. |
+--------------+------------------------------------------------------------------------------+
"""
DDEMOD_SEARCH_LENGTH_AUTO = 2101319
r"""Specifies whether the measurement should search for synchronization bit pattern in the waveform of length determined by
the measurement or search for length duration.
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) | Synchronization bit pattern is searched in a waveform within the search Length duration. |
+--------------+------------------------------------------------------------------------------------------------+
| True (1) | Synchronization bit pattern is searched in a waveform of length determined by the measurement. |
+--------------+------------------------------------------------------------------------------------------------+
"""
DDEMOD_SEARCH_LENGTH = 2101320
r"""Specifies the length of the waveform within which the synchronization bit pattern needs to be searched when you set the
:py:attr:`~nirfmxdemod.attributes.AttributeID.DDEMOD_SEARCH_LENGTH_AUTO` 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 0.001 seconds.
"""
DDEMOD_ALL_TRACES_ENABLED = 2101269
r"""Specifies whether to enable the traces to be stored and retrieved after performing the digital demodulation.
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.
"""
DDEMOD_RESULTS_CARRIER_MEAN_FREQUENCY_OFFSET = 2101281
r"""Returns the measured frequency offset from the transmitted carrier frequency. 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.
"""
DDEMOD_RESULTS_CARRIER_MEAN_FREQUENCY_DRIFT = 2101282
r"""Returns the measured carrier frequency drift. 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.
"""
DDEMOD_RESULTS_CARRIER_MEAN_PHASE_ERROR = 2101283
r"""Returns the measured phase offset from the transmitted carrier phase. This value is expressed in degrees.
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.
"""
DDEMOD_RESULTS_EVM_MEAN_RMS = 2101284
r"""Returns the mean of the RMS EVM measured per acquisition, as a 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.
"""
DDEMOD_RESULTS_EVM_MAXIMUM_RMS = 2101285
r"""Returns the maximum of the RMS EVM measured per acquisition, as a 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.
"""
DDEMOD_RESULTS_EVM_MEAN_PEAK = 2101286
r"""Returns the mean of the peak EVM measured per acquisition, as a 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.
"""
DDEMOD_RESULTS_EVM_MAXIMUM_PEAK = 2101287
r"""Returns the maximum of the peak EVM measured per acquisition, as a 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.
"""
DDEMOD_RESULTS_EVM_MEAN_MODULATION_ERROR_RATIO = 2101288
r"""Returns the modulation error ratio. This value is expressed in dB.
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.
"""
DDEMOD_RESULTS_OFFSET_EVM_MEAN_RMS = 2101306
r"""Returns the mean of the RMS EVM, as a percentage, measured per acquisition, after removing the offset between the I and
Q channels of OQPSK demodulated 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.
"""
DDEMOD_RESULTS_OFFSET_EVM_MEAN_PEAK = 2101307
r"""Returns the mean of the peak EVM, as a percentage, measured per acquisition, after removing the offset between the I
and Q channels of OQPSK demodulated 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.
"""
DDEMOD_RESULTS_OFFSET_EVM_MAXIMUM_RMS = 2101308
r"""Returns the maximum of the RMS EVM, as a percentage, measured per acquisition, after removing the offset between the I
and Q channels of OQPSK demodulated 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.
"""
DDEMOD_RESULTS_OFFSET_EVM_MAXIMUM_PEAK = 2101309
r"""Returns the maximum of the peak EVM, as a percentage, measured per acquisition, after removing the offset between the I
and Q channels of OQPSK demodulated 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.
"""
DDEMOD_RESULTS_MAGNITUDE_ERROR_MEAN = 2101289
r"""Returns the mean of the magnitude error measured per acquisition, as a 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.
"""
DDEMOD_RESULTS_MAGNITUDE_ERROR_MAXIMUM = 2101290
r"""Returns the maximum of the magnitude error measured per acquisition, as a 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.
"""
DDEMOD_RESULTS_PHASE_ERROR_MEAN = 2101291
r"""Returns the mean of the phase error measured per acquisition. This value is expressed in degrees.
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.
"""
DDEMOD_RESULTS_PHASE_ERROR_MAXIMUM = 2101292
r"""Returns the maximum of the phase error measured per acquisition. This value is expressed in degrees.
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.
"""
DDEMOD_RESULTS_FSK_MEAN_DEVIATION = 2101293
r"""Returns the reference FSK deviation used to measure the FSK error. 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.
"""
DDEMOD_RESULTS_FSK_MEAN_RMS_FSK_ERROR = 2101294
r"""Returns the mean of the RMS frequency error of the FSK symbols measured per acquisition. 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.
"""
DDEMOD_RESULTS_FSK_MAXIMUM_PEAK_FSK_ERROR = 2101295
r"""Returns the maximum of peak frequency error of the FSK symbols measured per acquisition. 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.
"""
DDEMOD_RESULTS_IQ_IMPAIRMENTS_MEAN_IQ_ORIGIN_OFFSET = 2101298
r"""Returns the offset from the ideal location of the constellation origin. This value is expressed in dB.
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.
"""
DDEMOD_RESULTS_IQ_IMPAIRMENTS_MEAN_IQ_GAIN_IMBALANCE = 2101296
r"""Returns the measured ratio of I gain to Q gain. This value is expressed in dB.
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.
"""
DDEMOD_RESULTS_IQ_IMPAIRMENTS_MEAN_QUADRATURE_SKEW = 2101297
r"""Returns a measure of I and Q components in the signal that are not perfectly orthogonal. Quadrature error can be either
positive or negative, with the sign indicating the orientation of the error.
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.
"""
DDEMOD_RESULTS_MEAN_RHO_FACTOR = 2101310
r"""Returns the correlation of the measurement waveform and the reference waveform.
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.
"""
DDEMOD_RESULTS_MEAN_AMPLITUDE_DROOP = 2101311
r"""Returns the mean amplitude droop per symbol.
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.
"""
DDEMOD_RESULTS_SYNC_FOUND = 2101301
r"""Indicates whether the synchronization bits were found in the demodulated 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.
"""
AUTO_LEVEL_INITIAL_REFERENCE_LEVEL = 2105357
r"""Specifies the initial reference level which the :py:meth:`auto_level` method uses to estimate the peak power of the
input signal. This value is expressed in dBm.
You do not need to use a selector string to configure or read this attribute for the default signal instance.
Refer to the Selector String topic for information about the string syntax for named signals.
The default value is 30.
"""
LIMITED_CONFIGURATION_CHANGE = 2105358
r"""Specifies the set of attributes that are considered by RFmx in the locked signal configuration state.
If your test system performs the same measurement at different selected ports, multiple frequencies and/or
power levels repeatedly, enabling this attribute can 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. Because RFmx skips
some checks when you use this attribute, you need to be aware of the limitations of this feature, which are listed in
the `Limitations of the Limited Configuration Change Property
<https://www.ni.com/docs/en-US/bundle/rfmx-wcdma-prop/page/rfmxwcdmaprop/limitations.html>`_ topic.
You can also use this attribute to lock a specific instrument configuration for a signal so that every time
that you initiate the signal, RFmx applies the RFmxInstr attributes from a locked configuration.
NI recommends you use this attribute in conjunction with named signal configurations. Create named signal
configurations for each measurement configuration in your test program and set this attribute to a value other than
**Disabled** for one or more of the named signal configurations. This allows RFmx to precompute the acquisition
settings for your measurement configurations and re-use the precomputed settings each time you initiate the
measurement. You do not need to use this attribute if you create named signals for all the measurement configurations
in your test program during test sequence initialization and do not change any RFInstr or personality attributes while
testing each device under test. RFmx automatically optimizes that use case.
Specify the named signal configuration you are setting this attribute in the selector string input. You do not
need to use a selector string to configure or read this attribute for the default signal instance. Refer to the
Selector String topic for information about the string syntax for named signals.
The default value is **Disabled**.
+----------------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| Name (Value) | Description |
+========================================+==========================================================================================================================+
| Disabled (0) | This is the normal mode of RFmx operation. All configuration changes in RFmxInstr attributes or in personality |
| | attributes will be applied during RFmx Commit. |
+----------------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| No Change (1) | Signal configuration is locked after the first Commit 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. |
+----------------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| Frequency (2) | Signal configuration, other than center frequency and external attenuation, is locked after first Commit of the named |
| | signal configuration. Thereafter, only the Center Frequency and External Attenuation attribute value changes will be |
| | considered by subsequent driver Commits or Initiates of this signal. |
| | Refer to the Limitations of the Limited Configuration Change Property topic for more details about the limitations of |
| | using this mode. |
+----------------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| Reference Level (3) | Signal configuration, other than the reference level, is locked after first Commit of the named signal configuration. |
| | Thereafter only the Reference Level attribute value change will be considered by subsequent driver Commits or Initiates |
| | of this signal. If you have configured this signal to use an IQ Power Edge Trigger, NI recommends that you set the IQ |
| | Power Edge Level Type to Relative so that the trigger level is automatically adjusted as you adjust the reference |
| | level. Refer to the Limitations of the Limited Configuration Change Property topic for more details about the |
| | limitations of using this mode. |
+----------------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| Freq and Ref Level (4) | Signal configuration, other than center frequency, reference level, and external attenuation, is locked after first |
| | Commit of the named signal configuration. Thereafter only Center Frequency, Reference Level, and External Attenuation |
| | attribute value changes will be considered by subsequent driver Commits or Initiates of this signal. If you have |
| | configured this signal to use an IQ Power Edge Trigger, NI recommends you set the IQ Power Edge |
| | Level Type attribute to Relative so that the trigger level is automatically adjusted as you adjust the reference level. |
| | Refer to the Limitations of the Limited Configuration Change Property topic for more details about the limitations of |
| | using this mode. |
+----------------------------------------+--------------------------------------------------------------------------------------------------------------------------+
| Selected Ports, Freq and Ref Level (5) | Signal configuration, other than Selected Ports, Center frequency, Reference level, External attenuation, and RFInstr |
| | configuration, is locked after first Commit or Initiate of the named signal configuration. Thereafter only Selected |
| | Ports, Center Frequency, Reference Level, and External Attenuation attribute value changes will be considered by |
| | subsequent driver Commits or Initiates of this signal. If you have configured this signal to use an IQ Power Edge |
| | Trigger, NI recommends you set the IQ Power Edge Level Type attribute to Relative so that the trigger level is |
| | automatically adjusted as you adjust the reference level. Refer to the Limitations of the Limited Configuration Change |
| | Property topic for more details about the limitations of using this mode. |
+----------------------------------------+--------------------------------------------------------------------------------------------------------------------------+
"""
RESULT_FETCH_TIMEOUT = 2109440
r"""Specifies the time to wait before results are available in the RFmxDemod Attribute. Set this value to a time longer
than expected for fetching the measurement. A value of -1 specifies that the RFmxDemod Attribute waits until the
measurement is complete.
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 10.
"""