Air Source Heat Pump Residential Component¶
-
class
aaem.components.ashp_res.component.
ASHPResidential
(community_data, forecast, diag=None, prerequisites={})[source]¶ Bases:
aaem.components.ashp_base.component.ASHPBase
Residential ASHP component of the Alaska Affordable Energy Model: This module estimate the potential reduction in heating fuel use from
installation of Air Source Heat Pumps in residential buildings. Reduction in fuel used is based on coefficient of power in hypothetical ASHP system and heat energy produced per year. Savings result from differential heating fuel costs and ASHP operation costs. The costs of the ASHP infrastructure projects are based on the number of homes in the community and the cost of AHSP systems themselves.Parameters: community_data : CommunityData
CommunityData Object for a community
forecast : Forecast
forecast for a community
diagnostics : diagnostics, optional
diagnostics for tracking error/warning messages
prerequisites : dictionary of components, optional
‘Non-residential Energy Efficiency’ component is a required prerequisite for this component
See also
aaem.community_data
- community data module, see information on CommunityData Object
aaem.forecast
- forecast module, see information on Forecast Object
aaem.diagnostics
- diagnostics module, see information on diagnostics Object
aaem.components.residential
- ‘residential Energy Efficiency’ component is a required prerequisite for this component
Attributes
diagnostics (diagnostics) for tracking error/warning messages initial value: diag or new diagnostics object forecast (forecast) community forecast for estimating future values initial value: forecast cd (dictionary) general data for a community. Initial value: ‘community’ section of community_data comp_specs (dictionary) component specific data for a community. Initial value: ‘Residential ASHP’ section of community_data Methods
-
calc_capital_costs
()[source]¶ Calculate or Load the project Capital Costs.
Attributes
total_cap_required (float) total ASHP capacity provided. capital_costs (float) calculated or loaded capital costs for heat recovery
-
calc_electric_heat_energy_reduction
()[source]¶ calculate electric heat energy reduction kWh
Attributes
electric_heat_energy_reduction (float) reduction in energy used for heating
-
calc_electric_heat_energy_savings
()[source]¶ calculate heat energy savings in $/year
Attributes
electric_heat_energy_savings: array of floats savings from
-
calc_heat_energy_produced_per_year
()[source]¶ Calculate the heat energy produced per year by ASHP system (TODO: Double check definition)
Attributes
heat_displaced_sqft (float) Building Square footage that will be heated by ASHP heat_energy_produced_per_year (float) Heat energy produced per year in BTU
-
load_prerequisite_variables
(comps)[source]¶ Loads square footage of Residential buildings and average heating consumption per sqft(gal heating fuel/sqft)
Parameters: comps: Dictionary of components
Dictionary of components, needs ‘Non-residential Energy Efficiency’ key
Raises: KeyError
if ‘Non-residential Energy Efficiency’ component not found.
Attributes
res_sqft (float) Total square footage that may be refit of residential buildings, Will be set to 0 if a value cannot be found in ‘Residential Energy Efficiency’ component avg_gal_per_sqft (float) Heating fuel consumption per square foot. Will be set to 0 if a, value cannot be found in ‘Residential Energy Efficiency’ component
-
run
(scalers={'capital costs': 1.0})[source]¶ Runs the component. The Annual Total Savings,Annual Costs, Annual Net Benefit, NPV Benefits, NPV Costs, NPV Net Benefits, Benefit Cost Ratio, Levelized Cost of Energy, and Internal Rate of Return will all be calculated.
Parameters: scalers: dictionary of valid scalers, optional
Scalers to adjust normal run variables. See note on accepted scalers
Notes
Accepted scalers: capital costs.
Attributes
run (bool) True in the component runs to completion, False otherwise reason (string) lists reason for failure if run == False
Air Source Heat Pump Residential Configuration¶
Contains Air Source Heat Pump Residential configuration info for community data yaml file, and other set-up requirements
Air Source Heat Pump Residential Outputs¶
output functions for Air Source Heat Pump Residential component
-
aaem.components.ashp_res.outputs.
communities_summary
(coms, res_dir)[source]¶ Saves the summary by: community residential_ashp_summary.csv
Parameters: coms : dictionary
results from the model, dictionary with each community or project as key
res_dir : path
location to save file
-
aaem.components.ashp_res.outputs.
component_summary
(results, res_dir)[source]¶ Creates the regional and communities summary for the component in provided directory
Parameters: results : dictionary
results from the model, dictionary with each community or project as key
res_dir : path
location to save file
Air Source Heat Pump Residential preprocessing¶
preprocessing functions for Air Source Heat Pump Residential component
Note
Uses ASHP Base preprocessor functions