Installation Profiles
Installation Profiles
This document describes the Installation Profile specifications required for the Monthly - Home Energy Reports tier.
Installation Profiles provide additional information regarding:
the installation characteristics
household demographics
appliance ownership
appliance-specific metadata
Profile Usage
Installation Profiles are used by NET2GRID EnergyAI® to improve:
disaggregation accuracy
appliance detection
peer comparison quality
insights relevance
recommendation quality
Providing more complete and accurate profile information generally improves the quality of downstream analytics.
Default Profile Behavior
In many cases, the customer may not have complete information regarding a user installation.
To accommodate this, NET2GRID EnergyAI® supports an optional Default Profile mechanism.
Default Profile Rules
If no installation-specific profile exists, the default profile is used entirely.
If the installation profile is partial, missing values may be inherited from the default profile.
If the installation profile is complete, only the installation profile is used.
This inheritance mechanism ensures that NET2GRID EnergyAI® always has a coherent profile structure available for analytics processing.
The default profile functionality is optional (by default enabled) and it should be provided per label partner.
Missing vs Explicit Values
NET2GRID EnergyAI® distinguishes between:
Missing attribute
The value is unknown
Explicit value (0, false)
The appliance or attribute is explicitly declared as non-existing
Example:
means:
the installation explicitly declares that no electric vehicle exists.
While:
means:
the electric vehicle information is unknown.
This distinction is important for:
suggested profile correction reports
disaggregation optimization
downstream analytics
Appliance Count Semantics
Values under the appliances object represent the number of appliances present in the installation.
0
Appliance explicitly does not exist
1+
Number of appliances present
Missing attribute
Unknown appliance status
Multiple-Value Attributes
Some profile attributes support multiple values.
These values must be provided as comma-separated strings.
Example:
Supported multi-value attributes include:
spaceHeatingTypespaceCoolingTypewaterHeatingType
Profile Update Behavior
Profiles may be updated by uploading a new profile file for the same installation.
The latest uploaded profile replaces the previously stored profile for the installation.
Partial profile updates are not supported. All the profile attributes should be provided in the new profile.
Profile Validation
Uploaded profile files are validated before being accepted.
Validation may include checks such as:
valid JSON structure
supported attribute names
supported attribute values
valid country codes
valid timezone values
valid appliance counts
Invalid attributes may be ignored or rejected depending on the validation severity.
Recommended Minimum Profile Attributes
Although all profile attributes are optional, the following attributes are strongly recommended because they significantly improve analytics quality:
country
Regional analytics calibration
timezone
Correct local-day interpretation
postalCode
Peer comparison and climate estimation
Profile File Structure
Each installation profile is provided as a single JSON file.
The profile contains three main sections:
home
Household and installation metadata
appliances
Appliance ownership and quantities
applianceMetadata
Appliance-specific metadata
Filename Format
Example:
Upload Location
Profile files are uploaded through AWS S3 using the agreed bucket structure.
Path Format
JSON Structure
home
Contains household and installation metadata.
Example:
appliances
Contains appliance ownership information.
Example:
applianceMetadata
Contains metadata for specific appliance instances.
Example:
Installation Profile Attributes
Home Attributes
postalCode
The postal code of the premises.
Any valid postal code
timezone
The timezone of the premises.
Any valid timezone
country
The country in which the premises are located.
ISO 3166 alpha-2 country code
propertyType
Describes the layout of the premises.
detached, semi-detached, bungalow, terraced, end-terrace, flat
numBedrooms
The number of bedrooms on the premises.
1, 2, 3, 4
numOccupants
Indicates the number of people living on the premises.
1, 2, 3, 4, 5
propertyAge
Represents the period during which the premises were built.
pre-1919, 1920-1975, 1976-1999, post-2000
ownership
Defines whether the installation is owned or rented.
own, rent
occupantType
The type of people living on the premises.
students, working-adults, home-adults, young-family, older-family, retirees
spaceHeatingType
The type of space heating installed on the premises. Supports multiple comma-separated values.
gas, gas-furnace, electric-furnace, electric-storage, electric-heaters, heat-pump, hybrid-heat-pump, air-condition, district-heating, wood-pellet, oil, solar, other
spaceCoolingType
The type of space cooling installed on the premises. Supports multiple comma-separated values.
heat-pump, air-condition, ceiling-fan, other
spaceHeatingExchangerType
The type of space heating exchanger installed on the premises.
radiators, floor
waterHeatingType
The type of water heating installed on the premises. Supports multiple comma-separated values.
gas, electric, oil, solar, other, heat-pump, hybrid-heat-pump
stoveHeatingType
The type of stove appliances installed on the premises.
gas, electric, oil, other
grillHeatingType
The type of grill appliances installed on the premises.
gas, electric, oil, other
ovenHeatingType
The type of oven appliances installed on the premises.
gas, electric, oil, other
photovoltaic
Indicates whether photovoltaic panels are installed on the premises.
true, false
Appliances Attributes
The appliances section contains the number of appliances available in the installation.
A value of:
0means the appliance is explicitly declared as non-existing1+defines the number of appliances presentmissing attribute means the appliance status is unknown
fridgeCombo
The number of fridge-freezer combo appliances on the premises.
refrigerator
The number of refrigerator appliances on the premises.
freezer
The number of freezer appliances on the premises.
hob
The number of hob appliances on the premises.
oven
The number of oven appliances on the premises.
grill
The number of grill appliances on the premises.
microwave
The number of microwave appliances on the premises.
kettle
The number of kettle appliances on the premises.
toaster
The number of toaster appliances on the premises.
dishWasher
The number of dishwasher appliances on the premises.
washingMachine
The number of washing machine appliances on the premises.
tumbleDryer
The number of tumble dryer appliances on the premises.
iron
The number of iron appliances on the premises.
TV
The number of TV appliances on the premises.
dvd
The number of DVD appliances on the premises.
cableBox
The number of cable box appliances on the premises.
gameConsole
The number of game console appliances on the premises.
computer
The number of computer appliances on the premises.
tablet
The number of tablet appliances on the premises.
electricVehicle
The number of electric vehicle appliances on the premises.
electricShower
The number of electric shower appliances on the premises.
immersionHeater
The number of immersion heater appliances on the premises.
airCondition
The number of air conditioner appliances on the premises.
poolPump
The number of pool pump appliances on the premises.
sauna
The number of sauna appliances on the premises.
infraredPanels
The number of infrared panel appliances on the premises.
closeInBoiler
The number of close-in boiler appliances on the premises.
instantBoilingWaterTap
The number of instant boiling water tap appliances on the premises.
batteryEnergyStorageSystem
The number of battery energy storage system appliances on the premises.
heatPump
The number of heat pump appliances on the premises.
dehumidifier
The number of dehumidifier appliances on the premises.
hotTub
The number of hot tub appliances on the premises.
Appliance Metadata Attributes
fuelType
tumbleDryer, hotTub
Defines the fuel type of the appliance.
gas, electric
hotFill
washingMachine, dishWasher
Defines whether the appliance supports hot-fill water input.
true, false
Default Values
fuelType
electric
hotFill
false
Installation Profile Example
Last updated
Was this helpful?

