Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Ernst79 authored Jan 17, 2024
1 parent f24764a commit 4cea9ea
Showing 1 changed file with 13 additions and 13 deletions.
26 changes: 13 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Degree days integration for Home Assistant based on KNMI weather station data (the Netherlands) and your current gas consumption this year.

This integration will collect daily averaged temperatures of the last year from a KNMI weather station and will calculate the total number of (weighted) degree days this year (similar as is done on the [mindergas website](www.mindergas.nl)). Based on this information and input from your gas consumption so far this year, it will estimate the gas consumption for the entire year and will determine the gas consumption per weighted degree day, which can be used for comparison with other years or other houses.
This integration will collect daily averaged temperatures of the last year from a KNMI weather station and will calculate the total number of (weighted) degree days this year (similar as is done on the [mindergas website](https://www.mindergas.nl)). Based on this information and input from your gas/heatpump consumption so far this year, it will estimate the gas/energy consumption for the entire year and will determine the gas/energy consumption per weighted degree day, which can be used for comparison with other years or other houses.

## (Weighted) degree days
For more information on degree days and its use, have a look at the website [Degree Days.net](https://www.degreedays.net/) (English) or [Mindergas](https://mindergas.nl/degree_days/explanation) (Dutch).
Expand All @@ -13,18 +13,18 @@ In the current implementation, we follow the approach of Mindergas. Weighted deg
- March and October: 1,0
- November till Februari: 1,1

## Gas prognose and comparison
## Gas/energy prognose and comparison

You can add a gas sensor to calculate the gas consumption per weighted degree day from the start of the year, which can be used to compare your gas consumption with other users or previous years. Comparison based on gas consumption per weighted degree day corrects for effects of a cold or warm, which gives you a better insight into the effect of e.g. insulation or change in the number of family members, on your gas consumption. The integration will also calculate a prognose for the gas consumption for the current year.
You can add a gas or energy sensor to calculate the consumption per weighted degree day from the start of the year, which can be used to compare your consumption with other users or previous years. Comparison based on consumption per weighted degree day corrects for effects of a cold or warm, which gives you a better insight into the effect of e.g. insulation or change in the number of family members, on your gas/energy consumption. The integration will also calculate a prognose for the gas/energy consumption for the current year.

## How to install

1. Make sure you have [hacs](https://hacs.xyz/) installed.
2. Add this repository as custom repository to hacs by going to hacs, integrations, click on the three dots in the upper right corner and click on custom repositories.
3. In the repository field, fill in the link to this repository (https://github.com/Ernst79/degree-days) and for category, select `Integration`. Click on `Add`.
4. Go back to hacs, integrations and add click on the blue button `Exlore and download repositories` in the bottom left corner, search for `Degree-days` and install it.
5. Reboot HA.
6. In HA goto Config -> Integrations. Add the Degree-days integration to HA.
2. In hacs, go to integrations and click on the blue button `Exlore and download repositories` in the bottom left corner, search for `Degree-days` and install it.
3. Reboot HA.
4. In HA go to Config -> Integrations. Add the Degree-days integration to HA.
5. select your weather station and add your gas/heatpump sensor and check the other settings.
6. click submit.
7. In your lovelace dashboard, add a card with the degree days entities.

## Options
Expand All @@ -41,23 +41,23 @@ Estimated daily mean indoor temperature during day and night, averaged over one

**Heating temperature limit**

In the spring and autumn, the heating will not always be turned on directly, even if the daily mean outdoor temperature is below the daily mean indoor temperature. Buildings will collect heat during hot periods in e.g. concrete walls, which is released gradually, preventing the heating to turn on. By setting a different heating temperature limit (e.g. 15,5°C), degree days will only be counted if the daily mean outdoor temperature is lower than this heating temperature limit. A lower value for the heating temperature will increase the gas consumption per degree day in the spring and autumn.
In the spring and autumn, the heating will not always be turned on directly, even if the daily mean outdoor temperature is below the daily mean indoor temperature. Buildings will collect heat during hot periods in e.g. concrete walls, which is released gradually, preventing the heating to turn on. By setting a different heating temperature limit (e.g. 15,5°C), degree days will only be counted if the daily mean outdoor temperature is lower than this heating temperature limit. A lower value for the heating temperature will increase the gas/energy consumption per degree day in the spring and autumn.

**Startday for sum of total degree days**

Day of the month from which the yearly totals are computed. When used in combination with a gas sensor, this has to be the same day as the total gas consumption is determined from. E.g. if your gas sensor reports the total gas consumption starting at the 14th of February, set the Startday for the sum of total degree days to the 14th.
Day of the month from which the yearly totals are computed. When used in combination with a gas/energy sensor, this has to be the same day as the total consumption is determined from. E.g. if your gas sensor reports the total gas consumption starting at the 14th of February, set the Startday for the sum of total degree days to the 14th.

**Startmonth for sum of total degree days**

Month from which the yearly totals are computed. When used in combination with a gas sensor, this has to be the same month as the total gas consumption is determined from. E.g. if your gas sensor reports the total gas consumption starting at the 14th of February, set the Startmonth for the sum of total degree days to the February.
Month from which the yearly totals are computed. When used in combination with a gas/energy sensor, this has to be the same month as the total consumption is determined from. E.g. if your gas sensor reports the total gas consumption starting at the 14th of February, set the Startmonth for the sum of total degree days to the February.

**Gas/Energy sensor entity**

Gas/Energy sensor entity with the total consumption of gas in m3 or Energy in kWh, starting at the set Startday and Startmonth of the current year.
Gas/Energy sensor entity with the total consumption of gas in m3 or Energy in kWh, starting at the set Startday and Startmonth of the current year. You may have to use a utility_meter helper in Home Assistant to determine that data.

**Monthly gas/energy usage for shower, bath and cooking**

Monthly gasenergy usage for shower, bath and cooking. This will be subtracted from your gas consumption, before calculating the gas usage per weighted degree day.
Monthly gasenergy usage for shower, bath and cooking. This will be subtracted from your gas consumption, before calculating the gas/energy usage per weighted degree day.

**Heatpump/Electric heating**

Expand Down

0 comments on commit 4cea9ea

Please sign in to comment.