pypowsybl.network.Network.get_voltage_source_converters

Network.get_voltage_source_converters(all_attributes=False, attributes=None, **kwargs)[source]

Get a dataframe of voltage source converters.

Parameters:

  • all_attributes (bool) – flag for including all attributes in the dataframe, default is false

  • attributes (List[str] | None) – attributes to include in the dataframe. The 2 parameters are mutually exclusive. If no parameter is specified, the dataframe will include the default attributes.

  • kwargs (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str]) – the data to be selected, as named arguments.

Returns:

the voltage source converters dataframe

Return type:

DataFrame

Notes

The resulting dataframe, depending on the parameters, will include the following columns:

  • voltage_level_id: at which substation the converter is connected

  • bus1_id: bus where this converter is connected, on side 1

  • bus2_id (optional): bus where this converter is connected, on side 2

  • dc_node1_id: dc node where this converter is connected, on side 1

  • dc_node2_id: dc node where this converter is connected, on side 2

  • regulated_element_id (optional): which element of the network is regulating PCC, needed if bus2_id is set

  • dc_connected1: True if the converter is connected to a dc node, side 1

  • dc_connected2: True if the converter is connected to a dc node, side 2

  • voltage_regulator_on: the voltage regulator status

  • control_mode: the control mode of the converter

  • target_p: the active power setpoint

  • target_q: the reactive power setpoint

  • target_v_dc: the DC voltage setpoint

  • target_v_ac: the AC voltage setpoint

  • idle_loss: the idle loss coefficient

  • switching_loss: the switching loss coefficient

  • resistive_loss: the resistive loss coefficient

  • p_ac: the AC active flow on the converter, NaN if no loadflow has been computed (in MW)

  • q_ac: the AC reactive flow on the converter, NaN if no loadflow has been computed (in MVAr)

  • p_dc1: the DC flow on the converter, side 1 NaN if no loadflow has been computed (in MW)

  • p_dc2: the DC flow on the converter, side 2 NaN if no loadflow has been computed (in MW)

  • fictitious (optional): True if the area is part of the model and not of the actual network

This dataframe is indexed on the converter ID.