pypowsybl.network.Network.get_hvdc_lines#

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

Get a dataframe of HVDC lines.

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 (_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.

Returns:

A dataframe of HVDC lines.

Return type:

DataFrame

Notes

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

converters_mode: the mode of the converter stations. It can be either SIDE_1_RECTIFIER_SIDE_2_INVERTER or SIDE_1_INVERTER_SIDE_2_RECTIFIER

target_p: active power target (in MW)

max_p: the maximum of active power that can pass through the hvdc line (in MW)

nominal_v: nominal voltage (in kV)

r: the resistance of the hvdc line (in Ohm)

converter_station1_id: at which converter station the hvdc line is connected on side “1”

converter_station2_id: at which converter station the hvdc line is connected on side “2”

connected1: True if the busbar section on side “1” is connected to a bus

connected2: True if the busbar section on side “2” is connected to a bus

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

This dataframe is indexed by the id of the hvdc lines

Examples

net = pp.network.create_four_substations_node_breaker_network()
net.get_hvdc_lines()

will output something like:

	converters_mode	target_p	max_p	nominal_v	r	converter_station1_id	converter_station2_id	connected1	connected2
id
HVDC1	SIDE_1_RECTIFIER_SIDE_2_INVERTER	10.0	300.0	400.0	1.0	VSC1	VSC2	True	True
HVDC2	SIDE_1_RECTIFIER_SIDE_2_INVERTER	80.0	300.0	400.0	1.0	LCC1	LCC2	True	True

net = pp.network.create_four_substations_node_breaker_network()
net.get_hvdc_lines(all_attributes=True)

will output something like:

	converters_mode	active_power_setpoint	max_p	nominal_v	r	converter_station1_id	converter_station2_id	connected1	connected2
id
HVDC1	SIDE_1_RECTIFIER_SIDE_2_INVERTER	10.0	300.0	400.0	1.0	VSC1	VSC2	True	True
HVDC2	SIDE_1_RECTIFIER_SIDE_2_INVERTER	80.0	300.0	400.0	1.0	LCC1	LCC2	True	True

net = pp.network.create_four_substations_node_breaker_network()
net.get_hvdc_lines(attributes=['converters_mode','active_power_setpoint','nominal_v','converter_station1_id','converter_station2_id','connected1','connected2'])

will output something like:

	converters_mode	active_power_setpoint	nominal_v	converter_station1_id	converter_station2_id	connected1	connected2
id
HVDC1	SIDE_1_RECTIFIER_SIDE_2_INVERTER	10.0	400.0	VSC1	VSC2	True	True
HVDC2	SIDE_1_RECTIFIER_SIDE_2_INVERTER	80.0	400.0	LCC1	LCC2	True	True