branch.csv
This file defines branches - flow pathways between pairs of buses -
including lines and transformers. Add a row for each branch in the
system. Each row in the CSV file will cause a branch dictionary to be
added to ['elements']['branch']
in the Egret model.
Column Name |
Description |
Egret |
---|---|---|
UID |
A unique string identifier for the branch. |
Used as the branch name in Egret. Data for this branch is stored in a
branch dictionary stored at |
From Bus |
The Bus ID of one end of the branch |
The Bus Name of the bus with the corresponding Bus ID,
as entered in bus.csv, is stored in the Egret branch dictionary as
|
To Bus |
The Bus ID of the other end of the branch |
The Bus Name of the bus with the corresponding Bus ID,
as entered in bus.csv, is stored in the Egret branch dictionary as
|
R |
Branch resistance p.u. |
Stored in Egret bus dictionary as |
X |
Branch reactance p.u. |
Stored in the Egret bus dictionary as |
B |
Charging susceptance p.u. |
Stored in the Egret bus dictionary as |
Cont Rating |
Continuous flow limit in MW |
Stored in the Egret bus dictionary as |
LTE Rating |
Non-continuous long term flow limit in MW |
Stored in the Egret bus dictionary as |
STE Rating |
Short term flow limit in MW |
Stored in the Egret bus dictionary as |
Tr Ratio |
Transformer winding ratio. |
If non-zero, branch is treated as a transformer. If blank or zero, branch is considered a line. See Lines and Transformers below. |
Additional Branch Values
The following values are automatically added to every branch dictionary in the Egret model:
in_service
= trueangle_diff_min
= -90angle_diff_max
= 90pf
= nullqf
= nullpt
= nullqt
= null
Lines and Transformers
Each branch is either a line or a transformer. The type of branch is determined by the Tr Ratio. If this field is blank or zero, the branch is a line and the following property is added to the branch dictionary:
branch_type
= line
If the Tr Ratio is a non-zero value, the following properties are added to the branch dictionary:
branch_type
= transformertransformer_tap_ratio
= Tr Ratiotransformer_phase_shift
= 0