Gets or sets the power, in watts, to request the device to source from each active channel.

Syntax

Namespace: NationalInstruments.ModularInstruments.NIDCPower

public double RequestedPowerAllocation { get; set; }

Remarks

Returns a double value that is the amount of power, in watts, requested to be allocated for the channel.

  • The default value is 0.

  • Valid values are [0, device per-channel maximum power].

This property defines the power to source from the device only if the PowerAllocationMode property is set to Manual.

The power you request with this property may be incompatible with the power a given source configuration requires or the power the device can provide:

Incompatibility

Behavior

Requested power < power required for source configuration

  • Device does not exceed the requested power

  • NI-DCPower returns an error

Requested power > maximum per-channel or overall sourcing power

  • Device does not exceed the allowed power

  • NI-DCPower returns an error

Note

NI-DCPower uses the terms "source" and "output". However, while sinking with electronic loads and SMUs these correspond to "sinking" and "input", respectively.

Note

This property is not supported by all instruments. Refer to the Supported Properties by Device topic in the NI DC Power Supplies and SMUs Help for information about supported instruments.