Add support for ECM-level technology diffusion parameters

Add support for technology diffusion parameters defined within ECMs. Diffusion parameters can be defined using market share fractions by year for any number of years or with Bass diffusion curve parameters p and q. When using market share fractions, linear interpolation is used to obtain values for the years between those specified by the user. The documentation is updated accordingly, along with a new example illustrating how an ECM could be defined to include diffusion parameters.
trynthink · May 31, 2022 · 7dfb2fd · 7dfb2fd
1 parent 936bdc2
commit 7dfb2fd
Show file tree

Hide file tree

Showing 4 changed files with 3,341 additions and 533 deletions.
diff --git a/docs/examples/Best Commercial Electric HPWH.json b/docs/examples/Best Commercial Electric HPWH.json
@@ -0,0 +1,80 @@
+{
+  "name": "Best Commercial Electric HPWH",
+  "climate_zone": "all",
+  "bldg_type": "all commercial",
+  "structure_type": "all",
+  "end_use": "water heating",
+  "fuel_type": "electricity",
+  "technology": ["elec_water_heater", "HP water heater", "elec_booster_water_heater", "Solar water heater"],
+  "market_entry_year": 2021,
+  "market_entry_year_source": {
+    "notes": "Best commercial electric heat pump water heater in 2017, updated to current year to avoid retroactive savings effects.",
+    "source_data": {
+      "title": "Updated Buildings Sector Appliance and Equipment Costs and Efficiencies",
+      "author": null,
+      "organization": "U.S. Energy Information Administration",
+      "year": 2018,
+      "pages": 126,
+      "URL": "https://www.eia.gov/analysis/studies/buildings/equipcosts/pdf/full.pdf"}
+  },
+  "market_exit_year": null,
+  "market_exit_year_source": null,
+  "energy_efficiency": 3.9,
+  "energy_efficiency_units": "BTU out/BTU in",
+  "energy_efficiency_source": {
+    "notes": "Typical HPWH COP in 2017 (high efficiency not available)",
+    "source_data": {
+      "title": "Updated Buildings Sector Appliance and Equipment Costs and Efficiencies",
+      "author": null,
+      "organization": "U.S. Energy Information Administration",
+      "year": 2018,
+      "pages": 126,
+      "URL": "https://www.eia.gov/analysis/studies/buildings/equipcosts/pdf/full.pdf"}
+  },
+  "installed_cost": 298.64,
+  "cost_units": "2017$/kBtu/h water heating",
+  "installed_cost_source": {
+    "notes": "Typical installed cost in 2017 divided by output capacity of 170.607 kBtu/h (50kW)",
+    "source_data": {
+      "title": "Updated Buildings Sector Appliance and Equipment Costs and Efficiencies",
+      "author": null,
+      "organization": "U.S. Energy Information Administration",
+      "year": 2018,
+      "pages": 126,
+      "URL": "https://www.eia.gov/analysis/studies/buildings/equipcosts/pdf/full.pdf"}
+  },
+  "product_lifetime": 15,
+  "product_lifetime_units": "years",
+  "product_lifetime_source": {
+    "notes": "High efficiency average lifetime in 2017",
+    "source_data": {
+      "title": "Updated Buildings Sector Appliance and Equipment Costs and Efficiencies",
+      "author": null,
+      "organization": "U.S. Energy Information Administration",
+      "year": 2018,
+      "pages": 126,
+      "URL": "https://www.eia.gov/analysis/studies/buildings/equipcosts/pdf/full.pdf"}
+  },
+  "diffusion": {
+    "fraction_2016": 0.6,
+    "fraction_2030": 0.8,
+    "fraction_2050": 1
+  },
+  "measure_type": "full service",
+  "fuel_switch_to": null,
+  "market_scaling_fractions": null,
+  "market_scaling_fractions_source": "NA",
+  "_description": "Highest efficiency commercial heat pump water heater in 2017",
+  "_notes": null,
+  "_added_by": {
+    "name": "Jared Langevin",
+    "organization": "Lawrence Berkeley National Laboratory",
+    "email": "[email protected]",
+    "timestamp": "Mon Sep 17 2018 10:00:42 EDT"},
+  "_updated_by": {
+    "name": null,
+    "organization": null,
+    "email": null,
+    "timestamp": null
+  }
+}