NR

Defines a root class which is used to identify and control NR signal configuration.

class nirfmxnr.nr.NR(session, signal_name='', cloning=False)[source]

Bases: _NRBase

Defines a root class which is used to identify and control NR signal configuration.

abort_measurements(selector_string)

Stops acquisition and measurements associated with signal instance that you specify in the Selector String parameter, which were previously initiated by the initiate() method or measurement read methods. Calling this method is optional, unless you want to stop a measurement before it is complete. This method executes even if there is an incoming error.

Parameters:: selector_string (string) – Pass an empty string. The signal name that is passed when creating the signal configuration is used.
Returns:: Returns the status code of this method. The status code either indicates success or describes a warning condition.
Return type:: int

analyze_iq_1_waveform(selector_string, result_name, x0, dx, iq, reset)

Performs the enabled measurements on the I/Q complex waveform that you specify in IQ parameter. Call this method after you configure the signal and measurement attributes. You can fetch measurement results using the Fetch methods or result attributes in the attribute node. Use this method only if the RECOMMENDED_ACQUISITION_TYPE attribute value is either IQ or IQ or Spectral.

When using the Analysis-Only mode in RFmxNR, the RFmx driver ignores the RFmx hardware settings such as reference level and attenuation. The only RF hardware settings that are not ignored are the center frequency and trigger type, since it is needed for spectral measurement traces as well as some measurements such as ModAcc, ACP, and SEM.

Note

Query the Recommended Acquisition Type attribute from the RFmxInstr Attribute after calling the commit() method.

Parameters:

selector_string (string) –
This parameter specifies the signal name and result name. The result name can either be specified through this input or the Result Name parameter. If you do not specify the result name in this parameter, either the result name specified by the Result Name parameter or the default result instance is used.

Example:

””

”result::r1”

You can use the build_result_string() method to build the Selector String.
result_name (string) –
This parameter specifies the name to be associated with measurement results. Provide a unique name, such as “r1” to enable fetching of multiple measurement results and traces. This input accepts the result name with or without the “result::” prefix. The default value is “” (empty string), which refers to the default result instance.

Example:

””

”result::r1”

”r1”
x0 (float) – This parameter specifies the start time of the input y array. This value is expressed in seconds.
dx (float) – This parameter specifies the time interval between the samples in the input y array. This value is expressed in seconds. The reciprocal of dx indicates the I/Q rate of the input signal.
iq (numpy.complex64) – This parameter specifies an array of complex-valued time domain data. The real and imaginary parts of this complex data array correspond to the in-phase (I) and quadrature-phase (Q) data, respectively.
reset (bool) – This parameter resets measurement averaging. If you enable averaging, set this parameter to TRUE for the first record and FALSE for the subsequent records.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

analyze_n_waveforms_iq(selector_string, result_name, x0, dx, iq, reset)

Performs the enabled measurements on the I/Q complex waveform(s) that you specify in IQ parameter. Call this method after you configure the signal and measurement attributes. You can fetch measurement results using the Fetch methods or result attributes in the attribute node. Use this method only if the RECOMMENDED_ACQUISITION_TYPE attribute value is either IQ or IQ or Spectral.

When using the Analysis-Only mode in RFmxNR, the RFmx driver ignores the RFmx hardware settings such as reference level and attenuation. The only RF hardware settings that are not ignored are the center frequency and trigger type, since it is needed for spectral measurement traces as well as some measurements such as ModAcc, ACP, and SEM.

Note

Query the Recommended Acquisition Type attribute from the RFmxInstr Attribute after calling the commit() method.

Parameters:

selector_string (string) –
This parameter specifies the signal name and result name. The result name can either be specified through this input or the Result Name parameter. If you do not specify the result name in this parameter, either the result name specified by the Result Name parameter or the default result instance is used.

Example:

””

”result::r1”

You can use the build_result_string() method to build the Selector String.
result_name (string) –
This parameter specifies the name to be associated with measurement results. Provide a unique name, such as “r1” to enable fetching of multiple measurement results and traces. This input accepts the result name with or without the “result::” prefix. The default value is “” (empty string) which refers to default result instance.

Example:

””

”result::r1”

”r1”
x0 (float) – This parameter specifies the start time of the input y array. This value is expressed in seconds.
dx (float) – This parameter specifies the time interval between the samples in the input y array. This value is expressed in seconds. The reciprocal of dx indicates the I/Q rate of the input signal.
iq ([numpy.complex64]) – This parameter specifies an array of complex-valued time domain data. The real and imaginary parts of this complex data array correspond to the in-phase (I) and quadrature-phase (Q) data, respectively.
reset (bool) – This parameter resets measurement averaging. If you enable averaging, set this parameter to TRUE for first record and FALSE for subsequent records.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

analyze_n_waveforms_spectrum(selector_string, result_name, x0, dx, spectrum, reset)

Performs the enabled measurements on the spectrum(s) that you specify in the Spectrum parameter. Call this method after you configure the signal and measurement attributes. You can fetch measurement results using the Fetch methods or result attributes in the attribute node. Use this method only if the RECOMMENDED_ACQUISITION_TYPE attribute value is either Spectral or IQ or Spectral.

Note

Query the Recommended Acquisition Type attribute from the RFmxInstr Attribute after calling the commit() method.

Parameters:

selector_string (string) –
This parameter specifies the signal name and result name. The result name can either be specified through this input or the Result Name parameter. If you do not specify the result name in this parameter, either the result name specified by the Result Name parameter or the default result instance is used.

Example:

””

”result::r1”

You can use the build_result_string() method to build the Selector String.
result_name (string) –
This parameter specifies the name to be associated with measurement results. Provide a unique name, such as “r1” to enable fetching of multiple measurement results and traces. This input accepts the result name with or without the “result::” prefix. The default value is “” (empty string), which refers to the default result instance.

Example:

””

”result::r1”

”r1”
x0 (float) – This parameter specifies the start frequency of the spectrum. This value is expressed in Hz.
dx (float) – This parameter specifies the frequency interval between data points in the spectrum.
spectrum ([numpy.float32]) – This parameter specifies the array of real-value power spectrum.
reset (bool) – This parameter resets measurement averaging. If you enable averaging, set this parameter to TRUE for the first record and FALSE for the subsequent records.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

analyze_spectrum_1_waveform(selector_string, result_name, x0, dx, spectrum, reset)

Performs the enabled measurements on the spectrum that you specify in the Spectrum parameter. Call this method after you configure the signal and measurement attributes. You can fetch measurement results using the Fetch methods or result attributes in the attribute node. Use this method only if the RECOMMENDED_ACQUISITION_TYPE attribute value is either Spectral or IQ or Spectral.

When using the Analysis-Only mode in RFmxNR, the RFmx driver ignores the RFmx hardware settings such as reference level and attenuation. The only RF hardware settings that are not ignored are the center frequency and trigger type, since it is needed for spectral measurement traces as well as some measurements such as ModAcc, ACP, and SEM.

Note

Query the Recommended Acquisition Type attribute from the RFmxInstr Attribute after calling the commit() method.

Parameters:

selector_string (string) –
This parameter specifies the signal name and result name. The result name can either be specified through this input or the Result Name parameter. If you do not specify the result name in this parameter, either the result name specified by the Result Name parameter or the default result instance is used.

Example:

””

”result::r1”

You can use the build_result_string() method to build the Selector String.
result_name (string) –
This parameter specifies the name to be associated with measurement results. Provide a unique name, such as “r1” to enable fetching of multiple measurement results and traces. This input accepts the result name with or without the “result::” prefix. The default value is “” (empty string), which refers to the default result instance.

Example:

””

”result::r1”

”r1”
x0 (float) – This parameter specifies the start frequency of the spectrum. This value is expressed in Hz.
dx (float) – This parameter specifies the frequency interval between data points in the spectrum.
spectrum (numpy.float32) – This parameter specifies the real-value power spectrum.
reset (bool) – This parameter resets measurement averaging. If you enable averaging, set this parameter to TRUE for the first record and FALSE for the subsequent records.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

auto_level(selector_string, measurement_interval)

Examines the input signal to calculate the peak power level and sets it as the value of the REFERENCE_LEVEL attribute. Use this method to calculate an approximate setting for the reference level.

The RFmxNR Auto Level method completes the following tasks: #. Resets the mixer level, mixer level offset, and IF output power offset.

Sets the starting reference level to the maximum reference level supported by the device based on the current RF attenuation, mechanical attenuation, and preamplifier enabled settings.
Iterates to adjust the reference level based on the input signal peak power.
Uses immediate triggering and restores the trigger settings back to user setting after the execution.

When using NI-PXIe 5663, NI-PXIe 5665, or NI-PXIe 5668R device, NI recommends that you set an appropriate value for mechanical attenuation before calling the RFmxNR Auto Level method. Setting an appropriate value for mechanical attenuation reduces the number of times the attenuator settings are changed by this function; thus reducing wear and tear, and maximizing the life time of the attenuator.

Parameters:

selector_string (string) – Pass an empty string. The signal name that is passed when creating the signal configuration is used.
measurement_interval (float) –
This parameter specifies the acquisition length. This value is expressed in seconds. Use this value to compute the number of samples to acquire from the signal analyzer. The default value is 10 ms.

Auto Level method does not use any trigger for acquisition. It ignores the user-configured trigger attributes. NI recommends that you set a sufficiently high measurement interval to ensure that the acquired waveform is at least as long as one period of the signal.

Returns:

reference_level (float):: This parameter returns the estimated peak power level of the input signal. This value is expressed in dBm. The default value of this parameter is hardware dependent.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (reference_level, error_code)

static build_bandwidth_part_string(selector_string, bandwidth_part_number)

Creates the bandwidth part string.

Parameters:

selector_string (string) – Specifies the result name for building the selector string.
bandwidth_part_number (int) – This parameter specifies the bandwidth part number for building the selector string.

Returns:

Contains the selector string created by this method.

Return type:

string

static build_carrier_string(selector_string, carrier_number)

Creates the carrier string.

Parameters:

selector_string (string) – Specifies the result name for building the selector string.
carrier_number (int) – This parameter specifies the carrier number for building the selector string.

Returns:

Contains the selector string created by this method.

Return type:

string

static build_chain_string(selector_string, chain_number)

Creates a chain string.

Parameters:

selector_string (string) – Specifies the result name for building the selector string.
chain_number (int) – This parameter specifies the chain number for building the selector string.

Returns:

Contains the selector string created by this method.

Return type:

string

static build_coreset_cluster_string(selector_string, coreset_cluster_number)

Creates the coreset cluster string.

Parameters:

selector_string (string) – Specifies the result name for building the selector string.
coreset_cluster_number (int) – This parameter specifies the CORESET cluster number for building the selector string.

Returns:

Contains the selector string created by this method.

Return type:

string

static build_coreset_string(selector_string, coreset_number)

Creates the coreset string.

Parameters:

selector_string (string) – Specifies the result name for building the selector string.
coreset_number (int) – This parameter specifies the CORESET number for building the selector string.

Returns:

Contains the selector string created by this method.

Return type:

string

static build_layer_string(selector_string, layer_number)

Creates a layer string.

Parameters:

selector_string (string) – Specifies the result name for building the selector string.
layer_number (int) – This parameter specifies the layer number for building the selector string.

Returns:

Contains the selector string created by this method.

Return type:

string

static build_offset_string(selector_string, offset_number)

Creates the offset string.

Parameters:

selector_string (string) – Specifies the result name for building the selector string.
offset_number (int) – This parameter specifies the offset number for building the selector string.

Returns:

Contains the selector string created by this method.

Return type:

string

static build_pdcch_string(selector_string, pdcch_number)

Creates the PDCCH string.

Parameters:

selector_string (string) – Specifies the result name for building the selector string.
pdcch_number (int) – This parameter specifies the PDCCH number for building the selector string.

Returns:

Contains the selector string created by this method.

Return type:

string

static build_pdsch_cluster_string(selector_string, pdsch_cluster_number)

Creates a PDSCH Cluster string.

Parameters:

selector_string (string) – Specifies the result name for building the selector string.
pdsch_cluster_number (int) – This parameter specifies the PDSCH cluster number for building the selector string.

Returns:

Contains the selector string created by this method.

Return type:

string

static build_pdsch_string(selector_string, pdsch_number)

Creates the PDSCH string.

Parameters:

selector_string (string) – Specifies the result name for building the selector string.
pdsch_number (int) – This parameter specifies the PDSCH number for building the selector string.

Returns:

Contains the selector string created by this method.

Return type:

string

static build_pusch_cluster_string(selector_string, pusch_cluster_number)

Creates a PUSCH Cluster string.

Parameters:

selector_string (string) – Specifies the result name for building the selector string.
pusch_cluster_number (int) – This parameter specifies the PUSCH cluster number for building the selector string.

Returns:

Contains the selector string created by this method.

Return type:

string

static build_pusch_string(selector_string, pusch_number)

Creates the PUSCH string.

Parameters:

selector_string (string) – Specifies the result name for building the selector string.
pusch_number (int) – This parameter specifies the PUSCH number for building the selector string.

Returns:

Contains the selector string created by this method.

Return type:

string

static build_result_string(result_name)

Creates selector string for use with configuration or fetch.

Parameters:: result_name (string) – Specifies the result name for building the selector string. This input accepts the result name with or without the “result::” prefix. Example: “”, “result::r1”, “r1”.
Returns:: Contains the selector string created by this method.
Return type:: string

static build_subblock_string(selector_string, subblock_number)

Creates the subblock string.

Parameters:

selector_string (string) – Specifies the result name for building the selector string.
subblock_number (int) – This parameter specifies the number of subblocks that are configured in the non-contiguous carrier aggregation. Set this parameter to 1, which is the default, for single carrier and intra-band contiguous carrier aggregation.

Returns:

Contains the selector string created by this method.

Return type:

string

static build_user_string(selector_string, user_number)

Creates the user number string.

Parameters:

selector_string (string) – Specifies the result name for building the selector string.
user_number (int) – This parameter specifies the user number for building the selector string.

Returns:

Contains the selector string created by this method.

Return type:

string

check_measurement_status(selector_string)

Checks the status of the measurement. Use this method to check for any errors that may occur during measurement or to check whether the measurement is complete and results are available.

Parameters:

selector_string (string) –

This parameter specifies a Selector String comprising of the result name. The default is “” (empty string).

Example:

”result::r1”

You can use the build_result_string() method to build the selector string.

Returns:

is_done (bool):: This parameter indicates whether the measurement is complete.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (is_done, error_code)

clear_all_named_results(selector_string)

Clears all results for the signal that you specify in the Selector String parameter.

Parameters:: selector_string (string) – Pass an empty string. The signal name that is passed when creating the signal configuration is used.
Returns:: Returns the status code of this method. The status code either indicates success or describes a warning condition.
Return type:: int

clear_named_result(selector_string)

Clears a result instance specified by the result name in the Selector String parameter.

Parameters:

selector_string (string) –

This parameter specifies a Selector String comprising of the result name. The default is “” (empty string).

Example:

”result::r1”

You can use the build_result_string() method to build the selector string.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

clear_noise_calibration_database(selector_string)

Clears the noise calibration database used for noise compensation.

Parameters:: selector_string (string) – Pass an empty string. The signal name that is passed when creating the signal configuration is used.
Returns:: Returns the status code of this method. The status code either indicates success or describes a warning condition.
Return type:: int

clone_signal_configuration(new_signal_name)

Creates a new instance of a signal by copying all the properties from an existing signal instance.

Parameters:

new_signal_name (string) –

This parameter specifies the name of the new signal. This parameter accepts the signal name with or without the "signal::" prefix.

Example:

"signal::NewSigName"

"NewSigName"

Returns:

cloned_signal (nr):: Contains a new NR signal instance.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (cloned_signal, error_code)

commit(selector_string)

Commits settings to the hardware. Calling this method is optional. RFmxNR commits settings to the hardware when you call the initiate() method.

Parameters:: selector_string (string) – Pass an empty string. The signal name that is passed when creating the signal configuration is used.
Returns:: Returns the status code of this method. The status code either indicates success or describes a warning condition.
Return type:: int

configure_digital_edge_trigger(selector_string, digital_edge_source, digital_edge, trigger_delay, enable_trigger)

Configures the device to wait for a digital edge trigger and then marks a reference point within the record.

Spectral measurements are sometimes implemented with multiple acquisitions and therefore will require that digital triggers are sent for each acquisition. Multiple factors, including the desired span versus the realtime bandwidth of the hardware, affect the number of acquisitions. NI recommends repeating the generation until the measurement is completed in order to ensure that all the acquisitions are triggered.

Parameters:

selector_string (string) – Pass an empty string. The signal name that is passed when creating the signal configuration is used.

digital_edge_source (string) –

This parameter specifies the source terminal for the digital edge trigger. This parameter is used when you set the TRIGGER_TYPE attribute to Digital Edge. The default value of this parameter is hardware dependent.

Name (Value)	Description
PFI0 (0)	The trigger is received on PFI 0.
PFI1 (PFI1)	The trigger is received on PFI 1.
PXI_Trig0 (PXI_Trig0)	The trigger is received on PXI trigger line 0.
PXI_Trig1 (PXI_Trig1)	The trigger is received on PXI trigger line 1.
PXI_Trig2 (PXI_Trig2)	The trigger is received on PXI trigger line 2.
PXI_Trig3 (PXI_Trig3)	The trigger is received on PXI trigger line 3.
PXI_Trig4 (PXI_Trig4)	The trigger is received on PXI trigger line 4.
PXI_Trig5 (PXI_Trig5)	The trigger is received on PXI trigger line 5.
PXI_Trig6 (PXI_Trig6)	The trigger is received on PXI trigger line 6.
PXI_Trig7 (PXI_Trig7)	The trigger is received on PXI trigger line 7.
PXI_STAR (PXI_STAR)	The trigger is received on the PXI star trigger line.
PXIe_DStarB (PXIe_DStarB)	The trigger is received on the PXIe DStar B trigger line.
TimerEvent (TimerEvent)	The trigger is received from the timer event.

digital_edge (enums.DigitalEdgeTriggerEdge, int) –
This parameter specifies the source terminal for the digital edge trigger. This parameter is used when you set the Trigger Type attribute to Digital Edge. 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.
trigger_delay (float) – This parameter 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. The default value is 0.
enable_trigger (bool) – This parameter specifies whether to enable the trigger. The default value is TRUE.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

configure_external_attenuation(selector_string, external_attenuation)

Specifies the attenuation of a switch or cable connected to the RF IN connector of the signal analyzer.

Parameters:

selector_string (string) – Pass an empty string. The signal name that is passed when creating the signal configuration is used.
external_attenuation (float) – This parameter specifies the attenuation of a switch or cable connected to the RF IN connector of the signal analyzer. This value is expressed in dB. For more information about attenuation, refer to the RF Attenuation and Signal Levels topic for your device in the* NI RF Vector Signal Analyzers Help*. The default value is 0.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

configure_frequency(selector_string, center_frequency)

Configures the expected carrier frequency of the RF signal to acquire. The signal analyzer tunes to this frequency.

Parameters:

selector_string (string) –
This parameter specifies a Selector String comprising of the subblock number.

Example:

”subblock0”

You can use the build_result_string() method to build the selector string.
center_frequency (float) – This parameter specifies the expected carrier frequency, in Hz, of the RF signal to acquire. The signal analyzer tunes to this frequency. The default of this attribute is hardware dependent.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

configure_gnodeb_category(selector_string, gnodeb_category)

Configures the gNodeB Category of the signal being measured.

Parameters:

selector_string (string) – Pass an empty string. The signal name that is passed when creating the signal configuration is used.

gnodeb_category (enums.gNodeBCategory, int) –

This parameter specifies the downlink gNodeB (Base station) category. Refer to 3GPP 38.104 specification for more information about gNodeB Category. The default value is Wide Area Base Station - Category A.

Name (Value)	Description
Wide Area Base Station - Category A (0)	Specifies that gNodeB is of type Wide Area Base Station - Category A.
Wide Area Base Station - Category B Option1 (1)	Specifies that gNodeB is of type Wide Area Base Station - Category B Option1.
Wide Area Base Station - Category B Option2 (2)	Specifies that gNodeB is of type Wide Area Base Station - Category B Option2.
Local Area Base Station (3)	Specifies that gNodeB is of type Local Area Base Station.
Medium Range Base Station (5)	Specifies that gNodeB is of type Medium Range Base Station.
FR2 Category A (6)	Specifies that gNodeB is of type FR2 Category A.
FR2 Category B (7)	Specifies that gNodeB is of type FR2 Category B.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

configure_iq_power_edge_trigger(selector_string, iq_power_edge_trigger_source, iq_power_edge_trigger_slope, iq_power_edge_trigger_level, trigger_delay, trigger_minimum_quiet_time_mode, trigger_minimum_quiet_time_duration, iq_power_edge_trigger_level_type, enable_trigger)

Configures the device to wait for the complex power of the I/Q data to cross the specified threshold and then marks a reference point within the record.

To trigger on bursty signals, specify a minimum quiet time, which ensures that the trigger does not occur in the middle of the burst signal. The quiet time must be set to a value smaller than the time between bursts, but large enough to ignore power changes within a burst.

Parameters:

selector_string (string) – Pass an empty string. The signal name that is passed when creating the signal configuration is used.
iq_power_edge_trigger_source (string) – This parameter specifies the channel from which the device monitors the trigger. This parameter is used only when you set the TRIGGER_TYPE attribute to IQ Power Edge. The default value of this parameter is hardware dependent.
iq_power_edge_trigger_slope (enums.IQPowerEdgeTriggerSlope, int) – This parameter specifies whether the device asserts the trigger when the signal power is rising or when it is falling. The device asserts the trigger when the signal power exceeds the specified level with the slope you specify. This parameter is used only when you set the Trigger Type attribute to IQ Power Edge. The default value is Rising Slope.
iq_power_edge_trigger_level (float) – This parameter specifies the power level at which the device triggers. This value is expressed in dB when you set the IQ Power Edge Level Type parameter to Relative, and this value is expressed in dBm when you set the IQ Power Edge Level Type parameter to Absolute. The device asserts the trigger when the signal exceeds the level specified by the value of this parameter, taking into consideration the specified slope. This parameter is used only when you set the Trigger Type attribute to IQ Power Edge. The default value of this parameter is hardware dependent.
trigger_delay (float) – This parameter 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. The default value is 0.

trigger_minimum_quiet_time_mode (enums.TriggerMinimumQuietTimeMode, int) –

This parameter specifies whether the measurement computes the minimum quiet time used for triggering. The default value is Auto.

Name (Value)	Description
Manual (0)	The minimum quiet time for triggering is the value of the Min Quiet Time parameter.
Auto (1)	The measurement computes the minimum quiet time used for triggering.

trigger_minimum_quiet_time_duration (float) –
This parameter specifies the time duration for which the signal must be quiet before the signal analyzer arms the I/Q power edge trigger. This value is expressed in seconds. If you set the IQ Power Edge Slope parameter to Rising Slope, the signal is quiet below the trigger level. If you set the IQ Power Edge Slope parameter to Falling Slope, the signal is quiet above the trigger level.

The default value of this parameter is hardware dependent.

iq_power_edge_trigger_level_type (enums.IQPowerEdgeTriggerLevelType, int) –

This parameter specifies the reference for the** IQ Power Edge Level** parameter. The IQ Power Edge Level Type parameter is used only when you set the Trigger Type attribute to IQ Power Edge.

Name (Value)	Description
Relative (0)	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.

enable_trigger (bool) – This parameter specifies whether to enable the trigger. The default value is TRUE.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

configure_reference_level(selector_string, reference_level)

Configures the reference level which represents the maximum expected power of an RF input signal.

Parameters:

selector_string (string) – Pass an empty string. The signal name that is passed when creating the signal configuration is used.
reference_level (float) – This parameter 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. The default value of this parameter is hardware dependent.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

configure_rf(selector_string, center_frequency, reference_level, external_attenuation)

Configures the RF attributes of the signal specified by the selector string.

Parameters:

selector_string (string) – Pass an empty string. The signal name that is passed when creating the signal configuration is used.
center_frequency (float) – This parameter specifies the expected carrier frequency, in Hz, of the RF signal to acquire. The signal analyzer tunes to this frequency. The default of this attribute is hardware dependent.
reference_level (float) – This parameter 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. The default value of this parameter is hardware dependent.
external_attenuation (float) – This parameter specifies the attenuation of a switch or cable connected to the RF IN connector of the signal analyzer. This value is expressed in dB. For more information about attenuation, refer to the RF Attenuation and Signal Levels topic for your device in the* NI RF Vector Signal Analyzers Help*. The default value is 0.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

configure_selected_ports_multiple(selector_string, selected_ports)

Configures the selected ports to each chain based on the values you set in NUMBER_OF_RECEIVE_CHAINS attribute.

Parameters:

selector_string (string) – Pass an empty string. The signal name that is passed when creating the signal configuration is used.
selected_ports (string) –
This parameter specifies the list of MIMO ports to be configured. Use “port::<deviceName>/<channelNumber>” as the format for the selected port.

For PXIe-5830/5831/5832 devices on a MIMO session, the selected port includes the instrument port in the format “port::<deviceName>/<channelNumber>/<instrPort>”.

Example:

port::myrfsa1/0/if1

You can use the build_port_string() method to build the selected port.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

configure_software_edge_trigger(selector_string, trigger_delay, enable_trigger)

Configures the device to wait for a software trigger and then marks a reference point within the record.

Parameters:

selector_string (string) – Pass an empty string. The signal name that is passed when creating the signal configuration is used.
trigger_delay (float) – This parameter 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. The default value is 0.
enable_trigger (bool) – This parameter specifies whether to enable the trigger. The default value is TRUE.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

delete_signal_configuration()

Deletes the current instance of a signal.

Returns:: Returns the status code of this method. The status code either indicates success or describes a warning condition.
Return type:: error_code

disable_trigger(selector_string)

Configures the device to not wait for a trigger to mark a reference point within a record. This method defines the signal triggering as immediate.

Parameters:: selector_string (string) – Pass an empty string. The signal name that is passed when creating the signal configuration is used.
Returns:: Returns the status code of this method. The status code either indicates success or describes a warning condition.
Return type:: int

dispose(): Deletes the signal configuration if it is not the default signal configuration and clears any trace of the current signal configuration, if any.

Note

You can call this function safely more than once, even if the signal is already deleted.

get_acquisition_bandwidth_optimization_enabled(selector_string)

Gets whether RFmx optimizes the acquisition bandwidth. This may cause acquisition center frequency or local oscillator (LO) to be placed at different position than you configured.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is False.

Name (Value)	Description
False (0)	RFmx does not optimize acquisition bandwidth and will be based on the Nyquist criterion. The value of the acquisition center frequency is the same as the value of the Center Frequency that you configure.
True (1)	RFmx positions the acquisition center frequency to acquire the least bandwidth based on the configuration and span needed for the measurement. This helps in reducing the amount of data to process for the measurement, thus improving the speed. However this might cause the LO to be positioned at a non-dc subcarrier position, hence the measurement sensitive to it should have this attribute disabled.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.AcquisitionBandwidthOptimizationEnabled):: Specifies whether RFmx optimizes the acquisition bandwidth. This may cause acquisition center frequency or local oscillator (LO) to be placed at different position than you configured.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_all_named_result_names(selector_string)

Returns all the named result names of the signal that you specify in the Selector String parameter.

Parameters:

selector_string (string) – Pass an empty string. The signal name that is passed when creating the signal configuration is used.

Returns:

result_names (string):: Returns an array of result names.
default_result_exists (bool):: Indicates whether the default result exists.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (result_names, default_result_exists, error_code)

get_auto_cell_id_detection_enabled(selector_string)

Gets whether to enable the autodetection of the cell ID.

When you set the LINK_DIRECTION attribute to Downlink, autodetection of the Cell ID is not possible if the signal measured does not contain SSB with PSS/SSS, or if the PDSCH does not include enough allocated Resource Blocks.

When you set the Link Direction attribute to Uplink, autodetection of the Cell ID is not possible if the PUSCH PUSCH_TRANSFORM_PRECODING_ENABLED attribute is set to True, or if the PUSCH does not include enough allocated Resource Blocks.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is False.

Name (Value)	Description
False (0)	User-configured Cell ID is used.
True (1)	Measurement tries to autodetect the Cell ID.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.AutoCellIDDetectionEnabled):: Specifies whether to enable the autodetection of the cell ID.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_auto_increment_cell_id_enabled(selector_string)

Gets whether the cell ID of component carrier is auto calculated and configured by the measurement or configured by the user.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is False.

Name (Value)	Description
False (0)	The measurement uses the user-configured cell IDs.
True (1)	The Cell ID of each CC is auto calculated as specified in section 4.9.2.3 of 3GPP 38.141 specification.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.AutoIncrementCellIDEnabled):: Specifies whether the cell ID of component carrier is auto calculated and configured by the measurement or configured by the user.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_auto_resource_block_detection_enabled(selector_string)

Gets whether the values of modulation type, number of resource block clusters, resource block offsets, and number of resource blocks are auto-detected by the measurement or configured by you.

When you set the LINK_DIRECTION attribute to Uplink, enabling Auto RB Detection Enabled attribute detects the PUSCH_MODULATION_TYPE, PUSCH_NUMBER_OF_RESOURCE_BLOCK_CLUSTERS, PUSCH_RESOURCE_BLOCK_OFFSET, and PUSCH_NUMBER_OF_RESOURCE_BLOCKS attributes.

When you set the Link Direction attribute to Downlink, enabling Auto RB Detection Enabled attribute detects the PDSCH Mod Type, PDSCH Num RB Clusters, PDSCH RB Offset, and PDSCH Num RBs attributes.

When this attribute is enabled, the modulation type, number of resource block clusters, resource block offsets, and number of resource blocks of the received signal are assumed to be the constant in all active symbols of the received signal.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is True.

Name (Value)	Description
False (0)	The values of modulation type, number of resource block clusters, resource block offsets, and number of resource blocks that you specify are used for the measurement.
True (1)	The values of modulation type, number of resource block clusters, resource block offsets, and number of resource blocks are auto-detected by the measurement.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.AutoResourceBlockDetectionEnabled):: Specifies whether the values of modulation type, number of resource block clusters, resource block offsets, and number of resource blocks are auto-detected by the measurement or configured by you.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_band(selector_string)

Gets the evolved universal terrestrial radio access (E-UTRA) or NR operating frequency band of a subblock as specified in section 5.2 of the 3GPP 38.101-1/2/3 specification. Band determines the spectral flatness mask and spectral emission mask.

Use “subblock<n>” as the Selector String to configure or read this attribute.

The default value is 78.

Valid values for frequency range 1 are 1, 2, 3, 5, 7, 8, 12, 13, 14, 18, 20, 24, 25, 26, 28, 29, 30, 31, 34, 38, 39, 40, 41, 46, 47, 48, 50, 51, 53, 54, 65, 66, 67, 68, 70, 71, 72, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 104, 105, 106, 109, 110, 247, 248, 250, 251, 252, 253, 254, 255, and 256.

Valid values for frequency range 2-1 are 257, 258, 259, 260, 261, 262, 508, 509, 510, 511 and 512.

Valid values for frequency range 2-2 are 263.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):: Specifies the evolved universal terrestrial radio access (E-UTRA) or NR operating frequency band of a subblock as specified in section 5.2 of the 3GPP 38.101-1/2/3 specification. Band determines the spectral flatness mask and spectral emission mask.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_center_frequency(selector_string)

Gets the center frequency of the acquired RF signal. 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 topic for information about the string syntax for named signals.

The default of this attribute is hardware dependent.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Specifies the center frequency of the acquired RF signal. This value is expressed in Hz. The signal analyzer tunes to this frequency.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_channel_raster(selector_string)

Gets the subblock channel raster which is used for computing nominal spacing between aggregated carriers as specified in section 5.4A.1 of 3GPP 38.101-1/2 specification and section 5.4.1.2 of 3GPP TS 38.104 specification. The value is expressed in Hz.

Use “subblock<n>” as the Selector String to configure or read this attribute.

The default value is 15 kHz.

Valid values for frequency range 1 are 15 kHz and 100kHz.

Valid values for frequency range 2-1 is 60 kHz.

Valid values for frequency range 2-2 are 120 kHz, 480 kHz, and 960 kHz.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Specifies the subblock channel raster which is used for computing nominal spacing between aggregated carriers as specified in section 5.4A.1 of 3GPP 38.101-1/2 specification and section 5.4.1.2 of 3GPP TS 38.104 specification. The value is expressed in Hz.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_component_carrier_at_center_frequency(selector_string)

Gets the index of the component carrier having its center at the user-configured center frequency. The measurement uses this attribute along with COMPONENT_CARRIER_SPACING_TYPE attribute to calculate the value of the COMPONENT_CARRIER_FREQUENCY. This attribute is ignored if you set the CC Spacing Type attribute to User.

Use “subblock<n>” as the Selector String to configure or read this attribute.

Valid values are -1, 0, 1 … n - 1, inclusive, where n is the number of component carriers in the subblock.

The default value is -1. If the value is -1, the component carrier frequency values are calculated such that the center of the subcarrier(with maximum subcarrier spacing for a frequency range), which is closest to the center of the aggregated channel bandwidth, lies at the center frequency.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):: Specifies the index of the component carrier having its center at the user-configured center frequency. The measurement uses this attribute along with COMPONENT_CARRIER_SPACING_TYPE attribute to calculate the value of the COMPONENT_CARRIER_FREQUENCY. This attribute is ignored if you set the CC Spacing Type attribute to User.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_component_carrier_spacing_type(selector_string)

Gets the spacing between adjacent component carriers (CCs) within a subblock.

Use “subblock<n>” as the Selector String to configure or read this attribute.

The default value is Nominal.

Name (Value)	Description
Nominal (0)	Calculates the frequency spacing between component carriers as defined in section 5.4A.1 in the 3GPP 38.101-1/2 specification and section 5.4.1.2 in the 3GPP TS 38.104 specification and sets the CC Freq attribute.
User (2)	The component carrier frequency that you configure in the CC Freq attribute is used.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.ComponentCarrierSpacingType):: Specifies the spacing between adjacent component carriers (CCs) within a subblock.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_digital_edge_trigger_edge(selector_string)

Gets the active edge for the trigger. This attribute is used only when you set the 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 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.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.DigitalEdgeTriggerEdge):: Specifies the active edge for the trigger. This attribute is used only when you set the TRIGGER_TYPE attribute to Digital Edge.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_digital_edge_trigger_source(selector_string)

Gets the source terminal for the digital edge trigger. This attribute is used only when you set the 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 topic for information about the string syntax for named signals.

The default of this attribute is hardware dependent.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (string):: Specifies the source terminal for the digital edge trigger. This attribute is used only when you set the TRIGGER_TYPE attribute to Digital Edge.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_downlink_channel_configuration_mode(selector_string)

Gets the downlink channel configuration mode.

You 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 Test Model.

Name (Value)	Description
User Defined (1)	The user sets all signals and channels manually.
Test Model (2)	A Test Model needs to be selected in theDownlink Test Model attribute to configure all the signals and channels automatically, according to the section 4.9.2 of 3GPP 38.141-1/2 specification.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.DownlinkChannelConfigurationMode):: Specifies the downlink channel configuration mode.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_downlink_test_model_cell_id_mode(selector_string)

Gets whether the cell ID of downlink test model component carriers is auto calculated and configured by the measurement or configured by the user.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is Auto.

Name (Value)	Description
Auto (0)	Cell ID of each CC is auto calculated as specified in section 4.9.2.3 of the 3GPP 38.141 specification.
Manual (1)	The measurement uses the user-configured cell IDs.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.DownlinkTestModelCellIDMode):: Specifies whether the cell ID of downlink test model component carriers is auto calculated and configured by the measurement or configured by the user.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_error_string(error_code)

Gets the description of a driver error code.

Parameters:: error_code (int) – Specifies an error or warning code.
Returns:: Contains the error description.
Return type:: string

get_external_attenuation(selector_string)

Gets the attenuation of a switch (or cable) connected to the RF IN connector of the signal analyzer. This value is expressed in dB. For more information about attenuation, refer to the Attenuation and Signal Levels topic for your device in the NI RF Vector Signal Analyzers Help.

You do not need to use a selector string to configure or read this attribute for the default signal instance. On a MIMO session, use port::<deviceName>/<channelNumber> as a selector string to configure or read this attribute per port. If you do not specify port string, this attribute is configured for all ports. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is 0.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Specifies the attenuation of a switch (or cable) connected to the RF IN connector of the signal analyzer. This value is expressed in dB. For more information about attenuation, refer to the Attenuation and Signal Levels topic for your device in the NI RF Vector Signal Analyzers Help.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_frequency_range(selector_string)

Gets whether to use channel bandwidth and subcarrier spacing configuration supported in Frequency Range 1 (sub 6GHz), Frequency Range 2-1 (between 24.25GHz and 52.6GHz) or Frequency Range 2-2 (between 52.6GHz and 71GHz).

Use “subblock<n>” as the Selector String to configure or read this attribute.

The default value is Range 1.

Name (Value)	Description
Range 1 (0)	Measurement uses the channel bandwidth and the subcarrier spacing configuration supported in frequency range 1 (sub 6 GHz).
Range 2-1 (1)	Measurement uses the channel bandwidth and the subcarrier spacing configuration supported in frequency range 2-1 (between 24.25 GHz and 52.6 GHz).
Range 2-2 (2)	Measurement uses the channel bandwidth and the subcarrier spacing configuration supported in frequency range 2-2 (between 52.6 GHz and 71 GHz).

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.FrequencyRange):: Specifies whether to use channel bandwidth and subcarrier spacing configuration supported in Frequency Range 1 (sub 6GHz), Frequency Range 2-1 (between 24.25GHz and 52.6GHz) or Frequency Range 2-2 (between 52.6GHz and 71GHz).
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_gnodeb_category(selector_string)

Gets the downlink gNodeB (Base Station) category. Refer to the 3GPP 38.104 specification for more information about gNodeB category.

You 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 Wide Area Base Station - Category A.

Name (Value)	Description
Wide Area Base Station - Category A (0)	Specifies that the gNodeB type is Wide Area Base Station - Category A.
Wide Area Base Station - Category B Option1 (1)	Specifies that the gNodeB type is Wide Area Base Station - Category B Option1.
Wide Area Base Station - Category B Option2 (2)	Specifies that the gNodeB type is Wide Area Base Station - Category B Option2.
Local Area Base Station (3)	Specifies that the gNodeB type is Local Area Base Station.
Medium Range Base Station (5)	Specifies that the gNodeB type is Medium Range Base Station.
FR2 Category A (6)	Specifies that the gNodeB type is FR2 Category A.
FR2 Category B (7)	Specifies that the gNodeB type is FR2 Category B.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.gNodeBCategory):: Specifies the downlink gNodeB (Base Station) category. Refer to the 3GPP 38.104 specification for more information about gNodeB category.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_gnodeb_type(selector_string)

Gets the downlink gNodeB (Base Station) type. Refer to the 3GPP 38.104 specification for more information about gNodeB Type.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is Type 1-C.

Name (Value)	Description
Type 1-C (0)	Type 1-C NR base station operating at FR1 and conducted requirements apply.
Type 1-H (1)	Type 1-H base station operating at FR1 and conducted and OTA requirements apply.
Type 1-O (2)	Type 1-O base station operating at FR1 and OTA requirements apply.
Type 2-O (3)	Type 2-O base station operating at FR2 and OTA requirements apply.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.gNodeBType):: Specifies the downlink gNodeB (Base Station) type. Refer to the 3GPP 38.104 specification for more information about gNodeB Type.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_grid_size_mode(selector_string)

Gets whether to set the grid size of all BWPs and SSB in a component carrier automatically or manually.

When you set this attribute to Auto, the grid size is set equal to the maximum transmission bandwidth specified in the 3GPP specification.

You 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 the named signals.

The default value is Auto.

Name (Value)	Description
Manual (0)	The grid size is user specified.
Auto (1)	The grid size is set equal to the maximum transmission bandwidth specified by the 3GPP specification.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.GridSizeMode):: Specifies whether to set the grid size of all BWPs and SSB in a component carrier automatically or manually.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_iq_power_edge_trigger_level(selector_string)

Gets the power level at which the device triggers. This value is expressed in dB when you set the 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 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 topic for information about the string syntax for named signals.

The default value of this attribute is hardware dependent.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Specifies the power level at which the device triggers. This value is expressed in dB when you set the 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 TRIGGER_TYPE attribute to IQ Power Edge.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_iq_power_edge_trigger_level_type(selector_string)

Gets the reference for the IQ_POWER_EDGE_TRIGGER_LEVEL attribute. The IQ Power Edge Level Type attribute is used only when you set the 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 topic for information about the string syntax for named signals.

The default value is Relative.

Name (Value)	Description
Relative (0)	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.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.IQPowerEdgeTriggerLevelType):: Specifies the reference for the IQ_POWER_EDGE_TRIGGER_LEVEL attribute. The IQ Power Edge Level Type attribute is used only when you set the TRIGGER_TYPE attribute to IQ Power Edge.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_iq_power_edge_trigger_slope(selector_string)

Gets whether the device asserts the trigger when the signal power is rising or when it is falling. The device asserts the trigger when the signal power exceeds the specified level with the slope you specify.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is Rising 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.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.IQPowerEdgeTriggerSlope):: Specifies whether the device asserts the trigger when the signal power is rising or when it is falling. The device asserts the trigger when the signal power exceeds the specified level with the slope you specify.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_iq_power_edge_trigger_source(selector_string)

Gets the channel from which the device monitors the trigger.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value of this attribute is hardware dependent.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (string):: Specifies the channel from which the device monitors the trigger.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_limited_configuration_change(selector_string)

Gets 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 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 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 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.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.LimitedConfigurationChange):: Specifies the set of attributes that are considered by RFmx in the locked signal configuration state.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_link_direction(selector_string)

Gets the link direction of the received signal.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is Uplink.

Name (Value)	Description
Downlink (0)	NR measurement uses 3GPP NR downlink specification to measure the received signal.
Uplink (1)	NR measurement uses 3GPP NR uplink specification to measure the received signal.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.LinkDirection):: Specifies the link direction of the received signal.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_number_of_receive_chains(selector_string)

Gets the number of receive chains.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is 1.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):: Specifies the number of receive chains.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_number_of_subblocks(selector_string)

Gets the number of subblocks configured in intraband non-contiguous carrier aggregation scenarios.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is 1. Set this attribute to 1 for single carrier and intra-band contiguous carrier aggregation.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):: Specifies the number of subblocks configured in intraband non-contiguous carrier aggregation scenarios.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_phase_compensation(selector_string)

Gets whether phase compensation is disabled, auto-set by the measurement or set by the you.

You 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 the named signals.

The default value is Disabled.

Name (Value)	Description
Disabled (0)	No phase compensation is applied on the signal.
Auto (1)	Phase compensation is applied on the signal using value of Center Frequency attribute as the phase compensation frequency.
User Defined (2)	Phase compensation is applied on the signal using value of Ph Comp Freq attribute.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.PhaseCompensation):: Specifies whether phase compensation is disabled, auto-set by the measurement or set by the you.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_phase_compensation_frequency(selector_string)

Gets the frequency used for phase compensation of the signal when you set the PHASE_COMPENSATION attribute to User Defined. This value is expressed in Hz.

Use “subblock<n>” as the Selector String to configure or read this attribute.

The default value is 0.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Specifies the frequency used for phase compensation of the signal when you set the PHASE_COMPENSATION attribute to User Defined. This value is expressed in Hz.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_piby2bpsk_power_boost_enabled(selector_string)

Gets the power boost for PI/2 BPSK signal when you set the FREQUENCY_RANGE attribute to Range 1. This attribute is valid only for uplink direction.

For PI/2 BPSK modulation, if this attribute is set to True, POWER_CLASS attribute to 3,:py:attr:~nirfmxnr.attributes.AttributeID.BAND attribute to 40, 41, 77, 78, or 79, and the PUSCH_SLOT_ALLOCATION attribute is set such that, at most 40% of the radio frame is active, then the EVM Equalizer spectral flatness mask specified in section 6.4.2.4.1 of 3GPP 38.101-1 is used. Otherwise the EVM Equalizer spectral flatness mask specified in section 6.4.2.4 of 3GPP 38.101-1 is used.

When you set the Frequency Range attribute to Range 2-1 or Range 2-2, the measurement ignores the PIby2BPSK Pwr Boost Enabled attribute. In this case, when you set the MODACC_SPECTRAL_FLATNESS_CONDITION attribute to Normal, the equalizer spectral flatness mask as specified in section 6.4.2.5 of 3GPP TS 38.101-2 is used for the PI/2 BPSK signal. Otherwise, the equalizer spectral flatness mask as specified in section 6.4.2.4 of 3GPP 38.101-2 is used.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is False.

Name (Value)	Description
False (0)	Power boost for PI/2 BPSK modulation is not enabled.
True (1)	Power boost for PI/2 BPSK modulation is enabled.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.PiBy2BpskPowerBoostEnabled):: Specifies the power boost for PI/2 BPSK signal when you set the FREQUENCY_RANGE attribute to Range 1. This attribute is valid only for uplink direction.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_power_class(selector_string)

Gets the power class for the UE as specified in section 6.2 of 3GPP 38.101-1/2/3 specification.

This attribute impacts the spectral flatness mask for uplink.

You 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 3.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):: Specifies the power class for the UE as specified in section 6.2 of 3GPP 38.101-1/2/3 specification.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_reference_grid_alignment_mode(selector_string)

Gets whether to align the bandwidthparts and the SSB in a component carrier to a reference resource grid automatically or manually.

You 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 the named signals.

The default value is Auto.

Name (Value)	Description
Manual (0)	The subcarrier spacing of the reference resource grid and the grid start of each bandwidthpart is user specified. Center of subcarrier 0 in common resource block 0 of the reference resource grid is considered as Reference Point A.
Auto (1)	The subcarrier spacing of the reference resource grid is determined by the largest subcarrier spacing among the configured bandwidthparts and the SSB. The grid start of each bandwidthpart and the SSB is computed by minimizing k0 to {0, +6} subcarriers.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.ReferenceGridAlignmentMode):: Specifies whether to align the bandwidthparts and the SSB in a component carrier to a reference resource grid automatically or manually.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_reference_level(selector_string)

Gets 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_pk-pkfor baseband devices.

You do not need to use a selector string to configure or read this attribute for the default signal instance. On a MIMO session, use port::<deviceName>/<channelNumber> as a selector string to configure or read this attribute per port. If you do not specify port string, this attribute is configured for all ports. Refer to the Selector String topic for information about the string syntax for named signals.

The default of this attribute is hardware dependent.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: 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_pk-pkfor baseband devices.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_reference_level_headroom(selector_string)

Gets the margin RFmx adds to the 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 topic for information about the string syntax for named signals.

**Supported devices: **PXIe-5668R, 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

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Specifies the margin RFmx adds to the REFERENCE_LEVEL attribute. The margin avoids clipping and overflow warnings if the input signal exceeds the configured reference level.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_result_fetch_timeout(selector_string)

Gets the time to wait before results are available in the RFmxNR Attribute. This value is expressed in seconds.

Set this value to a time longer than expected for fetching the measurement. A value of -1 specifies that the RFmx Attribute waits until the measurement is complete.

The default value is 10.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Specifies the time to wait before results are available in the RFmxNR Attribute. This value is expressed in seconds.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_satellite_access_node_class(selector_string)

Gets the downlink Satellite Access Node (SAN) class representing the satellite constellation as specified in section 4.4 of 3GPP 38.108 specification.

This attribute is valid only for the bands restricted to the operation with Non-Terrestrial Networks (NTN) as specified in section 5.2 of 3GPP 38.108 specification. This attribute impacts the spectral emission mask for downlink.

You 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 GEO (0).

Name (Value)	Description
GEO (0)	Specifies the downlink Satellite Access Node (SAN) class corresponding to GEO satellite constellation.
LEO (1)	Specifies the downlink Satellite Access Node (SAN) class corresponding to LEO satellite constellation.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.SatelliteAccessNodeClass):: Specifies the downlink Satellite Access Node (SAN) class representing the satellite constellation as specified in section 4.4 of 3GPP 38.108 specification.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_selected_ports(selector_string)

Gets the instrument port to be configured to acquire a signal. Use 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 topic for information about the string syntax for named signals.

On a MIMO session, this attribute specifies one of the initialized devices. Use “port::<deviceName>/<channelNumber>” as the format for the selected port. To perform a MIMO measurement, you must configure the selected ports attribute for the configured number of receive chains.

For PXIe-5830/5831/5832 devices on a MIMO session, the selected port includes the instrument port in the format “port::<deviceName>/<channelNumber>/<instrPort>”.

Example:

port::myrfsa1/0/if1

You can use the build_port_string() method to build the selected port.

Use “chain<n>” as the selector string to configure or read this attribute. You can use the build_chain_string() method to build the selector string.

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)

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (string):: Specifies the instrument port to be configured to acquire a signal. Use nirfmxinstr.session.Session.get_available_ports() method to get the valid port names.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_subblock_endc_nominal_spacing_adjustment(selector_string)

Gets the adjustment of the center frequency for adjacent E-UTRA and NR Channels in case of nominal spacing. The value is expressed in Hz.

Use “subblock<n>” as the Selector String to configure or read this attribute.

The default value is 0.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Specifies the adjustment of the center frequency for adjacent E-UTRA and NR Channels in case of nominal spacing. The value is expressed in Hz.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_subblock_frequency(selector_string)

Gets the offset of the subblock from the CENTER_FREQUENCY.

Use “subblock<n>” as the Selector String to configure or read this attribute.

The default value is 0.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Specifies the offset of the subblock from the CENTER_FREQUENCY.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_subblock_transmit_lo_frequency(selector_string)

Gets the frequency of the transmitters local oscillator. This value is expressed in Hz. The frequency is defined per subblock and relative to the respective subblock center frequency.

Use “subblock<n>” as the Selector String to configure or read this attribute.

The default value is 0.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Specifies the frequency of the transmitters local oscillator. This value is expressed in Hz. The frequency is defined per subblock and relative to the respective subblock center frequency.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_transmit_antenna_to_analyze(selector_string)

Gets the physical antenna that is currently connected to the analyzer.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is 0.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (int):: Specifies the physical antenna that is currently connected to the analyzer.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_transmitter_architecture(selector_string)

Gets the RF architecture at the transmitter, whether each component carriers have a separate LO or one common LO for the entire subblock.

You 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 LO per Subblock.

Name (Value)	Description
LO per Component Carrier (0)	The Carrier IQ Origin Offset Mean (dBc) and the In-Band Emission Margin (dB) are calculated as the LO per Component Carrier, the Subblock IQ Origin Offset Mean (dBc) and the Subblock In-Band Emission Margin (dB) will not be returned.
LO per Subblock (1)	The Subblock IQ Origin Offset Mean (dBc) and the Subblock In-Band Emission Margin (dB) are calculated as the LO per Subblock, the Carrier IQ Origin Offset Mean (dBc), and the In-Band Emission Margin (dB) will be NaN. In the case of a single carrier, the measurement returns the same value of IQ Origin Offset and In-Band Emission Margin for both components carrier and subblock results.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.TransmitterArchitecture):: Specifies the RF architecture at the transmitter, whether each component carriers have a separate LO or one common LO for the entire subblock.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_trigger_delay(selector_string)

Gets the trigger delay time. This value is expressed in seconds. If the delay is negative, the measurement acquires pre-trigger 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 topic for information about the string syntax for named signals.

The default value is 0.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Specifies the trigger delay time. This value is expressed in seconds. If the delay is negative, the measurement acquires pre-trigger samples. If the delay is positive, the measurement acquires post-trigger samples.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_trigger_minimum_quiet_time_duration(selector_string)

Gets the time duration for which the signal must be quiet before the signal analyzer arms the I/Q power edge trigger. This value is expressed in seconds. If you set the IQ_POWER_EDGE_TRIGGER_SLOPE 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.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default of this attribute is hardware dependent.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (float):: Specifies the time duration for which the signal must be quiet before the signal analyzer arms the I/Q power edge trigger. This value is expressed in seconds. If you set the IQ_POWER_EDGE_TRIGGER_SLOPE 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.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_trigger_minimum_quiet_time_mode(selector_string)

Gets 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 topic for information about the string syntax for named signals.

The default value is Auto.

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.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.TriggerMinimumQuietTimeMode):: Specifies whether the measurement computes the minimum quiet time used for triggering.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_trigger_type(selector_string)

Gets the type of trigger to be used 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 topic for information about the string syntax for named signals.

The default value is None.

Name (Value)	Description
None (0)	No Reference Trigger is configured.
Digital Edge (1)	The Reference Trigger is not asserted until a digital edge is detected. The source of the digital edge is specified using the Digital Edge Source attribute.
IQ Power Edge (2)	The Reference Trigger is asserted when the signal changes past the level specified by the slope (rising or falling), which is configured using the IQ Power Edge Slope attribute.
Software (3)	The Reference Trigger is not asserted until a software trigger occurs.

Parameters:

selector_string (string) – Pass an empty string.

Returns:

attr_val (enums.TriggerType):: Specifies the type of trigger to be used for signal acquisition.
error_code (int):: Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

Tuple (attr_val, error_code)

get_warning()

Retrieves and then clears the warning information for the session.

Returns:

warning_code (int):: Contains the latest warning code.
warning_message (string):: Contains the latest warning description.

Return type:

Tuple (warning_code, warning_message)

initiate(selector_string, result_name)

Initiates all enabled measurements. Call this method after configuring the signal and measurement. This method asynchronously launches measurements in the background and immediately returns to the caller program. You can fetch measurement results using the Fetch methods or result attributes in the attribute node. To get the status of measurements, use the wait_for_measurement_complete() method or check_measurement_status() method.

Parameters:

selector_string (string) –
This parameter specifies the signal name and result name. The result name can either be specified through this input or the Result Name parameter. If you do not specify the result name in this parameter, either the result name specified by the Result Name parameter or the default result instance is used.

Example:

””

”result::r1”

You can use the build_result_string() method to build the Selector String.
result_name (string) –
This parameter specifies the name to be associated with measurement results. Provide a unique name, such as “r1” to enable fetching of multiple measurement results and traces. This input accepts the result name with or without the “result::” prefix. The default value is “” (empty string) which refers to default result instance.

Example:

”result::r1”

”r1”

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

load_from_generation_configuration_file(selector_string, file_path, configuration_index)

Loads the attributes saved in an RFWS/TDMS file onto the RFmx session. This file can be saved using the NR Modulation Scheme in RFmx Waveform Creator. Make sure to select the ‘store configuration’ option while saving the TDMS file.

Parameters:

selector_string (string) – Pass an empty string. The signal name that is passed when creating the signal configuration is used.
file_path (string) – This parameter specifies the complete path to the RFWS/TDMS file from which the configurations are to be loaded.
configuration_index (int) – This parameter specifies the index of the carrier set to be loaded from the RFWS/TDMS file.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

reset_attribute(selector_string, attribute_id)

Resets the attribute to its default value.

Parameters:

selector_string (string) – Specifies the selector string for the property being reset.
attribute_id (PropertyId) – Specifies an attribute identifier.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

reset_to_default(selector_string)

Resets a signal to the default values.

Parameters:: selector_string (string) – Pass an empty string. The signal name that is passed when creating the signal configuration is used.
Returns:: Returns the status code of this method. The status code either indicates success or describes a warning condition.
Return type:: int

select_measurements(selector_string, measurements, enable_all_traces)

Enables all the measurements that you specify in the Measurement parameter and disables all other measurements.

Parameters:

selector_string (string) – Pass an empty string. The signal name that is passed when creating the signal configuration is used.

measurements (enums.MeasurementTypes, int) –

This parameter specifies the measurements to perform. You can specify one or more of the following measurements. The default value is an empty array.

Name (Value)	Description
ModAcc (0)	Enables the ModAcc measurement.
SEM (1)	Enables the SEM measurement.
ACP (2)	Enables the ACP measurement.
CHP (3)	Enables the CHP measurement.
OBW (4)	Enables the OBW measurement.
PVT (5)	Enables the PVT measurement.
TXP (6)	Enables the TXP measurement.

enable_all_traces (bool) – This parameter specifies whether to enable all traces for the selected measurement. The default value is FALSE.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

send_software_edge_trigger()

Sends a trigger to the device when you use the RFmxNR Configure Trigger method to choose a software version of a trigger and the device is waiting for the trigger to be sent. You can also use this method to override a hardware trigger.

This method returns an error in the following situations:

You configure an invalid trigger.
You have not previously called the initiate() method.

Returns:: Returns the status code of this method. The status code either indicates success or describes a warning condition.
Return type:: int

set_acquisition_bandwidth_optimization_enabled(selector_string, value)

Sets whether RFmx optimizes the acquisition bandwidth. This may cause acquisition center frequency or local oscillator (LO) to be placed at different position than you configured.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is False.

Name (Value)	Description
False (0)	RFmx does not optimize acquisition bandwidth and will be based on the Nyquist criterion. The value of the acquisition center frequency is the same as the value of the Center Frequency that you configure.
True (1)	RFmx positions the acquisition center frequency to acquire the least bandwidth based on the configuration and span needed for the measurement. This helps in reducing the amount of data to process for the measurement, thus improving the speed. However this might cause the LO to be positioned at a non-dc subcarrier position, hence the measurement sensitive to it should have this attribute disabled.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.AcquisitionBandwidthOptimizationEnabled, int) – Specifies whether RFmx optimizes the acquisition bandwidth. This may cause acquisition center frequency or local oscillator (LO) to be placed at different position than you configured.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_auto_cell_id_detection_enabled(selector_string, value)

Sets whether to enable the autodetection of the cell ID.

When you set the LINK_DIRECTION attribute to Downlink, autodetection of the Cell ID is not possible if the signal measured does not contain SSB with PSS/SSS, or if the PDSCH does not include enough allocated Resource Blocks.

When you set the Link Direction attribute to Uplink, autodetection of the Cell ID is not possible if the PUSCH PUSCH_TRANSFORM_PRECODING_ENABLED attribute is set to True, or if the PUSCH does not include enough allocated Resource Blocks.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is False.

Name (Value)	Description
False (0)	User-configured Cell ID is used.
True (1)	Measurement tries to autodetect the Cell ID.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.AutoCellIDDetectionEnabled, int) – Specifies whether to enable the autodetection of the cell ID.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_auto_increment_cell_id_enabled(selector_string, value)

Sets whether the cell ID of component carrier is auto calculated and configured by the measurement or configured by the user.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is False.

Name (Value)	Description
False (0)	The measurement uses the user-configured cell IDs.
True (1)	The Cell ID of each CC is auto calculated as specified in section 4.9.2.3 of 3GPP 38.141 specification.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.AutoIncrementCellIDEnabled, int) – Specifies whether the cell ID of component carrier is auto calculated and configured by the measurement or configured by the user.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_auto_resource_block_detection_enabled(selector_string, value)

Sets whether the values of modulation type, number of resource block clusters, resource block offsets, and number of resource blocks are auto-detected by the measurement or configured by you.

When you set the LINK_DIRECTION attribute to Uplink, enabling Auto RB Detection Enabled attribute detects the PUSCH_MODULATION_TYPE, PUSCH_NUMBER_OF_RESOURCE_BLOCK_CLUSTERS, PUSCH_RESOURCE_BLOCK_OFFSET, and PUSCH_NUMBER_OF_RESOURCE_BLOCKS attributes.

When you set the Link Direction attribute to Downlink, enabling Auto RB Detection Enabled attribute detects the PDSCH Mod Type, PDSCH Num RB Clusters, PDSCH RB Offset, and PDSCH Num RBs attributes.

When this attribute is enabled, the modulation type, number of resource block clusters, resource block offsets, and number of resource blocks of the received signal are assumed to be the constant in all active symbols of the received signal.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is True.

Name (Value)	Description
False (0)	The values of modulation type, number of resource block clusters, resource block offsets, and number of resource blocks that you specify are used for the measurement.
True (1)	The values of modulation type, number of resource block clusters, resource block offsets, and number of resource blocks are auto-detected by the measurement.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.AutoResourceBlockDetectionEnabled, int) – Specifies whether the values of modulation type, number of resource block clusters, resource block offsets, and number of resource blocks are auto-detected by the measurement or configured by you.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_band(selector_string, value)

Sets the evolved universal terrestrial radio access (E-UTRA) or NR operating frequency band of a subblock as specified in section 5.2 of the 3GPP 38.101-1/2/3 specification. Band determines the spectral flatness mask and spectral emission mask.

Use “subblock<n>” as the Selector String to configure or read this attribute.

The default value is 78.

Valid values for frequency range 1 are 1, 2, 3, 5, 7, 8, 12, 13, 14, 18, 20, 24, 25, 26, 28, 29, 30, 31, 34, 38, 39, 40, 41, 46, 47, 48, 50, 51, 53, 54, 65, 66, 67, 68, 70, 71, 72, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 104, 105, 106, 109, 110, 247, 248, 250, 251, 252, 253, 254, 255, and 256.

Valid values for frequency range 2-1 are 257, 258, 259, 260, 261, 262, 508, 509, 510, 511 and 512.

Valid values for frequency range 2-2 are 263.

Parameters:

selector_string (string) – Pass an empty string.
value (int) – Specifies the evolved universal terrestrial radio access (E-UTRA) or NR operating frequency band of a subblock as specified in section 5.2 of the 3GPP 38.101-1/2/3 specification. Band determines the spectral flatness mask and spectral emission mask.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_center_frequency(selector_string, value)

Sets the center frequency of the acquired RF signal. 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 topic for information about the string syntax for named signals.

The default of this attribute is hardware dependent.

Parameters:

selector_string (string) – Pass an empty string.
value (float) – Specifies the center frequency of the acquired RF signal. This value is expressed in Hz. The signal analyzer tunes to this frequency.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_channel_raster(selector_string, value)

Sets the subblock channel raster which is used for computing nominal spacing between aggregated carriers as specified in section 5.4A.1 of 3GPP 38.101-1/2 specification and section 5.4.1.2 of 3GPP TS 38.104 specification. The value is expressed in Hz.

Use “subblock<n>” as the Selector String to configure or read this attribute.

The default value is 15 kHz.

Valid values for frequency range 1 are 15 kHz and 100kHz.

Valid values for frequency range 2-1 is 60 kHz.

Valid values for frequency range 2-2 are 120 kHz, 480 kHz, and 960 kHz.

Parameters:

selector_string (string) – Pass an empty string.
value (float) – Specifies the subblock channel raster which is used for computing nominal spacing between aggregated carriers as specified in section 5.4A.1 of 3GPP 38.101-1/2 specification and section 5.4.1.2 of 3GPP TS 38.104 specification. The value is expressed in Hz.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_component_carrier_at_center_frequency(selector_string, value)

Sets the index of the component carrier having its center at the user-configured center frequency. The measurement uses this attribute along with COMPONENT_CARRIER_SPACING_TYPE attribute to calculate the value of the COMPONENT_CARRIER_FREQUENCY. This attribute is ignored if you set the CC Spacing Type attribute to User.

Use “subblock<n>” as the Selector String to configure or read this attribute.

Valid values are -1, 0, 1 … n - 1, inclusive, where n is the number of component carriers in the subblock.

The default value is -1. If the value is -1, the component carrier frequency values are calculated such that the center of the subcarrier(with maximum subcarrier spacing for a frequency range), which is closest to the center of the aggregated channel bandwidth, lies at the center frequency.

Parameters:

selector_string (string) – Pass an empty string.
value (int) – Specifies the index of the component carrier having its center at the user-configured center frequency. The measurement uses this attribute along with COMPONENT_CARRIER_SPACING_TYPE attribute to calculate the value of the COMPONENT_CARRIER_FREQUENCY. This attribute is ignored if you set the CC Spacing Type attribute to User.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_component_carrier_spacing_type(selector_string, value)

Sets the spacing between adjacent component carriers (CCs) within a subblock.

Use “subblock<n>” as the Selector String to configure or read this attribute.

The default value is Nominal.

Name (Value)	Description
Nominal (0)	Calculates the frequency spacing between component carriers as defined in section 5.4A.1 in the 3GPP 38.101-1/2 specification and section 5.4.1.2 in the 3GPP TS 38.104 specification and sets the CC Freq attribute.
User (2)	The component carrier frequency that you configure in the CC Freq attribute is used.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.ComponentCarrierSpacingType, int) – Specifies the spacing between adjacent component carriers (CCs) within a subblock.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_digital_edge_trigger_edge(selector_string, value)

Sets the active edge for the trigger. This attribute is used only when you set the 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 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.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.DigitalEdgeTriggerEdge, int) – Specifies the active edge for the trigger. This attribute is used only when you set the TRIGGER_TYPE attribute to Digital Edge.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_digital_edge_trigger_source(selector_string, value)

Sets the source terminal for the digital edge trigger. This attribute is used only when you set the 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 topic for information about the string syntax for named signals.

The default of this attribute is hardware dependent.

Parameters:

selector_string (string) – Pass an empty string.
value (string) – Specifies the source terminal for the digital edge trigger. This attribute is used only when you set the TRIGGER_TYPE attribute to Digital Edge.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_downlink_channel_configuration_mode(selector_string, value)

Sets the downlink channel configuration mode.

You 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 Test Model.

Name (Value)	Description
User Defined (1)	The user sets all signals and channels manually.
Test Model (2)	A Test Model needs to be selected in theDownlink Test Model attribute to configure all the signals and channels automatically, according to the section 4.9.2 of 3GPP 38.141-1/2 specification.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.DownlinkChannelConfigurationMode, int) – Specifies the downlink channel configuration mode.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_downlink_test_model_cell_id_mode(selector_string, value)

Sets whether the cell ID of downlink test model component carriers is auto calculated and configured by the measurement or configured by the user.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is Auto.

Name (Value)	Description
Auto (0)	Cell ID of each CC is auto calculated as specified in section 4.9.2.3 of the 3GPP 38.141 specification.
Manual (1)	The measurement uses the user-configured cell IDs.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.DownlinkTestModelCellIDMode, int) – Specifies whether the cell ID of downlink test model component carriers is auto calculated and configured by the measurement or configured by the user.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_external_attenuation(selector_string, value)

Sets the attenuation of a switch (or cable) connected to the RF IN connector of the signal analyzer. This value is expressed in dB. For more information about attenuation, refer to the Attenuation and Signal Levels topic for your device in the NI RF Vector Signal Analyzers Help.

You do not need to use a selector string to configure or read this attribute for the default signal instance. On a MIMO session, use port::<deviceName>/<channelNumber> as a selector string to configure or read this attribute per port. If you do not specify port string, this attribute is configured for all ports. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is 0.

Parameters:

selector_string (string) – Pass an empty string.
value (float) – Specifies the attenuation of a switch (or cable) connected to the RF IN connector of the signal analyzer. This value is expressed in dB. For more information about attenuation, refer to the Attenuation and Signal Levels topic for your device in the NI RF Vector Signal Analyzers Help.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_frequency_range(selector_string, value)

Sets whether to use channel bandwidth and subcarrier spacing configuration supported in Frequency Range 1 (sub 6GHz), Frequency Range 2-1 (between 24.25GHz and 52.6GHz) or Frequency Range 2-2 (between 52.6GHz and 71GHz).

Use “subblock<n>” as the Selector String to configure or read this attribute.

The default value is Range 1.

Name (Value)	Description
Range 1 (0)	Measurement uses the channel bandwidth and the subcarrier spacing configuration supported in frequency range 1 (sub 6 GHz).
Range 2-1 (1)	Measurement uses the channel bandwidth and the subcarrier spacing configuration supported in frequency range 2-1 (between 24.25 GHz and 52.6 GHz).
Range 2-2 (2)	Measurement uses the channel bandwidth and the subcarrier spacing configuration supported in frequency range 2-2 (between 52.6 GHz and 71 GHz).

Parameters:

selector_string (string) – Pass an empty string.
value (enums.FrequencyRange, int) – Specifies whether to use channel bandwidth and subcarrier spacing configuration supported in Frequency Range 1 (sub 6GHz), Frequency Range 2-1 (between 24.25GHz and 52.6GHz) or Frequency Range 2-2 (between 52.6GHz and 71GHz).

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_gnodeb_category(selector_string, value)

Sets the downlink gNodeB (Base Station) category. Refer to the 3GPP 38.104 specification for more information about gNodeB category.

You 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 Wide Area Base Station - Category A.

Name (Value)	Description
Wide Area Base Station - Category A (0)	Specifies that the gNodeB type is Wide Area Base Station - Category A.
Wide Area Base Station - Category B Option1 (1)	Specifies that the gNodeB type is Wide Area Base Station - Category B Option1.
Wide Area Base Station - Category B Option2 (2)	Specifies that the gNodeB type is Wide Area Base Station - Category B Option2.
Local Area Base Station (3)	Specifies that the gNodeB type is Local Area Base Station.
Medium Range Base Station (5)	Specifies that the gNodeB type is Medium Range Base Station.
FR2 Category A (6)	Specifies that the gNodeB type is FR2 Category A.
FR2 Category B (7)	Specifies that the gNodeB type is FR2 Category B.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.gNodeBCategory, int) – Specifies the downlink gNodeB (Base Station) category. Refer to the 3GPP 38.104 specification for more information about gNodeB category.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_gnodeb_type(selector_string, value)

Sets the downlink gNodeB (Base Station) type. Refer to the 3GPP 38.104 specification for more information about gNodeB Type.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is Type 1-C.

Name (Value)	Description
Type 1-C (0)	Type 1-C NR base station operating at FR1 and conducted requirements apply.
Type 1-H (1)	Type 1-H base station operating at FR1 and conducted and OTA requirements apply.
Type 1-O (2)	Type 1-O base station operating at FR1 and OTA requirements apply.
Type 2-O (3)	Type 2-O base station operating at FR2 and OTA requirements apply.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.gNodeBType, int) – Specifies the downlink gNodeB (Base Station) type. Refer to the 3GPP 38.104 specification for more information about gNodeB Type.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_grid_size_mode(selector_string, value)

Sets whether to set the grid size of all BWPs and SSB in a component carrier automatically or manually.

When you set this attribute to Auto, the grid size is set equal to the maximum transmission bandwidth specified in the 3GPP specification.

You 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 the named signals.

The default value is Auto.

Name (Value)	Description
Manual (0)	The grid size is user specified.
Auto (1)	The grid size is set equal to the maximum transmission bandwidth specified by the 3GPP specification.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.GridSizeMode, int) – Specifies whether to set the grid size of all BWPs and SSB in a component carrier automatically or manually.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_iq_power_edge_trigger_level(selector_string, value)

Sets the power level at which the device triggers. This value is expressed in dB when you set the 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 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 topic for information about the string syntax for named signals.

The default value of this attribute is hardware dependent.

Parameters:

selector_string (string) – Pass an empty string.
value (float) – Specifies the power level at which the device triggers. This value is expressed in dB when you set the 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 TRIGGER_TYPE attribute to IQ Power Edge.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_iq_power_edge_trigger_level_type(selector_string, value)

Sets the reference for the IQ_POWER_EDGE_TRIGGER_LEVEL attribute. The IQ Power Edge Level Type attribute is used only when you set the 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 topic for information about the string syntax for named signals.

The default value is Relative.

Name (Value)	Description
Relative (0)	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.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.IQPowerEdgeTriggerLevelType, int) – Specifies the reference for the IQ_POWER_EDGE_TRIGGER_LEVEL attribute. The IQ Power Edge Level Type attribute is used only when you set the TRIGGER_TYPE attribute to IQ Power Edge.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_iq_power_edge_trigger_slope(selector_string, value)

Sets whether the device asserts the trigger when the signal power is rising or when it is falling. The device asserts the trigger when the signal power exceeds the specified level with the slope you specify.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is Rising 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.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.IQPowerEdgeTriggerSlope, int) – Specifies whether the device asserts the trigger when the signal power is rising or when it is falling. The device asserts the trigger when the signal power exceeds the specified level with the slope you specify.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_iq_power_edge_trigger_source(selector_string, value)

Sets the channel from which the device monitors the trigger.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value of this attribute is hardware dependent.

Parameters:

selector_string (string) – Pass an empty string.
value (string) – Specifies the channel from which the device monitors the trigger.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_limited_configuration_change(selector_string, value)

Sets 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 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 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 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.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.LimitedConfigurationChange, int) – Specifies the set of attributes that are considered by RFmx in the locked signal configuration state.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_link_direction(selector_string, value)

Sets the link direction of the received signal.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is Uplink.

Name (Value)	Description
Downlink (0)	NR measurement uses 3GPP NR downlink specification to measure the received signal.
Uplink (1)	NR measurement uses 3GPP NR uplink specification to measure the received signal.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.LinkDirection, int) – Specifies the link direction of the received signal.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_number_of_receive_chains(selector_string, value)

Sets the number of receive chains.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is 1.

Parameters:

selector_string (string) – Pass an empty string.
value (int) – Specifies the number of receive chains.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_number_of_subblocks(selector_string, value)

Sets the number of subblocks configured in intraband non-contiguous carrier aggregation scenarios.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is 1. Set this attribute to 1 for single carrier and intra-band contiguous carrier aggregation.

Parameters:

selector_string (string) – Pass an empty string.
value (int) – Specifies the number of subblocks configured in intraband non-contiguous carrier aggregation scenarios.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_phase_compensation(selector_string, value)

Sets whether phase compensation is disabled, auto-set by the measurement or set by the you.

You 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 the named signals.

The default value is Disabled.

Name (Value)	Description
Disabled (0)	No phase compensation is applied on the signal.
Auto (1)	Phase compensation is applied on the signal using value of Center Frequency attribute as the phase compensation frequency.
User Defined (2)	Phase compensation is applied on the signal using value of Ph Comp Freq attribute.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.PhaseCompensation, int) – Specifies whether phase compensation is disabled, auto-set by the measurement or set by the you.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_phase_compensation_frequency(selector_string, value)

Sets the frequency used for phase compensation of the signal when you set the PHASE_COMPENSATION attribute to User Defined. This value is expressed in Hz.

Use “subblock<n>” as the Selector String to configure or read this attribute.

The default value is 0.

Parameters:

selector_string (string) – Pass an empty string.
value (float) – Specifies the frequency used for phase compensation of the signal when you set the PHASE_COMPENSATION attribute to User Defined. This value is expressed in Hz.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_piby2bpsk_power_boost_enabled(selector_string, value)

Sets the power boost for PI/2 BPSK signal when you set the FREQUENCY_RANGE attribute to Range 1. This attribute is valid only for uplink direction.

For PI/2 BPSK modulation, if this attribute is set to True, POWER_CLASS attribute to 3,:py:attr:~nirfmxnr.attributes.AttributeID.BAND attribute to 40, 41, 77, 78, or 79, and the PUSCH_SLOT_ALLOCATION attribute is set such that, at most 40% of the radio frame is active, then the EVM Equalizer spectral flatness mask specified in section 6.4.2.4.1 of 3GPP 38.101-1 is used. Otherwise the EVM Equalizer spectral flatness mask specified in section 6.4.2.4 of 3GPP 38.101-1 is used.

When you set the Frequency Range attribute to Range 2-1 or Range 2-2, the measurement ignores the PIby2BPSK Pwr Boost Enabled attribute. In this case, when you set the MODACC_SPECTRAL_FLATNESS_CONDITION attribute to Normal, the equalizer spectral flatness mask as specified in section 6.4.2.5 of 3GPP TS 38.101-2 is used for the PI/2 BPSK signal. Otherwise, the equalizer spectral flatness mask as specified in section 6.4.2.4 of 3GPP 38.101-2 is used.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is False.

Name (Value)	Description
False (0)	Power boost for PI/2 BPSK modulation is not enabled.
True (1)	Power boost for PI/2 BPSK modulation is enabled.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.PiBy2BpskPowerBoostEnabled, int) – Specifies the power boost for PI/2 BPSK signal when you set the FREQUENCY_RANGE attribute to Range 1. This attribute is valid only for uplink direction.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_power_class(selector_string, value)

Sets the power class for the UE as specified in section 6.2 of 3GPP 38.101-1/2/3 specification.

This attribute impacts the spectral flatness mask for uplink.

You 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 3.

Parameters:

selector_string (string) – Pass an empty string.
value (int) – Specifies the power class for the UE as specified in section 6.2 of 3GPP 38.101-1/2/3 specification.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_reference_grid_alignment_mode(selector_string, value)

Sets whether to align the bandwidthparts and the SSB in a component carrier to a reference resource grid automatically or manually.

You 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 the named signals.

The default value is Auto.

Name (Value)	Description
Manual (0)	The subcarrier spacing of the reference resource grid and the grid start of each bandwidthpart is user specified. Center of subcarrier 0 in common resource block 0 of the reference resource grid is considered as Reference Point A.
Auto (1)	The subcarrier spacing of the reference resource grid is determined by the largest subcarrier spacing among the configured bandwidthparts and the SSB. The grid start of each bandwidthpart and the SSB is computed by minimizing k0 to {0, +6} subcarriers.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.ReferenceGridAlignmentMode, int) – Specifies whether to align the bandwidthparts and the SSB in a component carrier to a reference resource grid automatically or manually.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_reference_level(selector_string, value)

Sets 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_pk-pkfor baseband devices.

You do not need to use a selector string to configure or read this attribute for the default signal instance. On a MIMO session, use port::<deviceName>/<channelNumber> as a selector string to configure or read this attribute per port. If you do not specify port string, this attribute is configured for all ports. Refer to the Selector String topic for information about the string syntax for named signals.

The default of this attribute is hardware dependent.

Parameters:

selector_string (string) – Pass an empty string.
value (float) – 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_pk-pkfor baseband devices.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_reference_level_headroom(selector_string, value)

Sets the margin RFmx adds to the 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 topic for information about the string syntax for named signals.

**Supported devices: **PXIe-5668R, 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

Parameters:

selector_string (string) – Pass an empty string.
value (float) – Specifies the margin RFmx adds to the REFERENCE_LEVEL attribute. The margin avoids clipping and overflow warnings if the input signal exceeds the configured reference level.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_result_fetch_timeout(selector_string, value)

Sets the time to wait before results are available in the RFmxNR Attribute. This value is expressed in seconds.

Set this value to a time longer than expected for fetching the measurement. A value of -1 specifies that the RFmx Attribute waits until the measurement is complete.

The default value is 10.

Parameters:

selector_string (string) – Pass an empty string.
value (float) – Specifies the time to wait before results are available in the RFmxNR Attribute. This value is expressed in seconds.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_satellite_access_node_class(selector_string, value)

Sets the downlink Satellite Access Node (SAN) class representing the satellite constellation as specified in section 4.4 of 3GPP 38.108 specification.

This attribute is valid only for the bands restricted to the operation with Non-Terrestrial Networks (NTN) as specified in section 5.2 of 3GPP 38.108 specification. This attribute impacts the spectral emission mask for downlink.

You 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 GEO (0).

Name (Value)	Description
GEO (0)	Specifies the downlink Satellite Access Node (SAN) class corresponding to GEO satellite constellation.
LEO (1)	Specifies the downlink Satellite Access Node (SAN) class corresponding to LEO satellite constellation.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.SatelliteAccessNodeClass, int) – Specifies the downlink Satellite Access Node (SAN) class representing the satellite constellation as specified in section 4.4 of 3GPP 38.108 specification.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_selected_ports(selector_string, value)

Sets the instrument port to be configured to acquire a signal. Use 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 topic for information about the string syntax for named signals.

On a MIMO session, this attribute specifies one of the initialized devices. Use “port::<deviceName>/<channelNumber>” as the format for the selected port. To perform a MIMO measurement, you must configure the selected ports attribute for the configured number of receive chains.

For PXIe-5830/5831/5832 devices on a MIMO session, the selected port includes the instrument port in the format “port::<deviceName>/<channelNumber>/<instrPort>”.

Example:

port::myrfsa1/0/if1

You can use the build_port_string() method to build the selected port.

Use “chain<n>” as the selector string to configure or read this attribute. You can use the build_chain_string() method to build the selector string.

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)

Parameters:

selector_string (string) – Pass an empty string.
value (string) – Specifies the instrument port to be configured to acquire a signal. Use nirfmxinstr.session.Session.get_available_ports() method to get the valid port names.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_subblock_endc_nominal_spacing_adjustment(selector_string, value)

Sets the adjustment of the center frequency for adjacent E-UTRA and NR Channels in case of nominal spacing. The value is expressed in Hz.

Use “subblock<n>” as the Selector String to configure or read this attribute.

The default value is 0.

Parameters:

selector_string (string) – Pass an empty string.
value (float) – Specifies the adjustment of the center frequency for adjacent E-UTRA and NR Channels in case of nominal spacing. The value is expressed in Hz.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_subblock_frequency(selector_string, value)

Sets the offset of the subblock from the CENTER_FREQUENCY.

Use “subblock<n>” as the Selector String to configure or read this attribute.

The default value is 0.

Parameters:

selector_string (string) – Pass an empty string.
value (float) – Specifies the offset of the subblock from the CENTER_FREQUENCY.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_subblock_transmit_lo_frequency(selector_string, value)

Sets the frequency of the transmitters local oscillator. This value is expressed in Hz. The frequency is defined per subblock and relative to the respective subblock center frequency.

Use “subblock<n>” as the Selector String to configure or read this attribute.

The default value is 0.

Parameters:

selector_string (string) – Pass an empty string.
value (float) – Specifies the frequency of the transmitters local oscillator. This value is expressed in Hz. The frequency is defined per subblock and relative to the respective subblock center frequency.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_transmit_antenna_to_analyze(selector_string, value)

Sets the physical antenna that is currently connected to the analyzer.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default value is 0.

Parameters:

selector_string (string) – Pass an empty string.
value (int) – Specifies the physical antenna that is currently connected to the analyzer.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_transmitter_architecture(selector_string, value)

Sets the RF architecture at the transmitter, whether each component carriers have a separate LO or one common LO for the entire subblock.

You 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 LO per Subblock.

Name (Value)	Description
LO per Component Carrier (0)	The Carrier IQ Origin Offset Mean (dBc) and the In-Band Emission Margin (dB) are calculated as the LO per Component Carrier, the Subblock IQ Origin Offset Mean (dBc) and the Subblock In-Band Emission Margin (dB) will not be returned.
LO per Subblock (1)	The Subblock IQ Origin Offset Mean (dBc) and the Subblock In-Band Emission Margin (dB) are calculated as the LO per Subblock, the Carrier IQ Origin Offset Mean (dBc), and the In-Band Emission Margin (dB) will be NaN. In the case of a single carrier, the measurement returns the same value of IQ Origin Offset and In-Band Emission Margin for both components carrier and subblock results.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.TransmitterArchitecture, int) – Specifies the RF architecture at the transmitter, whether each component carriers have a separate LO or one common LO for the entire subblock.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_trigger_delay(selector_string, value)

Sets the trigger delay time. This value is expressed in seconds. If the delay is negative, the measurement acquires pre-trigger 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 topic for information about the string syntax for named signals.

The default value is 0.

Parameters:

selector_string (string) – Pass an empty string.
value (float) – Specifies the trigger delay time. This value is expressed in seconds. If the delay is negative, the measurement acquires pre-trigger samples. If the delay is positive, the measurement acquires post-trigger samples.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_trigger_minimum_quiet_time_duration(selector_string, value)

Sets the time duration for which the signal must be quiet before the signal analyzer arms the I/Q power edge trigger. This value is expressed in seconds. If you set the IQ_POWER_EDGE_TRIGGER_SLOPE 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.

You do not need to use a selector string to configure or read this attribute for the default signal instance. Refer to the Selector String topic for information about the string syntax for named signals.

The default of this attribute is hardware dependent.

Parameters:

selector_string (string) – Pass an empty string.
value (float) – Specifies the time duration for which the signal must be quiet before the signal analyzer arms the I/Q power edge trigger. This value is expressed in seconds. If you set the IQ_POWER_EDGE_TRIGGER_SLOPE 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.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_trigger_minimum_quiet_time_mode(selector_string, value)

Sets 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 topic for information about the string syntax for named signals.

The default value is Auto.

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.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.TriggerMinimumQuietTimeMode, int) – Specifies whether the measurement computes the minimum quiet time used for triggering.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

set_trigger_type(selector_string, value)

Sets the type of trigger to be used 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 topic for information about the string syntax for named signals.

The default value is None.

Name (Value)	Description
None (0)	No Reference Trigger is configured.
Digital Edge (1)	The Reference Trigger is not asserted until a digital edge is detected. The source of the digital edge is specified using the Digital Edge Source attribute.
IQ Power Edge (2)	The Reference Trigger is asserted when the signal changes past the level specified by the slope (rising or falling), which is configured using the IQ Power Edge Slope attribute.
Software (3)	The Reference Trigger is not asserted until a software trigger occurs.

Parameters:

selector_string (string) – Pass an empty string.
value (enums.TriggerType, int) – Specifies the type of trigger to be used for signal acquisition.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int

signal_configuration_name = '': Name assigned to the current signal configuration object.

signal_configuration_type = None: Type of the current signal configuration object.

wait_for_measurement_complete(selector_string, timeout)

Waits for the specified number for seconds for all the measurements to complete.

Parameters:

selector_string (string) –
This parameter specifies a Selector String comprising of the result name. The default is “” (empty string).

Example:

”result::r1”

You can use the build_result_string() method to build the selector string.
timeout (float) – This parameter specifies the timeout for which the method waits for the measurement to complete. This value is expressed in seconds. A value of -1 specifies that the method waits until the measurement is complete.

Returns:

Returns the status code of this method. The status code either indicates success or describes a warning condition.

Return type:

int