393 files

custom_components/maintenance_supporter/data/climate/README.md

@@ -0,0 +1,23 @@
+# Climate grids
+
+Two small, zlib-compressed rasters the integration uses to describe the home's
+climate (Settings → Home profile, template recommendations). They are read with
+the Python standard library only — see `helpers/climate.py` for the format.
+
+| File | Content | Resolution |
+|---|---|---|
+| `koppen_0p5.bin` | Köppen-Geiger climate class 1991–2020 (1–30, 0 = water) | 0.5° |
+| `temp_1p0.bin` | Coldest and warmest monthly mean air temperature 1991–2020 (°C) | 1° |
+
+Built by `scripts/build_climate_grids.py` from:
+
+> Beck, H. E., T. R. McVicar, N. Vergopolan, A. Berg, N. J. Lutsko, A. Dufour,
+> Z. Zeng, X. Jiang, A. I. J. M. van Dijk, and D. G. Miralles. High-resolution
+> (1 km) Köppen-Geiger maps for 1901–2099 based on constrained CMIP6
+> projections. *Scientific Data* 10, 724 (2023).
+> https://www.gloh2o.org/koppen/
+
+The source data is licensed under
+[Creative Commons Attribution 4.0 International (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/).
+These files are derived from it (resampled class grid; coldest/warmest monthly
+means rounded to whole degrees).

custom_components/maintenance_supporter/data/regions/README.md

@@ -0,0 +1,19 @@
+# Region grid
+
+One small, zlib-compressed raster the integration uses to find the state,
+province or region the home is in (Settings → Home profile). Some template
+rules differ below the country — New York inspects cars every year, Florida
+not at all; Flanders tests them every two years, Wallonia every year — and
+the templates follow the home's region where they name one. It is read with
+the Python standard library only — see `helpers/region.py` for the format.
+
+| File | Content | Resolution |
+|---|---|---|
+| `regions.bin` | First-level subdivisions (ISO 3166-2) of the US, Canada, Australia, Austria, Belgium (its three regions), Italy (its regions) and the UK (its four nations) | 0.1°, 0.01° where a cell is shared by two regions |
+
+Only the location configured in Home Assistant is looked up, locally; the
+*State, province or region* setting overrides the result.
+
+Built by `scripts/build_region_grid.py` from Natural Earth's 1:10m
+*Admin 1 – States, Provinces* map (https://www.naturalearthdata.com/), which is
+in the public domain (https://www.naturalearthdata.com/about/terms-of-use/).