Merge pull request #1265 from NREL/ll/hot_water_fixtures_mult

Update Hot Water Fixtures tsv

Author: afontani

docs/read_the_docs/source/changelog/changelog_dev.rst

@@ -7,6 +7,21 @@ Development Changelog
     :released: pending
 
     .. change::
+
+        :tags: bugfix, characteristics
+        :pullreq: 1265
+        :tickets: 1236
+
+        **Date**: 2024-08-06
+
+        Title:
+        Fix Hot Water Fixtures multipliers
+
+        Description:
+        Mean-shift hot water usage multipliers distribution by increasing weighted average from 0.8 to 1.0 in Hot Water Fixtures.tsv.
+
+        Assignees: Lixi Liu
+
         :tags: workflow, infiltration, bugfix
         :pullreq: 1257
 

docs/read_the_docs/source/workflow_inputs/characteristics.rst

@@ -42290,17 +42290,13 @@ Created by
 Source
 ******
 
-- \Field data from a demand management program with 1700 residential electric resistance water heaters in the Northeast U.S.
+- \Field data from a demand management program with 1700 residential electric resistance water heaters in the Northeast U.S., mean-shifted from 0.8 to 1 average usage.
 
 
 Assumption
 **********
 
-- \A lognormal distribution was shown to match the distribution of annual energy consumption.
-
-- \For the lognormal distribution the average multiplier is 0.8 and the standard deviation is 0.2.
-
-- \Low, Medium, and High usage is assigned based on the lower 25th percent, middle 50th percent, and upper 25th percent. The bins do not align perfectly with these bins so the lower users are a total of 25 percent, the medium users are 47 percent, and the high users are 28 percent of the stock.
+- \Low, Medium, and High usage is assigned based on the lower 25th percent, middle 50th percent, and upper 25th percent.
 
 
 Arguments
@@ -42351,88 +42347,83 @@ From ``project_national`` the list of options, option stock sturation, and optio
      - ``water_fixtures_sink_low_flow``
      - ``water_fixtures_usage_multiplier``
 
-   * - 40% Usage
-     - 0.026%
-     - false
-     - false
-     - 0.4
    * - 50% Usage
-     - 0.9%
+     - 0.47%
      - false
      - false
      - 0.5
    * - 60% Usage
-     - 6.5%
+     - 3.6%
      - false
      - false
      - 0.6
    * - 70% Usage
-     - 18%
+     - 9.9%
      - false
      - false
      - 0.7
    * - 80% Usage
-     - 26%
+     - 14%
      - false
      - false
      - 0.8
    * - 90% Usage
-     - 24%
+     - 17%
      - false
      - false
      - 0.9
    * - 100% Usage
-     - 13%
+     - 18%
      - false
      - false
      - 1.0
    * - 110% Usage
-     - 6.9%
+     - 13%
      - false
      - false
      - 1.1
    * - 120% Usage
-     - 3.1%
+     - 8.9%
      - false
      - false
      - 1.2
    * - 130% Usage
-     - 1.2%
+     - 6.8%
      - false
      - false
      - 1.3
    * - 140% Usage
-     - 0.45%
+     - 3.8%
      - false
      - false
      - 1.4
    * - 150% Usage
-     - 0.16%
+     - 2.1%
      - false
      - false
      - 1.5
    * - 160% Usage
-     - 0.051%
+     - 0.99%
      - false
      - false
      - 1.6
    * - 170% Usage
-     - 0.016%
+     - 0.73%
      - false
      - false
      - 1.7
    * - 180% Usage
-     - 0.0051%
+     - 0.31%
      - false
      - false
      - 1.8
    * - 190% Usage
-     - 0.0016%
+     - 0%
      - false
      - false
      - 1.9
    * - 200% Usage
-     - 0.00048%
+     - 0.1%
      - false
      - false
      - 2.0

project_national/housing_characteristics/Hot Water Fixtures.tsv

@@ -1,11 +1,9 @@
-Dependency=Usage Level	Option=40% Usage	Option=50% Usage	Option=60% Usage	Option=70% Usage	Option=80% Usage	Option=90% Usage	Option=100% Usage	Option=110% Usage	Option=120% Usage	Option=130% Usage	Option=140% Usage	Option=150% Usage	Option=160% Usage	Option=170% Usage	Option=180% Usage	Option=190% Usage	Option=200% Usage	source_count	source_weight	sampling_probability
-Low	0.00104844	0.0361725	0.26082	0.701959	0	0	0	0	0	0	0	0	0	0	0	0	0	1700	1700	0.25
-Medium	0	0	0	0	0.527436	0.472564	0	0	0	0	0	0	0	0	0	0	0	1700	1700	0.5
-High	0	0	0	0	0	0	0.524138	0.275616	0.123572	0.0493377	0.0180979	0.00623972	0.00205649	0.000656194	0.000204683	6.28787e-05	1.91334e-05	1700	1700	0.25
-Average	0	0	0	0	0.527436	0.472564	0	0	0	0	0	0	0	0	0	0	0	1700	1700	0
+Dependency=Usage Level	Option=50% Usage	Option=60% Usage	Option=70% Usage	Option=80% Usage	Option=90% Usage	Option=100% Usage	Option=110% Usage	Option=120% Usage	Option=130% Usage	Option=140% Usage	Option=150% Usage	Option=160% Usage	Option=170% Usage	Option=180% Usage	Option=190% Usage	Option=200% Usage	source_count	source_weight	sampling_probability
+Low	0.0186722	0.145228	0.396266	0.439834	0	0	0	0	0	0	0	0	0	0	0	0	1700	1700	0.25
+Medium	0	0	0	0.0591286	0.335062	0.364108	0.241701	0	0	0	0	0	0	0	0	0	1700	1700	0.5
+High	0	0	0	0	0	0	0.0539419	0.354772	0.271784	0.151452	0.0829876	0.0394191	0.0290456	0.0124481	0	0.00414938	1700	1700	0.25
+Average	0	0	0	0.0591286	0.335062	0.364108	0.241701	0	0	0	0	0	0	0	0	0	1700	1700	0
 # Created by: sources\other\tsv_maker.py
 # Description: Hot water fixture usage and flow levels.
-# Source: Field data from a demand management program with 1700 residential electric resistance water heaters in the Northeast U.S.
-# Assumption: A lognormal distribution was shown to match the distribution of annual energy consumption.
-# Assumption: For the lognormal distribution the average multiplier is 0.8 and the standard deviation is 0.2.
-# Assumption: Low, Medium, and High usage is assigned based on the lower 25th percent, middle 50th percent, and upper 25th percent. The bins do not align perfectly with these bins so the lower users are a total of 25 percent, the medium users are 47 percent, and the high users are 28 percent of the stock.
+# Source: Field data from a demand management program with 1700 residential electric resistance water heaters in the Northeast U.S., mean-shifted from 0.8 to 1 average usage.
+# Assumption: Low, Medium, and High usage is assigned based on the lower 25th percent, middle 50th percent, and upper 25th percent.

project_national/resources/options_saturations.csv

@@ -4669,23 +4669,22 @@ Level,Parameter,Option,Saturation
 1,Dishwasher Usage Level,80% Usage,0.25
 1,Dishwasher Usage Level,100% Usage,0.5
 1,Dishwasher Usage Level,120% Usage,0.25
-1,Hot Water Fixtures,40% Usage,0.00026211
-1,Hot Water Fixtures,50% Usage,0.00904313
-1,Hot Water Fixtures,60% Usage,0.065205
-1,Hot Water Fixtures,70% Usage,0.17549
-1,Hot Water Fixtures,80% Usage,0.263718
-1,Hot Water Fixtures,90% Usage,0.236282
-1,Hot Water Fixtures,100% Usage,0.131034
-1,Hot Water Fixtures,110% Usage,0.068904
-1,Hot Water Fixtures,120% Usage,0.030893
-1,Hot Water Fixtures,130% Usage,0.0123344
-1,Hot Water Fixtures,140% Usage,0.00452448
-1,Hot Water Fixtures,150% Usage,0.00155993
-1,Hot Water Fixtures,160% Usage,0.000514122
-1,Hot Water Fixtures,170% Usage,0.000164049
-1,Hot Water Fixtures,180% Usage,5.11707e-05
-1,Hot Water Fixtures,190% Usage,1.57197e-05
-1,Hot Water Fixtures,200% Usage,4.78335e-06
+1,Hot Water Fixtures,50% Usage,0.00466805
+1,Hot Water Fixtures,60% Usage,0.036307
+1,Hot Water Fixtures,70% Usage,0.0990665
+1,Hot Water Fixtures,80% Usage,0.139523
+1,Hot Water Fixtures,90% Usage,0.167531
+1,Hot Water Fixtures,100% Usage,0.182054
+1,Hot Water Fixtures,110% Usage,0.134336
+1,Hot Water Fixtures,120% Usage,0.088693
+1,Hot Water Fixtures,130% Usage,0.067946
+1,Hot Water Fixtures,140% Usage,0.037863
+1,Hot Water Fixtures,150% Usage,0.0207469
+1,Hot Water Fixtures,160% Usage,0.00985477
+1,Hot Water Fixtures,170% Usage,0.0072614
+1,Hot Water Fixtures,180% Usage,0.00311203
+1,Hot Water Fixtures,190% Usage,0
+1,Hot Water Fixtures,200% Usage,0.00103735
 1,Plug Load Diversity,50%,0.25
 1,Plug Load Diversity,100%,0.5
 1,Plug Load Diversity,200%,0.25

project_national/resources/source_report.csv

@@ -92,7 +92,7 @@ Heating Setpoint Offset Magnitude,4.0,4.0,sources\recs\recs2020\tsv_maker.py,Mag
 Heating Setpoint Offset Period,34.0,4.0,sources\recs\recs2020\tsv_maker.py,The period and offset for the dwelling unit's heating setpoint. Default for the day is from 9am to 5pm and for the night is 10pm to 7am.,U.S. EIA 2020 Residential Energy Consumption Survey (RECS) microdata.,"For dependency conditions with low samples, the following lumpings are used in progressive order until there are enough samples: 1) lumping buildings into Single-Family and Multi-Family only,  2) lumping buildings into Single-Family and Multi-Family only and lumping nearby climate zones within  A/B regions and separately 7AK and 8AK 3) lumping all building types together and lumping climate zones within A/B regions and separately 7AK and 8AK"
 Holiday Lighting,1.0,0.0,manually created,Use of holiday lighting (not used in project_national).,Not applicable (holiday lighting is not currently modeled separate from other exterior lighting),
 Hot Water Distribution,1.0,0.0,manually created,Hot water piping material and insulation level.,Engineering Judgement,
-Hot Water Fixtures,17.0,1.0,sources\other\tsv_maker.py,Hot water fixture usage and flow levels.,Field data from a demand management program with 1700 residential electric resistance water heaters in the Northeast U.S.,"A lognormal distribution was shown to match the distribution of annual energy consumption.; For the lognormal distribution the average multiplier is 0.8 and the standard deviation is 0.2.; Low, Medium, and High usage is assigned based on the lower 25th percent, middle 50th percent, and upper 25th percent. The bins do not align perfectly with these bins so the lower users are a total of 25 percent, the medium users are 47 percent, and the high users are 28 percent of the stock."
+Hot Water Fixtures,16.0,1.0,sources\other\tsv_maker.py,Hot water fixture usage and flow levels.,"Field data from a demand management program with 1700 residential electric resistance water heaters in the Northeast U.S., mean-shifted from 0.8 to 1 average usage.","Low, Medium, and High usage is assigned based on the lower 25th percent, middle 50th percent, and upper 25th percent."
 Household Has Tribal Persons,3.0,3.0,sources\pums\pums2019_5yrs\tsv_maker.py,The houshold occupying the dwelling unit has at least one tribal person in the household.,"2019-5yrs Public Use Microdata Samples (PUMS). IPUMS USA, University of Minnesota, www.ipums.org.",2188 / 2336 PUMA has <10 samples and are falling back to state level aggregated values.DC Mobile Homes do not exist and are replaced with Single-Family Detached.
 ISO RTO Region,8.0,1.0,sources\spatial\tsv_maker.py,The independent system operator or regional transmission organization region that the sample is located.,"Spatial definitions are from the U.S. Census Bureau as of July 1, 2015.; Unit counts are from the American Community Survey 5-yr 2016.; ISO and RTO regions are from EIA Form 861.",
 Income,20.0,4.0,sources\pums\pums2019_5yrs\tsv_maker.py,Income of the household occupying the dwelling unit.,"2019-5yrs Public Use Microdata Samples (PUMS). IPUMS USA, University of Minnesota, www.ipums.org.","In ACS, Income and Tenure are reported for occupied units only. Because we assume vacant units share the same Tenure distribution as occupied units, by extension, we assume this Income distribution applies to all units regardless of Vacancy Status. For reference, 57445 / 140160 rows have sampling_probability >= 1/550000. Of those rows, 2961 (5%) were replaced due to low samples in the following process: Where sample counts are less than 10 (79145 / 140160 relevant rows), the Census Division by PUMA Metro Status average distribution has been inserted first (76864), followed by Census Division by 'Metro'/'Non-metro' average distribution (1187), followed by Census Region by PUMA Metro Status average distribution (282), followed by Census Region by 'Metro'/'Non-metro' average distribution (112)."

project_testing/housing_characteristics/Hot Water Fixtures.tsv

@@ -1,4 +1,4 @@
-Option=40% Usage	Option=50% Usage	Option=60% Usage	Option=70% Usage	Option=80% Usage	Option=90% Usage	Option=100% Usage	Option=110% Usage	Option=120% Usage	Option=130% Usage	Option=140% Usage	Option=150% Usage	Option=160% Usage	Option=170% Usage	Option=180% Usage	Option=190% Usage	Option=200% Usage	sampling_probability
-0.0588235	0.0588235	0.0588235	0.0588235	0.0588235	0.0588235	0.0588235	0.0588235	0.0588235	0.0588235	0.0588235	0.0588235	0.0588235	0.0588235	0.0588235	0.0588235	0.0588235	1
+Option=50% Usage	Option=60% Usage	Option=70% Usage	Option=80% Usage	Option=90% Usage	Option=100% Usage	Option=110% Usage	Option=120% Usage	Option=130% Usage	Option=140% Usage	Option=150% Usage	Option=160% Usage	Option=170% Usage	Option=180% Usage	Option=190% Usage	Option=200% Usage	sampling_probability
+0.0625	0.0625	0.0625	0.0625	0.0625	0.0625	0.0625	0.0625	0.0625	0.0625	0.0625	0.0625	0.0625	0.0625	0.0625	0.0625	1
 # Created by: sources\other\tsv_maker.py
 # Description: Hot water fixture usage and flow levels.

project_testing/resources/options_saturations.csv

@@ -156,23 +156,22 @@ Level,Parameter,Option,Saturation
 0,Hot Water Distribution,"R-2, Timer",0.2
 0,Hot Water Distribution,"R-2, Demand",0.2
 0,Hot Water Distribution,"R-5, Timer",0.2
-0,Hot Water Fixtures,40% Usage,0.0588235
-0,Hot Water Fixtures,50% Usage,0.0588235
-0,Hot Water Fixtures,60% Usage,0.0588235
-0,Hot Water Fixtures,70% Usage,0.0588235
-0,Hot Water Fixtures,80% Usage,0.0588235
-0,Hot Water Fixtures,90% Usage,0.0588235
-0,Hot Water Fixtures,100% Usage,0.0588235
-0,Hot Water Fixtures,110% Usage,0.0588235
-0,Hot Water Fixtures,120% Usage,0.0588235
-0,Hot Water Fixtures,130% Usage,0.0588235
-0,Hot Water Fixtures,140% Usage,0.0588235
-0,Hot Water Fixtures,150% Usage,0.0588235
-0,Hot Water Fixtures,160% Usage,0.0588235
-0,Hot Water Fixtures,170% Usage,0.0588235
-0,Hot Water Fixtures,180% Usage,0.0588235
-0,Hot Water Fixtures,190% Usage,0.0588235
-0,Hot Water Fixtures,200% Usage,0.0588235
+0,Hot Water Fixtures,50% Usage,0.0625
+0,Hot Water Fixtures,60% Usage,0.0625
+0,Hot Water Fixtures,70% Usage,0.0625
+0,Hot Water Fixtures,80% Usage,0.0625
+0,Hot Water Fixtures,90% Usage,0.0625
+0,Hot Water Fixtures,100% Usage,0.0625
+0,Hot Water Fixtures,110% Usage,0.0625
+0,Hot Water Fixtures,120% Usage,0.0625
+0,Hot Water Fixtures,130% Usage,0.0625
+0,Hot Water Fixtures,140% Usage,0.0625
+0,Hot Water Fixtures,150% Usage,0.0625
+0,Hot Water Fixtures,160% Usage,0.0625
+0,Hot Water Fixtures,170% Usage,0.0625
+0,Hot Water Fixtures,180% Usage,0.0625
+0,Hot Water Fixtures,190% Usage,0.0625
+0,Hot Water Fixtures,200% Usage,0.0625
 0,Infiltration,0.5 ACH50,0.037037
 0,Infiltration,0.25 ACH50,0.037037
 0,Infiltration,0.75 ACH50,0.037037

project_testing/resources/source_report.csv

@@ -78,7 +78,7 @@ Heating Setpoint Offset Magnitude,4.0,1.0,manually created,Magnitude of the heat
 Heating Setpoint Offset Period,34.0,1.0,manually created,The period and offset for the dwelling unit's heating setpoint. Default for the day is from 9am to 5pm and for the night is 10pm to 7am.
 Holiday Lighting,2.0,1.0,manually created,Use of holiday lighting (not used in project_national).
 Hot Water Distribution,5.0,0.0,manually created,Hot water piping material and insulation level.
-Hot Water Fixtures,17.0,0.0,sources\other\tsv_maker.py,Hot water fixture usage and flow levels.
+Hot Water Fixtures,16.0,0.0,sources\other\tsv_maker.py,Hot water fixture usage and flow levels.
 Infiltration,27.0,0.0,sources\resdb\tsv_maker.py,Total infiltration to the dwelling unit.
 Insulation Ceiling,9.0,1.0,manually created,Ceiling insulation level.
 Insulation Floor,6.0,1.0,manually created,Floor insulation level.

resources/options_lookup.tsv

@@ -9954,7 +9954,6 @@ Hot Water Fixtures	170% Usage	ResStockArguments	water_fixtures_shower_low_flow=f
 Hot Water Fixtures	180% Usage	ResStockArguments	water_fixtures_shower_low_flow=false	water_fixtures_sink_low_flow=false	water_fixtures_usage_multiplier=1.8
 Hot Water Fixtures	190% Usage	ResStockArguments	water_fixtures_shower_low_flow=false	water_fixtures_sink_low_flow=false	water_fixtures_usage_multiplier=1.9
 Hot Water Fixtures	200% Usage	ResStockArguments	water_fixtures_shower_low_flow=false	water_fixtures_sink_low_flow=false	water_fixtures_usage_multiplier=2.0
-Hot Water Fixtures	40% Usage	ResStockArguments	water_fixtures_shower_low_flow=false	water_fixtures_sink_low_flow=false	water_fixtures_usage_multiplier=0.4
 Hot Water Fixtures	50% Usage	ResStockArguments	water_fixtures_shower_low_flow=false	water_fixtures_sink_low_flow=false	water_fixtures_usage_multiplier=0.5
 Hot Water Fixtures	60% Usage	ResStockArguments	water_fixtures_shower_low_flow=false	water_fixtures_sink_low_flow=false	water_fixtures_usage_multiplier=0.6
 Hot Water Fixtures	70% Usage	ResStockArguments	water_fixtures_shower_low_flow=false	water_fixtures_sink_low_flow=false	water_fixtures_usage_multiplier=0.7