import data

fix CI

disable pytest

fix CI

do not treat warnings as errors

Configure PROJ environment for pyproj usage

Author: kmuehlbauer

.github/workflows/ci-docs.yml

@@ -14,35 +14,36 @@ jobs:
       fail-fast: false
       matrix:
         python-version: [ "3.13" ]
+    defaults:
+      run:
+        shell: bash -l {0}
     env:
-      WRADLIB_DATA: ./wradlib-data
       CONDA_ENV_FILE: environment.yml
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
-
       - name: Install micromamba environment
         uses: mamba-org/setup-micromamba@v2
         with:
-          environment-name: radolan-guide-guide
+          environment-name: radolan-guide
           environment-file: environment.yml
           cache-environment: true
           cache-environment-key: "${{runner.os}}-${{runner.arch}}-py${{env.PYTHON_VERSION}}-${{env.TODAY}}-${{hashFiles(env.CONDA_ENV_FILE)}}"
           create-args: >-
             python=${{matrix.python-version}}
 
-      - name: Render with pytest
-        run: |
-          pytest -v sphinx-build -b html -W . _build/html
-
-      - name: Build Sphinx documentation
+      - name: pytest notebooks
         working-directory: notebooks
         run: |
           pytest -v -n auto
 
+      - name: Build documentation with Sphinx
+        run: |
+          python -m sphinx -j 14 -b html . _build/html -v
+
       - name: Upload HTML build (for PR inspection)
         if: ${{ success() }}
         uses: actions/upload-artifact@v4
         with:
           name: docs-html
-          path: docs/_build/html
+          path: _build/html

conf.py

@@ -6,6 +6,12 @@
 import os
 import sys
 
+import pyproj
+
+# set PROJ_LIB explicitely to overcome RTD issue
+os.environ["PROJ_LIB"] = pyproj.datadir.get_data_dir()
+os.environ["PROJ_NETWORK"] = "ON"
+
 sys.path.insert(0, os.path.abspath(".."))
 
 project = "RADOLAN Guide"

data/ATTRIBUTION.md

@@ -0,0 +1 @@
+PROJCS["Radolan_Projection",GEOGCS["GCS_Radolan_Coordinate_System",DATUM["D_Radolan_Kugel",SPHEROID["Erdkugel",6370040.0,0.0]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]],PROJECTION["Stereographic_North_Pole"],PARAMETER["False_Easting",0.0],PARAMETER["False_Northing",0.0],PARAMETER["Central_Meridian",10.0],PARAMETER["Standard_Parallel_1",60.0],UNIT["kilometre",1000.0]]

data/asc/RW-20221018.tar.gz

@@ -0,0 +1 @@
+PROJCS["Radolan projection",GEOGCS["Radolan Coordinate System",DATUM["Radolan Kugel",SPHEROID["Erdkugel",6370040.0,0.0]],PRIMEM["Greenwich",0.0,AUTHORITY["EPSG","8901"]],UNIT["degree",0.017453292519943295],AXIS["Longitude",EAST],AXIS["Latitude",NORTH]],PROJECTION["polar_stereographic"],PARAMETER["central_meridian",10.0],PARAMETER["latitude_of_origin",60.0],PARAMETER["scale_factor",0.9330127019],PARAMETER["false_easting",0.0],PARAMETER["false_northing",0.0],UNIT["m*1000.0",1000.0],AXIS["X",EAST],AXIS["Y",NORTH]]