pypowsybl.network.Network.create_areas_voltage_levels

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

Associate voltage levels to (existing) areas.

Parameters:

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

  • kwargs (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str]) – 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.

Important: The provided voltage levels for an area replace all existing voltage levels of that area, i.e. the entire list of voltage levels must be provided for the areas being edited.

Valid attributes are:

  • id: the identifier of the area

  • voltage_level_id: the identifier of the voltage level to be associated with the area

See also

get_areas_voltage_levels()

Examples

To associate voltage levels VL1 and VL2 to Area1.

network.create_areas_voltage_levels(id=['Area1', 'Area1'], voltage_level_id=['VL1', 'VL2'])

To dissociate all VoltageLevels of a given area, provide an empty string in voltage_level_id.

network.create_areas_voltage_levels(id=['Area1'], voltage_level_id=[''])