NI-RFPM API Reference

Measurement:Power Level Coercion Method Property

  • Updated2023-12-28
  • 2 minute(s) read

Measurement:Power Level Coercion Method Property

Short Name: Power Level Coercion Method

Property of niRFPM

Specifies if and how power level is coerced when fetching the source offset. Coercion can either be to the nearest calibrated power level with a matching frequency, or to a lower power level only.

This property does not support the mmWave subsystem.

If you only enable power level coercion and do not enable frequency interpolation by setting the Interpolation Enabled property to TRUE, NI-RFPM looks for an offset that matches the requested frequency exactly, and has a power level within the range specified by the Maximum Power Level Coercion property. Of those points, NI-RFPM coerces to the offset whose power level is closest to the requested value.

If you enable power level coercion and set Interpolation Enabled to TRUE, NI-RFPM first attempts to do the same as above. If no exact frequency matches are found, NI-RFPM selects the pair of points whose power levels are in the coercible range, and whose frequencies are closest to what was requested (one above and one below), and interpolates between them.

Default Value: Coercion Diabled

Coercion Disabled (1)

Power level coercion is disabled.

Coercion to Nearest Power (2)

Power level will be coerced to the nearest calibrated power, higher or lower.

Coercion to Lower Power (3)

Power level will be coerced only to a lower calibrated power.

Remarks

The following table lists the characteristics of this property.

Datatype iL
PermissionsRead/Write
High-level VIs N/A
Channel-based No
Port-based No
Device-based Yes
ResettableNo