API field
Discharge schedule
24 hour-of-day flags allowing discharge; empty = every hour
What it is
Twenty-four flags, one per hour of the day, that allow discharge in the flagged hours. With clip capture and daily full cycle, charging is never gated. With timed discharge the flagged hours are the discharge window: the battery charges outside it and delivers inside it. The hour is the hour of the weather timestamp, in the fixed UTC offset of the site's time zone, and the timestamp labels the start of its interval: flag h covers the timestep from h:00. No daylight-saving shift is applied, so one schedule serves the whole year in standard time. A window that crosses midnight, such as 22:00 to 02:00, is one window.
Typical values and how to get it
Empty for a battery allowed to discharge whenever there is room; under clip capture it then returns the captured energy within hours, usually the same afternoon. An evening window, such as 18:00 to 22:00 (flags 18 to 21 set), holds the energy for the evening under every dispatch. A window stated in daylight-saving clock time sits one hour earlier in standard time: 18:00 to 22:00 daylight time is flags 17 to 20. Timed discharge needs at least one flagged hour and at least one hour outside the window to charge.
Values
Empty (default) = every hour · 24 entries of 0 or 1 = discharge allowed in the hours set to 1
References
- DiOrio, Dobos & Janzou 2015, "Technoeconomic Modeling of Battery Energy Storage in SAM", NREL/TP-6A20-64641
API
storage.dispatch_schedule