Skip to content

Latest commit

 

History

History
67 lines (63 loc) · 3.07 KB

DOCUMENATION.md

File metadata and controls

67 lines (63 loc) · 3.07 KB
Raw

Home Energy Data API - Data Source Documentation

Documentation of data, formulae, and scientific conversions supporting Zwell's home energy audit and calculation tools.

  • Energy conversions
  • Appliance table
  • Fuel/utility cost table
  • State electricity production data
  • Zip code data (weather stations, water sites)
  • Solar insolation logic
  • Heating & cooling logic
  • Water heating logic
  • Lighting energy logic
  • Energy generation logic
  • CO2 emissions logic
  • Operating cost logic

Dynamic Data:

  • Heating Degree Days & Cooling Degree Days (at a weather station level)
    • We pull the historical temperature data by weather station from the GHCNd
    • We use an assumption around a 65° internal home temperature to determine heat degree and cooling degree days. We arrived at this number based on EIA's definition.
  • Ground Water Temperature (or Surface Water Temperature) (at a water site level
  • Electricity Production Sources (at a state level)
  • Natural Gas Utility Price (at a state level)
  • Electricity Utility Price (at a state level)
  • Other Fuel Prices (Propane, Fuel Oil, Kerosene, Wood, Wood Pellets) (at a national average level)
    • EIA Open Data
      • Natural Gas - Monthly by State
      • Electricity - Monthly by State
      • Propane - Weekly by State
      • Heating Oil - Weekly by State
    • We'd like to use APIv2 to connect pull this data by state as frequently as it is updated.

Static Data:

  • Heating, Cooling, Water Heating
    • Every appliance category has its own measure e.g. SEER and this is sourced from AHRI using a median rating for each product type and fuel type.
  • Appliance annual energy usage
    • We are tyring to source the median efficiency from the FTC's EnergyGuide for the following:
      • Boilers
      • Ceiling Fans
      • Central Air Conditioners
      • Clothes Washers
      • Dishwashers
      • Freezers
      • Furnaces
      • Heat Pumps
      • Pool Heaters
      • Refrigerators
      • Televisions
      • Water Heaters
      • Room and Portable Air Aonditioners
      • Light Bulbs
    • We don't have create documentation on the efficiency sources for the following appliances and need help sourcing:
      • Cooktops
      • Ovens
      • Dryers
  • Zip code latitude and longitude
  • Home R values
    • International Energy Conservation Code
  • ACH values
  • Water usage averages