RFmx SpecAn VIs

Table of Contents

RFmxSpecAn ACP Fetch (VI)

  • Updated2023-10-12
  • 13 minute(s) read
 RFmxSpecAn ACP Fetch (VI)

RFmxSpecAn ACP Fetch (VI)

Owning Palette: Fetch

Fetches adjacent channel power (ACP) measurement results.

RFmxSpecAn ACP Fetch Total Carrier Power

Fetches the total integrated power of all the active carriers measured when you set the ACP Power Units property to dBm. This VI returns the power spectral density based on the power in all the active carriers measured when you set the ACP Power Units property to dBm/Hz.

RFmxSpecAn ACP Fetch Total Carrier Power

cio.gif

Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI.

cdbl.gif

Timeout specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the VI waits until the measurement is complete. The default value is 10.

cstr.gif

Selector String specifies a selector string comprising of the signal name and result name. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used. The default value is "" (empty string).

Example:

""

"signal::sig1"

"result::r1"

"signal::sig1/result::r1"

You can use the RFmxSpecAn Build Signal String VI to build the selector string.

cerrcodeclst.gif

error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

iio.gif

Instrument Handle Out passes a reference of your RFmx session to the next VI.

idbl.gif

Total Carrier Power returns the total integrated power of all the active carriers measured when you set the ACP Power Units property to dBm. This parameter returns the power spectral density based on the power in all the active carriers measured when you set the ACP Power Units property to dBm/Hz.

ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

RFmxSpecAn ACP Fetch Frequency Resolution

Returns the frequency resolution, in Hz, of the spectrum acquired by the measurement.

RFmxSpecAn ACP Fetch Frequency Resolution

cio.gif

Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI.

cdbl.gif

Timeout specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the VI waits until the measurement is complete. The default value is 10.

cstr.gif

Selector String specifies a selector string comprising of the signal name and result name. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used. The default value is "" (empty string).

Example:

""

"signal::sig1"

"result::r1"

"signal::sig1/result::r1"

You can use the RFmxSpecAn Build Signal String VI to build the selector string.

cerrcodeclst.gif

error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

iio.gif

Instrument Handle Out passes a reference of your RFmx session to the next VI.

idbl.gif

Frequency Resolution returns the frequency bin spacing, in Hz, of the spectrum acquired by the measurement.

ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

RFmxSpecAn ACP Fetch Carrier Measurement

Returns the measured carrier power.

Use "carrier<n>" as the selector string to read results from this VI.

RFmxSpecAn ACP Fetch Carrier Measurement

cio.gif

Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI.

cdbl.gif

Timeout specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the VI waits until the measurement is complete. The default value is 10.

cstr.gif

Selector String specifies a selector string comprising of the signal name, result name, and carrier number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.

Example:

"carrier0"

"signal::sig1/carrier0"

"result::r1/carrier0"

"signal::sig1/result::r1/carrier0"

You can use the RFmxSpecAn Build Carrier String2 VI to build the selector string.

cerrcodeclst.gif

error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

iio.gif

Instrument Handle Out passes a reference of your RFmx session to the next VI.

idbl.gif

Absolute Power returns the measured carrier power. The carrier power is reported in dBm or dBm/Hz based on the value of the ACP Power Units property.

idbl.gif

Total Relative Power returns the carrier power, in dB, measured relative to the total carrier power of all active carriers.

idbl.gif

Integration Bandwidth returns the frequency range, in Hz, over which the measurement integrates the carrier power.

idbl.gif

Frequency returns the center frequency, in Hz, of the carrier relative to the Center Frequency property.

ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

RFmxSpecAn ACP Fetch Offset Measurement

Returns the absolute and relative powers measured in the offset channel. The relative powers are measured relative to the integrated power of the power reference carrier. The relative powers are not measured if you set the ACP Carrier Mode property to Passive.

Use "offset<n>" as the selector string to read results from this VI.

RFmxSpecAn ACP Fetch Offset Measurement

cio.gif

Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI.

cdbl.gif

Timeout specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the VI waits until the measurement is complete. The default value is 10.

cstr.gif

Selector String specifies a selector string comprising of the signal name, result name, and offset number. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used.

Example:

"offset0"

"signal::sig1/offset0"

"result::r1/offset0"

"signal::sig1/result::r1/offset0"

You can use the RFmxSpecAn Build Offset String2 VI to build the selector string.

cerrcodeclst.gif

error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

iio.gif

Instrument Handle Out passes a reference of your RFmx session to the next VI.

idbl.gif

Lower Relative Power returns the lower offset channel power, in dB, measured relative to the integrated power of the ACP Results Lower Offset Pwr Ref Carrier property.

idbl.gif

Upper Relative Power returns the upper offset channel power, in dB, measured relative to the integrated power of the ACP Results Upper Offset Pwr Ref Carrier property.

idbl.gif

Lower Absolute Power returns the lower offset channel power.

idbl.gif

Upper Absolute Power returns the upper offset channel power.

ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

RFmxSpecAn ACP Fetch Offset Measurement (Array)

Returns the absolute and relative powers measured in the offset channel. The relative powers are measured relative to the integrated power of the power reference carrier. The relative powers are not measured if you set the ACP Carrier Mode property for the reference carrier to Passive.

RFmxSpecAn ACP Fetch Offset Measurement (Array)

cio.gif

Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI.

cdbl.gif

Timeout specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the VI waits until the measurement is complete. The default value is 10.

cstr.gif

Selector String specifies a selector string comprising of the signal name and result name. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used. The default value is "" (empty string).

Example:

""

"signal::sig1"

"result::r1"

"signal::sig1/result::r1"

You can use the RFmxSpecAn Build Signal String VI to build the selector string.

cerrcodeclst.gif

error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

iio.gif

Instrument Handle Out passes a reference of your RFmx session to the next VI.

i2ddbl.gif

Lower Relative Power returns the array of lower offset channel powers, in dB, measured relative to the integrated power of the ACP Results Lower Offset Pwr Ref Carrier property.

i2ddbl.gif

Upper Relative Power returns the array of upper offset channel powers, in dB, measured relative to the integrated power of the ACP Results Upper Offset Pwr Ref Carrier property.

i2ddbl.gif

Lower Absolute Power returns the array of lower offset channel powers.

i2ddbl.gif

Upper Absolute Power returns the array of upper offset channel powers.

ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

RFmxSpecAn ACP Fetch Spectrum

Fetches the spectrum used for adjacent channel power (ACP) measurement.

RFmxSpecAn ACP Fetch Spectrum

cio.gif

Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI.

cdbl.gif

Timeout specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the VI waits until the measurement is complete. The default value is 10.

cstr.gif

Selector String specifies a selector string comprising of the signal name and result name. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used. The default value is "" (empty string).

Example:

""

"signal::sig1"

"result::r1"

"signal::sig1/result::r1"

You can use the RFmxSpecAn Build Signal String VI to build the selector string.

cerrcodeclst.gif

error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

iio.gif

Instrument Handle Out passes a reference of your RFmx session to the next VI.

icclst.gif

Spectrum returns the spectrum.

idbl.gif

x0 returns the start frequency. This value is expressed in Hz.

idbl.gif

dx returns the frequency bin spacing. This value is expressed in Hz.

i1dsgl.gif

y returns the array of averaged powers measured at each frequency bin. This value is expressed in dBm.

ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

RFmxSpecAn ACP Fetch Relative Powers Trace

Fetches the relative powers trace for adjacent channel power (ACP) measurement.

RFmxSpecAn ACP Fetch Relative Powers Trace

cio.gif

Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI.

cdbl.gif

Timeout specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the VI waits until the measurement is complete. The default value is 10.

cstr.gif

Selector String specifies a selector string comprising of the signal name and result name. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used. The default value is "" (empty string).

Example:

""

"signal::sig1"

"result::r1"

"signal::sig1/result::r1"

You can use the RFmxSpecAn Build Signal String VI to build the selector string.

cerrcodeclst.gif

error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

iio.gif

Instrument Handle Out passes a reference of your RFmx session to the next VI.

i1dcclst.gif

Relative Powers returns the trace of relative powers measured in each channel relative to the power reference carrier.

idbl.gif

x0 returns the start frequency of the channel. This value is expressed in Hz.

idbl.gif

dx returns the frequency bin spacing. This value is expressed in Hz.

i1dsgl.gif

y returns the relative power, in dB, measured in each channel relative to power reference carrier.

ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

RFmxSpecAn ACP Fetch Absolute Powers Trace

Fetches the absolute powers trace for adjacent channel power (ACP) measurement.

RFmxSpecAn ACP Fetch Absolute Powers Trace

cio.gif

Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI.

cdbl.gif

Timeout specifies the timeout, in seconds, for fetching the specified measurement. Set this value to an appropriate time, longer than expected for fetching the measurement. A value of -1 specifies that the VI waits until the measurement is complete. The default value is 10.

cstr.gif

Selector String specifies a selector string comprising of the signal name and result name. If you do not specify the signal name, the default signal instance is used. If you do not specify the result name, the default result instance is used. The default value is "" (empty string).

Example:

""

"signal::sig1"

"result::r1"

"signal::sig1/result::r1"

You can use the RFmxSpecAn Build Signal String VI to build the selector string.

cerrcodeclst.gif

error in describes error conditions that occur before this node runs. This input provides standard error in functionality.

iio.gif

Instrument Handle Out passes a reference of your RFmx session to the next VI.

i1dcclst.gif

Absolute Powers returns the trace of measured integrated power in dBm or power spectral density in dBm/Hz based on the power units that you specify in the ACP Power Units property.

idbl.gif

x0 returns the start frequency of the channel. This value is expressed in Hz.

idbl.gif

dx returns the frequency bin spacing. This value is expressed in Hz.

i1dsgl.gif

y returns the integrated power in dBm, or power spectral density in dBm/Hz, in the channel based on the power units specified.

ierrcodeclst.gif

error out contains error information. This output provides standard error out functionality.

Log in to get a better experience