Add implementation for IMGW observation

CHANGELOG.rst

@@ -5,6 +5,9 @@ Development
 ***********
 
 - Add retry to functions
+- Add IMGW Hydrology API
+- Add IMGW Meteorology API
+- Rename FLOW to DISCHARGE and WATER_LEVEL to STAGE everywhere
 
 0.57.1 (28.06.2023)
 *******************

README.rst

@@ -183,6 +183,14 @@ Geosphere (Geosphere Austria, formerly Central Institution for Meteorology and G
     - Observation
         - historical meteorological data of Austrian stations
 
+IMGW (Institute of Meteorology and Water Management)
+    - Meteorology
+        - meteorological data of polish weather stations
+        - daily and monthly summaries
+    - Hydrology
+        - hydrological data of polish river stations
+        - daily and monthly summaries
+
 To get better insight on which data we have currently made available and under which
 license those are published take a look at the data_ section.
 

docs/data/coverage/imgw.rst

@@ -0,0 +1,21 @@
+IMGW
+####
+
+Polish meteorological/hydrological data
+
+Overview
+********
+
+License
+*******
+
+Declaration of availability at https://imgw.pl/deklaracja-dostepnosci
+
+Products
+********
+
+.. toctree::
+   :maxdepth: 1
+
+   imgw/meteorology
+   imgw/hydrology

docs/data/coverage/imgw/hydrology.rst

@@ -0,0 +1,14 @@
+Hydrology
+#########
+
+Overview
+********
+
+Structure
+*********
+
+.. toctree::
+   :maxdepth: 1
+
+   hydrology/daily
+   hydrology/monthly

docs/data/coverage/imgw/hydrology/daily.rst

@@ -0,0 +1,115 @@
+Daily
+#####
+
+----
+
+Metadata
+********
+
+.. list-table::
+   :widths: 20 80
+   :stub-columns: 1
+
+   * - original name
+     - missing
+   * - url
+     - `daily dataset`_
+
+.. _daily dataset: https://danepubliczne.imgw.pl/data/dane_pomiarowo_obserwacyjne/dane_hydrologiczne/dobowe/
+
+----
+
+Datasets
+********
+
+----
+
+Hydrology
+=========
+
+----
+
+Metadata
+--------
+
+.. list-table::
+   :widths: 20 80
+   :stub-columns: 1
+
+   * - original name
+     - klimat
+   * - url
+     - `daily climate dataset`_
+   * - description file
+     - 
+   * - description
+     - historical daily climate data
+
+.. _daily climate dataset: https://danepubliczne.imgw.pl/data/dane_pomiarowo_obserwacyjne/dane_hydrologiczne/dobowe/
+
+----
+
+Parameters
+----------
+
+----
+
+discharge
+^^^^^^^^^
+
+.. list-table::
+   :widths: 20 80
+   :stub-columns: 1
+
+   * - original name
+     - przepływ
+   * - description file
+     -
+   * - description
+     -
+   * - origin unit
+     - :math:`m^{3} / s`
+   * - SI unit
+     - :math:`m^{3} / s`
+   * - constraints
+     - :math:`\geq{0}`
+
+temperature_water
+^^^^^^^^^^^^^^^^^
+
+.. list-table::
+   :widths: 20 80
+   :stub-columns: 1
+
+   * - original name
+     - temperatura wody
+   * - description file
+     -
+   * - description
+     -
+   * - origin unit
+     - :math:`°C`
+   * - SI unit
+     - :math:`K`
+   * - constraints
+     - :math:`None`
+
+stage
+^^^^^
+
+.. list-table::
+   :widths: 20 80
+   :stub-columns: 1
+
+   * - original name
+     - stan wody
+   * - description file
+     -
+   * - description
+     -
+   * - origin unit
+     - :math:`cm`
+   * - SI unit
+     - :math:`m`
+   * - constraints
+     - :math:`None`