pypowsybl.network.Network.create_voltage_source_converters

Network.create_voltage_source_converters(df=None, **kwargs)[source]

Creates voltage source converter.

Parameters:

  • df (DataFrame | None) – Attributes as a dataframe.

  • kwargs (ArrayLike) – Attributes as keyword arguments.

Return type:

None

Notes

Data may be provided as a dataframe or as keyword arguments. In the latter case, all arguments must have the same length.

Valid attributes are:

  • id: the identifier of the new voltage source converter

  • name: an optional human-readable name

  • voltage_level_id: the voltage level where the new converter will be connected. The voltage level must already exist.

  • bus_id1 the bus where the new converter will be connected on side 1.

    It must already exist.

  • bus_id2 the bus where the new converter will be connected on side 2.

    It must already exist.

  • dc_node1_id: the DC node where the new converter will be connected on DC side 1. It must already exist.

  • dc_node2_id: the DC node where the new converter will be connected on DC side 2. It must already exist.

  • dc_connected1: defines if the converter is connected at the dc node 1 (boolean)

  • dc_connected2: defines if the converter is connected at the dc node 2 (boolean)

  • regulating_element_id: the network PCC element

    It must already exist.

  • voltage_regulator_on: defines if the converter regulates AC voltage (boolean)

  • control_mode the control mode of the converter (V_DC or P_PCC)

  • target_p the AC active power setpoint

  • target_q the AC reactive power setpoint

  • min_p the minimum active power in MW (optional, unbounded by default)

  • max_p the maximum active power in MW (optional, unbounded by default)

  • target_v_ac the AC voltage setpoint

  • target_v_dc the DC voltage setpoint

  • idle_loss the idle loss coefficient

  • switching_loss the switching loss coefficient

  • resistive_loss the resistive loss coefficient

Note

target_p, min_p and max_p follow the load sign convention at the point of common coupling (PCC): a positive value means active power absorbed by the converter from the AC grid.

Warning

A finite min_p / max_p (any value other than -inf / inf) is not yet supported by IIDM serialization: saving a network that contains one raises a PowsyblException.

Examples

Using keyword arguments:

network.create_voltage_source_converter(id='VSC-1', voltage_level_id='VL1',dc_node1_id='DN1',
dc_node2_id='DN2', bus1_id='B1', voltage_regulator_on=0, control_mode='P_PCC', target_p=50.0,
target_q=50.0, target_v_ac=300.0, target_v_dc=400.0, idle_loss=1.0, switching_loss=2.0,
resistive_loss=3.0)