Skip to content

HERS® Diagnostic Output Schema Specification

Data Model

Enumerations

SchemaType

Enumerator

Description

Notes

HERS_DIAGNOSTIC_OUTPUT

HERS Diagnostic Output

FuelType

Enumerator

Description

Notes

ELECTRICITY

Electricity

NATURAL_GAS

Natural gas

FUEL_OIL_2

Fuel oil #2

LIQUID_PETROLEUM_GAS

Liquid petroleum gas

BIOMASS

Biomass

Data Groups

HERSDiagnosticOutput

Name

Description

Data Type

Units

Constraints

Req

Notes

metadata

ASHRAE Standard 232P metadata

{Metadata}

schema=HERS_DIAGNOSTIC_OUTPUT

$✓$

project_name

Name of the file or project used to generate this data

String

$✓$

home_description

Supplementary descriptive information about the home

String

software_name

Name of the software used to generate this data

String

$✓$

software_version

Version of the software used to generate this data

String

$✓$

weather_data_location

Descriptive name of the weather data location

String

$✓$

For example: City, town, or airport name.

weather_data_state

State

String

"[A-Z]{2}"

$✓$

conditioned_floor_area

Conditioned floor area

Numeric

ft^2^

>0

$✓$

number_of_bedrooms

Number of bedrooms

Integer

≥1

$✓$

number_of_stories

Number of above-grade stories

Integer

≥1

$✓$

hers_index

HERS Index

Numeric

-

$✓$

Unrounded value based on the latest version of MINHERS®

carbon_index

RESNET® Carbon Index

Numeric

-

$✓$

Unrounded value based on the latest version of MINHERS®

electricity_co2_emissions_factors

Regional emissions factors for electricity use

[Numeric][8760]

lb/kWh

≥0

$✓$

outdoor_drybulb_temperature

Outdoor drybulb temperature

[Numeric]

F

[8760]

$✓$

on_site_power_production

On-site power production (OPP) of the rated home

[Numeric][8760]

kWh

≥0

battery_storage_losses

Battery storage losses (BSL) of the rated home

[Numeric][8760]

kWh

≥0

rated_home_output

Rated Home outputs

{HomeOutputs}

$✓$

hers_reference_home_output

HERS Reference Home outputs

{HomeOutputs}

$✓$

co2_reference_home_output

CO2 Reference Home outputs

{HomeOutputs}

$✓$

iad_rated_home_output

Index Adjustment Design (IAD) Rated Home outputs

{HomeOutputs}

$✓$

iad_hers_reference_home_output

Index Adjustment Design (IAD) HERS Reference Home outputs

{HomeOutputs}

$✓$

EnergyOutput

Name

Description

Data Type

Units

Constraints

Req

Notes

fuel_type

Fuel type

<FuelType>

$✓$

energy

Energy use

[Numeric][8760]

kBtu

≥0

$✓$

SystemOutput

Name

Description

Data Type

Units

Constraints

Req

Notes

primary_fuel_type

System primary fuel type (needed to determine 'a' and 'b' coefficients for normalized energy consumption)

<FuelType>

$✓$

equipment_efficiency_coefficient

Equipment efficiency coefficient (EEC)

Numeric

-

≥0

$✓$

load

System load

[Numeric][8760]

kBtu

≥0

Only required for systems of the HERS Reference Home

energy_use

System energy use

[{EnergyOutput}][1..]

$✓$

HomeOutputs

Name

Description

Data Type

Units

Constraints

Req

Notes

conditioned_space_temperature

Conditioned space temperature

[Numeric][8760]

F

$✓$

space_heating_system_output

Array of outputs for space heating systems

[{SystemOutput}][1..]

$✓$

space_cooling_system_output

Array of outputs for space cooling systems

[{SystemOutput}][1..]

$✓$

water_heating_system_output

Array of outputs for water heating systems

[{SystemOutput}][1..]

$✓$

lighting_and_appliance_energy

Lighting and appliance energy use

[{EnergyOutput}][1..]

$✓$

ventilation_energy

Ventilation energy use

[{EnergyOutput}][1..]

$✓$

dehumidification_energy

Dehumidification energy use

[{EnergyOutput}][1..]