RFmxSpecAn ACP Fetch (VI)
- Updated2023-10-12
- 13 minute(s) read
RFmxSpecAn ACP Fetch (VI)
Owning Palette: FetchFetches 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.
![]() |
Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI. |
![]() |
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. |
![]() |
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. |
![]() |
error in describes error conditions that occur before this node runs. This input provides standard error in functionality. |
![]() |
Instrument Handle Out passes a reference of your RFmx session to the next VI. |
![]() |
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. |
![]() |
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.
![]() |
Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI. |
![]() |
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. |
![]() |
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. |
![]() |
error in describes error conditions that occur before this node runs. This input provides standard error in functionality. |
![]() |
Instrument Handle Out passes a reference of your RFmx session to the next VI. |
![]() |
Frequency Resolution returns the frequency bin spacing, in Hz, of the spectrum acquired by the measurement. |
![]() |
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.
![]() |
Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI. |
![]() |
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. |
![]() |
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. |
![]() |
error in describes error conditions that occur before this node runs. This input provides standard error in functionality. |
![]() |
Instrument Handle Out passes a reference of your RFmx session to the next VI. |
![]() |
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. |
![]() |
Total Relative Power returns the carrier power, in dB, measured relative to the total carrier power of all active carriers. |
![]() |
Integration Bandwidth returns the frequency range, in Hz, over which the measurement integrates the carrier power. |
![]() |
Frequency returns the center frequency, in Hz, of the carrier relative to the Center Frequency property. |
![]() |
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.
![]() |
Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI. |
![]() |
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. |
![]() |
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. |
![]() |
error in describes error conditions that occur before this node runs. This input provides standard error in functionality. |
![]() |
Instrument Handle Out passes a reference of your RFmx session to the next VI. |
![]() |
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. |
![]() |
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. |
![]() |
Lower Absolute Power returns the lower offset channel power. |
![]() |
Upper Absolute Power returns the upper offset channel power. |
![]() |
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.
![]() |
Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI. |
![]() |
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. |
![]() |
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. |
![]() |
error in describes error conditions that occur before this node runs. This input provides standard error in functionality. |
![]() |
Instrument Handle Out passes a reference of your RFmx session to the next VI. |
![]() |
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. |
![]() |
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. |
![]() |
Lower Absolute Power returns the array of lower offset channel powers. |
![]() |
Upper Absolute Power returns the array of upper offset channel powers. |
![]() |
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.
![]() |
Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI. |
||||||
![]() |
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. |
||||||
![]() |
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. |
||||||
![]() |
error in describes error conditions that occur before this node runs. This input provides standard error in functionality. |
||||||
![]() |
Instrument Handle Out passes a reference of your RFmx session to the next VI. |
||||||
![]() |
Spectrum returns the spectrum.
|
||||||
![]() |
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.
![]() |
Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI. |
||||||
![]() |
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. |
||||||
![]() |
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. |
||||||
![]() |
error in describes error conditions that occur before this node runs. This input provides standard error in functionality. |
||||||
![]() |
Instrument Handle Out passes a reference of your RFmx session to the next VI. |
||||||
![]() |
Relative Powers returns the trace of relative powers measured in each channel relative to the power reference carrier.
|
||||||
![]() |
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.
![]() |
Instrument Handle In specifies the RFmx session refnum. Instrument Handle In is obtained from the RFmxInstr Initialize NIRFSA VI. |
||||||
![]() |
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. |
||||||
![]() |
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. |
||||||
![]() |
error in describes error conditions that occur before this node runs. This input provides standard error in functionality. |
||||||
![]() |
Instrument Handle Out passes a reference of your RFmx session to the next VI. |
||||||
![]() |
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.
|
||||||
![]() |
error out contains error information. This output provides standard error out functionality. |