Bus DC
See also
Create Function
- pandapower.create.create_bus_dc(net, vn_kv, name=None, index=None, geodata=None, type=DEFAULT_BUS_DC_TYPE, zone=None, in_service=get_default_value('bus_dc', 'in_service'), 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[list[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=DEFAULT_BUS_DC_TYPE, geodata=None, zone=None, in_service=get_default_value('bus_dc', 'in_service'), max_vm_pu=nan, min_vm_pu=nan, coords=None, skip_validation=False, **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]) – Reference voltage level for the bus.
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'] | ~collections.abc.Iterable[~typing.Literal['n', 'b', 'm']]) – Type of the bus. “n” - auxiliary node, “b” - busbar, “m” - muff
geodata (Iterable[tuple[float, float]] | 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[list[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)]]
skip_validation (bool) – if set to true validate_network will not be run after creating. (Only use this if performance is critical)
- 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"])
Table Structure
net.bus_dc
Parameter |
Datatype |
Value Range |
Explanation |
nullable |
required |
optimal power flow |
|---|---|---|---|---|---|---|
name |
name of the dc bus |
✓ |
||||
vn_kv |
float |
>0 |
reference voltage of the dc bus [kV] |
✓ |
||
type |
type variable to classify buses |
✓ |
||||
zone |
can be used to group dc buses, for example network groups / regions |
✓ |
||||
in_service |
bool |
specifies if the dc bus is in service |
✓ |
|||
geo |
geojson.Point as object or string |
✓ |
||||
max_vm_pu |
float |
>0 |
Maximum dc bus voltage in p.u. - necessary for OPF |
✓ |
||
min_vm_pu |
float |
>=0 |
Minimum dc bus voltage in p.u. - necessary for OPF |
✓ |
Note
Bus voltage limits can not be set for slack buses and will be ignored by the optimal power flow.
Electric Model
Result Table
net.res_bus_dc
Parameter |
Datatype |
Explanation |
nullable |
required |
|---|---|---|---|---|
vm_pu |
float |
voltage magnitude [p.u] |
✓ |
✓ |
p_mw |
float |
resulting active power demand [MW] |
✓ |
✓ |
The power flow bus results are defined as: