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

Creates a static var compensator, 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 static var compensator

  • 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 static var compensator is connected to the busbar with a breaker and a closed disconnector. If the network has position extensions, the static var compensator will also be connected to every parallel busbar section with an open disconnector. If the voltage level is bus/breaker, the static var compensator is just connected to the bus.

Valid attributes are:

  • id: the identifier of the new SVC

  • name: an optional human-readable name

  • b_max: the maximum susceptance, in S

  • b_min: the minimum susceptance, in S

  • regulation_mode: the regulation mode (VOLTAGE, REACTIVE_POWER, OFF)

  • target_v: the target voltage, in kV, when the regulation mode is VOLTAGE

  • target_q: the target reactive power, in MVar, when the regulation mode is not 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 static var compensator, will fill the ConnectablePosition extension

  • direction: optionally, in node/breaker, the direction of the static var compensator, will fill the ConnectablePosition extension, default is BOTTOM.