RFmxLTE ACP Fetch (VI)

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

Timeout specifies the timeout for fetching the specified measurement. This value is expressed in seconds. 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 the 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 RFmxLTE 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 to your RFmx session to the next VI.

Total Aggregated Power returns the sum of powers of all the frequency bins over the integration bandwidth of subblock. This value includes the power in the inter-carrier gaps within a subblock, but it does not include the power in the subblock gaps.

When you set the ACP Pwr Units property to dBm, the parameter returns the total integrated power in dBm of all the active carriers measured. When you set the ACP Pwr Units property to dBm/Hz, the parameter returns the power spectral density in dBm/Hz based on the power in all the active carriers measured.

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

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

Timeout specifies the timeout for fetching the specified measurement. This value is expressed in seconds. 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 subblock 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. The default value is "subblock0".

Example:

"subblock0"

"signal::sig1/subblock0"

"result::r1/subblock0"

"signal::sig1/result::r1/subblock0"

You can use the RFmxLTE Build Subblock 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 to your RFmx session to the next VI.

Subblock Power returns the sum of powers of all the frequency bins over the integration bandwidth of the subblock. When you set the ACP Pwr Units property to dBm, the parameter returns the total subblock power in dBm of all the active carriers measured over the subblock. When you set the ACP Pwr Units property to dBm/Hz, the parameter returns the power spectral density in dBm/Hz based on the power in all the active carriers measured over the subblock.

Integration Bandwidth returns the integration bandwidth used in calculating the power of the subblock. Integration bandwidth is the span from left edge of the leftmost carrier to the right edge of the rightmost carrier within a subblock. This value is expressed in Hz.

Frequency returns the absolute center frequency of the subblock. This value is the center of the subblock integration bandwidth. This value is expressed in Hz.

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

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

Timeout specifies the timeout for fetching the specified measurement. This value is expressed in seconds. 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, subblock number, 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. The default value is "subblock0/carrier0".

Example:

"subblock0/carrier0"

"signal::sig1/subblock0/carrier0"

"result::r1/subblock0/carrier0"

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

You can use the RFmxLTE Build Carrier 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 to your RFmx session to the next VI.

Absolute Power returns the power measured over the integration bandwidth of the carrier. The carrier power is reported in dBm when you set the ACP Pwr Units property to dBm, and in dBm/Hz when you set the ACP Pwr Units property to dBm/Hz.

Relative Power returns the component carrier power relative to its subblock power. This value is expressed in dB.

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

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

Timeout specifies the timeout for fetching the specified measurement. This value is expressed in seconds. 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 subblock 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. The default value is "subblock0".

Example:

"subblock0"

"signal::sig1/subblock0"

"result::r1/subblock0"

"signal::sig1/result::r1/subblock0"

You can use the RFmxLTE Build Subblock 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 to your RFmx session to the next VI.

Absolute Power returns the array of powers measured over the integration bandwidths of the carriers. The carrier power is reported in dBm when you set the ACP Pwr Units property to dBm, and in dBm/Hz when you set the ACP Pwr Units property to dBm/Hz.

Relative Power returns the array of component carrier powers relative to their subblock powers measured over the integration bandwidths of the component carriers in the subblock. This value is expressed in dB.

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

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

Timeout specifies the timeout for fetching the specified measurement. This value is expressed in seconds. 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, subblock number, 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. The default value is "" (empty string).

Example:

"subblock0/offset0"

"signal::sig1/subblock0/offset0"

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

"result::r1/subblock0/offset0"

You can use the RFmxLTE Build Offset 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 to your RFmx session to the next VI.

Lower Relative Power returns the power in lower (negative) offset channel relative to value returned by the ACP Results Total Aggregated Pwr property. If this offset is not applicable for the intra band non contagious type of carrier aggregation, a Nan is returned.

Upper Relative Power returns the power in upper (positive) offset channel relative to the value returned by the ACP Results Total Aggregated Pwr property. If this offset is not applicable for the intra band non contagious type of carrier aggregation, a Nan is returned.

Lower Absolute Power returns the lower offset channel power. If this offset is not applicable for the intra band non contagious type of carrier aggregation, a Nan is returned. The offset channel power is reported in dBm when you set the ACP Pwr Units property to dBm, and in dBm/Hz when you set the ACP Pwr Units property to dBm/Hz.

Upper Absolute Power returns the upper offset channel power. If this offset is not applicable for the intra band non contagious type of carrier aggregation, a Nan is returned. The offset channel power is reported in dBm when you set the ACP Pwr Units property to dBm, and in dBm/Hz when you set the ACP Pwr Units property to dBm/Hz.

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

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

Timeout specifies the timeout for fetching the specified measurement. This value is expressed in seconds. 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 subblock 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. The default value is "subblock0".

Example:

"subblock0"

"signal::sig1/subblock0"

"result::r1/subblock0"

"signal::sig1/result::r1/subblock0"

You can use the RFmxLTE Build Subblock 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 to your RFmx session to the next VI.

Lower Relative Power returns the array of power in lower (negative) offset channel relative to the value returned by the ACP Results Total Aggregated Pwr property. If this offset is not applicable for the intra band non contagious type of carrier aggregation, a Nan is returned.

Upper Relative Power returns the array of powers in upper (positive) offset channel relative to the value returned by the ACP Results Total Aggregated Pwr property. If this offset is not applicable for the intra band non contagious type of carrier aggregation, a Nan is returned.

Lower Absolute Power returns the array of lower offset channel power. If this offset is not applicable for the intra band non contagious type of carrier aggregation, a Nan is returned. The offset channel power is reported in dBm when you set the ACP Pwr Units property to dBm, and in dBm/Hz when you set the ACP Pwr Units property to dBm/Hz.

Upper Absolute Power returns the array of upper offset channel powers. If this offset is not applicable for the intra band non contagious type of carrier aggregation, a Nan is returned. The offset channel power is reported in dBm when you set the ACP Pwr Units property to dBm, and in dBm/Hz when you set the ACP Pwr Units property to dBm/Hz.

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

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

Timeout specifies the timeout for fetching the specified measurement. This value is expressed in seconds. 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 the 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 RFmxLTE 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 to your RFmx session to the next VI.

Spectrum returns the spectrum.

	x0 returns the start frequency of the channel. This value is expressed in Hz.
	dx returns the frequency bin spacing. This value is expressed in Hz.
	y returns the array of averaged power measured at each frequency bin. This value is expressed in dBm.

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

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

Timeout specifies the timeout for fetching the specified measurement. This value is expressed in seconds. 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 the 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 RFmxLTE 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 to your RFmx session to the next VI.

Relative Powers returns the array of traces of relative powers measured in each channel relative to total aggregated power.

	x0 returns the start frequency of the channel. This value is expressed in Hz.
	dx returns the frequency bin spacing. This value is expressed in Hz.
	y returns the relative power measured in each channel relative to total aggregated power. This value is expressed in dB.

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

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

Timeout specifies the timeout for fetching the specified measurement. This value is expressed in seconds. 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 the 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 RFmxLTE 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 to your RFmx session to the next VI.

Absolute Powers returns the trace of the measured integrated power in each channel.

	x0 returns the start frequency of the channel. This value is expressed in Hz.
	dx returns the frequency bin spacing. This value is expressed in Hz.
	y returns the power measured in each channel. The carrier power is reported in dBm when you set the ACP Pwr Units property to dBm, and in dBm/Hz when you set the ACP Pwr Units property to dBm/Hz.

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