Add NOAA GHCN API

.github/workflows/tests.yml

@@ -48,7 +48,7 @@ jobs:
       uses: actions/cache@v2
       env:
         # Increase this value to reset cache if `poetry.lock` has not changed.
-        CACHE_NUMBER: 1
+        CACHE_NUMBER: 3
       with:
         path: ${{ steps.poetry-cache-dir.outputs.dir }}
         key: poetry-${{ runner.os }}-py${{ matrix.python-version }}-${{ hashFiles('poetry.lock') }}-${{ env.CACHE_NUMBER }}

CHANGELOG.rst

@@ -4,6 +4,8 @@ Changelog
 Development
 ***********
 
+- Add NOAA GHCN API
+
 0.23.0 (21.11.2021)
 *******************
 

docs/data/coverage/dwd.rst

@@ -35,7 +35,7 @@ stations in Germany according to the report referenced above. The amount of stat
 that cover a specific parameter may differ strongly, so don't expect the amount of data
 to be that generous for all the parameters.
 
-Available dataa/parameters on the file server is sorted in different time resolutions:
+Available data/parameters on the file server is sorted in different time resolutions:
 
 - **1_minute** - measured every minute
 - **10_minutes** - measured every 10 minutes

docs/data/coverage/noaa.rst

@@ -0,0 +1,33 @@
+NOAA (National Oceanic and Atmospheric Administration)
+******************************************************
+
+Global Historical Climatology Network
+=====================================
+
+Overview
+________
+
+NOAA Global Historical Climatology Network is a collection of **hourly** weather data put together from multiple weather
+services around the world, even those where at this moment no data is publicly offered. Resolution is fixed on hourly,
+because this is the most common and maintainable resolution with most observations practiced all over the world.
+
+.. ipython:: python
+
+    from wetterdienst.provider.noaa.ghcn import NoaaGhcnRequest
+
+    meta = NoaaGhcnRequest.discover(flatten=False)
+
+    # Selection of daily historical data
+    print(meta)
+
+Special Parameters
+__________________
+
+The dataset originally doesn't contain **average daily temperature**, which is why this data is calculated by
+wetterdienst with
+
+.. math::
+
+    tmean = (tmax + tmin) / 2
+
+so those values are not actually averages but means.

docs/data/license/noaa.rst

@@ -0,0 +1,10 @@
+NOAA (National Oceanic and Atmospheric Administration)
+******************************************************
+
+Global Historical Climatology Network
+=====================================
+
+The NOAA GHCN incorporates data of multiple weather services across the globe. The `NOAA GHCN description`_ page
+includes more information on the usage, references, qualities etc.
+
+.. _NOAA GHCN description: https://www.ncei.noaa.gov/access/metadata/landing-page/bin/iso?id=gov.noaa.ncdc:C00861