BusΒΆ
The Bus is the fundamental node of the network, to which all other components
attach. It enforces energy conservation for all elements feeding in and out of
it in any snapshot (e.g. Kirchhoff's current law for electric buses). A Bus
can represent a grid connection point, but it can also be used for other,
non-electric energy carriers (e.g. hydrogen, heat, oil) or even non-energy
carriers (e.g. CO2 or steel) in different locations.
| attribute | type | unit | default | description | status |
|---|---|---|---|---|---|
| name | string | nan | nan | Unique name | Input (required) |
| v_nom | float | kV | 1 | Nominal voltage | Input (optional) |
| type | string | nan | nan | Placeholder for bus type. Not implemented. | Input (optional) |
| x | float | nan | 0 | Longitude; the Spatial Reference System Identifier (SRID) is set in n.srid. |
Input (optional) |
| y | float | nan | 0 | Latitude; the Spatial Reference System Identifier (SRID) is set in n.srid. |
Input (optional) |
| carrier | string | nan | AC | Carrier, such as "AC", "DC", "heat" or "gas". | Input (optional) |
| unit | string | nan | nan | Unit of the bus' carrier if the implicitly assumed unit ("MW") is inappropriate (e.g. "t/h"). Only descriptive. Does not influence any PyPSA functions. | Input (optional) |
| location | string | nan | nan | Location of the bus. Does not influence the optimisation model but can be used for aggregation with n.statistics. |
Input (optional) |
| v_mag_pu_set | static or series | per unit | 1 | Voltage magnitude set point, per unit of v_nom. |
Input (optional) |
| v_mag_pu_min | float | per unit | 0 | Minimum desired voltage, per unit of v_nom. Placeholder attribute not currently used by any functions. |
Input (optional) |
| v_mag_pu_max | float | per unit | inf | Maximum desired voltage, per unit of v_nom. Placeholder attribute not currently used by any functions. |
Input (optional) |
| control | string | nan | PQ | P,Q,V control strategy for power flow, must be "PQ", "PV" or "Slack". Note that this attribute is an output inherited from the controls of the generators attached to the bus. Do not set by hand. | Output |
| generator | string | nan | nan | Name of slack generator attached to slack bus. | Output |
| sub_network | string | nan | nan | Name of connected sub-network to which bus belongs. This attribute is set by n.determine_network_topology(). Do not set by hand. |
Output |
| p | series | MW | 0. | active power at bus (positive if net generation at bus) | Output |
| q | series | MVar | 0. | reactive power (positive if net generation at bus) | Output |
| v_mag_pu | series | per unit | 1. | Voltage magnitude, per unit of v_nom |
Output |
| v_ang | series | radians | 0. | Voltage angle | Output |
| marginal_price | series | currency/MWh | 0. | Shadow price from energy balance constraint | Output |