V1.7 beta final

QuESt.kv

@@ -12,6 +12,7 @@
 #:include es_gui/apps/data_manager/rate_structure.kv
 #:include es_gui/apps/data_manager/load.kv
 #:include es_gui/apps/data_manager/widgets.kv
+#:include es_gui/apps/data_manager/power.kv
 #:include es_gui/apps/data_manager/pv.kv
 #:include es_gui/apps/data_manager/nsrdb.kv
 
@@ -32,6 +33,10 @@
 #:include es_gui/apps/tech_selection/tech_selection_wizard.kv
 #:include es_gui/apps/tech_selection/results_viewer.kv
 
+#:include es_gui/apps/equity/home.kv
+#:include es_gui/apps/equity/peaker_rep.kv
+#:include es_gui/apps/equity/reporting.kv
+
 #:include es_gui/proving_grounds/data_importer.kv
 #:include es_gui/proving_grounds/help_carousel.kv
 
@@ -93,12 +98,12 @@
             size_hint: (1, 0.75)
 
             GridLayout:
-                size_hint_x: 0.4
+                size_hint_x: 0.3
                 cols: 1
                 spacing: 5
                 row_force_default: True
-                row_default_height: self.height/6
-                padding: (100, 50)
+                row_default_height: self.height/4
+                padding: (5, 50)
 
                 AppSelectionIndexButton:
                     text: ('[font=Modern Pictograms][size=54]_[/font][/size]\nQuESt Data Manager')
@@ -112,6 +117,15 @@
                     text: ('[font=Modern Pictograms][size=54]p[/font][/size]\nQuESt BTM')
                     on_state: root.app_select_sm.current = 'btm'
 
+
+            GridLayout:
+                size_hint_x: 0.3
+                cols: 1
+                spacing: 5
+                row_force_default: True
+                row_default_height: self.height/4
+                padding: (5, 50)
+
                 AppSelectionIndexButton:
                     text: ('[font=Modern Pictograms][size=54]6[/font][/size]\nQuESt Performance')
                     on_state: root.app_select_sm.current = 'performance'
@@ -120,6 +134,11 @@
                     text: ('[font=Modern Pictograms][size=54]E[/font][/size]\nTechnology Selection')
                     on_state: root.app_select_sm.current = 'technology selection'
 
+                AppSelectionIndexButton:
+                    #state: 'down'
+                    text: ('[font=Modern Pictograms][size=54]g[/font][/size]\nQuESt Equity')
+                    on_state: root.app_select_sm.current = 'equity'
+
             BoxLayout:
                 size_hint_x: 0.6
                 orientation: 'vertical'
@@ -140,7 +159,7 @@
                                 text: 'QuESt Data Manager'
 
                             AppSelectionDescBody:
-                                text: 'Manages the acquisition of data from ISO/RTOs, databases, and other sources for use in QuESt applications, including: \n *ISO/RTO historical market data \n *U.S. utility rate structures/tariffs \n *Commercial and residential building load profiles \n *Photovoltaic power system profiles \n *Weather data'
+                                text: 'Manages the acquisition of data from ISO/RTOs, databases, and other sources for use in QuESt applications, including: \n *ISO/RTO historical market data \n *U.S. utility rate structures/tariffs \n *Commercial and residential building load profiles \n *Photovoltaic power system profiles \n *Weather data \n *Powerplant dispatch and pollution data'
 
                             AnchorLayout:
                                 anchor_x: 'center'
@@ -221,7 +240,26 @@
                                 AppIndexGoButton:
                                     text: 'Get started'
                                     on_release: root.manager.launch_tech_selection()
+
+                    Screen:
+                        name: 'equity'
+
+                        AppSelectionDescBox:
+                            AppSelectionDescTitle:
+                                text: 'QuESt Equity' 
+
+                            AppSelectionDescBody:
+                                text: 'A collection of tools for energy equity and environmental justice (EEEJ) applications of energy storage systems:\n*replace a selected powerplant with ES+PV'
+
+                            AnchorLayout:
+                                anchor_x: 'center'
+                                anchor_y: 'top'
+
+                                AppIndexGoButton:
+                                    text: 'Get started'
+                                    on_release: root.manager.launch_equity()
 
+
                     Screen:
                         name: 'handbook'
 

README.md

@@ -68,6 +68,13 @@ An application for identifying the energy storage technologies most suitable for
 
 <img src="patch_note_resources/gifs/tech_selection.gif" alt="Technology selection wizard charts" width=600px margin="auto" />
 
+#### QuESt Equity
+
+An application for assessing energy equity and environmental justice of energy storage projects. This application currently has the powerplant replacement wizard that estimates the health and climate benefits of substituting a powerplant with energy storage and PV. It then calculates the county level benefits to estimate how much the project would impact disadvantaged communities and people with low incomes.
+
+<img src="patch_note_resources/gifs/09_powerplant_rep.gif" alt="Powerplant replacement wizard charts" width=600px margin="auto" />
+
+
 ### Who should use it?
 The software is designed to be used by anyone with an interest in performing analysis of energy storage or its applications without having to create their own models or write their own code. It’s designed to be easy to use out of the box but also modifiable by the savvy user if they so choose. The software is intended to be used as a platform for running simulations, obtaining results, and using the information to inform planning decisions. 
 
@@ -271,6 +278,10 @@ It is approximately Albuquerque, NM.
 
 Leaving the text input field blank sets the tilt angle to the latitude of the site.
 
+> I try to download data for a powerplant and get "An error has occurred with the COBRA API."
+
+This can occur if you are requesting data for a powerplant outside of the continental U.S. or if there is some issue with the FIPS code for the county (e.g., it applies to a city instead of a county). We are working on correcting this kind of error but there is no fix at this time. 
+
 ### QuESt Valuation
 <a id="faq-valuation"></a>
 
@@ -321,6 +332,21 @@ This is a known issue. You can try to generate the report again in order to fix
 
 Since version 1.2.f, you can import your own time series data (PV and load profiles) through the user interface. You can also import your own data by adding to the QuESt data bank manually. See below for details.
 
+### QuESt Equity
+<a id="faq-equity"></a>
+
+> Can I adjust the powerplant parameters in the wizard?
+
+No, any adjustments must be made in QuESt Data Manager before saving the entire powerplant data file.
+
+> Can I use a PV profile sepororat from what the QuESt Data Manager downloads automatically for the powerplant?
+
+Yes. You would need to normalize it to the range [0,1] and then open the powerplant data file and replace the parameter "pv" with the new normalized profile. The wizard would then use the new profile when that powerplant data file was selected.
+
+> When I select more than three replacement fractions the figures don't display correctly and I can't read the lables.
+
+This is a known issue. The output file (labled outputfile.json) can be found in `/results/equity/YYYY_MM_DD_HHMMSS/` and has all of the results stored so that they can be plotted corectly thorugh another program. 
+
 #### Rate structure
 The rate structure files are stored as .json files in `/data/rate_structures/` after being downloaded through QuESt Data Manager. You can add a new file following the format of one downloaded using QuESt Data Manager. The general structure of the .json object is as follows:
 
@@ -358,6 +384,13 @@ The format is basically two columns; the "Date/Time" column gives the month, day
 
 Once new files are added to the `data` bank appropriately, they should be picked up in the relevant applications when you are prompted to make a selection.
 
+#### powerplant data and dispatch profile
+The powerplant data files are stored as .json files in `/data/power_plant/` after being downloaded through QuESt Data Manager. You can add a new file following the format of one downloaded using QuESt Data Manager. 
+
+The format has the plant medidata stored by parameter name. For example {"Name": "Calpine Hidalgo Energy Center",}. The parameter "plant_dispatch" has a hourly dispatch for 1 year in MW stored as a list of floating points [1,2,3,4,5,6 ...], while the parameter "pv" has a similar list of available PV resource but it is normalized to the range [0,1] on a per MW basis. The "COBRA_results" parameter stores the county level "Impacts" and a "Summary" of the total impacts across the country. The "health_impact_equity" parameter has data calculated by cross-referencing the "COBRA_results" with census data for each county. Classification as a disadvantaged communities is done by census tract so the population fraction of a county living in a disadvantaged community is calculated by the total population of census tracts within a county that are considered disadvantaged divided by the total population of the county. 
+
+Once new files are added to the `data` bank appropriately, they should be picked up in the relevant applications when you are prompted to make a selection.
+
 ## References
 <a id="references"></a>
 Nguyen, Tu A., David A. Copp, and Raymond H. Byrne. "Stacking Revenue of Energy Storage System from Resilience, T&D Deferral and Arbitrage." 2019 IEEE Power & Energy Society General Meeting (PESGM). IEEE, 2019.