Merge pull request #1325 from NREL/ll/well_pump

Well pump distr using AHS

Author: afontani

docs/read_the_docs/source/changelog/changelog_dev.rst

@@ -6,6 +6,22 @@ Development Changelog
     :released: pending
 
     .. change::
+        :tags: feature, characteristics
+        :pullreq: 1325
+        :tickets: resstock-estimation 437
+
+        **Date**: 2024-11-19
+
+        Title:
+        Well pump distribution using AHS
+
+        Description:
+        Use 2017-2019 AHS data to create Misc Well Pump distribution (~11% nationally) with respect to geography/urbanity, building type, and foundation type. Previously well pump was randomly assigned via a manually created distribution.
+
+        resstock-estimation: `pull request 437 <https://github.com/NREL/resstock-estimation/pull/437>`_
+
+        Assignees: Lixi Liu
+
         :tags: characteristics, pool heater
         :pullreq: 1324
 

docs/read_the_docs/source/workflow_inputs/characteristics.rst

@@ -35182,7 +35182,7 @@ From ``project_national`` the list of options, option stock sturation, and optio
      - auto
      - auto
    * - None
-     - 23%
+     - 24%
      - Percent
      - 0
      - 0
@@ -35342,7 +35342,7 @@ From ``project_national`` the list of options, option stock sturation, and optio
      - auto
      - auto
    * - None
-     - 23%
+     - 24%
      - conditioned space
      - auto
      - auto
@@ -36374,13 +36374,13 @@ From ``project_national`` the list of options, option stock sturation, and optio
 
    * - Mobile Home
      - 6.2%
-   * - Multifamily with 2-4 Units
+   * - Multi-Family with 2 - 4 Units
      - 8%
-   * - Multifamily with 5+ units, 1-3 stories
+   * - Multi-Family with 5+ Units, 1-3 Stories
      - 13%
-   * - Multifamily with 5+ units, 4-7 stories
+   * - Multi-Family with 5+ Units, 4-7 Stories
      - 3.4%
-   * - Multifamily with 5+ units, 8+ stories
+   * - Multi-Family with 5+ Units, 8+ Stories
      - 2.1%
    * - Single-Family Attached
      - 5.9%
@@ -36688,7 +36688,7 @@ Assumption
 
 - \Because we need to assume a foundation type for ground-floor MF units, we use the lumped SFD+SFA distributions for MF2-4 and MF5+ building foundations. (RECS data for households in MF2-4 unit buildings are not useful since we do not know which floor the unitis on. RECS does not include foundation responses for households in MF5+ unit buildings.)
 
-- \For SFD and SFA, if no foundation type specified, then sample has Ambient foundation.
+- \For Single-Family Detached, if no foundation type specified, then sample has Ambient foundation.
 
 
 Arguments
@@ -38352,10 +38352,10 @@ From ``project_national`` the list of options, option stock sturation, and optio
      - ``hvac_blower_fan_watts_per_cfm``
 
    * - No
-     - 23%
+     - 24%
      - auto
    * - Yes
-     - 77%
+     - 76%
      - auto
    * - Void
      - 0%
@@ -39253,7 +39253,7 @@ From ``project_national`` the list of options, option stock sturation, and optio
      - auto
      - auto
    * - Fuel Boiler, 76% AFUE
-     - 0.83%
+     - 0.89%
      - Boiler
      - 0.76
      - auto
@@ -39298,7 +39298,7 @@ From ``project_national`` the list of options, option stock sturation, and optio
      - auto
      - auto
    * - Fuel Boiler, 80% AFUE
-     - 3.2%
+     - 3.3%
      - Boiler
      - 0.8
      - auto
@@ -39343,7 +39343,7 @@ From ``project_national`` the list of options, option stock sturation, and optio
      - auto
      - auto
    * - Fuel Boiler, 90% AFUE
-     - 0.48%
+     - 0.49%
      - Boiler
      - 0.9
      - auto
@@ -39613,7 +39613,7 @@ From ``project_national`` the list of options, option stock sturation, and optio
      - auto
      - auto
    * - Fuel Wall/Floor Furnace, 68% AFUE
-     - 2.9%
+     - 2.8%
      - WallFurnace
      - 0.68
      - auto
@@ -39703,7 +39703,7 @@ From ``project_national`` the list of options, option stock sturation, and optio
      - auto
      - auto
    * - MSHP, SEER 29.3, 14 HSPF
-     - 0.014%
+     - 0.015%
      - none
      - 0
      - auto
@@ -39993,7 +39993,7 @@ From ``project_national`` the list of options, option stock sturation, and optio
    * - Fuel Oil Fuel Furnace
      - 2.8%
    * - Fuel Oil Fuel Wall/Floor Furnace
-     - 0.3%
+     - 0.29%
    * - Fuel Oil Shared Heating
      - 0.51%
    * - Natural Gas Fuel Boiler
@@ -40007,7 +40007,7 @@ From ``project_national`` the list of options, option stock sturation, and optio
    * - None
      - 1.1%
    * - Other Fuel Fuel Boiler
-     - 0.45%
+     - 0.46%
    * - Other Fuel Fuel Furnace
      - 0.24%
    * - Other Fuel Fuel Wall/Floor Furnace
@@ -40023,7 +40023,7 @@ From ``project_national`` the list of options, option stock sturation, and optio
    * - Propane Shared Heating
      - 0.16%
    * - Void
-     - 0%
+     - 0.00039%
 
 .. _hvac_secondary_heating_efficiency:
 
@@ -42236,7 +42236,7 @@ From ``project_national`` the list of options, option stock sturation, and optio
      - 1.1%
      - 3
    * - 3 months
-     - 0.35%
+     - 0.36%
      - 90
    * - Never
      - 96%
@@ -47656,17 +47656,29 @@ Misc Well Pump
 Description
 ***********
 
-Presence and efficiency of well pump.
+Presence of well pump according to the use of well for domestic water source.
 
 Created by
 **********
 
-manually created
+``sources/ahs/ahs2017_2019/tsv_maker.py``
 
 Source
 ******
 
-- \Wilson et al. 'Building America House Simulation Protocols' 2014, national average fraction used for saturation
+- \2017 and 2019 American Housing Survey (AHS) microdata.
+
+- \Core Based Statistical Area (CBSA) data based on the Feb 2013 CBSA delineation file.
+
+
+Assumption
+**********
+
+- \All well pumps are assumed to have typical efficiency.
+
+- \Where the number of samples < 10, the Census Division is aggregated up to Census Region.
+
+- \AHS has data for buildings up to 7 stories tall. Buildings with 8 or more stories are assumed not to have a well pump.
 
 
 Arguments
@@ -47724,18 +47736,18 @@ From ``project_national`` the list of options, option stock sturation, and optio
      - ``misc_plug_loads_well_pump_usage_multiplier``
      - ``misc_plug_loads_well_pump_2_usage_multiplier``
 
-   * - Typical Efficiency
-     - 13%
-     - true
-     - auto
-     - 1.0
-     - 1.0
    * - None
      - 87%
      - false
      - 0
      - 0
      - 0
+   * - Typical Efficiency
+     - 13%
+     - true
+     - auto
+     - 1.0
+     - 1.0
 
 .. _natural_ventilation:
 
@@ -63001,7 +63013,7 @@ From ``project_national`` the list of options, option stock sturation, and optio
      - auto
      - auto
    * - FIXME Fuel Oil Indirect
-     - 0.68%
+     - 0.69%
      - storage water heater
      - fuel oil
      - auto
@@ -63039,7 +63051,7 @@ From ``project_national`` the list of options, option stock sturation, and optio
      - auto
      - auto
    * - Fuel Oil Standard
-     - 1.3%
+     - 1.4%
      - storage water heater
      - fuel oil
      - auto

project_national/housing_characteristics/Geometry Building Type Height.tsv

@@ -1,4 +1,4 @@
-Dependency=Geometry Building Type RECS	Dependency=Geometry Stories	Option=Mobile Home	Option=Multifamily with 2-4 Units	Option=Multifamily with 5+ units, 1-3 stories	Option=Multifamily with 5+ units, 4-7 stories	Option=Multifamily with 5+ units, 8+ stories	Option=Single-Family Attached	Option=Single-Family Detached	source_count	source_weight	sampling_probability
+Dependency=Geometry Building Type RECS	Dependency=Geometry Stories	Option=Mobile Home	Option=Multi-Family with 2 - 4 Units	Option=Multi-Family with 5+ Units, 1-3 Stories	Option=Multi-Family with 5+ Units, 4-7 Stories	Option=Multi-Family with 5+ Units, 8+ Stories	Option=Single-Family Attached	Option=Single-Family Detached	source_count	source_weight	sampling_probability
 Mobile Home	1	1	0	0	0	0	0	0	541	6.94096e+06	0.0624897
 Mobile Home	2	1	0	0	0	0	0	0	0	0	0
 Mobile Home	3	1	0	0	0	0	0	0	0	0	0

project_national/housing_characteristics/Geometry Foundation Type.tsv

@@ -517,4 +517,4 @@ Dependency=ASHRAE IECC Climate Zone 2004	Dependency=Geometry Building Type RECS
 # Assumption: Single-family attached buildings cannot have Ambient foundations
 # Assumption: Foundation types are the same for each building type except mobile homes and the applicable options.
 # Assumption: Because we need to assume a foundation type for ground-floor MF units, we use the lumped SFD+SFA distributions for MF2-4 and MF5+ building foundations. (RECS data for households in MF2-4 unit buildings are not useful since we do not know which floor the unitis on. RECS does not include foundation responses for households in MF5+ unit buildings.)
-# Assumption: For SFD and SFA, if no foundation type specified, then sample has Ambient foundation.
+# Assumption: For Single-Family Detached, if no foundation type specified, then sample has Ambient foundation.

project_national/housing_characteristics/Misc Pool Heater.tsv

@@ -1,21 +1,20 @@
 Dependency=Heating Fuel	Dependency=Misc Pool	Option=Electric Heat Pump	Option=Electricity	Option=Natural Gas	Option=None	Option=Other Fuel	source_count	source_weight	sampling_probability
-Electricity	Has Pool	0.0184454	0.139695	0.0703046	0.671207	0.100347	411	3.08643e+06	0.0290193
+Electricity	Has Pool	0.0184454	0.139695	0.0703046	0.671207	0.100347	411	3.08643e+06	0.0290182
 Fuel Oil	Has Pool	0.0246983	0.0530754	0	0.749028	0.173199	105	431588	0.0040479
-Natural Gas	Has Pool	0.0175311	0.0376736	0.262356	0.634394	0.0480448	619	4.04905e+06	0.0316923
-None	Has Pool	0.0581784	0.125023	0.0990135	0.60331	0.114475	53	390468	0.000546069
-Other Fuel	Has Pool	0	0	0	0	1	1	6953.18	0.000552064
-Propane	Has Pool	0.0234773	0.0504515	0	0.739533	0.186538	66	409140	0.00376988
-Wood	Has Pool	0	0	0	0.941845	0.0581551	25	147130	0.00163129
-Electricity	None	0	0	0	1	0	5288	3.94876e+07	0.365019
+Natural Gas	Has Pool	0.0175311	0.0376736	0.262356	0.634394	0.0480448	619	4.04905e+06	0.0316922
+None	Has Pool	0.0581784	0.125023	0.0990135	0.60331	0.114475	53	390468	0.000543151
+Other Fuel	Has Pool	0	0	0	0	1	1	6953.18	0.000551967
+Propane	Has Pool	0.0234773	0.0504515	0	0.739533	0.186538	66	409140	0.00376982
+Wood	Has Pool	0	0	0	0.941845	0.0581551	25	147130	0.00163127
+Electricity	None	0	0	0	1	0	5288	3.94876e+07	0.36502
 Fuel Oil	None	0	0	0	1	0	992	4.50335e+06	0.0445443
 Natural Gas	None	0	0	0	1	0	8976	5.86644e+07	0.436976
-None	None	0	0	0	1	0	698	5.39976e+06	0.010793
-Other Fuel	None	0	0	0	1	0	7	47557.2	0.00688877
-Propane	None	0	0	0	1	0	862	4.80248e+06	0.046516
+None	None	0	0	0	1	0	698	5.39976e+06	0.010796
+Other Fuel	None	0	0	0	1	0	7	47557.2	0.00688887
+Propane	None	0	0	0	1	0	862	4.80248e+06	0.0465161
 Wood	None	0	0	0	1	0	393	2.10314e+06	0.0180041
 # Created by: sources\recs\recs2020\tsv_maker.py
 # Description: The heating fuel of the pool heater if there is a pool.
 # Source: Constructed using U.S. EIA 2020 Residential Energy Consumption Survey (RECS) microdata.
 # Source: Constructed using the California Energy Commision 2019 Residential Appliance Saturation Study (RASS) microdata.
-# Assumption: Within electric pool heaters, proportion of heat pump electric pool heating vs. non-heat
-# Assumption: pump electric pool heating was derived from RASS
+# Assumption: Within electric pool heaters, proportion of heat pump electric pool heating vs. non-heat pump electric pool heating was derived from RASS 2019.