Skip to content

Commit d1628ee

Browse files
jtlangevinjtlangevin
committed
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.
1 parent 2c64c84 commit d1628ee

11 files changed

Lines changed: 828 additions & 162 deletions

‎docs/ecm_reference.rst‎

Lines changed: 296 additions & 37 deletions
Large diffs are not rendered by default.

‎docs/examples/Commercial AC (Flatten).json‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,15 @@
33
"time_sensitive_valuation": {
44
"shape": {"start": null, "stop": null, "flatten_fraction": 0.5}
55
},
6+
"time_sensitive_valuation_source": {
7+
"notes": "Hypothetical time sensitive valuation information, not tied to a specific source",
8+
"source_data": [{
9+
"title": "",
10+
"author": "",
11+
"organization": "",
12+
"year": 0,
13+
"pages": 0,
14+
"URL": ""}]},
615
"climate_zone": "all",
716
"bldg_type": "all commercial",
817
"structure_type": "all",

‎docs/examples/Commercial AC (Multiple TSV).json‎

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,18 @@
11
{
2-
"name": "Commercial AC (Shift)",
2+
"name": "Commercial AC (Multiple TSV)",
33
"time_sensitive_valuation": {
44
"shift": {"start": 12, "stop": 20, "offset_hrs_earlier": 12},
55
"shape": {"start": null, "stop": null, "flatten_fraction": 0.5}
66
},
7+
"time_sensitive_valuation_source": {
8+
"notes": "Hypothetical time sensitive valuation information, not tied to a specific source",
9+
"source_data": [{
10+
"title": "",
11+
"author": "",
12+
"organization": "",
13+
"year": 0,
14+
"pages": 0,
15+
"URL": ""}]},
716
"climate_zone": "all",
817
"bldg_type": "all commercial",
918
"structure_type": "all",

‎docs/examples/Commercial AC (Peak Elimination).json‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,15 @@
33
"time_sensitive_valuation": {
44
"conventional": {"start": 12, "stop": 20}
55
},
6+
"time_sensitive_valuation_source": {
7+
"notes": "Hypothetical time sensitive valuation information, not tied to a specific source",
8+
"source_data": [{
9+
"title": "",
10+
"author": "",
11+
"organization": "",
12+
"year": 0,
13+
"pages": 0,
14+
"URL": ""}]},
615
"climate_zone": "all",
716
"bldg_type": "all commercial",
817
"structure_type": "all",

‎docs/examples/Commercial AC (Peak Shave).json‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,15 @@
33
"time_sensitive_valuation": {
44
"shave": {"start": 12, "stop": 20, "peak_fraction": 0.75}
55
},
6+
"time_sensitive_valuation_source": {
7+
"notes": "Hypothetical time sensitive valuation information, not tied to a specific source",
8+
"source_data": [{
9+
"title": "",
10+
"author": "",
11+
"organization": "",
12+
"year": 0,
13+
"pages": 0,
14+
"URL": ""}]},
615
"climate_zone": "all",
716
"bldg_type": "all commercial",
817
"structure_type": "all",

‎docs/examples/Commercial AC (Shape).json‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,15 @@
99
0.713134087, 0.71775213, 0.766065772, 0.766065772,
1010
0.802987921, 0.850260722, 0.90480515, 0.957987688,
1111
0.995280578, 1, 0.962613938, 0.888721644]}},
12+
"time_sensitive_valuation_source": {
13+
"notes": "Hypothetical time sensitive valuation information, not tied to a specific source",
14+
"source_data": [{
15+
"title": "",
16+
"author": "",
17+
"organization": "",
18+
"year": 0,
19+
"pages": 0,
20+
"URL": ""}]},
1221
"climate_zone": "all",
1322
"bldg_type": "all commercial",
1423
"structure_type": "all",

‎docs/examples/Commercial AC (Shift).json‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,15 @@
33
"time_sensitive_valuation": {
44
"shift": {"start": 12, "stop": 20, "offset_hrs_earlier": 12}
55
},
6+
"time_sensitive_valuation_source": {
7+
"notes": "Hypothetical time sensitive valuation information, not tied to a specific source",
8+
"source_data": [{
9+
"title": "",
10+
"author": "",
11+
"organization": "",
12+
"year": 0,
13+
"pages": 0,
14+
"URL": ""}]},
615
"climate_zone": "all",
716
"bldg_type": "all commercial",
817
"structure_type": "all",

‎docs/examples/led_troffers_high_retrofit.json‎

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
{
2+
"name": "LED Troffers (High Retrofit Rate)",
3+
"climate_zone": "all",
4+
"bldg_type": "all commercial",
5+
"structure_type": "all",
6+
"end_use": "lighting",
7+
"fuel_type": "electricity",
8+
"technology": ["T5 F28", "T8 F28","T8 F32", "T8 F59","T8 F96"],
9+
"market_entry_year": 2015,
10+
"market_entry_year_source": {
11+
"notes": "The source suggests that technologies described in the document are available on the market by its release date.",
12+
"source_data": [{
13+
"title": "High Efficiency Troffer Performance Specification, Version 5.0",
14+
"author": "",
15+
"organization": "U.S. Department of Energy",
16+
"year": 2015,
17+
"pages": null,
18+
"URL": "https://betterbuildingssolutioncenter.energy.gov/sites/default/files/attachments/High%20Efficiency%20Troffer%20Performance%20Specification.pdf"}]},
19+
"market_exit_year": null,
20+
"market_exit_year_source": null,
21+
"energy_efficiency": 120,
22+
"energy_efficiency_units": "lm/W",
23+
"energy_efficiency_source": {
24+
"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).",
25+
"source_data": [{
26+
"title": "High Efficiency Troffer Performance Specification, Version 5.0",
27+
"author": "",
28+
"organization": "U.S. Department of Energy",
29+
"year": 2015,
30+
"pages": 5,
31+
"URL": "https://betterbuildingssolutioncenter.energy.gov/sites/default/files/attachments/High%20Efficiency%20Troffer%20Performance%20Specification.pdf"}]},
32+
"installed_cost": 233.33,
33+
"cost_units": "$/1000 lm",
34+
"installed_cost_source": {
35+
"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.",
36+
"source_data": [{
37+
"title": "",
38+
"author": "",
39+
"organization": "",
40+
"year": null,
41+
"pages": null,
42+
"URL": ""}]},
43+
"product_lifetime": 15,
44+
"product_lifetime_units": "years",
45+
"product_lifetime_source": {
46+
"notes": "Calculated from 68,000 hrs, stated as item II.c.i, assuming 12 hr/day operation.",
47+
"source_data": [{
48+
"title": "High Efficiency Troffer Performance Specification, Version 5.0",
49+
"author": "",
50+
"organization": "U.S. Department of Energy",
51+
"year": 2015,
52+
"pages": 5,
53+
"URL": "https://betterbuildingssolutioncenter.energy.gov/sites/default/files/attachments/High%20Efficiency%20Troffer%20Performance%20Specification.pdf"}]},
54+
"measure_type": "full service",
55+
"market_scaling_fractions": null,
56+
"market_scaling_fractions_source": null,
57+
"fuel_switch_to": null,
58+
"retro_rate": 0.1,
59+
"retro_rate_source": {
60+
"notes": "Hypothetical retrofit rate, not tied to a specific source",
61+
"source_data": [{
62+
"title": "",
63+
"author": "",
64+
"organization": "",
65+
"year": 0,
66+
"pages": 0,
67+
"URL": ""}]},
68+
"_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.",
69+
"_notes": "Energy performance is specified for the luminaire, not the base lamp.",
70+
"_added_by": {
71+
"name": "Carmen Sandiego",
72+
"organization": "Super Appliances, Inc.",
73+
"email": "carmen.sandiego@superappliances.com",
74+
"timestamp": "2015-07-14 11:49:57 UTC"},
75+
"_updated_by": {
76+
"name": null,
77+
"organization": null,
78+
"email": null,
79+
"timestamp": null}
80+
}

0 commit comments

Comments
 (0)