Skip to content

Commit c310822

Browse files
darrylmelanderdarrylmelander
committed
Start documenting storage support in RTS-GMLC input
1 parent 7a35468 commit c310822

File tree

3 files changed

+125
-2
lines changed

3 files changed

+125
-2
lines changed

‎doc/OnlineDocs/source/reference/file_formats/rts-gmlc/gen.rst

+2-2
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,8 @@ generator in the model, including both thermal and renewable generators.
1111
- **Description**
1212
- **Egret**
1313
* - :col:`GEN UID`
14-
- A unique string identifier for the generator.
15-
- Used as the branch name in Egret. Data for this branch is stored in a
14+
- A unique string identifier for the generator
15+
- Used as the generator name in Egret. Data for this generator is stored in a
1616
generator dictionary stored at :samp:`['elements']['generator'][{<GEN UID>}]`.
1717
* - :col:`Bus ID`
1818
- :col:`Bus ID` of connecting bus

‎doc/OnlineDocs/source/reference/file_formats/rts-gmlc/index.rst

+1
Original file line numberDiff line numberDiff line change
@@ -31,4 +31,5 @@ Optional Files
3131
:maxdepth: 1
3232

3333
dc_branch
34+
storage
3435
initial_status

‎doc/OnlineDocs/source/reference/file_formats/rts-gmlc/storage.rst

+122
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,122 @@
1+
storage.csv
2+
===========
3+
4+
This file is where storage elements are defined. Add one row for each
5+
storage component in the model.
6+
7+
Note that Prescient supports more storage properties than what is
8+
supported by the standard RTS-GMLC input format. Prescient extends
9+
the standard RTS-GMLC file format by supporting a set of additional
10+
columns that are not part of the RTS-GMLC standard. All non-standard
11+
columns are optional; they are not required to be present in the input
12+
file. Prescient will use default values for any missing columns.
13+
14+
.. list-table:: storage.csv Required Columns
15+
:header-rows: 1
16+
17+
* - **Column Name**
18+
- **Description**
19+
- **Egret**
20+
- **Default Value**
21+
* -
22+
-
23+
-
24+
-
25+
* - **Required Columns**
26+
-
27+
-
28+
-
29+
* - :col:`GEN UID`
30+
- The name of a generator on the same bus as this storage element
31+
- Used to identify the bus this storage element is attached to.
32+
The storage will be placed on the same bus as the named generator.
33+
No relationship between the generator and the storage is reflected
34+
in the Egret model, other than being placed on the same bus.
35+
- *Required*
36+
* - :col:`Storage`
37+
- A unique name for the storage element
38+
- Used as the storage element name in Egret. Data for this storage component is placed in a
39+
dictionary located at :samp:`['elements']['generator'][{<Storage>}]`.
40+
- *Required*
41+
* - :col:`Max Volume GWh`
42+
- The maximum storage capacity, in GWh
43+
- Converted to MWh, then placed in the storage dictionary as ``energy_capacity``.
44+
- *Required*
45+
* - :col:`Initial Volume GWh`
46+
- The quantity of energy stored in the storage element at the beginning
47+
of the simulation
48+
- Converted to MWh, then placed in the storage dictionary as ``initial_state_of_charge``
49+
- 0.0
50+
* - :col:`Start Energy`
51+
- The rate at which energy is being drawn from the storage element (if positive),
52+
or the rate at which energy is being injected into the storage element (if negative),
53+
at the start of the simulation. Units are GW.
54+
- First converted to MW.
55+
56+
If positive, placed in the storage dictionary as ``initial_discharge_rate``,
57+
and ``initial_charge_rate`` is set to 0.0.
58+
59+
If negative, placed in the storage dictionary as ``initial_charge_rate``,
60+
and ``initial_discharge_rate`` is set to 0.0.
61+
- 0.0
62+
* - :col:`Inflow Limit GWh` (Should this really be GWh, or GW???)
63+
- The maximum rate at which energy can be inserted into the storage element, in GW
64+
- Converted to MW, then placed in the storage dictionary as ``max_charge_rate``
65+
- Unlimited
66+
* - :col:`Rating MVA`
67+
- The maximum rate at which energy can be drawn from the storage element
68+
- Placed in the storage dictionary as ``max_discharge_rate``
69+
- Unlimited
70+
* - **Optional Columns**
71+
-
72+
-
73+
-
74+
* - :col:`Min Discharge Rate MW`
75+
- The minimum rate at which energy can be drawn from the storage element
76+
- Placed in the storage dictionary as ``min_discharge_rate``
77+
- 0.0
78+
* - :col:`Min Charge Rate MW`
79+
- The minimum rate at which energy can be injected into the storage element
80+
- Placed in the storage dictionary as ``min_charge_rate``
81+
- 0.0
82+
* - :col:`Max Hourly Discharge Ramp Up MW`
83+
- The maximum increase in the discharge rate within a 60 minute period
84+
- Placed in the storage dictionary as ``ramp_up_output_60min``
85+
- Unlimited
86+
* - :col:`Max Hourly Discharge Ramp Down MW`
87+
- The maximum decrease in the discharge rate with a 60 minute period
88+
- Placed in the storage dictionary as ``ramp_down_output_60min``
89+
- Unlimited
90+
* - :col:`Max Hourly Charge Ramp Up MW`
91+
- The maximum increase in the charging rate within a 60 minute period
92+
- Placed in the storage dictionary as ``ramp_up_input_60min``
93+
- Unlimited
94+
* - :col:`Max Hourly Charge Ramp Down MW`
95+
- The maximum decrease in the charging rate within a 60 minute period
96+
- Placed in the storage dictionary as ``ramp_down_input_60min``
97+
- Unlimited
98+
* - :col:`Min SoC`
99+
- The minimum state of charge the storage element is allowed to be drawn down to.
100+
Below this point, the system is not allowed to draw additional energy from
101+
the storage element. Expressed as a number between 0 and 1 that indicates the
102+
fraction of the maximum storage capacity below which additional energy
103+
may not be drawn. A value of 0 means all energy is allowed to be drawn from the
104+
storage element; a value of 0.5 means the system must stop drawing energy
105+
from the storage element once its stored energy drops below half of its capacity.
106+
- Placed in the storage dictionary as ``minimum_state_of_charge``
107+
- 0.0
108+
* - :col:`Charge Efficiency`
109+
- The fraction of injected energy that is stored in the storage
110+
element. Between 0 and 1.
111+
- Placed in the storage dictionary as ``charge_efficiency``
112+
- 1.0
113+
* - :col:`Discharge Efficiency`
114+
- The fraction of drawn energy that is injected onto the bus.
115+
Between 0 and 1.
116+
- Placed in the storage dictionary as ``discharge_efficiency``
117+
- 1.0
118+
* - :col:`Hourly Retention Rate`
119+
- The fraction of stored energy that is still stored in the storage
120+
element after 60 minutes of idle time. Between 0 and 1.
121+
- Placed in the storage dictionary as ``retention_rate_60min``
122+
- 1.0

0 commit comments

Comments
 (0)