Sticky loads library table header

data/input/metadata_index.json

@@ -63,6 +63,12 @@
     ]
   },
   "emissions": {
+    "elec_emission_source" : [
+      "Marginal (Cambium, Long-run)",
+      "Marginal (Cambium, Short-run)",
+      "Average (Cambium)",
+      "Constant (User-provided)"
+    ],
     "year": [
       2025,
       2030,

docs/documentation/calculations.md

@@ -88,7 +88,12 @@ The second step is to convert the electricity and gas site energy, and any refri
 
 * The electricity emissions data is taken from Cambium (see further information in [Emissions](emissions.md)) in month-hour average format (data is provided for each hour of a representative day for every month). This is expanded to match with the full 8,760-hour resolution of the site energy data.
 
-**Step 3: Calculate emissions**
+**Step 3: Calculate fuel switching (**[**if enabled**](equipment.md#backup-equipment)**)**
+
+* The hourly carbon emissions intensity for electric and gas heating is calculated using the corresponding emissions factor and equipment operating efficiency.
+* For hours where electricity carbon intensity is higher than gas, the HHW load served by the AWHP is switched to the gas boiler.
+
+**Step 4: Calculate emissions**
 
 * The total emissions for each fuel is calculated using the total usage and fuel emissions rate.
 * The total emissions associated with refrigerant leakage is calculated using the type, weight, and annual leakage rate for the the refrigerant in each equipment. Leakage is assumed to be spread evenly over the year.
@@ -110,8 +115,7 @@ The second step is to convert the electricity and gas site energy, and any refri
 3. Add functionality for water cooled chillers.
 4. Add cooling tower water use calculations.
 5. Add functionality for chiller performance tables and/or curves instead of fixed COP.
-6. Add fuel switching evaluation (based on grid emissions and equipment COP).
-7. Add load shifting evaluation (thermal energy storage).
-8. Add exhaust air heat recovery as an optional heat source for WWHPs.
-9. Add functionality for AWHP models with heat recovery.
-10. Add utility cost calculations.
+6. Add load shifting evaluation (thermal energy storage).
+7. Add exhaust air heat recovery as an optional heat source for WWHPs.
+8. Add functionality for AWHP models with heat recovery.
+9. Add utility cost calculations.

docs/documentation/emissions.md

@@ -24,9 +24,9 @@ The grid scenarios project the possible evolution of the US electricity sector t
 6. **High Natural Gas Prices**: The same set of base assumptions as the first scenario but where natural gas prices are assumed to be higher.
 7. **Low Renewable Energy and Battery Costs With High Natural Gas Prices**: The same set of base assumptions as the first scenario but with higher natural gas prices and where renewable energy and battery costs are assumed to be lower and performance improvements greater.
 
-#### GEA Grid Region
+#### Generation and Emission Assessment Grid Region
 
-The Generation and Emission Assessment grid region. GEA regions are based on data from the [EPA's eGRID subregions](https://www.epa.gov/green-power-markets/us-grid-regions). This input is automatically populated based on the specified building location, but can be edited by the user.
+The Generation and Emission Assessment (GEA) grid region. GEA grid regions are based on data from the [EPA's eGRID subregions](https://www.epa.gov/green-power-markets/us-grid-regions). This input is automatically populated based on the specified building location, but can be edited by the user.
 
 #### Emission Type
 

docs/documentation/equipment.md

@@ -8,7 +8,7 @@ Equipment scenarios are defined on this page. An explanation for each input and
 
 ### Inputs
 
-For each category of equipment noted below, the tool's equipment library defines a number of equipment models with energy and emissions characteristics, including capacity, efficiency, operating temperatures, and refrigerant type and weight. The library can be viewed in full [here](../../data/input/equipment_data.JSON).
+For each category of equipment noted below, the tool's equipment library defines a number of equipment models with energy and emissions characteristics, including capacity, efficiency, operating temperatures, and refrigerant type and weight. The library can be viewed in full [here](https://github.com/CenterForTheBuiltEnvironment/decarb-tool/blob/development/data/input/equipment_data.JSON).
 
 <details>
 
@@ -70,13 +70,13 @@ These two inputs determine how the total number of AWHP units, not including red
 
 An integer number of additional units for redundancy. The default value is 1, i.e., N+1 redundancy. The total number of AWHP units, including redundancy, is used in refrigerant leakage calculations.
 
-**AWHP Use Cooling**
+**Use AWHP for Cooling**
 
 This input determines if the AWHPs serve cooling loads. The tool prioritizes heating loads, so the cooling capacity in a given hour is calculated using the number of units not used to serve heating load.
 
 **AWHP Sizing Priority**
 
-This input determines which load profile (heating, cooling, or both) is used to calculate the number of units per the sizing mode and value inputs. The default is heating load. Not editable if AWHP Use Cooling is unchecked.
+This input determines which load profile (heating, cooling, or both) is used to calculate the number of units per the sizing mode and value inputs. The default is heating load. Not editable if Use AWHP for Cooling is unchecked.
 
 </details>
 
@@ -95,6 +95,10 @@ The default equipment types are all specific equipment models.
 
 Two types of backup heating equipment are defined: gas boilers and electric resistance heaters. Both are assumed to have fixed efficiency over all operating conditions. A range of typical gas boiler efficiencies are provided; the default is 80% efficiency.
 
+**Use Optimal Heating Fuel**
+
+Dynamically switch between electric and gas heating based on emissions (see [Calculations](calculations.md#calculation-1) for further detail). Only selectable if the scenario contains both AWHP and gas boiler backup heating.
+
 **Backup Cooling**
 
 The backup cooling equipment is assumed to be an air-cooled chiller with fixed efficiency over all operating conditions. Generic units are defined with efficiency values per the IECC.
@@ -103,7 +107,7 @@ The backup cooling equipment is assumed to be an air-cooled chiller with fixed e
 
 ### Default Scenario Groups
 
-A summary of the significant inputs in each scenario group is provided below. The full list of inputs for each default scenario can be viewed in the tool or [here](../../data/input/equipment_data.JSON#L729).
+A summary of the significant inputs in each scenario group is provided below. The full list of inputs for each default scenario can be viewed in the tool or [here](https://github.com/CenterForTheBuiltEnvironment/decarb-tool/blob/development/data/input/equipment_data.JSON#L729).
 
 #### Default
 
@@ -121,6 +125,10 @@ This scenario group evaluates the impact of heat recovery with different configu
 
 This scenario group varies the WWHP and AWHP heating hot water supply temperature and performance calculation model (fixed vs OAT-based reset), holding all other inputs constant.
 
+#### Dynamic Fuel Switching
+
+This scenario group compares fully gas and fully electric heating plants with a partial AWHP scenario and a fuel switching scenario.
+
 ### Future Development
 
 1. Allow users to edit the equipment library and add new equipment models.

docs/documentation/loads/load-types.md

@@ -10,11 +10,11 @@ Expand this dropdown and select `Open Library` to access the Load Data Library p
 
 #### DOE
 
-The Simulated:DOE dataset contains loads generated using the [DOE Commercial Reference Building models](https://www.energy.gov/cmei/buildings/commercial-reference-buildings) with every combination of the following characteristics:
+The Simulated:DOE dataset contains loads generated using the [DOE commercial prototype building models](https://www.energycodes.gov/prototype-building-models) with every combination of the following characteristics:
 
 * 4 building types: Hospital, Large Office, Outpatient Healthcare, Large Hotel
 * 2 vintages: 2004, 2022
-* 16 climate zones: 1A, 2A-B, 3A-C, 4A-C, 5A-C, 6A-B, 7, 8. The representative cities used for each climate zone are listed [here](https://www.energy.gov/cmei/buildings/commercial-reference-buildings).
+* 16 climate zones: 1A, 2A-B, 3A-C, 4A-C, 5A-C, 6A-B, 7, 8. The representative cities used for each climate zone are listed [here](https://www.energycodes.gov/prototype-building-models).
 
 The heating loads in this dataset include only heating hot water (HHW) loads.
 

layout/charts.py

@@ -20,7 +20,9 @@ def _chart_block(controls, graph_id, height=600):
             controls,
             dmc.Paper(
                 dcc.Loading(
-                    type="default",
+                    type="circle",
+                    delay_show=300,
+                    delay_hide=100,
                     children=dcc.Graph(
                         id=graph_id,
                         style={"height": f"{height}px", "width": "100%"},
@@ -49,12 +51,13 @@ def _emission_scen_seed():
 
 
 def emissions_bar_chart():
+    seed_options = _emission_scen_seed()
     controls = _controls_bar(
         [
             dmc.MultiSelect(
                 id="emission-em-scen-dropdown",
-                data=_emission_scen_seed(),  # will be overwritten dynamically
-                value=["em_scenario_a", "em_scenario_b", "em_scenario_c"],
+                data=seed_options,  # will be overwritten dynamically
+                value=[opt["value"] for opt in seed_options],
                 placeholder="Emission Scenarios",
                 searchable=True,
                 clearable=True,