create_vsc_converter_station_bay(network, df=None, raise_exception=True, reporter=None, report_node=None, **kwargs)[source]#

Creates a vsc converter station, connects it to the network on a given bus or busbar section and creates the associated topology.

  • network (Network) – the network to which we want to add the vsc converter station

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

  • raise_exception (bool) – optionally, whether the calculation should throw exceptions. In any case, errors will be logged. Default is True.

  • reporter (ReportNode | None) – deprecated, use report_node instead

  • report_node (ReportNode | None) – optionally, the reporter to be used to create an execution report, default is None (no report).

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

Return type:



The voltage level containing the busbar section can be described in node/breaker or bus/breaker topology. If the voltage level is node/breaker, the vsc converter station is connected to the busbar with a breaker and a closed disconnector. If the network has position extensions, the vsc converter station will also be connected to every parallel busbar section with an open disconnector. If the voltage level is bus/breaker, the vsc converter station is just connected to the bus.

Valid attributes are:

  • id: the identifier of the new station

  • name: an optional human-readable name

  • loss_factor: the loss factor of the new station

  • voltage_regulator_on: true if the station regulated voltage

  • target_v: the target voltage, in kV, when the station regulates voltage

  • target_q: the target reactive power, in MVar, when the station does not regulate voltage

  • bus_or_busbar_section_id: id of the bus or of the busbar section to which the injection will be connected with a closed disconnector.

  • position_order: in node/breaker, the order of the vsc converter station, will fill the ConnectablePosition extension

  • direction: optionally, in node/breaker, the direction of the vsc converter station, will fill the ConnectablePosition extension, default is BOTTOM.