This file is used to define buses. Add one row for each bus in the system. Each row in the CSV file will cause a bus dictionary object to be added to ['elements']['bus']
in the Egret model.
Each row with a non-zero MW Load
and/or non-zero MVAR Load
will also cause a load to be added to ['elements']['load']
in Egret, and each row with a non-zero MW Shunt G
and/or non-zero MVAR Shunt B
will cause a shunt to be added to ['elements']['shunt']
in Egret.
Column Name | Description | Egret |
---|---|---|
Bus ID |
A unique string identifier for the bus. This string is used to refer to this bus in other CSV files. | Not used by Egret except during parsing of CSV files. |
Bus Name |
A human-friendly unique string for this bus. | Used as the bus name in Egret. Data for this bus is stored in a bus dictionary stored at This is also the name of the load, if a load is added for the bus (a load is added if MW Load or MVAR Load is non-zero). The load dictionary is stored at This is also the name of the shunt, if a shunt is added for the bus (a bus is added if |
BaseKV |
The bus base voltage. Must be non-zero positive. | Stored in the Egret bus dictionary as base_kv . |
Bus Type |
The type of bus. Can be one of the following:
|
Stored in Egret bus dictionary as matpower_bustype . The Ref bus type is stored in Egret in all lower case (ref). |
MW Load |
Magnitude of the load on the bus. | Stored in the Egret bus dictionary as p_load . A non-zero value causes a load to be added; see Bus Loads. |
MVAR Load |
Magnitude of the reactive load on the bus. | Stored in the Egret bus dictionary as q_load . A non-zero value causes a load to be added; see Bus Loads. |
V Mag |
Voltage magnitude setpoint | Stored in the Egret bus dictionary as vm . |
V Angle |
Voltage angle setpoint in degrees | Stored in the Egret bus dictionary as va . If the Bus Type is Ref, this value must be 0.0. |
Area |
The area the bus is in. | Stored in the Egret bus dictionary as area . An area dictionary is added to the Egret model for each unique area mentioned in the file. The Egret area dictionary is found at ['elements']['area'][{<Area>}] . See Areas. |
Zone |
The zone the bus is in. | Stored in the Egret bus dictionary as zone . |
MW Shunt G |
Optional. | Stored in the shunt dictionary as gs . See Shunts. |
MVAR Shunt B |
Optional. | Stored in the shunt dictionary as bs . See Shunts. |
va |
Reference bus angle. If the Bus Type is Ref, va is required and must be zero. |
The following values are automatically added to the bus dictionary:
v_min
= 0.95v_max
= 1.05
If a bus has a non-zero MW Load
or MVAR Load
, a load dictionary is added to Egret at ['elements']['load'][{<Bus Name>}]
. The load dictionary will have the following values taken from bus.csv:
bus
=Bus Name
p_load
=MW Load
q_load
=MVAR Load
area
=Area
zone
=Zone
An additional property is automatically added, always with the same value:
in_service
= true
Loads can (and usually do) vary throughout the study horizon. Variable loads are defined using a timeseries (see timeseries_pointers
).
If a bus has a non-zero MW Shunt G
or a non-zero MVAR Shunt B
, a shunt dictionary is added to Egret at ['elements']['shunt'][{<Bus Name>}]
. The shunt dictionary will have the following values taken from bus.csv:
bus
=Bus Name
gs
=MW Shunt G
bs
=MVAR Shunt B
An additional property is automatically added, always with the same value:
shunt_type
= fixed
Each unique area mentioned in bus.csv leads to an area being created in the Egret model at ['elements']['area'][{<Area>}]
, using the area name as it appears in bus.csv.