Submit Inputs Method

Element Attribute Description No. Instances Type Length Possible Values Min Max
building 1



user_key 3scale key required string 32





building_id ID of building to modify required int




about 0..1



assessment_date date the assessment was performed not required date

2010-01-01 present



comments free text comment field not required string 256





comment_api_only pass through field for use by api users not required string 40





shape house shape not required string 20 rectangle, town_house




town_house_walls which townhouse walls are exposed not required string 20 back_front, back_right_front, back_front_left
used only if shape=town_house





year_built year building was built not required year

1600 Present



number_bedrooms number of bedrooms in house not required int

1 10



num_floor_above_grade number of floors above grade not required int

1 4



floor_to_ceiling_height floor to ceiling height (feet) not required int

6 12



conditioned_floor_area total conditioned floor area (sqaure feet) not required int

250 25000



orientation orientation of house not required string
north, north_east, east, south_east, south, south_west, west, north_west




blower_door_test Was a blower door test performed on this house? not required int
1=yes, 0=no 0 1



air_sealing_present Does the building have air sealing? not required int
1=yes, 0=no
used only if blower_door_test=0
0 1



envelope_leakage building air leakage (CFM50) not required int
used only if blower_door_test=1 0 25000

zone 0..1



wall_construction_same Do all the walls have the same construction? not required int 1 1=yes, 0=no 0 1



window_construction_same Do all the windows have the same construction? not required int 1 1=yes, 0=no 0 1


zone_roof 0..1



roof_assembly_code construction assembly library code (ewwf00wo etc.) not required string 20 See construction codes spreadsheet

      roof_color
color of the exterior surface
not required
string

20
white, light, medium, medium_dark, dark, cool_color
   



roof_absorbance absorptance of exterior surface not required float

0 1



roof_type type of roof not required string 20 vented_attic, cond_attic, cath_ceiling




ceiling_assembly_code construction assembly library code not required string 20 See construction codes spreadsheet



zone_skylight 0..1



skylight_area area of skylights (square feet) not required float

0 300



skylight_method construction method to use for skylights not required string 20 code, custom




skylight_code assembly code for skylights not required string 20 See construction codes spreadsheet
used only if skylight_method=code





skylight_u_value u-value (conductance) of skylights not required float
used only if skylight_method=custom 0.01 5



skylight_shgc solar heat gain coefficient of skylights not required float
used only if skylight_method=custom 0 1


zone_floor 0..1



foundation_type type of foundation not required string 20 uncond_basement, cond_basement, vented_crawl, unvented_crawl, slab_on_grade




foundation_insulation_level foundation wall insulation R-value not required int

0 19



floor_assembly_code construction assembly library code not required string 20 See construction codes spreadsheet



zone_wall 0..4



side side or zone this wall faces required string 20 front, back, right, left




wall_assembly_code assembly code for this wall not required string 20 See construction codes spreadsheet



zone_window 0..1



window_area area of windows on this wall (square feet) not required float

0 999



window_method construction method to use for this window not required string 20 code, custom




window_code assembly code for this window not required string 20 See construction codes spreadsheet
used only if window_method=code





window_u_value u-value (conductance) of this window not required float
used only if window_method=custom 0.01 5



window_shgc solar heat gain coefficient of this window not required float
used only if window_method=custom 0 1

systems 0..1


heating 0..1



type Heating system type not required string 20 heat_pump, contral_furnace, wall_furnace, baseboard, boiler, gchp, none





fuel_primary primary heating fuel not required string 20 electric, natural_gas, lpg, fuel_oil




efficiency_method method to determine heating efficiency not required string 20 user, shipment_weighted




year year equipment was manufactured not required int
used only if efficiency_method = shipment_weighted 1970 present



efficiency efficiency of heating equipment not required float
used only if efficiency_method = user
0.1 20


cooling 0..1



type cooling equipment type not required string 20 packaged_dx, split_dx, heat_pump, gchp, dec, iec, idec, none





efficiency_method method to determine cooling efficiency not required string 20 user, shipment_weighted




year year equipment was manufactured not required int
used only if efficiency_method = shipment_weighted 1970 present



efficiency efficiency of cooling equipment not required float
used only if efficiency_method = user 0.1 30


hvac_distribution 0..3



name name of distribution system required string 20 duct1, duct2, duct3




location location of distribution system not required string 20 cond_space, uncond_basement, unvented_crawl, vented_crawl, uncond_attic





fraction fraction of total duct length required int

0 100



insulated are these ducts insulated not required int
1=yes, 0=no 0 1



sealed are these ducts sealed not required int
1=yes, 0=no 0 1


domestic_hot_water 0..1



category water heater category not required string 20 unit, combined




type water heater type not required string 20 storage, indirect, tankless_coil, heat_pump




fuel_primary primary water heater fuel not required string 20 electric, natural_gas, lpg, fuel_oil




efficiency_method method to determine water heater efficiency not required string 20 user, shipment_weighted




year year water heater was manufactured not required int
used only if efficiency_method = shipment_weighted 1972 Present



energy_factor energy factor of water heater not required float
used only if efficiency_method = user 0.1 3

Notes:

(1) "Required" here means required to submit inputs. Many inputs must be set for the calculation to run that are not required to do submit. This allows for a partial submit to be saved and revised later.
(2) "tankless coil" water heater is a type of combinatiopn boiler-water heater, not an instantaneous tankless unit.