Enums

Enums used in NI-RFSA

AcquisitionType

class nirfsa.AcquisitionType
IQ

Configures NI-RFSA for I/Q acquisitions.

SPECTRUM

Configures NI-RFSA for spectrum acquisitions.

Action

class nirfsa.Action
COMMIT

The new calibration constants are stored in the EEPROM.

ABORT

The old calibration constants are kept, and the new ones are discarded.

AdvanceTriggerDigitalEdgeEdge

class nirfsa.AdvanceTriggerDigitalEdgeEdge
RISING

The trigger asserts on the rising edge of the signal.

FALLING

The trigger asserts on the falling edge of the signal.

AdvanceTriggerType

class nirfsa.AdvanceTriggerType
NONE

No Advance Trigger is configured.

DIGITAL_EDGE

The Advance Trigger is not asserted until a digital edge is detected. The source of the digital edge is specified with the nirfsa.Session.digital_edge_advance_trigger_source property.

SOFTWARE_EDGE

The Advance Trigger is not asserted until a software trigger occurs. You can assert the software trigger by calling the nirfsa.Session.send_software_edge_trigger() method and selecting NIRFSA_VAL_ADVANCE_TRIGGER as the trigger parameter.

AllowOutOfSpecificationUserSettings

class nirfsa.AllowOutOfSpecificationUserSettings
DISABLED

Disables out-of-specification user settings.

ENABLED

Enables out-of-specification user settings.

ArmReferenceTriggerType

class nirfsa.ArmReferenceTriggerType
NONE

No Arm Reference Trigger is configured.

DIGITAL_EDGE

The Arm Reference Trigger is not asserted until a digital edge is detected. The source of the digital edge is specified with the nirfsa.Session.digital_edge_arm_ref_trigger_source property.

SOFTWARE_EDGE

The Arm Reference Trigger is not asserted until a software trigger occurs. You can assert the software trigger by calling the nirfsa.Session.send_software_edge_trigger() method and selecting ARM_REF as the trigger parameter.

CalToneMode

class nirfsa.CalToneMode
DISABLED

Disables the calibration tone for the associated signal path.

CAL_TONE_LOWBAND_RF

Injects the calibration tone into the low band RF signal path.

CAL_TONE_HIGHBAND_RF

Injects the calibration tone into the high band RF signal path.

CAL_TONE_HIGHBAND_IF

Injects the calibration tone into the high band IF signal path.

CAL_TONE_LOWBAND_RF_WITHOUT_ALC

Injects the calibration tone into the low band RF signal path, bypassing the ALC.

CAL_TONE_COMB_GENERATOR

Injects the calibration tone into the high band RF signal path through the Comb Generator.

CalibrateStep

class nirfsa.CalibrateStep
IF_ATTENUATION

Initializes the IF Attenuation Calibration step. This step is not supported for the PXIe-5693.

IF_RESPONSE

Initializes the IF Response Calibration step. This step is not supported for the PXIe-5603/5605 or PXIe-5693/5698.

IF_REF_LEVEL

Initializes the Ref Level Calibration step. This step is not supported on the PXIe-5694.

LO_EXPORT

Initializes the LO Export Calibration step. This step calibrates the output power of each LO to be within specification. This step is not supported on the PXIe-5601 or the PXIe-5693/5694/5698.

GAIN_REFERENCE

Initializes the Gain Reference Calibration step. This step calibrates the calibration tone amplitude across supported calibration tone frequencies. This step is not supported on the PXIe-5601/5603/5605 or PXIe-5694.

ChannelCoupling

class nirfsa.ChannelCoupling
AC

Specifies that the RF input channel is AC-coupled. For low frequencies (<10 MHz), accuracy decreases because NI-RFSA does not calibrate the configuration.

DC

Specifies that the RF input channel is DC-coupled. NI-RFSA enforces a minimum RF attenuation for device protection.

ConditioningCalToneMode

class nirfsa.ConditioningCalToneMode
DISABLED

Disables the calibration tone for the associated signal path.

CAL_TONE_LOWBAND_RF

Injects the calibration tone into the low band RF signal path.

CAL_TONE_HIGHBAND_RF

Injects the calibration tone into the high band RF signal path.

DeembeddingType

class nirfsa.DeembeddingType
NONE

De-embedding is not applied to the measurement.

SCALAR

De-embeds the measurement using only the gain term.

VECTOR

De-embeds the measurement using the gain term and the reflection term.

AMPLITUDE_FLATNESS

De-embeds the measurement using wideband amplitude flatness correction.

DeviceResponseType

class nirfsa.DeviceResponseType
DOWNCONVERTER_IF

Returns the IF response of the downconverter.

DOWNCONVERTER_RF

Returns the RF response of the downconverter. This value is supported only for the PXIe-5603/5605/5665/5667/5693..

DOWNCONVERTER_COMBINED

Returns the combined RF and IF response of the downconverter. The combined response is in terms of IF frequency. This value is supported only for the PXIe-5603/5605/5665/5667.

VSA_IF

Returns the IF response of the entire NI-RFSA device. This value is supported only for the PXIe-5665/5667.

VSA_COMBINED

Returns the combined IF and RF response of the entire NI-RFSA device. The combined response is in terms of IF frequency. This value is supported only for the PXIe-5665/5667.

DigitizerDitherEnabled

class nirfsa.DigitizerDitherEnabled
DISABLED

Disables dither on the digitizer.

ENABLED

Enables dither on the digitizer.

DigitizerSampleClockExportedTerminal

class nirfsa.DigitizerSampleClockExportedTerminal
NONE

The Reference Clock is not exported. This value is not valid for the PXIe-5644/5645/5646.

CLK_OUT

Export the clock on the CLK OUT terminal on the IF digitizer. This value is not valid for the PXIe-5644/5645/5646 or PXIe-5820/5830/5831/5832/5840/5841.

DigitizerSampleClockTimebaseSource

class nirfsa.DigitizerSampleClockTimebaseSource
ONBOARD_CLOCK

The digitizer uses its onboard clock as the Sample Clock timebase.

CLK_IN

The digitizer uses the signal present on the CLK IN connector as the Sample Clock timebase.

LO_REF_CLK

The digitizer uses the signal generated on the 100 MHz REF OUT terminal on the PXIe-5653 as the Sample Clock timebase. This value is supported only for the PXIe-5665.

PXI_STAR

The digitizer uses the signal present at the PXI star trigger line as the Sample Clock timebase. This value is not supported for the PXIe-5668.

DOWNCONVERTER_LO2_OUT

The digitizer uses the signal present on the LO2 OUT connector on the downconverter as the Sample Clock timebase. This value is supported only for the PXIe-5668.

DownconverterFrequencyOffsetMode

class nirfsa.DownconverterFrequencyOffsetMode
AUTOMATIC

NI-RFSA places the downconverter center frequency outside of the signal bandwidth if the nirfsa.Session.signal_bandwidth property has been set and can be avoided.

ENABLED

NI-RFSA places the downconverter center frequency outside of the signal bandwidth if the nirfsa.Session.signal_bandwidth property has been set and can be avoided. NI-RFSA returns an error if the nirfsa.Session.signal_bandwidth property has not been set, or if the signal bandwidth is too large.

USER_DEFINED

NI-RFSA uses the offset that you specified with the nirfsa.Session.downconverter_frequency_offset or nirfsa.Session.downconverter_center_frequency properties.

DownconverterLoopBandwidth

class nirfsa.DownconverterLoopBandwidth
NARROW

Specifies that the downconverter module uses a narrow loop bandwidth.

MEDIUM

Specifies that the downconverter module uses a medium loop bandwidth.

WIDE

Specifies that the downconverter module uses a wide loop bandwidth.

DownconverterPreselectorEnabled

class nirfsa.DownconverterPreselectorEnabled
DISABLED

Disables the preselector.

ENABLED_WHEN_IN_SIGNAL_PATH

The preselector is automatically enabled when it is in the signal path and is automatically disabled when it is not in the signal path. Use the nirfsa.Session.preselector_present property to determine if the downconverter has an preselector.

ENABLED

Enables the preselector. If the preselector is not in the signal path or if the preselector is not supported on the device, NI-RFSA returns an error. Select the ENABLED_WHEN_IN_SIGNAL_PATH whenever possible avoid an error.

EnableAttrVals

class nirfsa.EnableAttrVals
DISABLED

The property is disabled.

ENABLED

The property is enabled.

EnableRfPreamp

class nirfsa.EnableRfPreamp
DISABLED

Disables the RF preamplifier.

ENABLED_WHEN_IN_SIGNAL_PATH

Enables the RF preamplifier when the RF preamplifier is present in the signal path and disables the preamplifier when it is not in the signal path. Only devices with an RF preamplifier on the downconverter and an RF preselector support this option. Use the nirfsa.Session.rf_preamp_present property to determine whether the downconverter has a preamplifier.

ENABLED

Enables the RF preamplifier. If the RF preamplifier is not in a signal path, NI-RFSA returns an error. Select the ENABLED_WHEN_IN_SIGNAL_PATH value whenever possible to avoid an error.

AUTOMATIC

Automatically enables the RF preamplifier based on the value of the nirfsa.Session.reference_level property. This value is valid only for the PXIe-5644/5645/5646, PXIe-5667, and PXIe-5830/5831/5832/5840/5841.

ExportOutputTerminal

class nirfsa.ExportOutputTerminal
DO_NOT_EXPORT

The signal is not exported.

CLK_OUT

Export the clock on the CLK OUT terminal on the IF digitizer. This value is not valid for the PXIe-5644/5645/5646 or PXIe-5820/5830/5831/5832/5840/5841.

REF_OUT

Export the clock on the REF IN/OUT terminal on the PXI/PXIe-5652, the REF OUT terminals on the PXIe-5653, or the REF OUT terminal on the PXIe-5644/5645/5646, PXIe-5694, or PXIe-5820/5830/5831/5832/5840/5841.

REF_OUT2

Export the clock on the REF OUT2 terminal on the PXIe-5652. This value is valid only for the PXIe-5663E.

PFI0

The trigger is received on PFI 0. For the PXIe-5841 with PXIe-5655, the trigger is received on the PXIe-5841 PFI 0.

PFI1

The trigger is received on PFI 1.

PXI_TRIG0

The trigger is received on PXI trigger line 0.

PXI_TRIG1

The trigger is received on PXI trigger line 1.

PXI_TRIG2

The trigger is received on PXI trigger line 2.

PXI_TRIG3

The trigger is received on PXI trigger line 3.

PXI_TRIG4

The trigger is received on PXI trigger line 4.

PXI_TRIG5

The trigger is received on PXI trigger line 5.

PXI_TRIG6

The trigger is received on PXI trigger line 6.

PXI_TRIG7

The trigger is received on PXI trigger line 7.

PXI_STAR

The trigger is received on the PXI star trigger line. This value is not valid for the PXIe-5644/5645/5646.

PXIE_DSTARC

The trigger is received on the PXIe DStar C trigger line. This value is valid on only the PXIe-5820/5830/5831/5832/5840/5841.

DIO_PFI0

The trigger is received on PFI0 from the front panel DIO terminal.

DIO_PFI1

The trigger is received on PFI1 from the front panel DIO terminal.

DIO_PFI2

The trigger is received on PFI2 from the front panel DIO terminal.

DIO_PFI3

The trigger is received on PFI3 from the front panel DIO terminal.

DIO_PFI4

The trigger is received on PFI4 from the front panel DIO terminal.

DIO_PFI5

The trigger is received on PFI5 from the front panel DIO terminal.

DIO_PFI6

The trigger is received on PFI6 from the front panel DIO terminal.

DIO_PFI7

The trigger is received on PFI7 from the front panel DIO terminal.

FetchRelativeTo

class nirfsa.FetchRelativeTo
MOST_RECENT_SAMPLE

Fetching occurs relative to the most recently acquired data. The value of the nirfsa.Session.fetch_offset property must be negative.

FIRST_SAMPLE

Fetching occurs at the first sample acquired by the device. If the device wraps its buffer, the first sample is no longer available. In this case, NI-RFSA returns an error if the fetch offset is in the overwritten data.

REFERENCE_TRIGGER

Fetching occurs relative to the Reference Trigger. This value behaves like FIRST_SAMPLE if no Reference Trigger is configured.

FIRST_PRETRIGGER_SAMPLE

Fetching occurs relative to the first pretrigger sample acquired.

CURRENT_READ_POSITION

Fetching occurs after the last fetched sample.

FrequencySettlingUnits

class nirfsa.FrequencySettlingUnits
PPM

Specifies the frequency settling time in parts per million (PPM).

SECONDS_AFTER_LOCK

Specifies the frequency settling in time after lock (seconds).

SECONDS_AFTER_IO

Specifies the frequency settling time after I/O (seconds).

IFattenTableSel

class nirfsa.IFattenTableSel
STANDARD

Specifies that the standard IF attenuation table is used for the external calibration.

ACPR

Specifies that the adjacent channel power ratio (ACPR) IF attenuation table is used for the external calibration. You can only select this value if you set the nirfsa.Session.CAL_IF_FILTER_SELECTION property to EXT_CAL_IF_FILTER_PATH_1 or EXT_CAL_IF_FILTER_PATH_2.

IFfilter

class nirfsa.IFfilter
_187_5_MHZ_WIDE

The device uses the 187.5 MHz wide bandwidth filter.

_187_5_MHZ_NARROW

The device uses the 187.5 MHz narrow bandwidth filter.

_53_MHZ

The device uses the 53 MHz filter.

BYPASS

The device bypasses the IF filter.

IFfilterSelection

class nirfsa.IFfilterSelection
EXT_CAL_IF_FILTER_PATH_1

Specifies that the 5 MHz filter path is used during calibration.

EXT_CAL_IF_FILTER_PATH_2

Specifies that the 300 kHz filter path is used during calibration. Not supported for the PXIe-5694.

EXT_CAL_IF_FILTER_PATH_3

None of the IF filter paths are used during calibration.

EXT_CAL_IF_FILTER_PATH_4

Specifies that the 20 MHz filter path is used during calibration.

EXT_CAL_IF_FILTER_PATH_5

Specifies that the 1.4 MHz filter path is used during calibration.

EXT_CAL_IF_FILTER_PATH_6

Specifies that the 400 kHz filter path is used during calibration.

EXT_CAL_IF_FILTER_PATH_7

Specifies that the 110 kHz filter path is used during calibration.

EXT_CAL_IF_FILTER_PATH_8

Specifies that the 30 kHz filter path is used during calibration.

IfConditioningDownConversionEnabled

class nirfsa.IfConditioningDownConversionEnabled
DISABLED

Disables IF conditioning downconversion.

ENABLED

Enables IF conditioning downconversion.

InputIsolationEnabled

class nirfsa.InputIsolationEnabled
DISABLED

Disables input isolation.

ENABLED

Enables input isolation.

InputPort

class nirfsa.InputPort
RF_IN

Enables the RF IN port.

IQ_IN

Enables the I/Q IN port.

CAL_IN

Enables the CAL IN port.

I_ONLY

Enables the I terminals of the I/Q IN port. It is supported only for PXIe-5645.

IqInPortTerminalConfiguration

class nirfsa.IqInPortTerminalConfiguration
DIFFERENTIAL

Sets the terminal configuration to differential.

SINGLE_ENDED

Sets the terminal configuration to single-ended.

LinearInterpolationFormat

class nirfsa.LinearInterpolationFormat
MAGNITUDE_AND_PHASE

Results in a linear interpolation of the real portion of the complex number and a separate linear interpolation of the complex portion.

MAGNITUDE_DB_AND_PHASE

Results in a linear interpolation of the magnitude and a separate linear interpolation of the phase.

REAL_AND_IMAGINARY

Results in a linear interpolation of the magnitude, in decibels, and a separate linear interpolation of the phase.

Lo2ExportEnabled

class nirfsa.Lo2ExportEnabled
DISABLED

Disables LO2 export.

ENABLED

Enables LO2 export.

LoInjection

class nirfsa.LoInjection
HIGH

Configures the LO signal that the NI-RFSA device generates at a frequency higher than the RF frequency. This LO frequency is given by the formula f<sub>LO</sub> = f<sub>RF</sub> + f<sub>IF</sub>.

LOW

Configures the LO signal that the NI-RFSA device generates at a frequency lower than the RF frequency. This LO frequency is given by the formula f<sub>LO</sub> = f<sub>RF</sub> - f<sub>IF</sub>.

LoNumber

class nirfsa.LoNumber
LO2

Selects LO2, which is the 4 GHz signal path.

LO3

Selects LO3, which is the 800 MHz signal path.

LO1

Selects LO1, which is the 3.2 GHz to 8.3 GHz variable signal path.

LoOutExportConfigureFromRfsg

class nirfsa.LoOutExportConfigureFromRfsg
DISABLED

Do not allow NI-RFSG to control the NI-RFSA local oscillator export.

ENABLED

Allow NI-RFSG to control the NI-RFSA local oscillator export.

LoPathSel

class nirfsa.LoPathSel
EXT_CAL_LO_PATH_1

Specifies that the LO path 1 is used.

EXT_CAL_LO_PATH_2

Specifies that the LO path 2 is used.

EXT_CAL_LO_PATH_3

Specifies that the LO path 3 is used.

EXT_CAL_LO_PATH_4

Specifies that the LO path 4 is used.

EXT_CAL_LO_PATH_5

Specifies that the LO path 5 is used.

LoPllFractionalModeEnabled

class nirfsa.LoPllFractionalModeEnabled
DISABLED

Disables fractional mode for the LO PLL.

ENABLED

Enables fractional mode for the LO PLL.

LoSource

class nirfsa.LoSource
NONE

Specifies that no LO source is required to downconvert the RF input signal.

ONBOARD

Specifies that the onboard synthesizer is used to generate the LO signal that downconverts the RF input signal.**PXIe-5831/5832** This configuration uses the onboard LO of the PXIe-3622, using the LO2 stage.**PXIe-5831/5832 with PXIe-5653** This configuration uses the onboard LO of the PXIe-5653 when associated with the PXIe-3622.**PXIe-5841 with PXIe-5655** This configuration uses the onboard LO of the PXIe-5655.

LO_IN

Specifies that the LO source used to downconvert the RF input signal is connected to the LO IN connector on the front panel.

LO_SOURCE_SECONDARY

Uses the PXIe-5831/5840 internal LO as the LO source. This value is valid on only the PXIe-5831 with PXIe-5653 (LO1 stage only) or PXIe-5832 with PCIe-5653 (LO1 stage only).

LO_SOURCE_SG_SA_SHARED

Uses the same internal LO during NI-RFSA and NI-RFSG sessions. NI-RFSA selects an internal synthesizer and the synthesizer signal is switched to both the RF Out and RF In mixers. This value is valid on only the PXIe-5830/5831/5832/5841 with PXIe-5655.

LoYigMainCoilDrive

class nirfsa.LoYigMainCoilDrive
NORMAL

Adjusts the YIG main coil on the LO for an underdamped response.

FAST

Adjusts the YIG main coil on the LO for an overdamped response.

LoadConfigurationResetOptions

class nirfsa.LoadConfigurationResetOptions
NONE

NI-RFSA resets all configurations.

DEEMBEDDING_TABLES

NI-RFSA skips resetting the de-embedding tables.

NoiseSourcePowerEnabled

class nirfsa.NoiseSourcePowerEnabled
DISABLED

Disables the noise source power.

ENABLED

Enables the noise source power.

NotchFilterEnabled

class nirfsa.NotchFilterEnabled
DISABLED

Disables the notch filter.

ENABLED_WHEN_IN_SIGNAL_PATH

The notch filter is automatically enabled when it is in the signal path and automatically disabled when it is not in the signal path.

ENABLED

Enables the notch filter. If the notch filter is not in the signal path or if the notch filter is not supported on the device, NI-RFSA returns an error. Select ENABLED_WHEN_IN_SIGNAL_PATH whenever possible to avoid an error.

OutputTerm

class nirfsa.OutputTerm
DO_NOT_EXPORT

The signal is not exported.

CLK_OUT

Export the clock on the CLK OUT terminal on the IF digitizer. This value is not valid for the PXIe-5644/5645/5646 or PXIe-5820/5830/5831/5832/5840/5841.

REF_OUT

Export the clock on the REF IN/OUT terminal on the PXI/PXIe-5652, the REF OUT terminals on the PXIe-5653, or the REF OUT terminal on the PXIe-5644/5645/5646, PXIe-5694, or PXIe-5820/5830/5831/5832/5840/5841.

REF_OUT2

Export the clock on the REF OUT2 terminal on the PXIe-5652. This value is valid only for the PXIe-5663E.

PFI0

The trigger is received on PFI 0. For the PXIe-5841 with PXIe-5655, the trigger is received on the PXIe-5841 PFI 0.

PFI1

The trigger is received on PFI 1.

PXI_TRIG0

The trigger is received on PXI trigger line 0.

PXI_TRIG1

The trigger is received on PXI trigger line 1.

PXI_TRIG2

The trigger is received on PXI trigger line 2.

PXI_TRIG3

The trigger is received on PXI trigger line 3.

PXI_TRIG4

The trigger is received on PXI trigger line 4.

PXI_TRIG5

The trigger is received on PXI trigger line 5.

PXI_TRIG6

The trigger is received on PXI trigger line 6.

PXI_TRIG7

The trigger is received on PXI trigger line 7.

PXI_STAR

The trigger is received on the PXI star trigger line. This value is not valid for the PXIe-5644/5645/5646.

PXIE_DSTARB

The trigger is received on the PXIe DStar B trigger line. This value is valid on only the PXIe-5820/5830/5831/5832/5840/5841.

DIO_PFI0

The trigger is received on PFI0 from the front panel DIO terminal.

DIO_PFI1

The trigger is received on PFI1 from the front panel DIO terminal.

DIO_PFI2

The trigger is received on PFI2 from the front panel DIO terminal.

DIO_PFI3

The trigger is received on PFI3 from the front panel DIO terminal.

DIO_PFI4

The trigger is received on PFI4 from the front panel DIO terminal.

DIO_PFI5

The trigger is received on PFI5 from the front panel DIO terminal.

DIO_PFI6

The trigger is received on PFI6 from the front panel DIO terminal.

DIO_PFI7

The trigger is received on PFI7 from the front panel DIO terminal.

TIMER_EVENT

The trigger is received from the Timer Event. This value is valid on only the PXIe-5820/5830/5831/5832/5840/5841, and for digital edge Advance Triggers on the PXIe-5663E/5665.

OverflowErrorReporting

class nirfsa.OverflowErrorReporting
WARNING

Configures NI-RFSA to return a warning when an ADC or onboard signal processing (OSP) overflow occurs.

DISABLED

Configures NI-RFSA to not return an error or a warning when an ADC or OSP overflow occurs.

PowerSpectrumUnits

class nirfsa.PowerSpectrumUnits
DBM

Units are dB with reference to 1 milliwatt.

VOLTS_SQUARED

Units are in volts squared.

DBMV

Units are dB with reference to 1 millivolt.

DBUV

Units are dB with reference to 1 microvolt.

VOLTS

Units are in volts.

WATTS

Units are in watts.

PxiChassisClk10Source

class nirfsa.PxiChassisClk10Source
NONE

The device does not drive the PXI 10 MHz backplane Reference Clock.

ONBOARD_CLOCK

The device drives the PXI 10 MHz backplane Reference Clock with the PXI-5600 onboard clock. You must connect the 10 MHz OUT connector to the PXI 10 MHz I/O connector on the PXI-5600 front panel to use this option.

REF_IN

The device drives the PXI 10 MHz backplane Reference Clock with the reference source attached to the PXI-5600 FREQ REF IN connector. You must connect the 10 MHz OUT connector to the PXI 10 MHz I/O connector on the PXI-5600 front panel to use this option.

ReferenceClockExportedRate

class nirfsa.ReferenceClockExportedRate
_10MHZ

Exports a 10 MHz Reference Clock.

_100MHZ

Exports a 100 MHz Reference Clock.

_1GHZ

Exports a 1 GHz Reference Clock.

ReferenceClockExportedTerminal

class nirfsa.ReferenceClockExportedTerminal
NONE

The Reference Clock is not exported. This value is not valid for the PXIe-5644/5645/5646.

REF_OUT

Export the clock on the REF IN/OUT terminal on the PXI/PXIe-5652, the REF OUT terminals on the PXIe-5653, or the REF OUT terminal on the PXIe-5644/5645/5646, PXIe-5694, or PXIe-5820/5830/5831/5832/5840/5841.

REF_OUT2

Export the clock on the REF OUT2 terminal on the PXIe-5652. This value is valid only for the PXIe-5663E.

CLK_OUT

Export the clock on the CLK OUT terminal on the IF digitizer. This value is not valid for the PXIe-5644/5645/5646 or PXIe-5820/5830/5831/5832/5840/5841.

IF_COND_REF_OUT

Export the clock on the REF OUT terminal on the PXIe-5694. This value is valid only for the PXIe-5667.

ReferenceClockSource

class nirfsa.ReferenceClockSource
NONE

No Reference Clock is required for the current device configuration. This value is valid only for the PXIe-5694 or the PXIe-5668.

ONBOARD_CLOCK

**PXI-5661 **NI-RFSA locks the NI-RFSA device to the PXI-5600 RF downconverter onboard clock.**PXIe-5663/5663E **NI-RFSA locks the PXIe-5663/5663E to the PXI/PXIe-5652 LO source onboard clock. Connect the REF OUT2 connector (if it exists) on the PXI/PXIe-5652 to the CLK IN terminal on the PXIe-5622. On versions of the PXIe-5663/5663E that lack a REF OUT2 connector on the PXI/PXIe-5652, connect the REF IN/OUT connector on the PXI/PXIe-5652 to the CLK IN terminal on the PXI5622.**PXIe-5665 **NI-RFSA locks the PXIe-5665 to the PXIe-5653 LO source onboard clock. Connect the 100 MHz REF OUT terminal on the PXIe-5653 to the CLK IN terminal on the PXIe-5622.**PXIe-5667 **NI-RFSA locks the PXIe-5667 to the PXIe-5653 LO source onboard clock. Connect the 100 MHz REF OUT terminal on the PXIe-5653 to the CLK IN terminal on the PXIe-5622, and connect the 10 MHZ REF OUT terminal on the PXIe-5653 to the REF/LO IN connector on the PXIe-5694.**PXIe-5668 **Lock the PXIe-5668 to the PXIe-5653 LO SOURCE onboard clock. Connect the LO2 OUT connector on the PXIe-5606 to the CLK IN connector on the PXIe-5624.**PXIe-5830/5831 **For the PXIe-5830, connect the PXIe-5820 REF IN connector to the PXIe-3621 REF OUT connector. For the PXIe-5831/5832, connect the PXIe-5820 REF IN connector to the PXIe-3622 REF OUT connector.**PXIe-5831/5832 with PXIe-5653 **Connect the PXIe-5820 REF IN connector to the PXIe-3622 REF OUT connector. Connect the PXIe-5653 REF OUT (10 MHz) connector to the PXIe-3622 REF IN connector.**PXIe-5644/5645/5646, PXIe-5820/5840/5841 **Lock the NI-RFSA device to its onboard clock.**PXIe-5841 with PXIe-5655 **Lock to the PXIe-5655 onboard clock. Connect the REF OUT connector on the PXIe-5655 to the PXIe-5841 REF IN connector.**PXIe-5842 **Lock to the PXIe-5655 onboard clock. Cables between modules are required as shown in the User Manual for the instrument.**PXIe-5860 **Lock to the PXIe-5860 onboard clock.

REF_IN

PXI-5661 **NI-RFSA locks the NI-RFSA device to the signal at the external FREQ REF IN connector on the PXI-5600**PXIe-5663/5663E **Connect the external signal to the PXI/PXIe-5652 REF IN/OUT connector. Connect the REF OUT2 connector (if it exists) on the PXI/PXIe-5652 to the CLK IN terminal on the PXIe-5622. On versions of the PXIe-5663/5663E that lack a REF OUT2 connector on the PXI/PXIe-5652, this configuration can only be used in external digitizer mode.**PXIe-5665 **Connect the external signal to the PXIe-5653 REF IN connector. Connect the 100 MHz REF OUT terminal on the PXIe-5653 to the CLK IN terminal on the PXIe-5622. If your external clock signal frequency is set to a frequency other than 10 MHz, set the :py:attr:`nirfsa.Session.ref_clock_rate` property according to the frequency of your external clock signal.**PXIe-5667 **Connect the external signal to the PXIe-5653 REF IN connector. Connect the 100 MHz REF OUT terminal on the PXIe-5653 to the CLK IN terminal on the PXIe-5622, and connect the 10 MHZ REF OUT terminal on the PXIe-5653 to the REF/LO IN connector on the PXIe-5694. If your external clock signal frequency is set to a frequency other than 10 MHz, set the :py:attr:`nirfsa.Session.ref_clock_rate` property according to the frequency of your external clock signal.**PXIe-5668 **Connect the external signal to the PXIe-5653 REF IN connector. Connect the LO2 OUT on the PXIe-5606 to the CLK IN connector on the PXIe-5622. If your external clock signal frequency is set to a frequency other than 10 MHz, set the **clock rate parameter according to the frequency of your external clock signal.**PXIe-5694 **Connect the Reference Clock signal to the REF/LO IN connector on the PXIe-5694 front panel.**PXIe-5644/5645/5646, PXIe-5820/5840/5841 **Lock the NI-RFSA device to the signal at the external REF IN connector.**PXIe-5830/5831 **For the PXIe-5830, connect the PXIe-5820 REF IN connector to the PXIe-3621 REF OUT connector. For the PXIe-5831, connect the PXIe-5820 REF IN connector to the PXIe-3622 REF OUT connector. For the PXIe-5830, lock the external signal to the PXIe-3621 REF IN connector. For the PXIe-5831/5832, lock the external signal to the PXIe-3622 REF IN connector.**PXIe-5831/5832 with PXIe-5653 **Connect the PXIe-5820 REF IN connector to the PXIe-3622 REF OUT connector. Connect the PXIe-5653 REF OUT (10 MHz) connector to the PXIe-3622 REF IN connector. Lock the external signal to the PXIe-5653 REF IN connector.**PXIe-5841 with PXIe-5655 **Lock to the signal at the REF IN connector on the associated PXIe-5655. Connect the REF OUT connector on the PXIe-5655 to the PXIe-5841 REF IN connector. **PXIe-5842 **Lock to the signal at the REF IN connector on the associated PXIe-5655. Cables between modules are required as shown in the User Manual for the instrument. PXIe-5860 Lock to the signal at the REF IN connector on the PXIe-5860.

PXI_CLK

**PXI-5661 **NI-RFSA locks the NI-RFSA device to the PXI backplane clock using the PXI-5600. You must connect the PXI 10 MHz connector to the REF IN connector on the PXI-5600 front panel to use this option. **PXIe-5668 **Lock the PXIe-5653 to the PXI backplane clock. Connect the PXIe-5606 LO2 OUT to the LO2 IN connector on the PXIe-5624.**PXIe-5644/5645/5646, PXIe-5663/5663E/5665/5667, PXIe-5694, PXIe-5820/5830/5831/5831/5832 with PXIe-5653/5840/5840 with PXIe-5653/5841/5841 with PXIe-5655/5842/5860 **Lock the device to the PXI backplane clock.

CLK_IN

PXI-5661 **This configuration does not apply to the PXI-5661.**PXIe-5663/5663E **NI-RFSA locks the PXIe-5663/5663E to an external 10 MHz signal. Connect the external signal to the CLK IN connector on the PXIe-5622, and connect the PXIe-5622 CLK OUT connector to the FREQ REF IN connector on the PXI/PXIe-5652.**PXIe-5665 **NI-RFSA locks the PXIe-5665 to an external 100 MHz signal. Connect the external signal to the CLK IN connector on the PXIe-5622, and connect the PXIe-5622 CLK OUT connector to the REF IN connector on the PXIe-5653. Set the :py:attr:`nirfsa.Session.ref_clock_rate` property to 100 MHz.**PXIe-5667 **NI-RFSA locks the PXIe-5667 to an external 100 MHz signal. Connect the external signal to the CLK IN connector on the PXIe-5622, and connect the PXIe-5622 CLK OUT connector to the REF IN connector on the PXIe-5653. Connect the 10 MHZ REF OUT terminal on the PXIe-5653 to the REF/LO IN connector on the PXIe-5694. Set the :py:attr:`nirfsa.Session.ref_clock_rate` property to 100 MHz.**PXIe-5668 **Lock the PXIe-5668 to an external 100 MHz signal. Connect the external signal to the CLK IN connector on the PXIe-5624, and connect the PXIe-5624 CLK OUT connector to the REF IN connector on the PXIe-5653. Set the **clock rate parameter to 100 MHz.**PXIe-5644/5645/5646, PXIe-5820/5830/5831/5831/5832 with PXIe-5653/5840/5840 with PXIe-5653/5841/5841 with PXIe-5655/5842/5860 **This configuration does not apply.

PXI_CLK_MASTER

**PXIe-5831/5832 with PXIe-5653 **NI-RFSA configures the PXIe-5653 to export the Reference clock and configures the PXIe-5820 and PXIe-3622 to use PXI_Clk as the Reference Clock source. Connect the PXIe-5653 REF OUT (10 MHz) connector to the PXI chassis REF IN connector.**PXI-5661, PXIe-5663/5663E/5665/5667/5668, PXIe-5644/5645/5646, PXIe-5820/5840/5841/5841 with PXIe-5655 /5842/5860**This configuration does not apply.

REF_IN_2

**PXI-5661, PXIe-5663/5663E/5665/5667/5668, PXIe-5644/5645/5646, PXIe-5820/5830/5831/5831/5832 with PXIe-5653/5840/5841/5841 with PXIe-5655 **This configuration does not apply.

ReferenceLevelDataType

class nirfsa.ReferenceLevelDataType
MECHANICAL_ATTENUATOR_DISABLED

The data is the configuration data when the mechanical relay is disabled. Use this option to save uncalibrated measurements for more advanced operations.

DEFAULT

The data is the default configuration data.

ReferenceTriggerDigitalEdgeEdge

class nirfsa.ReferenceTriggerDigitalEdgeEdge
RISING

The trigger asserts on the rising edge of the signal.

FALLING

The trigger asserts on the falling edge of the signal

ReferenceTriggerIqPowerEdgeSlope

class nirfsa.ReferenceTriggerIqPowerEdgeSlope
RISING

The trigger asserts when the signal power is rising.

FALLING

The trigger asserts when the signal power is falling.

ReferenceTriggerOspDelayEnabled

class nirfsa.ReferenceTriggerOspDelayEnabled
DISABLED

Disables OSP delay for the Reference Trigger.

ENABLED

Enables OSP delay for the Reference Trigger.

ReferenceTriggerType

class nirfsa.ReferenceTriggerType
NONE

No Reference Trigger is configured.

DIGITAL_EDGE

The Reference Trigger is not asserted until a digital edge is detected. The source of the digital edge is specified with the nirfsa.Session.digital_edge_ref_trigger_source property.

IQ_POWER_EDGE

The Reference Trigger is asserted when the signal is changing past the level specified with the slope (rising or falling) configured with the nirfsa.Session.iq_power_edge_ref_trigger_slope property.

SOFTWARE_EDGE

The Reference Trigger is not asserted until a software trigger occurs. You can assert the software trigger by calling the nirfsa.Session.send_software_edge_trigger() method and selecting NIRFSA_VAL_REF_TRIGGER as the trigger parameter.

IQ_ANALOG_EDGE

The Reference Trigger is asserted when the I or Q signal is changed past the level specified with the slope configured with the nirfsa.Session.IQ_ANALOG_EDGE_REF_TRIGGER_SLOPE property. This value is valid only for PXIe-5644/5645 devices.

ResetWithOptionsStepsToOmit

class nirfsa.ResetWithOptionsStepsToOmit
DEEMBEDDING_TABLES

Omits deleting de-embedding tables. This step is valid only for the PXIe-5830/5831/5832/5840.

NONE

No step is omitted during reset.

ROUTES

Omits the routing reset step. Routing is preserved after a reset. However, routing related properties are reset to default, and routing is released if the default properties are committed after a reset.

RfLbSigCondPathSel

class nirfsa.RfLbSigCondPathSel
EXT_CAL_RF_LOWBAND_SIGNAL_CONDITIONING_PATH_1

yet to be defined

EXT_CAL_RF_LOWBAND_SIGNAL_CONDITIONING_PATH_2

yet to be defined

RfOutLoExport

class nirfsa.RfOutLoExport
DISABLED

The LO signal is not exported from the RF OUT LO OUT terminal.

ENABLED

The LO signal is exported from the RF OUT LO OUT terminal.

UNSPECIFIED

The LO signal may or may not be exported to the RF OUT LO OUT terminal, because NI-RFSG may be controlling it.

RfPathSelection

class nirfsa.RfPathSelection
EXT_CAL_RF_BAND_1

The data is the default configuration data.

EXT_CAL_RF_BAND_2

The data is the configuration data when the mechanical relay is disabled. Use this option to save uncalibrated measurements for more advanced operations.

EXT_CAL_RF_BAND_3

The data is the default configuration data.

EXT_CAL_RF_BAND_4

The data is the default configuration data.

SelfCalSteps

class nirfsa.SelfCalSteps
DIGITIZER_SELF_CAL

Omits the Image Suppression step. If you omit this step, the Residual Sideband Image performance is not adjusted.

PRESELECTOR_ALIGNMENT

Omits the LO Self Cal step. If you omit this step, the power level of the LO is not adjusted.

OMIT_NONE

No calibration steps are omitted.

GAIN_REFERENCE

Omits the Power Level Accuracy step. If you omit this step, the power level accuracy of the device is not adjusted.

IF_FLATNESS

Omits the Residual LO Power step. If you omit this step, the Residual LO Power performance is not adjusted.

LO_SELF_CAL

Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.

AMPLITUDE_ACCURACY

Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.

RESIDUAL_LO_POWER

Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.

IMAGE_SUPPRESSION

Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.

SYNTHESIZER_ALIGNMENT

Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.

DC_OFFSET

Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.

SelfCalibrateRangeStepsToOmit

class nirfsa.SelfCalibrateRangeStepsToOmit
DIGITIZER_SELF_CAL

Omits the Image Suppression step. If you omit this step, the Residual Sideband Image performance is not adjusted.

PRESELECTOR_ALIGNMENT

Omits the LO Self Cal step. If you omit this step, the power level of the LO is not adjusted.

OMIT_NONE

No calibration steps are omitted.

GAIN_REFERENCE

Omits the Power Level Accuracy step. If you omit this step, the power level accuracy of the device is not adjusted.

IF_FLATNESS

Omits the Residual LO Power step. If you omit this step, the Residual LO Power performance is not adjusted.

LO_SELF_CAL

Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.

AMPLITUDE_ACCURACY

Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.

RESIDUAL_LO_POWER

Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.

IMAGE_SUPPRESSION

Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.

SYNTHESIZER_ALIGNMENT

Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.

DC_OFFSET

Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.

SelfCalibrationStep

class nirfsa.SelfCalibrationStep
PRESELECTOR_ALIGNMENT

Calls for preselector alignment.

GAIN_REFERENCE

Measures the changes in gain since the last external calibration was run.

IF_FLATNESS

Measures the IF response of the entire system for each of the supported IF filters

DIGITIZER_SELF_CAL

Calls for digitizer self-calibration, if the digitizer is associated with the RF downconverter.

LO_SELF_CAL

Calls for LO self-calibration, if the LO source module is associated with the RF downconverter.

AMPLITUDE_ACCURACY

Selects the Amplitude Accuracy self-calibration step.

RESIDUAL_LO_POWER

Selects the Residual LO Power self-calibration step.

IMAGE_SUPPRESSION

Selects the Image Suppression self-calibration step.

SYNTHESIZER_ALIGNMENT

Selects the Synthesizer Alignment self-calibration step.

DC_OFFSET

Selects the DC Offset self-calibration step.

Signal

class nirfsa.Signal
START_TRIGGER

NI-RFSA routes a Start Trigger.

REF_TRIGGER

NI-RFSA routes a Reference

ADVANCE_TRIGGER

NI-RFSA routes an Advance

READY_FOR_START_EVENT

NI-RFSA routes a Ready for Start Event.

READY_FOR_REF_EVENT

NI-RFSA routes a Ready for Reference Event..

END_OF_RECORD_EVENT

NI-RFSA routes a End of Record Event.

DONE_EVENT

NI-RFSA routes a Done Event.

REF_CLOCK

NI-RFSA routes a Reference Clock.

USER

NI-RFSA routes a User Defined Signal.

SignalConditioningEnabled

class nirfsa.SignalConditioningEnabled
ENABLED

Enables signal conditioning.

BYPASSED

Bypasses all signal conditioning.

SmoothSpectrumEnabled

class nirfsa.SmoothSpectrumEnabled
DISABLED

Disables spectrum smoothing.

ENABLED

Enables spectrum smoothing.

SoftwareTriggerType

class nirfsa.SoftwareTriggerType
START

NI-RFSA sends a Start software trigger.

REF

NI-RFSA sends a Reference software trigger.

ADVANCE

NI-RFSA sends an Advance software trigger.

ARM_REF

NI-RFSA sends an Arm Reference software trigger. This trigger is not valid for the PXIe-5668.

SparameterOrientation

class nirfsa.SparameterOrientation
PORT1_TOWARDS_DUT

Port 1 of the S2P is oriented towards the DUT port.

PORT2_TOWARDS_DUT

Port 2 of the S2P is oriented towards the DUT port.

SpectrumAveragingMode

class nirfsa.SpectrumAveragingMode
NO

Configures NI-RFSA to perform no averaging on acquisitions.

RMS

Configures NI-RFSA for root-mean-square (RMS) averaging. RMS averaging reduces signal fluctuations but not the noise floor. RMS averaging averages the energy, or power, of the signal. This averaging prevents noise floor reduction and gives averaged RMS quantities of single-channel measurements zero phase. RMS averaging for dual-channel measurements preserves important phase information.

VECTOR

Configures NI-RFSA for vector averaging. Vector averaging reduces noise from synchronous signals. Vector averaging computes the average of complex quantities directly, which means that it allows separate averaging for real and imaginary parts. Complex averaging such as vector averaging reduces noise and usually requires a trigger to improve block-to-block phase coherence.

PEAK_HOLD

Configures NI-RFSA for peak-hold averaging. Peak-hold averaging retains the RMS peak levels of the averaged quantities. The peak-hold averaging process performs peak-hold at each frequency bin separately to retain peak RMS levels from one FFT record to the next.

MIN_HOLD

Configures NI-RFSA to perform no averaging on acquisitions.

SCALAR

Configures NI-RFSA to perform no averaging on acquisitions.

LOG

Configures NI-RFSA to perform no averaging on acquisitions.

SpectrumFftWindowType

class nirfsa.SpectrumFftWindowType
UNIFORM

No window is applied.

HANNING

The Hanning window is useful for analyzing transients longer than the time duration of the window, and also for general-purpose applications.

HAMMING

A Hamming window is applied to the waveform using the following equation: y[i] = x[i] * (0.54 - 0.46cos(w)) where w = (2)i/n and n = the waveform size. Note: Hanning and Hamming windows are somewhat similar. However, in the time domain, the Hamming window does not get as close to zero near the edges as does the Hanning window.

BLACKMAN_HARRIS

A Blackman-Harris window is applied to the waveform using the following equation: y[i] = x[i] * (0.42323 - 0.49755*cos(w) + 0.07922*cos(2w))

EXACT_BLACKMAN

An Exact Blackman window is applied to the waveform using the following equation: y[i] = x[i] * (a0 - a1*cos(w) + a2*cos(2w))

BLACKMAN

A Blackman window is useful for analyzing transient signals, and provides similar windowing to Hanning and Hamming windows but adds one additional cosine term to reduce ripple. A Blackman window is applied to the waveform using the following equation: y[i] = x[i] * (0.42 - 0.50*cos(w) + 0.08*cos(2w))

FLAT_TOP

The fifth-order Flat Top window has the best amplitude accuracy of all the window methods. The increased amplitude accuracy (0.02 dB for signals exactly between integral cycles) is at the expense of frequency selectivity. The Flat Top window is most useful in accurately measuring the amplitude of single frequency components with little nearby spectral energy in the signal. A fifth-order Flat Top window is applied to the waveform using the following equation: y[i] = x[i] * (a0 - a1*cos(w) + a2*cos(2w) - a3*cos(3w) + a4*cos(4w))

_4_TERM_BLACKMAN_HARRIS

A 4-term Blackman-Harris window is a general purpose window; it has side-lobe rejection in the upper 90 dB, with moderately wide side lobe. A 4-term Blackman Harris window is applied to the waveform using the following equation: y[i] = x[i] * (a0 - a1*cos(w) + a2*cos(2w) - a3*cos(3w))

_7_TERM_BLACKMAN_HARRIS

A 7-term Blackman-Harris window has the highest dynamic range; it is ideal for signal-to-noise ratio applications. A 7-term Blackman Harris window is applied to the waveform using the following equation: y[i] = x[i] * (a0 - a1*cos(w) + a2*cos(2w) - a3*cos(3w) + a4*cos(4w) - a5*cos(5w) + a6*cos(6w))

LOW_SIDE_LOBE

The Low Side Lobe window further reduces the size of the main lobe. The following equation defines the Low Side Lobe window. where N is the length of window

GAUSSIAN

A Gaussian window is applied to the waveform using the following equation: y[i] = x[i] * exp(-0.5*(i - (N-1)/2)^2 / ((N-1)/2)^2) where N is the length of the window

KAISER_BESSEL

A Kaiser-Bessel window is applied to the waveform using the following equation: y[i] = x[i] * I0(β*sqrt(1 - (2i/(N-1) - 1)^2))/I0(β) where i is between 0 and N-1, N is the length of the window, β determines the shape of the window, and I0 is the zeroth order Modified Bessel method of the first kind

SpectrumResolutionBandwidthType

class nirfsa.SpectrumResolutionBandwidthType
THREE_DECIBELS

Defines the resolution bandwidth (RBW) in terms of the 3 dB bandwidth of the window specified by the nirfsa.Session.fft_window_type property.

SIX_DECIBELS

Defines the RBW in terms of the 6 dB bandwidth of the window specified by the nirfsa.Session.fft_window_type property.

BIN_WIDTH

Defines the RBW in terms of the display resolution, which is the ratio of the sampling frequency to the number of samples that you acquire.

EQUIVALENT_NOISE_BANDWIDTH

Defines the RBW in terms of the equivalent noise bandwidth (ENBW) of the window specified by the nirfsa.Session.fft_window_type property.

StartTriggerDigitalEdgeEdge

class nirfsa.StartTriggerDigitalEdgeEdge
RISING

The trigger asserts on the rising edge of the signal.PXI-5661, PXIe-5663/5663E/5665/5668

FALLING

The trigger asserts on the falling edge of the signal | PXIe-5668

StartTriggerType

class nirfsa.StartTriggerType
NONE

No Start Trigger is configured.

DIGITAL_EDGE

The Start Trigger is not asserted until a digital edge is detected. The source of the digital edge is specified with the nirfsa.Session.digital_edge_start_trigger_source property.

SOFTWARE_EDGE

The Start Trigger is not asserted until a software trigger occurs. You can assert the software trigger by calling the nirfsa.Session.send_software_edge_trigger() method and selecting NIRFSA_VAL_START_TRIGGER as the value of the trigger parameter.

StepsToOmit

class nirfsa.StepsToOmit
DEEMBEDDING_TABLES

Omits deleting de-embedding tables. This step is valid only for the PXIe-5830/5831/5832/5840.

NONE

No step is omitted during reset.

ROUTES

Omits the routing reset step. Routing is preserved after a reset. However, routing related properties are reset to default, and routing is released if the default properties are committed after a reset.

SyncRefTriggerDelayEnabled

class nirfsa.SyncRefTriggerDelayEnabled
DISABLED

Disables synchronization reference trigger delay.

ENABLED

Enables synchronization reference trigger delay.

UserSourcePulseWidthUnits

class nirfsa.UserSourcePulseWidthUnits
SECONDS

Units are seconds.

CLOCK_PERIODS

Units are clock periods.