InterconnectingConverter

Package: PowerOperationsOpenAPIModels · Source: Operations/StaticInjection/InterconnectingConverter.json

Interconnecting Power Converter (IPC) for transforming power from an ACBus to a DCBus. Voltage and voltage-droop fields are natural units only: there is no conventional DC base voltage from which to per-unitize them. rated_dc_voltage and rated_ac_voltage record the voltage bases, so a consumer can convert the voltage fields to per unit.

Properties

Property	Type	Required	Unit	Description
id	integer	yes	—	Unique integer identifier for this component.
name	string	yes	—	Name of the component. Components of the same type (e.g., PowerLoad) must have unique names, but components of different types (e.g., PowerLoad and ACBus) can have the same name.
available	boolean	yes	—	Indicator of whether the component is connected and online (true) or disconnected, offline, or down (false). Unavailable components are excluded during simulations.
bus	integer	yes	—	ID of the bus on the AC side of this converter.
dc_bus	integer	yes	—	ID of the bus on the DC side of this converter.
active_power	number	yes	MW / pu (by power_units)	Active power on the DC side. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu .
rating	number	yes	MVA / pu (by power_units)	Maximum output power rating of the converter. Units: per power_units — NATURAL_UNITS: MVA, COMPONENT_BASE: pu .
active_power_limits	MinMax	yes	MW / pu (by power_units)	Minimum and maximum stable active power levels. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu .
base_power	number	yes	MVA	Base power of the converter for per unitization. Units: MVA.
power_units	string (UnitSystem)	yes	—	Unit basis for this component’s power-family fields (active/reactive/apparent power, ratings, limits, ramp rates). COMPONENT_BASE: per unit on this component’s own base_power. NATURAL_UNITS: the field’s physical unit.
reactive_power_limits	MinMax	—	MVAr / pu (by power_units)	Minimum and maximum reactive power limits. Set to null if not applicable. Units: per power_units — NATURAL_UNITS: MVAr, COMPONENT_BASE: pu .
dc_current	number	—	kA	DC current on the converter. Units: kA.
max_dc_current	number	—	kA	Maximum stable dc current limits. 9999 means no limit. Units: kA.
loss_function	CurrentLossCurve	—	—	Linear or quadratic loss (power) as a function of the converter’s DC current.
dc_control	string (VSCDCControlModes)	—	—	DC-side control mode of the converter. No default: an in-service converter always controls something on each side, so the mode is supplied explicitly.
ac_control	string (VSCACControlModes)	—	—	AC-side control mode of the converter. No default: an in-service converter always controls something on each side, so the mode is supplied explicitly.
dc_power_setpoint	number or null	—	MW / pu (by power_units)	Active-power order of the converter, used when dc_control is DC_POWER; null otherwise. Positive means the converter supplies power to the AC network; negative means it withdraws power from it. Units: per power_units — NATURAL_UNITS: MW, COMPONENT_BASE: pu .
dc_voltage_setpoint	number or null	—	kV	DC-side voltage target of the converter, used when dc_control is DC_VOLTAGE or DC_VOLTAGE_DROOP; null otherwise. Units: kV.
rated_dc_voltage	number	—	kV	Rated DC voltage of the converter, the base for dc_voltage_setpoint and voltage_limits; 0.0 means unspecified. Units: kV.
power_factor_setpoint	number or null	—	1	Power-factor setpoint of the converter, used when ac_control is AC_REACTIVE_POWER; null otherwise. Units: 1.
ac_voltage_setpoint	number or null	—	kV	AC-side voltage magnitude target of the converter, used when ac_control is AC_VOLTAGE; null otherwise. Units: kV.
rated_ac_voltage	number	—	kV	Rated AC voltage at the converter’s AC terminal, the base for ac_voltage_setpoint; 0.0 means unspecified. Units: kV.
dc_voltage_droop	number	—	kV/MW	DC-voltage droop gain on the converter, used when dc_control is DC_VOLTAGE_DROOP: V_dc = dc_voltage_setpoint - dc_voltage_droop * P_c, with V_dc in kV and P_c in MW regardless of power_units. A value of 0.0 disables droop. Units: kV/MW.
remote_bus_control	integer or null	—	—	Number of the AC bus whose voltage the converter regulates when ac_control is AC_VOLTAGE; null regulates its own terminal bus.
power_factor_weighting_fraction	number	—	1	Power weighting factor fraction used in reducing the active power order and either the reactive power order when the converter rating is violated. When is 0.0, only the active power is reduced; when is 1.0, only the reactive power is reduced; otherwise, a weighted reduction of both active and reactive power is applied. Units: 1.
voltage_limits	MinMax	—	kV	Minimum and maximum voltage at the DC bus. Units: kV.
dynamic_injector	integer or null	—	—	ID of the corresponding dynamic injection device, if any.