InterconnectingConverter
Package: PowerOperationsOpenAPIModels · Source: Operations/StaticInjection/InterconnectingConverter.json
Interconnecting Power Converter (IPC) for transforming power from an ACBus to a DCBus.
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 | — | A | DC current on the converter. Units: A. |
max_dc_current | number | — | A | Maximum stable dc current limits. Units: A. |
loss_function | LossCurve | — | — | Linear or quadratic loss function with respect to the converter current. |
dc_control | string (VSCDCControlModes) | — | — | DC-side control mode of the converter. |
ac_control | string (VSCACControlModes) | — | — | AC-side control mode of the converter. |
voltage_setpoint_units | string (VoltageUnitBasis) | — | — | Unit basis for the DC/AC voltage setpoints. |
dc_setpoint | number | — | MW / (kV / pu by voltage_setpoint_units) / (kV / pu by voltage_setpoint_units) (by dc_control) | DC-voltage target (when dc_control regulates DC voltage) or active-power order (otherwise). Units: per dc_control — DC_POWER: MW, DC_VOLTAGE: (per voltage_setpoint_units — NATURAL_UNITS: kV, COMPONENT_BASE: pu), DC_VOLTAGE_DROOP: (per voltage_setpoint_units — NATURAL_UNITS: kV, COMPONENT_BASE: pu) . |
ac_setpoint | number | — | 1 / (kV / pu by voltage_setpoint_units) (by ac_control) | AC-voltage magnitude target (when ac_control regulates AC voltage) or power factor setpoint (otherwise). Units: per ac_control — AC_REACTIVE_POWER: 1, AC_VOLTAGE: (per voltage_setpoint_units — NATURAL_UNITS: kV, COMPONENT_BASE: pu) . |
dc_voltage_droop | number | — | pu | DC-voltage droop gain relating DC voltage to converter active power as V_dc = dc_setpoint - dc_voltage_droop * P_c. A value of 0.0 disables droop. Units: pu. |
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. |
rmpct | number | — | 1 | Percent of the total Mvar required to hold the voltage at the bus regulated by this converter that is contributed by this converter. Units: 1. |
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 | — | pu | Limits on the voltage at the DC bus in per unit. Units: pu. |
dynamic_injector | integer or null | — | — | ID of the corresponding dynamic injection device, if any. |