Added ECM-specific retrofit rate and documentation

A user may now specify ECM-specific retrofit rates (‘retro_rate’) as part of ECM definitions; the rate may be specified as a point value or as a probability distribution. The latter required several enhancements to the ‘partition_microsegment’ function in ‘ecm_prep.py’. The documentation was expanded to reflect the new ‘retro_rate’ parameter as part of the “Additional ECM features” section and to include both this parameter and the recently added ‘time_sensitive_valuation’ parameter in the ECM JSON schema. Additionally, a bug was found in the stock-and-flow dynamics in ‘ecm_prep.py’ for secondary microsegments and was fixed, and a few other minor edits were made to the code.
trynthink · Jun 29, 2018 · d1628ee · d1628ee
1 parent 2c64c84
commit d1628ee
Show file tree

Hide file tree

Showing 11 changed files with 828 additions and 162 deletions.
diff --git a/docs/ecm_reference.rst b/docs/ecm_reference.rst
diff --git a/docs/examples/Commercial AC (Flatten).json b/docs/examples/Commercial AC (Flatten).json
@@ -3,6 +3,15 @@
   "time_sensitive_valuation": {
       "shape": {"start": null, "stop": null, "flatten_fraction": 0.5}
   },
+  "time_sensitive_valuation_source": {
+    "notes": "Hypothetical time sensitive valuation information, not tied to a specific source",
+    "source_data": [{
+      "title": "",
+      "author": "",
+      "organization": "",
+      "year": 0,
+      "pages": 0,
+      "URL": ""}]},
   "climate_zone": "all",
   "bldg_type": "all commercial",
   "structure_type": "all",

diff --git a/docs/examples/Commercial AC (Multiple TSV).json b/docs/examples/Commercial AC (Multiple TSV).json
@@ -1,9 +1,18 @@
 {
-  "name": "Commercial AC (Shift)",
+  "name": "Commercial AC (Multiple TSV)",
   "time_sensitive_valuation": {
       "shift": {"start": 12, "stop": 20, "offset_hrs_earlier": 12},
       "shape": {"start": null, "stop": null, "flatten_fraction": 0.5}
   },
+  "time_sensitive_valuation_source": {
+    "notes": "Hypothetical time sensitive valuation information, not tied to a specific source",
+    "source_data": [{
+      "title": "",
+      "author": "",
+      "organization": "",
+      "year": 0,
+      "pages": 0,
+      "URL": ""}]},
   "climate_zone": "all",
   "bldg_type": "all commercial",
   "structure_type": "all",

diff --git a/docs/examples/Commercial AC (Peak Elimination).json b/docs/examples/Commercial AC (Peak Elimination).json
@@ -3,6 +3,15 @@
   "time_sensitive_valuation": {
       "conventional": {"start": 12, "stop": 20}
   },
+  "time_sensitive_valuation_source": {
+    "notes": "Hypothetical time sensitive valuation information, not tied to a specific source",
+    "source_data": [{
+      "title": "",
+      "author": "",
+      "organization": "",
+      "year": 0,
+      "pages": 0,
+      "URL": ""}]},
   "climate_zone": "all",
   "bldg_type": "all commercial",
   "structure_type": "all",

diff --git a/docs/examples/Commercial AC (Peak Shave).json b/docs/examples/Commercial AC (Peak Shave).json
@@ -3,6 +3,15 @@
   "time_sensitive_valuation": {
       "shave": {"start": 12, "stop": 20, "peak_fraction": 0.75}
   },
+  "time_sensitive_valuation_source": {
+    "notes": "Hypothetical time sensitive valuation information, not tied to a specific source",
+    "source_data": [{
+      "title": "",
+      "author": "",
+      "organization": "",
+      "year": 0,
+      "pages": 0,
+      "URL": ""}]},
   "climate_zone": "all",
   "bldg_type": "all commercial",
   "structure_type": "all",

diff --git a/docs/examples/Commercial AC (Shape).json b/docs/examples/Commercial AC (Shape).json
@@ -9,6 +9,15 @@
             0.713134087, 0.71775213, 0.766065772, 0.766065772,
             0.802987921, 0.850260722, 0.90480515, 0.957987688,
             0.995280578, 1, 0.962613938, 0.888721644]}},
+  "time_sensitive_valuation_source": {
+    "notes": "Hypothetical time sensitive valuation information, not tied to a specific source",
+    "source_data": [{
+      "title": "",
+      "author": "",
+      "organization": "",
+      "year": 0,
+      "pages": 0,
+      "URL": ""}]},
   "climate_zone": "all",
   "bldg_type": "all commercial",
   "structure_type": "all",

diff --git a/docs/examples/Commercial AC (Shift).json b/docs/examples/Commercial AC (Shift).json
@@ -3,6 +3,15 @@
   "time_sensitive_valuation": {
       "shift": {"start": 12, "stop": 20, "offset_hrs_earlier": 12}
   },
+  "time_sensitive_valuation_source": {
+    "notes": "Hypothetical time sensitive valuation information, not tied to a specific source",
+    "source_data": [{
+      "title": "",
+      "author": "",
+      "organization": "",
+      "year": 0,
+      "pages": 0,
+      "URL": ""}]},
   "climate_zone": "all",
   "bldg_type": "all commercial",
   "structure_type": "all",

diff --git a/docs/examples/led_troffers_high_retrofit.json b/docs/examples/led_troffers_high_retrofit.json
@@ -0,0 +1,80 @@
+{
+  "name": "LED Troffers (High Retrofit Rate)",
+  "climate_zone": "all",
+  "bldg_type": "all commercial",
+  "structure_type": "all",
+  "end_use": "lighting",
+  "fuel_type": "electricity",
+  "technology": ["T5 F28", "T8 F28","T8 F32", "T8 F59","T8 F96"],
+  "market_entry_year": 2015,
+  "market_entry_year_source": {
+    "notes": "The source suggests that technologies described in the document are available on the market by its release date.",
+    "source_data": [{
+       "title": "High Efficiency Troffer Performance Specification, Version 5.0",
+       "author": "",
+       "organization": "U.S. Department of Energy",
+       "year": 2015,
+       "pages": null,
+       "URL": "https://betterbuildingssolutioncenter.energy.gov/sites/default/files/attachments/High%20Efficiency%20Troffer%20Performance%20Specification.pdf"}]},
+  "market_exit_year": null,
+  "market_exit_year_source": null,
+  "energy_efficiency": 120,
+  "energy_efficiency_units": "lm/W",
+  "energy_efficiency_source": {
+    "notes": "Initial efficiency value taken from source section II.a.2.a. Efficiency value increased slightly based on efficacy values for fixtures categorized as '2x4 Luminaires for Ambient Lighting of Interior Commercial Spaces' in the DesignLights Consortium Qualified Products List (https://www.designlights.org/qpl).",
+    "source_data": [{
+       "title": "High Efficiency Troffer Performance Specification, Version 5.0",
+       "author": "",
+       "organization": "U.S. Department of Energy",
+       "year": 2015,
+       "pages": 5,
+       "URL": "https://betterbuildingssolutioncenter.energy.gov/sites/default/files/attachments/High%20Efficiency%20Troffer%20Performance%20Specification.pdf"}]},
+  "installed_cost": 233.33,
+  "cost_units": "$/1000 lm",
+  "installed_cost_source": {
+    "notes": "Assumes single fixture provides 4800 lm; requires 2 hour install with 2 people at a fully-burdened cost of $100/person/hr. Luminaire cost based on a range of retail prices found for luminaires with similar specifications found online in October 2016.",
+    "source_data": [{
+       "title": "",
+       "author": "",
+       "organization": "",
+       "year": null,
+       "pages": null,
+       "URL": ""}]},
+  "product_lifetime": 15,
+  "product_lifetime_units": "years",
+  "product_lifetime_source": {
+    "notes": "Calculated from 68,000 hrs, stated as item II.c.i, assuming 12 hr/day operation.",
+    "source_data": [{
+       "title": "High Efficiency Troffer Performance Specification, Version 5.0",
+       "author": "",
+       "organization": "U.S. Department of Energy",
+       "year": 2015,
+       "pages": 5,
+       "URL": "https://betterbuildingssolutioncenter.energy.gov/sites/default/files/attachments/High%20Efficiency%20Troffer%20Performance%20Specification.pdf"}]},
+  "measure_type": "full service",
+  "market_scaling_fractions": null,
+  "market_scaling_fractions_source": null,
+  "fuel_switch_to": null,
+  "retro_rate": 0.1,
+  "retro_rate_source": {
+    "notes": "Hypothetical retrofit rate, not tied to a specific source",
+    "source_data": [{
+      "title": "",
+      "author": "",
+      "organization": "",
+      "year": 0,
+      "pages": 0,
+      "URL": ""}]}, 
+  "_description": "LED troffers for commercial modular dropped ceiling grids that are a replacement for the entire troffer luminaire for linear fluorescent bulbs, not a retrofit kit or linear LED bulbs that slot into existing troffers.",
+  "_notes": "Energy performance is specified for the luminaire, not the base lamp.",
+  "_added_by": {
+    "name": "Carmen Sandiego",
+    "organization": "Super Appliances, Inc.",
+    "email": "[email protected]",
+    "timestamp": "2015-07-14 11:49:57 UTC"},
+  "_updated_by": {
+    "name": null,
+    "organization": null,
+    "email": null,
+    "timestamp": null}
+  }