Appliance Efficiency
The monthly Appliance Efficiencies reports are a newly added feature and an essential aspect of the NET2GRID service for comprehending one’s installation consumption behavior.
It is essential to understand that the end customers’ behavior may be the reason for increased daily/monthly consumption due to their consumption behavior. But, another factor plays a vital role in this quest for energy consumption reduction. If, for example, the Washing Machine appliance installed within a household is old and energy inefficient, changing one's behavior will not solve the problem at its root.
To this end, to ensure that end customers’ convenience sacrifices are fruitful, it should ensure that their electrical appliances are also efficient (manufactured). This service will provide a win/win situation to both energy retailing companies and end users: retail energy companies will be able to inform their end-customers when it is time /good to change their electrical appliances due to their inefficiency. In contrast, the end customers will be able to ensure that they are using the appropriate equipment or change them when the time is right (saving money on the process).
For each month, the end-users are provided with a table - regarding each appliance - that will have info about the appliance usage frequency (number of end uses and average energy consumption during the past 30 days), the average temperature, and the average duration.
Currently, four different approaches are implemented in NET2GRID service; each one will create another set of thresholds that will provide insight for (in)efficient appliances. These are:
- EU Policies for Appliance Energy Efficiency Classes: This dataset contains the policies and directives of the EU as far as the Appliance Energy Classes are concerned, meaning the official labeling of the Energy Class for each appliance.
- NET2GRID Dataset Appliance Energy Efficiency Classes: this dataset contains statistics based on the NET2GRID extended appliance ground truth dataset. It primarily contains new appliances installed in Swedish, Dutch, and German households.
- Platform Dataset Appliance Energy Efficiency Classes: This dataset contains the Appliance Energy Efficiency results extracted from the largest NET2GRID Platforms, based on the Appliance Events extracted from the previous years.
- Historical Information for Appliance Energy Efficiency Classes
It should be noted that there may also be more approaches in the future. The concept is to calculate all the thresholds for the approaches provided and then utilize weights to make this service Platform specific.
Fetching Appliance Efficiency for the requested month
The Get monthly appliance efficiency CE API endpoint allows developers to retrieve the insights for a specific month. The insights details can then be used within the customer's solution.
A pseudo-code request to the Get monthly appliance efficiency endpoint looks like this:
GET /v2/insights/{year}/{month}
Authorization: Bearer <access_token>
A successful request will return a response similar to the following:
{
"status": "ok",
"data": {
"alwaysOn": {
"peer": {
"total": {
"status": "6",
"relevance": 1,
"is_positive": true,
"benchmark": 52,
"usage": 84,
"delta_kwh": 31,
"delta_perc": 60,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
},
"self": {
"total": {
"status": "3",
"relevance": 0,
"is_positive": false,
"benchmark": 86,
"usage": 84,
"delta_kwh": -1,
"delta_perc": -2,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
}
},
"cooking": {
"peer": {
"total": {
"status": "1",
"relevance": 0,
"is_positive": false,
"benchmark": 1,
"usage": 1,
"delta_kwh": 0,
"delta_perc": -24,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
},
"self": {
"total": {
"status": "1",
"relevance": 0,
"is_positive": false,
"benchmark": 1,
"usage": 1,
"delta_kwh": 0,
"delta_perc": -16,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
}
},
"dishWasher": {
"peer": {
"total": {
"status": "6",
"relevance": 1,
"is_positive": true,
"benchmark": 11,
"usage": 25,
"delta_kwh": 13,
"delta_perc": 112,
"last_updated": "2022-12-01T06:03:54+01:00",
"overall_efficiency_score": 100,
"appliance_efficiency_score": 50,
"usage_efficiency_score": 150,
"overall_eei": 89,
"frequency": 27,
"mean_energy": 0.969,
"mode_temperature": 2,
"mean_duration": 5617,
"recommendations": []
}
},
"self": {
"total": {
"status": "2",
"relevance": 0,
"is_positive": false,
"benchmark": 27,
"usage": 25,
"delta_kwh": -2,
"delta_perc": -9,
"last_updated": "2022-12-01T06:03:54+01:00",
"overall_efficiency_score": 100,
"appliance_efficiency_score": 50,
"usage_efficiency_score": 150,
"overall_eei": 89,
"frequency": 27,
"mean_energy": 0.969,
"mode_temperature": 2,
"mean_duration": 5617,
"recommendations": []
}
}
},
"entertainment": {
"peer": {
"total": {
"status": "5",
"relevance": 0,
"is_positive": true,
"benchmark": 14,
"usage": 17,
"delta_kwh": 3,
"delta_perc": 20,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
},
"self": {
"total": {
"status": "5",
"relevance": 0,
"is_positive": true,
"benchmark": 14,
"usage": 17,
"delta_kwh": 3,
"delta_perc": 20,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
}
},
"nonPeakElectricityDelivered": {
"peer": {
"total": {
"status": "5",
"relevance": 0,
"is_positive": true,
"benchmark": 98,
"usage": 115,
"delta_kwh": 17,
"delta_perc": 17,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
},
"self": {
"total": {
"status": "4",
"relevance": 0,
"is_positive": true,
"benchmark": 102,
"usage": 115,
"delta_kwh": 12,
"delta_perc": 12,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
}
},
"nonPeakElectricityReturn": {
"peer": {
"total": {
"status": "2",
"relevance": 0,
"is_positive": true,
"benchmark": 13,
"usage": 11,
"delta_kwh": -1,
"delta_perc": -12,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
},
"self": {
"total": {
"status": "0",
"relevance": 1,
"is_positive": true,
"benchmark": 56,
"usage": 11,
"delta_kwh": -44,
"delta_perc": -78,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
}
},
"oven": {
"peer": {
"total": {
"status": "0",
"relevance": 1,
"is_positive": false,
"benchmark": 3,
"usage": 1,
"delta_kwh": -1,
"delta_perc": -57,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
}
},
"peakElectricityDelivered": {
"peer": {
"peak": {
"status": "4",
"relevance": 0,
"is_positive": true,
"benchmark": 126,
"usage": 138,
"delta_kwh": 12,
"delta_perc": 9,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
},
"self": {
"peak": {
"status": "6",
"relevance": 1,
"is_positive": true,
"benchmark": 88,
"usage": 138,
"delta_kwh": 50,
"delta_perc": 57,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
}
},
"peakElectricityReturn": {
"peer": {
"peak": {
"status": "2",
"relevance": 0,
"is_positive": true,
"benchmark": 35,
"usage": 32,
"delta_kwh": -2,
"delta_perc": -7,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
},
"self": {
"peak": {
"status": "0",
"relevance": 1,
"is_positive": true,
"benchmark": 96,
"usage": 32,
"delta_kwh": -63,
"delta_perc": -66,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
}
},
"refrigeration": {
"peer": {
"total": {
"status": "6",
"relevance": 0,
"is_positive": true,
"benchmark": 28,
"usage": 39,
"delta_kwh": 10,
"delta_perc": 38,
"last_updated": "2022-12-01T06:03:54+01:00",
"overall_efficiency_score": 50,
"appliance_efficiency_score": 100,
"usage_efficiency_score": 50,
"overall_eei": 11,
"frequency": 30,
"mean_energy": 1.307,
"mode_temperature": 0,
"mean_duration": 86399,
"recommendations": []
}
},
"self": {
"total": {
"status": "3",
"relevance": 0,
"is_positive": false,
"benchmark": 39,
"usage": 39,
"delta_kwh": 0,
"delta_perc": -1,
"last_updated": "2022-12-01T06:03:54+01:00",
"overall_efficiency_score": 50,
"appliance_efficiency_score": 100,
"usage_efficiency_score": 50,
"overall_eei": 11,
"frequency": 30,
"mean_energy": 1.307,
"mode_temperature": 0,
"mean_duration": 86399,
"recommendations": []
}
}
},
"solarProduction": {
"peer": {
"total": {
"status": "2",
"relevance": 0,
"is_positive": false,
"benchmark": 89,
"usage": 76,
"delta_kwh": -12,
"delta_perc": -14,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
},
"self": {
"total": {
"status": "0",
"relevance": 1,
"is_positive": false,
"benchmark": 205,
"usage": 76,
"delta_kwh": -129,
"delta_perc": -63,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
}
},
"spaceHeating": {
"peer": {
"total": {
"status": "3",
"relevance": 0,
"is_positive": true,
"benchmark": 97,
"usage": 97,
"delta_kwh": 0,
"delta_perc": 0,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
},
"self": {
"total": {
"status": "6",
"relevance": 1,
"is_positive": true,
"benchmark": 20,
"usage": 97,
"delta_kwh": 77,
"delta_perc": 377,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
}
},
"total": {
"peer": {
"total": {
"status": "2",
"relevance": 0,
"is_positive": false,
"benchmark": 119,
"usage": 110,
"delta_kwh": -8,
"delta_perc": -7,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
},
"self": {
"total": {
"status": "6",
"relevance": 1,
"is_positive": true,
"benchmark": 34,
"usage": 110,
"delta_kwh": 75,
"delta_perc": 219,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
}
},
"totalElectricity": {
"peer": {
"total": {
"status": "4",
"relevance": 0,
"is_positive": true,
"benchmark": 222,
"usage": 253,
"delta_kwh": 31,
"delta_perc": 14,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
},
"self": {
"total": {
"status": "6",
"relevance": 0,
"is_positive": true,
"benchmark": 190,
"usage": 253,
"delta_kwh": 63,
"delta_perc": 33,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
}
},
"totalElectricityReturn": {
"peer": {
"total": {
"status": "6",
"relevance": 1,
"is_positive": false,
"benchmark": 14,
"usage": 44,
"delta_kwh": 29,
"delta_perc": 205,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
},
"self": {
"total": {
"status": "0",
"relevance": 1,
"is_positive": true,
"benchmark": 152,
"usage": 44,
"delta_kwh": -108,
"delta_perc": -70,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
}
},
"washingMachine": {
"peer": {
"total": {
"status": "6",
"relevance": 1,
"is_positive": true,
"benchmark": 6,
"usage": 14,
"delta_kwh": 8,
"delta_perc": 121,
"last_updated": "2022-12-01T06:03:54+01:00",
"overall_efficiency_score": 50,
"appliance_efficiency_score": 50,
"usage_efficiency_score": 100,
"overall_eei": 137,
"frequency": 30,
"mean_energy": 0.494,
"mode_temperature": 2,
"mean_duration": 2290,
"recommendations": []
}
},
"self": {
"total": {
"status": "4",
"relevance": 0,
"is_positive": true,
"benchmark": 13,
"usage": 14,
"delta_kwh": 1,
"delta_perc": 8,
"last_updated": "2022-12-01T06:03:54+01:00",
"overall_efficiency_score": 50,
"appliance_efficiency_score": 50,
"usage_efficiency_score": 100,
"overall_eei": 137,
"frequency": 30,
"mean_energy": 0.494,
"mode_temperature": 2,
"mean_duration": 2290,
"recommendations": []
}
}
},
"waterHeating": {
"peer": {
"total": {
"status": "1",
"relevance": 0,
"is_positive": false,
"benchmark": 13,
"usage": 11,
"delta_kwh": -2,
"delta_perc": -15,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
},
"self": {
"total": {
"status": "2",
"relevance": 0,
"is_positive": false,
"benchmark": 12,
"usage": 11,
"delta_kwh": -1,
"delta_perc": -9,
"last_updated": "2022-12-01T06:03:54+01:00",
"recommendations": []
}
}
}
},
"timestamp": "2022-12-09T11:40:46+01:00"
}
As you'd probably expect, the response contains the standard JSON structure containing the status field indicating whether or not the response was successful. If successful, the data field will contain a list of appliance events for a specific day. Each message consists of the following properties:
| Field | Type | Description |
|---|---|---|
| overall_efficiency_score | Integer | The overall energy efficiency score for the appliance under examination. |
| appliance_efficiency_score | Integer | The appliance energy efficiency score for the appliance under examination. |
| usage_efficiency_score | Integer | The usage energy efficiency score for the appliance under examination. |
| overall_eei | Integer | The overall energy efficiency index for the appliance under examination |
| appliance_eei | Integer | The appliance energy efficiency index for the appliance under examination. |
| usage_eei | Integer | The usage energy efficiency index for the appliance under examination. |
| frequency | Integer | The number of end uses for the appliance under examination. |
| mean_energy | Float | The mean end uses’ energy consumption for the appliance under examination. (in kWh) |
| mode_temperature | Integer | The mode end uses’ the temperature of the appliance under examination. |
| mean_duration | Integer | The mean end uses’ duration for the appliance under examination (in seconds) |
The following image provides an overview of how this API call is used in the Ynni Mobile App.
Updated over 1 year ago