RFmxPulseMX Methods

Stops acquisition and measurements associated with signal instance that you specify in the selectorString parameter, which were previously initiated by the Initiate(String, String) 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.

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 methods. You can fetch measurement results using the Fetch methods or result methods in the method node. Use this method only if the RFmxInstrMX.GetRecommendedAcquisitionType method value is either IQ or IQorSpectral.
Query the Recommended Acquisition Type method from the RFmxInstr Property Node after calling the RFmx Pulse Commit method.

Examines the input signal to calculate the peak power level and sets it as the value of the ReferenceLevel method. Use this method to help calculate an approximate setting for the reference level.
The RFmxPulse Auto Level method does the following:

1. Resets the mixer level, mixer level offset and IF output power offset.
   
2. Sets the starting reference level to the maximum reference level supported by the device based on the current RF attenuation, mechanical attenuation and preamp enabled settings.
   
3. Iterates to adjust the reference level based on the input signal peak power.
   
4. Uses immediate triggering and restores the trigger settings back to user setting after completing execution.
   

You can also specify the starting reference level using the AutoLevelInitialReferenceLevel method.
When using PXIe-5663, 5665, or 5668R devices, NI recommends that you set an appropriate value for mechanical attenuation before calling the RFmx Pulse Auto Level method. Setting an appropriate value for mechanical attenuation reduces the number of times the attenuator settings are changed by this method, thus reducing wear and tear, and maximizing the life time of the attenuator.

Creates selector string for use with configuration or fetch.

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.

Clears all results for the current signal instance.

Clears a result instance specified by the result name in the selectorString parameter.

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

Commits settings to the hardware. Calling this method is optional. RFmxPulse commits settings to the hardware when you call the Initiate(String, String) method or any of the measurement Read methods.

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

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

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

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

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

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

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

Deletes an instance of a signal.

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.

Deletes the signal configuration if it is not the default signal configuration and clears any trace of the current signal configuration, if any.

Determines whether the specified Object is equal to the current Object.

Gets the acquisition length for the pulse measurement. This value is expressed in seconds.You configure this method when you set the SegmentedAcquisitionEnabled method to False.

Gets the named result names of the signal that you specify in the selectorString parameter.

Gets the value of a Bool attribute.

Gets the value of a Double attribute.

Gets the value of a double array attribute.

Gets the value of an RFmx 32-bit integer (int32) attribute.

Gets the value of a integer array attribute.

Gets the value of a of an RFmx string.

Gets the initial reference level, in dBm, which the AutoLevel(String, Double, Double, Double) function uses to estimate the peak power of the input signal.

Gets the expected carrier frequency of the acquired RF signal. This value is expressed in Hz. The signal analyzer tunes to this frequency.

Gets the active edge for the trigger. This method is used only when you set the TriggerType method to DigitalEdge.

Gets the source terminal for the digital edge trigger. This method is used only when you set the TriggerType method to DigitalEdge.

Converts the status code returned by an RFmxPULSE function into a 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 RF Attenuation and Signal Levels topic for your device in the NI RF Vector Signal Analyzers Help.

Serves as a hash function for a particular type.

Gets the power level at which the device triggers. This value is expressed in dB when you set the IQPowerEdgeTriggerLevelType method to Relative and in dBm when you set the IQ Power Edge Level Type method to Absolute. The device asserts the trigger when the signal exceeds the level specified by the value of this method, taking into consideration the specified slope. This method is used only when you set the TriggerType method to IQPowerEdge.

Gets the reference for the IQPowerEdgeTriggerLevel method. The IQ Power Edge Level Type method is used only when you set the TriggerType method to IQPowerEdge.

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 level that you specify in the IQPowerEdgeTriggerLevel method with the slope you specify. This method is used only when you set the TriggerType method to IQPowerEdge.

Gets the channel from which the device monitors the trigger. This method is used only when you set the TriggerType method to IQPowerEdge.

Gets the maximum number of pulses to be measured when you set the MaximumPulseCountEnabled method to True.

Gets whether to enable the maximum pulse count for pulse measurements.You must configure this method when you set the SegmentedAcquisitionEnabled method to False.

Gets the bandwidth of the filter used for the required sample rate. This value is expressed in Hz.

Gets the demodulation filter type to be used in the measurements.

Gets the number of segments to acquire when you set the SegmentedAcquisitionEnabled method to True.

Gets the reference level that represents the maximum expected power of the RF input signal. This value is expressed in dBm for RF devices and Vpk-pk for baseband devices.

Gets the margin RFmx adds to the ReferenceLevel method. The margin avoids clipping and overflow warnings if the input signal exceeds the configured reference level.

Gets the wait time before results are available in the PropertyNode. 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 RFmxPulse Property Node waits until the measurement is complete.

Gets the acquisition length for the pulse measurement when you set the SegmentedAcquisitionEnabled method to True. This value is expressed in seconds.

Gets whether to enable Segmented Acquisition. This mode is best applied when the pulses are sparsely spaced.

Gets the instrument port to be configured to acquire a signal. Use RFmxInstr_GetAvailablePorts function to get the valid port names.

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

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 IQPowerEdgeTriggerSlope method to Rising, the signal is quiet below the trigger level. If you set the IQ Power Edge Slope method to Falling, the signal is quiet above the trigger level.

Gets whether the measurement computes the minimum quiet time used for triggering.

Gets the trigger type.

Gets the Type of the current instance.

Gets the latest warning code and description.

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 methods in the method node. To get the status of measurements, use the RF WaitForMeasurementComplete(String, Double) method or CheckMeasurementStatus(String, Boolean) method.

Resets the attribute to its default value.

Resets a signal to the default values.

Specifies the measurements that you want to enable.

Sends a trigger to the device when you use the ConfigureSoftwareEdgeTrigger(String, Double, Boolean) 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(String, String) method.
  

Sets the acquisition length for the pulse measurement. This value is expressed in seconds.You configure this method when you set the SegmentedAcquisitionEnabled method to False.

Sets the value of a Bool attribute.

Sets the value of a Double attribute.

Set the value of a double array attribute.

Sets the value of a Int attribute.

Set the value of a integer array attribute.

Sets the value of a String attribute.

Sets the initial reference level, in dBm, which the AutoLevel(String, Double, Double, Double) function uses to estimate the peak power of the input signal.

Sets the expected carrier frequency of the acquired RF signal. This value is expressed in Hz. The signal analyzer tunes to this frequency.

Sets the active edge for the trigger. This method is used only when you set the TriggerType method to DigitalEdge.

Sets the source terminal for the digital edge trigger. This method is used only when you set the TriggerType method to DigitalEdge.

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 RF Attenuation and Signal Levels topic for your device in the NI RF Vector Signal Analyzers Help.

Sets the power level at which the device triggers. This value is expressed in dB when you set the IQPowerEdgeTriggerLevelType method to Relative and in dBm when you set the IQ Power Edge Level Type method to Absolute. The device asserts the trigger when the signal exceeds the level specified by the value of this method, taking into consideration the specified slope. This method is used only when you set the TriggerType method to IQPowerEdge.

Sets the reference for the IQPowerEdgeTriggerLevel method. The IQ Power Edge Level Type method is used only when you set the TriggerType method to IQPowerEdge.

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 level that you specify in the IQPowerEdgeTriggerLevel method with the slope you specify. This method is used only when you set the TriggerType method to IQPowerEdge.

Sets the channel from which the device monitors the trigger. This method is used only when you set the TriggerType method to IQPowerEdge.

Sets the maximum number of pulses to be measured when you set the MaximumPulseCountEnabled method to True.

Sets whether to enable the maximum pulse count for pulse measurements.You must configure this method when you set the SegmentedAcquisitionEnabled method to False.

Sets the bandwidth of the filter used for the required sample rate. This value is expressed in Hz.

Sets the demodulation filter type to be used in the measurements.

Sets the number of segments to acquire when you set the SegmentedAcquisitionEnabled method to True.

Sets the reference level that represents the maximum expected power of the RF input signal. This value is expressed in dBm for RF devices and Vpk-pk for baseband devices.

Sets the margin RFmx adds to the ReferenceLevel method. The margin avoids clipping and overflow warnings if the input signal exceeds the configured reference level.

Sets the wait time before results are available in the RFmx Property. 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 RFmxPulse Property Node waits until the measurement is complete.

Sets the acquisition length for the pulse measurement when you set the SegmentedAcquisitionEnabled method to True. This value is expressed in seconds.

Sets whether to enable Segmented Acquisition. This mode is best applied when the pulses are sparsely spaced.

Sets the instrument port to be configured to acquire a signal. Use RFmxInstr_GetAvailablePorts function to get the valid port names.

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

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 IQPowerEdgeTriggerSlope method to Rising, the signal is quiet below the trigger level. If you set the IQ Power Edge Slope method to Falling, the signal is quiet above the trigger level.

Sets whether the measurement computes the minimum quiet time used for triggering.

Sets the trigger type.

Returns a string that represents the current object.

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