Bus DC

Create Function

pandapower.create.create_bus_dc(net, vn_kv, name=None, index=None, geodata=None, type='b', zone=None, in_service=True, max_vm_pu=nan, min_vm_pu=nan, coords=None, **kwargs)

Adds one dc bus in table net[“bus_dc”].

Buses are the nodes of the network that all other elements connect to.

Parameters:
  • net (pandapowerNet) – The pandapower network in which the element is created

  • vn_kv (float) – The grid voltage level.

  • name (str | None) – the name for this dc bus

  • index (int | integer | None) – Force a specified ID if it is available. If None, the index one higher than the highest already existing index is selected.

  • geodata (tuple[float, float] | None) – coordinates used for plotting

  • type (Literal['n', 'b', 'm']) – Type of the bus. “n” - node, “b” - busbar, “m” - muff

  • zone (str | None) – grid region

  • in_service (bool) – True for in_service or False for out of service

  • max_vm_pu (float) – necessary for OPF

  • min_vm_pu (float) – necessary for OPF

  • coords (list[tuple[float, float]] | None) – busbar coordinates to plot the dc bus with multiple points. coords is typically a list of tuples (start and endpoint of the busbar) - Example: [(x1, y1), (x2, y2)]

Returns:

The unique ID of the created element

Return type:

int | integer

Example

>>> create_bus_dc(net, 20., name="bus1")
pandapower.create.create_buses_dc(net, nr_buses_dc, vn_kv, index=None, name=None, type='b', geodata=None, zone=None, in_service=True, max_vm_pu=nan, min_vm_pu=nan, coords=None, **kwargs)

Adds several dc buses in table net[“bus_dc”] at once.

Buses are the nodal points of the network that all other elements connect to.

Parameters:
  • net (pandapowerNet) – The pandapower network in which the element is created

  • nr_buses_dc (int) – The number of dc buses that is created

  • vn_kv (float | Iterable[float]) – The grid voltage level.

  • index (int | integer | Iterable[int | integer] | None) – Force specified IDs if available. If None, the indices higher than the highest already existing index are selected.

  • name (Iterable[str] | None) – the name for this dc bus

  • type (Literal['n', 'b', 'm'] | ~typing.Iterable[~typing.Literal['n', 'b', 'm']]) – Type of the bus. “n” - auxiliary node, “b” - busbar, “m” - muff

  • geodata (Iterable[tuple[float, float]] | None) – (x,y)-tuple or list of tuples with length == nr_buses_dc, coordinates used for plotting

  • zone (str | None) – grid region

  • in_service (bool | Iterable[bool]) – True for in_service or False for out of service

  • max_vm_pu (float | Iterable[float]) – necessary for OPF

  • min_vm_pu (float | Iterable[float]) – necessary for OPF

  • coords (list[list[tuple[float, float]]] | None) – busbar coordinates to plot the dc bus with multiple points. coords is typically a list of tuples (start and endpoint of the busbar) - Example for 3 dc buses: [[(x11, y11), (x12, y12)], [(x21, y21), (x22, y22)], [(x31, y31), (x32, y32)]]

Returns:

The unique indices ID of the created elements

Return type:

ndarray[tuple[Any, …], dtype[int | integer]]

Example

>>> create_buses_dc(net, 2, [20., 20.], name=["bus1","bus2"])

Input Parameters

net.bus_dc

Parameter

Datatype

Value Range

Explanation

name

string

name of the dc bus

vn_kv*

float

\(>\) 0

rated voltage of the dc bus [kV]

type

string

naming conventions:
“n” - node
“b” - busbar
“m” - muff

type variable to classify buses

zone

string

can be used to group dc buses, for example network groups / regions

in_service*

boolean

True / False

specifies if the dc bus is in service

*necessary for executing a power flow calculation

Note

Bus voltage limits can not be set for slack buses and will be ignored by the optimal power flow.

net.bus_dc_geodata

Parameter

Datatype

Explanation

x

float

x coordinate of dc bus location

y

float

y coordinate of dc bus location

Electric Model

alternate Text

Result Parameters

net.res_bus_dc

Parameter

Datatype

Explanation

vm_pu

float

voltage magnitude [p.u]

p_mw

float

resulting active power demand [MW]

The power flow bus results are defined as:

\begin{align*} vm\_pu &= \lvert \underline{V}_{bus} \rvert \\ p\_mw &= Re(\sum_{n=1}^N \underline{S}_{bus, n}) \\ \end{align*}