Interface EquipmentV16

Represents all mechanical and energy systems in the building. Contains the equipment specifications and configuration details.

interface EquipmentV16 {
    aux: { entity: Entity };
    bundle?: { entity: Entity };
    dhw: { dhw2_entity?: {} | Entity; entity: Entity };
    hrv: { entity: Entity };
    mech: { entity: Entity };
    pv: { entity: Entity }[];
    suppl: { entity: Entity }[];
    ventilation: { fans: Fan[]; mechanical_supply_rate_ls?: number };
}

Implemented by

Properties

aux: { entity: Entity }

Auxiliary heating systems (e.g., Heat Pump).

Due to the long history of the EnerGuide program and HOT2000, heat pump systems were not originally considered as equipment capable of taking the entire home's load. Therefore, HOT2000 defines a Heat Pump as a "Type 2" system, which is translated to "auxiliary" in the Seed. This system needs to be backed up by a "Type 1" system to take up any load that the heat pump is not able to meet.

The auxiliary energy calculations works alongside the primary heating system. Particularly important for hybrid systems where a heat pump is supplemented by electric resistance heating at low temperatures. For such standalone Heat Pumps scenarios, use a baseboard as the "Type 1".

For F280: The standard is meant to size such system so it won't be factoring an existing system in.

Type declaration

  • entity: Entity

    Equipment specification for the auxiliary heating.

    Key properties typically include:

    • heatCOP: System Coefficient of Performance (COP) when heating
    • coolCOP: System Coefficient of Performance (COP) when cooling
    • function: whether it is only cooling or the equipment can heat too
    • Type: Central split system, mini-split
    • fuel: Fuel type used by the system
    • capacity: Heating capacity in kW - can be auto calculated

    For EnerGuide: These properties determine system performance in HOT2000.

bundle?: { entity: Entity }

Optional package of coordinated equipment upgrades.

Used primarily for the "before"/"after" condition change in retrofit scenarios, where multiple equipment changes are bundled together as a package. The bundle entity typically references a predefined package of compatible equipment upgrades.

Used to identify bundled equipment upgrades for energy and cost calculations.

For F280 and EnerGuide: Is a surrogate for separate "mech", "aux" and "dhw" equipment.

Type declaration

  • entity: Entity

    Specification for the equipment bundle.

    Contains references to the bundled equipment entities.

dhw: { dhw2_entity?: {} | Entity; entity: Entity }

Domestic hot water system.

Used to calculate domestic hot water energy consumption based on fuel type, system efficiency, and usage patterns. DHW energy is calculated using occupancy data and system efficiency.

For F280: Not directly used in heating/cooling load calculations.

For EnerGuide: Gets added to the overall consumption and directly impacts the EnerGuide score. Its placement can also impact the heating/cooling loads due to its waste heat. Exported to HOT2000 as DHWSystem elements with detailed specifications for tank volume, efficiency, fuel type, and recovery rate. Critical for EnerGuide ratings as DHW is a significant energy consumer.

Type declaration

  • Optionaldhw2_entity?: {} | Entity

    Optional secondary water heating equipment.

    Used for dual-fuel or hybrid DHW systems where a secondary heater provides supplemental or backup hot water heating. Properties are similar to the primary DHW entity's specifications. Specially when the primary system is a solar collector, it is useful.

  • entity: Entity

    Primary water heating equipment.

    Key properties typically include:

    • efficiency: Energy factor (EF) or Uniform Energy Factor (UEF)
    • fuel: Fuel type used by the system - Gas, Electricity, Mixed Wood, Propane, Oil
    • volume: Tank volume in liters (if applicable)
    • type: Technology type, can be: Conserver tank, Instantaneous, Condensing, Conventional tank (pilot), Conventional tank, Integrated heat pump, Not Applicable

    For EnerGuide: These specifications determine DHW energy use in HOT2000.

hrv: { entity: Entity }

Heat recovery ventilator system.

Used to calculate ventilation heat loss reduction when a HRV/ERV is installed. The HRV efficiency reduces ventilation heat loss by recovering heat from exhaust air. Typically calculated based on efficiency at different temperatures..

For F280: Critical for ventilation heat loss calculations, where the sensible heat recovery efficiency reduces the effective heat loss from mechanical ventilation. As a by-product, it affects duct loss multipliers (DLM).

For EnerGuide: HRV efficiency significantly impacts EnerGuide ratings in airtight homes. In general, higher ventilation rate, increases its impact. Exported to HOT2000 as Ventilator elements with efficiency, flow rate, and power consumption specifications.

Type declaration

  • entity: Entity

    Equipment specification for the HRV.

    Key properties typically include:

    • ef_A: Efficiency at temperature A
    • ef_B: Efficiency at temperature B
    • temp_A: temperature A in degrees C
    • temp_B: temperature B in degrees C
    • flow_rate: Airflow in L/s
    • power: Fan power consumption in watts
    • distribution: the ducting system.
    • energyStar: whether certified - true, false
    • HVI: whether certified - true, false
    • model
    • brand

    For F280 and EnerGuide: These properties determine heat recovery effectiveness and fan energy consumption.

mech: { entity: Entity }

Primary mechanical heating/cooling system.

Used to calculate primary heating and cooling energy consumption based on system type, efficiency, and capacity. System type in conjunction with aux determines which calculation approach is used (heat pump vs. furnace/boiler).

For F280: Not directly used in heat loss/gain calculations.

For EnerGuide: The primary mechanical system is a critical component in EnerGuide rating. In provinces with differences in fuel emission factors, it also heavily impacts the GHG emissions. Exported to HOT2000 as detailed heating and cooling system specifications with appropriate system type, efficiency, capacity, and distribution characteristics.

Type declaration

  • entity: Entity

    Equipment specification for the primary HVAC system.

    Key properties typically include:

    • efficiency: steady state efficiency of the device.
    • fuel: Fuel type used by the system - Gas, Electricity, Mixed Wood, Propane, Oil
    • system: The main design - ComboHeatDhw, Baseboards, Boiler, Furnace
    • type: Technology type - Condensing, NA, Furnace w/ continuous pilot, Furnace w/ spark ignition, Conventional stove
    • does_dhw: boolean whether the mechanical system provides hot water as well or not.
    • EE_motor: whether it has an energy efficient motor

    For EnerGuide: These specifications determine heating and cooling energy use in HOT2000 simulations.

pv: { entity: Entity }[]

Photovoltaic solar panels installed on the building.

Used to calculate electricity generation from solar panels. Processed to estimate energy production based on location of the building as well as panel specifications, and orientation.

For F280: Not directly used in heat loss/gain calculations, but can contribute to the overall energy balance of the building by offsetting electrical loads.

For EnerGuide: Exported to HOT2000 as PVSystem elements with attributes for area, efficiency, and electrical characteristics. Panel specifications are translated into HOT2000 PV parameters including DC/AC conversion efficiency.

Type declaration

  • entity: Entity

    Equipment specification for the PV panels.

    Key properties typically include:

    • area: Panel surface area in square meters
    • efficiency: Conversion efficiency (typically 0.15-0.22)
    • power: Rated power output in watts
    • direction: Cardinal orientation for fixed panels

    For EnerGuide: These properties are mapped to HOT2000's PV system model.

suppl: { entity: Entity }[]

Supplementary heating systems.

Used for additional heating sources like fireplaces, wood stoves, or electric heaters that supplement the primary system. Each system contributes to the overall heating energy mix.

For F280: Not included in design heating load calculations.

For EnerGuide: It makes an impact only when the system operates automatically with a thermostat or schedule. For example, portable heaters do not make a difference because they are not permanent installations. Exported to HOT2000 as supplementary heating systems with appropriate efficiency, fuel type, and capacity specifications. Wood-burning systems may require additional parameters.

Type declaration

  • entity: Entity

    Equipment specification for supplementary heating.

    Key properties typically include:

    • efficiency: System efficiency (varies by type)
    • fuel: Fuel type used by the system
    • capacity: Heating capacity in kW
    • type: Technology type (electric baseboard, wood stove, fireplace)
ventilation: { fans: Fan[]; mechanical_supply_rate_ls?: number }

Ventilation systems in the building.

Used to calculate total mechanical ventilation rates and fan energy consumption. Fans contribute to both ventilation heat loss and electrical energy use.

For F280: Ventilation rates directly impact heat loss calculations. Fan operation must meet minimum ventilation requirements based on room count and floor area.

For EnerGuide: Fan specifications, when they are whole-house, matters -- with flow rates, operation schedules, and power consumption parameters. Fan power may contribute to internal heat gains.

Type declaration

  • fans: Fan[]

    Array of exhaust and supply fans.

    Each fan typically includes:

    • flow_rate: Airflow in L/s
    • power: Fan power consumption in watts
    • operation: Hours of operation per day
    • location: Room or zone served

    For F280 and EnerGuide: These fans, along with mechanical_supply_rate_ls determine ventilation rates and fan energy consumption.

  • Optionalmechanical_supply_rate_ls?: number

    This item will be deprecated in the future. Please use fans instead.

    For legacy reasons The behaviour of this value in HOT2000 export results in a balanced ventilation system, but in F280 it only applies to the supply side. Fans provides consistent behaviour in both environments.

    This number represents any amount of ventilation that comes out of the mechanical system itself. For example, if the mechanical system is a furnace with a fan inside it, this info does not need to go to fans. Instead, it gets specified here in litres per second.

    For F280: If this value is not provided, Properate makes its best guess about the home's central ventilation configuration by looking at the fans. Then it looks at the requested supply_ls of the rooms to split the loads.

    For EnerGuide: If this value is not provided, but the building is new construction, Properate makes a best guess based on numbers derived from the Building Code.