Merge pull request #1 from sandialabs/v1.0.0

V1.0.0

Author: dpandit223

Images/BESS_degradation_ancillaries.png

@@ -6,9 +6,7 @@
 
 # **QuESt PCM**: A Production Cost Modeling Tool with High-Fidelity Models of Energy Storage Systems
 
-Current release version: 0.0.1
-
-Release date: 12/25/2025
+Current release version: 1.0.0
 
 ## Table of Contents
 - [Introduction](#intro)
@@ -26,7 +24,6 @@ Production cost models (PCM) are computational tools that simulate power system
 <div style="text-align: center;">
 <img src = "Images/QuEST_PCM_IO.png" alt="overview" />
 </div>
-<!--QuESt Planning documentation is under development and will be available [here](https://github.com/sandialabs/snl-quest).-->
 
 [Back to Top](#top)
 ## Key Features of QuESt PCM
@@ -135,14 +132,18 @@ Two test cases are included with the initial release of QuESt PCM. One test case
 
 **Figure 1:** IEEE RTS-GMLC Test Case nodal model
 
-Some outputs of Quest PCM for a 5-day RTS-GMLC simulation (included in the [config](config/GMLC_config.yaml) file) are illustrated here. Figure 2 shows the system dispatch, generation costs, and interactive LMP plots obtained from the simulation.
+Some outputs of Quest PCM for a 5-day RTS-GMLC simulation (included in the [config](config/GMLC_config.yaml) file) are illustrated as follows:
+
+### System Operation 
+ QuESt PCM provides detailed results for system operation, including chronological unit commitment and economic dispatch decisions, nodal power flows, and generator production levels. While the full set of detailed results is available to users through summary Excel files and structured .json outputs, QuESt PCM also offers system-level operational overview plots for visualization and analysis. For example, Figure 2 illustrates system dispatch, generation costs, and interactive locational marginal price (LMP) plots obtained from the RTS-GMLC simulation.
 
 <img src = "Images/dispatch.png" width="386" alt="Results" />  <img src = "Images/cost.png" width="409" alt="Results" /> 
 
 <img src = "Images/LMP_image.png" width="800" alt="Results" />
 
 **Figure 2:** 5-day dispatch, costs, and LMPs of the IEEE RTS-GMLC test case.
 
+### Ancillary Services
 QuESt PCM also emphasizes on modeling the system ancillary services. It enables users to analyze the revenues earned by generators and storage resources from ancillary service participation through summary Excel sheets and visual plots. Figure 3 presents example plots of real-time ancillary service market-clearing results produced by QuESt PCM for the RTS-GMLC system, with storage systems also contributing to operational reserves.
 
 <img src = "Images/regup_plot.png" width="397" alt="Results" />  <img src = "Images/regdown_plot.png" width="397" alt="Results" /> 
@@ -151,7 +152,8 @@ QuESt PCM also emphasizes on modeling the system ancillary services. It enables
 
 **Figure 3:** Ancillary service market clearing results for RTS-GMLC.
 
-QuESt PCM provides extensive modeling and visualization capabilities for energy storage systems within production cost models. Currently, the tool supports three distinct storage models—generic, battery, and pumped hydro—each with its own set of operational constraints. Figure 4 illustrates the operation of a generic 50 MW, 150 MWh energy storage system over a five-day simulation of the RTS-GMLC system. Figure 5 presents a comparison of the dispatch characteristics of battery energy storage (BESS) and pumped hydro storage (PHS) units of equivalent capacity, replacing the generic storage model and participating in ancillary service markets.
+### Storage Participation in Energy and Ancillary Service Markets 
+QuESt PCM provides extensive modeling and visualization capabilities for energy storage systems within production cost models. Currently, the tool supports three distinct storage models: generic, battery, and pumped hydro. Each storage system is equipped with its own set of operational constraints. Figure 4 illustrates the operation of a generic 50 MW, 150 MWh energy storage system with charging and discharging-only capability over a five-day simulation of the RTS-GMLC system. Figure 5 presents a comparison of the dispatch characteristics of battery energy storage (BESS) and pumped hydro storage (PHS) units of equivalent capacity, replacing the generic storage model and participating in ancillary service markets.
 
 <table>
   <tr>
@@ -170,6 +172,18 @@ QuESt PCM provides extensive modeling and visualization capabilities for energy
 
 **Figure 5:** Battery and pumped hydro storage dispatch in RTS-GMLC with ancillary service participation.
 
+### Detailed Storage Tech-Specific Modeling
+
+QuESt PCM also provides detailed modeling of technology-specific storage operation. In the current release, tech-specific models for two storage technologies are supported: batteries and pumped hydro. For batteries, QuESt PCM evaluates potential degradation arising from system operation. For example, Figure 6 presents two plots showing battery degradation when participating in energy markets only versus participation in both energy and reserve markets. The degradation models used for this evaluation are based on cyclic degradation data from the [batteryarchive](https://www.batteryarchive.org/index.html). Similarly, for pumped-hydro systems, unit-level control constraints are included, such as generator and pump operation limits, flow dynamics, and reservoir interactions. Figure 7 illustrates an example visualization of pumped-hydro unit operation status from the RTS-GMLC five-day simulation.
+
+<img src = "Images/BESS_degradation_arbitrage.png" width="397" alt="Results" />  <img src = "Images/BESS_degradation_ancillaries.png" width="397" alt="Results" /> 
+
+**Figure 6:** Potential degradation of BESS for different cathode chemistries with charging discharging only (first figure) vs ancillary service participation (second figure).
+
+<img src = "Images/PHS_schedules.png" width="800" alt="Results" />
+
+**Figure 7:** Generator/Pump unit operation schedule of pumped hydro storage in RTS-GMLC.
+
 [Back to Top](#top)
 ## Acknowledgment
 <a id="acknowledgement"></a>

Images/BESS_degradation_arbitrage.png

@@ -10,26 +10,30 @@ Overall, QuESt PCM presents simulation outputs through the following three forma
 A comprehensive Excel workbook that provides high-level summaries of system operation, including overall operational metrics, generation details, energy storage performance, line congestion, and line flow violations under contingency conditions.
 
 2. Visualization Outputs (PNG and Interactive HTML):
-A collection of static Matplotlib PNG figures and interactive HTML visualizations illustrating system-wide dispatch, locational marginal prices (LMPs), ancillary service dispatch, and clearing prices. In addition, detailed, storage-specific plots are generated for each energy storage system, showing dispatch behavior, operational costs, revenues, and state-of-charge (SoC) trajectories.
+A collection of static Matplotlib PNG figures and interactive HTML visualizations illustrating system-wide dispatch, locational marginal prices (LMPs), ancillary service dispatch, and clearing prices. Day-ahead results are designated with the suffix `_DA`, while real-time market results are designated with `_RT` or no suffix. In addition to system operation plots, detailed storage-specific plots are generated for each energy storage system, showing dispatch behavior, operational costs, revenues, and state-of-charge (SoC) trajectories. Technology-specific detail plots of storage such as degradation of battery storage, generator and pump schedules for pumped hydro storage are also provided.
 
 3. JSON Output Files:
-Machine-readable JSON files containing detailed results from the day-ahead unit commitment and real-time economic dispatch simulations. These files include granular information not available in the Excel summaries or plots, such as generator commitment status, startup and shutdown decisions, dispatch levels of thermal units at each timestep, load curtailment at each bus, and transmission line flows over time. For energy storage systems, technology-specific operational details such as generator and pump schedules for pumped hydro storage are also provided.
+Machine-readable JSON files containing detailed results from the day-ahead unit commitment and real-time economic dispatch simulations. These files include granular information not available in the Excel summaries or plots, such as generator commitment status, startup and shutdown decisions, dispatch levels of thermal units at each timestep, load curtailment at each bus, and transmission line flows over time. For energy storage systems, technology-specific operational details such as degradation of battery storage, generator and pump schedules for pumped hydro storage are also provided.
 
 Example: For a weekly result export resolution, QuEST PCM outputs are arranged in the directory as follows:
 
 - TimeStamp_Folder/
     - Week1-Week2/  (or Week2-Week3, etc.)
-        - Plotly_Plots/
-            - Dispatch.html, Costs.html, LMP.html, ...
-            - Ancillary_Services/
-                - Regulation_UP.html, Clearing_Prices.html, ...
+        - plotly_plots/
+            - Dispatch_DA.html, Dispatch_RT.html, Costs.html, LMP_DA.html, ...
+            - Ancillary_Services_DA/
+                - Regulation_UP_DA.html, Clearing_Prices_DA.html, ...
+            - Ancillary_Services_RT/
+                - Regulation_UP_RT.html, Clearing_Prices_RT.html, ...
             - Storage_1/ 
                 - Storage_Dispatch.html, Costs.html, Revenue.html, SoC.html
             - Storage_2/...
-        - PNG_Plots/
-            - Dispatch.png, Costs.png, LMP.png, ...
-            - Ancillary_Services/ 
-                - Regulation_UP.png, Clearing_Prices.png, ...
+        - png_plots/
+            - Dispatch_DA.png, Dispatch_RT.png, Costs.png, LMP_DA.png, ...
+            - Ancillary_Services_DA/
+                - Regulation_UP_DA.png, Clearing_Prices_DA.png, ...
+            - Ancillary_Services_RT/
+                - Regulation_UP_RT.png, Clearing_Prices_RT.png, ...
             - Storage_1/ 
                 - Dispatch.png, Costs.png, Revenue.png, SoC.png
             - Storage_2/...

Images/PHS_schedules.png

@@ -25,6 +25,7 @@ pytest==9.0.2
 python-dateutil==2.9.0.post0
 pytz==2025.2
 PyYAML==6.0.3
+rainflow==3.2.0
 scipy==1.16.3
 seaborn==0.13.2
 setuptools==80.9.0

README.md

@@ -111,7 +111,11 @@ def simulate_market(self):
             self.RT_result_dict[current_day], final_RT_sol = self._simulate_real_time(
                 current_day, RT_timekeys, day, pyomo_DA_sol, md_DA_full, RT_timekeys_set, final_RT_sol, self.data_obj.config.get("run_RTSCED_as")
             )
-            
+
+        # Evaluate degradation for any BESS in the system
+        self.utils.evaluate_degradation(self.RT_model, self.RT_result_dict)
+        pass
+    
     def _simulate_day_ahead(self, current_day, DA_timekeys, day, initializer_model):
         """
         Runs the Day-Ahead simulation for a single day.