# Event Types

Every event that occurs on a sensor or actor within a building can be seen as a [change of a state](https://content.iospress.com/download/journal-of-ambient-intelligence-and-smart-environments/ais242?id=journal-of-ambient-intelligence-and-smart-environments%2Fais242). Every event sent to the Recommender Platform needs to describe for which type of state it is sent.

Below you can find a [#list-of-customer-provided-types](#list-of-customer-provided-types "mention")[ ](#list-of-types)the Recommender Platform can receive from your environment.

The [#list-of-moost-provided-types](#list-of-moost-provided-types "mention") contains state types of events that are generated by context services that are part of the Recommender Platform.

## List of Customer Provided Types

<table data-full-width="true"><thead><tr><th width="367">State Type</th><th width="73">Unit</th><th width="126">Interval</th><th width="161">Device Type</th><th>Description</th></tr></thead><tbody><tr><td>CHARGING_MODE</td><td>ID<br>[0..7]</td><td>Each time the value changes</td><td>CAR_CHARGER<br>WATER_HEATER<br>HEAT_PUMP<br>BATTERY<br>SMART_PLUG</td><td>The current charging mode of a device. <br>See <a data-mention href="event-types/charging-modes">charging-modes</a></td></tr><tr><td>DEVICE_STATUS</td><td>ID<br>[-1..4]</td><td>Each time the value changes</td><td>ALL</td><td>The state of a device<br>See <a data-mention href="event-types/device-status">device-status</a></td></tr><tr><td>ENERGY_CONSUMPTION</td><td>Wh</td><td>Every 15min</td><td>ALL</td><td>The energy consumption of the last time interval that has occurred.</td></tr><tr><td>ENERGY_CONSUMPTION_LAST_24H</td><td>Wh</td><td>Once a day</td><td>GATEWAY</td><td>The energy consumed over the last 24 Hours at the time the event is created.</td></tr><tr><td>ENERGY_CONSUMPTION_YESTERDAY</td><td>Wh</td><td>Once a day</td><td>ALL</td><td>The energy consumed on the previous calendar day.</td></tr><tr><td>ENERGY_EXCESS_LAST_24H</td><td>Wh</td><td>Once a day</td><td>GATEWAY</td><td>The energy excess over the last 24 Hours at the time the event is created.</td></tr><tr><td>ENERGY_EXCESS_YESTERDAY</td><td>Wh</td><td>Once a day</td><td>GATEWAY</td><td>The energy excess on the previous calendar day.</td></tr><tr><td>ENERGY_GENERATION</td><td>Wh</td><td>Every 15min</td><td>GATEWAY</td><td>The energy generation of the last time interval that has occurred.</td></tr><tr><td>ENERGY_GENERATION_LAST_24H</td><td>Wh</td><td>Once a day</td><td>GATEWAY</td><td>The energy generated over the last 24 hours.</td></tr><tr><td>ENERGY_GENERATION_YESTERDAY</td><td>Wh</td><td>Once a day</td><td>GATEWAY</td><td>The energy generated on the previous calendar day.</td></tr><tr><td>ENERGY_IMPORT</td><td>Wh</td><td>Every 15min</td><td>BATTERY</td><td>The energy used to load a battery over the last 30 minutes at the time the event is created.</td></tr><tr><td>ENERGY_IMPORT_YESTERDAY</td><td>Wh</td><td>Once a day</td><td>BATTERY</td><td>The energy used to load a battery on the previous calendar day.</td></tr><tr><td>ENERGY_EXCESS</td><td>Wh</td><td>Every 30min</td><td>GATEWAY</td><td>The energy excess of the last time interval that has occurred.</td></tr><tr><td>ENERGY_EXPORT</td><td>Wh</td><td>Every 30min</td><td>BATTERY</td><td>The energy used from a battery over the  last 30 minutes at the time the event is created.</td></tr><tr><td>ENERGY_EXPORT_YESTERDAY</td><td>Wh</td><td>Once a day</td><td>BATTERY</td><td>The energy used from a battery on the previous calendar day.</td></tr><tr><td>GRID_ENERGY_CONSUMPTION</td><td>Wh</td><td>Every 15min</td><td>GATEWAY</td><td>The energy consumption from the grid of the last time interval that has occurred.</td></tr><tr><td>GRID_ENERGY_CONSUMPTION_YESTERDAY</td><td>Wh</td><td>Once a day</td><td>GATEWAY</td><td>The energy consumption from the grid of the previous day.</td></tr><tr><td>GRID_POWER_CONSUMPTION</td><td>W</td><td>Every 15min</td><td>GATEWAY</td><td>The current power consumed from the grid at the time the event is created.</td></tr><tr><td>POWER_CONSUMPTION</td><td>W</td><td>Every 15min</td><td>ALL</td><td>The current power consumed at the time the event is created.</td></tr><tr><td>POWER_EXCESS</td><td>W</td><td>Every 15min</td><td>GATEWAY</td><td>The current power excess at the time the event is created.</td></tr><tr><td>POWER_GENERATION</td><td>W</td><td>Every 15min</td><td>GATEWAY</td><td>The current power generated at the time the event is created.</td></tr><tr><td>SELF_CONSUMPTION_RATE</td><td>%</td><td>Every 15min</td><td>GATEWAY</td><td>The current self-consumption rate in percent</td></tr><tr><td>SELF_CONSUMPTION_RATE_YESTERDAY</td><td>%</td><td>Once a day</td><td>GATEWAY</td><td>The self-consumption rate in percent on the previous calendar day.</td></tr><tr><td>SELF_SUFFICIENCY_RATE</td><td>%</td><td>Every 15min</td><td>GATEWAY</td><td>The current self sufficiency rate in percent.</td></tr><tr><td>SELF_SUFFICIENCY_RATE_YESTERDAY</td><td>%</td><td>Once a day</td><td>GATEWAY</td><td>The self sufficiency rate in percent on the previous calendar day.</td></tr><tr><td>STATE_OF_CHARGE_FORECAST_RATE</td><td>%</td><td>Once a day</td><td>CAR<br>CAR_CHARGER</td><td>The target state of charge with the forecast time, when this should be reached.</td></tr><tr><td>STATE_OF_CHARGE_RATE</td><td>%</td><td>Each time the value changes</td><td>CAR</td><td>The current state of charge, expressed as a percentage of the total capacity relative to the current charge level.</td></tr><tr><td>SWITCH_STATE</td><td>ID</td><td>Each time the value changes</td><td>SMART_PLUG<br>CAR_CHARGER<br>SWITCH</td><td>Connection state of a switch.<br>See <a data-mention href="event-types/switch-state">switch-state</a></td></tr><tr><td>WATER_TEMPERATURE</td><td>°C</td><td>Every 15min</td><td>HEAT_PUMP<br>WATER_HEATER</td><td>The current temperature of the water measured by the given device.</td></tr></tbody></table>

<figure><img src="https://2791588365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkz3AVy8mukfhOsBy0Lvo%2Fuploads%2FTGV21xrKPGOO9ZtUix5c%2FEnergyFlowNaming.png?alt=media&#x26;token=5c5759e7-93bd-4eef-ab1b-9a1dc9cd95e9" alt=""><figcaption></figcaption></figure>

## List of MOOST Provided Types

The Recommender Platform offers multiple context services. These context services generate additional events of state types which can be used within the Recommender Platform without the need to be provided by you. The current context events available on the Recommender Platform are the following.

<table data-full-width="true"><thead><tr><th width="380">State Type</th><th width="75">Unit</th><th width="154">Interval</th><th width="132">Device Type</th><th>Description</th></tr></thead><tbody><tr><td>DYNAMIC_TARIFF_LOWEST_PRICE_FORECAST_TOMORROW</td><td><br>currency</td><td>Once a day</td><td>MOOST</td><td>The lowest tariff price of the next day of a building with dynamic pricing.<br>Remark: the currency and tariff plan for the next day has to be applied to the building data.</td></tr><tr><td>DYNAMIC_TARIFF_PRICE</td><td>currency</td><td>Every 30min</td><td>MOOST</td><td>The current tariff price of a building with dynamic pricing.<br>Remark: the currency and tariff plan for the next day has to be applied to the building data.</td></tr><tr><td>DYNAMIC_TARIFF_PRICE_FORECAST_1H</td><td>currency</td><td>Every 30min</td><td>MOOST</td><td>The tariff price of next hour of a building with dynamic pricing.</td></tr><tr><td>ENERGY_BASE_CONSUMPTION</td><td>Wh</td><td>Once a day</td><td>MOOST</td><td>This value is calculated out of the energy consumption data of the last view days.</td></tr><tr><td>ENERGY_CONSUMPTION_FORECAST_1H</td><td>Wh</td><td>Every hour</td><td>MOOST</td><td>The expected energy consumption of a building in the next hour during 1h</td></tr><tr><td>ENERGY_CONSUMPTION_FORECAST_24H</td><td>Wh</td><td>Every hour</td><td>MOOST</td><td>The expected energy consumption of a building in the next hour during 1h.</td></tr><tr><td>ENERGY_GENERATION_FORECAST_1H</td><td>Wh</td><td>Every hour</td><td>MOOST</td><td>The expected energy generation of a building in the next hour.</td></tr><tr><td>ENERGY_GENERATION_FORECAST_24H</td><td>Wh</td><td>Every hour</td><td>MOOST</td><td>The expected energy generation of a building in the next hour during 1h.</td></tr><tr><td>EXPECTED_OUTSIDE_TEMPERATURE</td><td>°C</td><td>Once a day</td><td>MOOST</td><td>The expected outside temperature on the location of a given building for the next calendar day.</td></tr><tr><td>EXPECTED_OUTSIDE_TEMPERATURE_4DAYS</td><td>°C</td><td>Once a day</td><td>MOOST</td><td>The expected outside temperature on the location of a given building in 4 days.</td></tr><tr><td>GRID_ENERGY_CONSUMPTION_ANOMALY_SCORE</td><td><p></p><p>Score</p></td><td>Calculated for <br>every incoming GRID_ENERGY_CONSUMPTION event</td><td>MOOST</td><td>A numerical value indicating the likelihood of an anomaly in grid energy consumption for a given building. This score is calculated using historical energy consumption data and patterns and ranges, with higher scores representing a greater probability of a consumption anomaly.</td></tr><tr><td>GRID_POWER_CONSUMPTION_ANOMALY_SCORE</td><td><p></p><p>Score</p></td><td>Calculated for <br>every incoming GRID_POWER_CONSUMPTION event</td><td>MOOST</td><td>A numerical value indicating the likelihood of an anomaly in grid power consumption for a given building. This score is calculated using historical power consumption data and patterns and ranges, with higher scores representing a greater probability of a consumption anomaly.</td></tr><tr><td>POWER_CONSUMPTION_BASE_LOAD</td><td>W</td><td>Once a day</td><td>MOOST</td><td>The base consumption of the household. <br>This value is calculated out of the power consumption data of the last view days.</td></tr><tr><td>POWER_CONSUMPTION_FORECAST_1H</td><td>W</td><td>Every hour</td><td>MOOST</td><td>The expected power consumption of a building in the next hour.</td></tr><tr><td>POWER_CONSUMPTION_FORECAST_24H</td><td>W</td><td>Every hour</td><td>MOOST</td><td>The expected power consumption of a building in 24 hours.</td></tr><tr><td>POWER_GENERATION_FORECAST_1H</td><td>W</td><td>Every hour</td><td>MOOST</td><td>The expected power generated in the next hour.</td></tr><tr><td>POWER_GENERATION_FORECAST_24H</td><td>W</td><td>Every hour</td><td>MOOST</td><td>The expected power generated in the next 24 hours.</td></tr><tr><td>POWER_GENERATION_FORECAST_48H</td><td>W</td><td>Every hour</td><td>MOOST</td><td>The expected power generated in the next 48 hours.</td></tr><tr><td>IS_LOW_TARIFF_HOURS</td><td>[0, 1]</td><td>Every 30min</td><td>MOOST</td><td>Is "1" if given building has currently low tariff.<br>Remark: if building has dynamic pricing, then is is set to "1" if current price is in the lower 25% band.</td></tr><tr><td>IS_HIGH_TARIFF_HOURS</td><td>[0, 1]</td><td>Every 30min</td><td>MOOST</td><td>Is "1" if given building has currently high tariff.<br>Remark: if building has dynamic pricing, then is is set to "1" if current price is in the upper 25% band.</td></tr></tbody></table>
