Release 0.3.0

.cruft.json

@@ -10,7 +10,7 @@
             "project_slug": "ravenpy",
             "project_short_description": "A Python wrapper to setup and run the hydrologic modelling framework Raven.",
             "pypi_username": "CSHS-CWRA",
-            "version": "0.2.3",
+            "version": "0.3.0",
             "use_pytest": "y",
             "use_pypi_deployment_with_travis": "y",
             "add_pyup_badge": "y",

HISTORY.rst

@@ -2,6 +2,16 @@
 History
 =======
 
+0.3.0
+-----
+
+* Migration and refactoring of GIS and IO utilities (`utils.py`, `utilities/gis.py`) from RavenWPS to RavenPy.
+* RavenPy can now be installed from PyPI without GIS dependencies (limited functionality).
+* Hydro routing product is now supported from `geoserver.py` (a notebook has been added to demonstrate the new functions).
+* New script `ravenpy aggregate-forcings-to-hrus` to aggregate NetCDF files and compute updated grid weights.
+* Add the basis for a new routing emulator option (WIP).
+* Add climpred verification capabilities.
+
 0.2.3
 -----
 

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020, Canadian Society for Hydrological Sciences
+Copyright (c) 2021, Canadian Society for Hydrological Sciences
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

docs/conf.py

@@ -83,7 +83,7 @@
 
 # General information about the project.
 project = "RavenPy"
-copyright = "2020, David Huard"
+copyright = "2021, David Huard"
 author = "David Huard"
 
 # The version info for the project you're documenting, acts as replacement

docs/installation.rst

@@ -111,7 +111,13 @@ Then clone the Raven Test Data repo somewhere on your disk:
 
    (ravenpy-env) $ git clone git@github.com:Ouranosinc/raven-testdata.git
 
-You can then run the test suite by doing:
+Install the pre-commit hook (to make sure that any code you contribute is properly formatted):
+
+.. code-block:: console
+
+   (ravenpy-env) $ pre-commit install
+
+If everything was properly installed the test suite should run successfully:
 
 .. code-block:: console
 

ravenpy/__version__.py

@@ -6,4 +6,4 @@
 
 __author__ = """David Huard"""
 __email__ = "huard.david@ouranos.ca"
-__version__ = "0.2.3"
+__version__ = "0.3.0"

ravenpy/utilities/__init__.py

@@ -1,6 +1,6 @@
 from .regionalization import read_gauged_params, read_gauged_properties, regionalize
 
-gis_error_message = (
+gis_import_error_message = (
     "`{}` requires installation of the RavenPy GIS libraries. These can be installed using the"
     " `pip install ravenpy[gis]` recipe or via Anaconda (`conda env -n ravenpy-env -f environment.yml`)"
     " from the RavenPy repository source files."

ravenpy/utilities/analysis.py

@@ -6,14 +6,14 @@
 
 import numpy as np
 
-from . import gis_error_message
+from . import gis_import_error_message
 
 try:
     import rasterio
     from osgeo.gdal import Dataset, DEMProcessing
     from shapely.geometry import GeometryCollection, MultiPolygon, Polygon, shape
 except (ImportError, ModuleNotFoundError) as e:
-    msg = gis_error_message.format(Path(__file__).stem)
+    msg = gis_import_error_message.format(Path(__file__).stem)
     raise ImportError(msg) from e
 
 from ravenpy.utilities.geo import generic_raster_clip

ravenpy/utilities/checks.py

@@ -8,7 +8,7 @@
 from pathlib import Path
 from typing import Any, List, Sequence, Tuple, Union
 
-from . import gis_error_message
+from . import gis_import_error_message
 
 try:
     import fiona
@@ -17,7 +17,7 @@
     from pyproj.exceptions import CRSError
     from shapely.geometry import GeometryCollection, MultiPolygon, Point, shape
 except (ImportError, ModuleNotFoundError) as e:
-    msg = gis_error_message.format(Path(__file__).stem)
+    msg = gis_import_error_message.format(Path(__file__).stem)
     raise ImportError(msg) from e
 
 import ravenpy.utilities.io as io

ravenpy/utilities/forecasting.py

@@ -19,15 +19,13 @@
 import xarray as xr
 from climpred import HindcastEnsemble
 
+from . import gis_import_error_message
+
 try:
     import rioxarray
     from clisops.core import subset
 except (ImportError, ModuleNotFoundError) as e:
-    msg = (
-        f"`{Path(__file__).stem}` requires installation of the RavenPy GIS libraries. These can be installed using the"
-        " `pip install ravenpy[gis]` recipe or via Anaconda (`conda env -n ravenpy-env -f environment.yml`)"
-        " from the RavenPy repository source files."
-    )
+    msg = gis_import_error_message.format(Path(__file__).stem)
     raise ImportError(msg) from e
 
 from ravenpy.models import get_model

ravenpy/utilities/geo.py

@@ -8,7 +8,7 @@
 from pathlib import Path
 from typing import List, Union
 
-from . import gis_error_message
+from . import gis_import_error_message
 
 try:
     import fiona
@@ -26,7 +26,7 @@
     )
     from shapely.ops import transform
 except (ImportError, ModuleNotFoundError) as e:
-    msg = gis_error_message.format(Path(__file__).stem)
+    msg = gis_import_error_message.format(Path(__file__).stem)
     raise ImportError(msg) from e
 
 RASTERIO_TIFF_COMPRESSION = "lzw"

ravenpy/utilities/geoserver.py

@@ -15,6 +15,8 @@
 
 from requests import Request
 
+from . import gis_import_error_message
+
 try:
     import fiona
     import pandas as pd
@@ -24,11 +26,7 @@
     from owslib.wfs import WebFeatureService
     from shapely.geometry import Point, shape
 except (ImportError, ModuleNotFoundError) as e:
-    msg = (
-        f"`{Path(__file__).stem}` requires installation of the RavenPy GIS libraries. These can be installed using the"
-        " `pip install ravenpy[gis]` recipe or via Anaconda (`conda env -n ravenpy-env -f environment.yml`)"
-        " from the RavenPy repository source files."
-    )
+    msg = gis_import_error_message.format(Path(__file__).stem)
     raise ImportError(msg) from e
 
 # Do not remove the trailing / otherwise `urljoin` will remove the geoserver path.

ravenpy/utilities/io.py

@@ -10,15 +10,15 @@
 from re import search
 from typing import Iterable, List, Optional, Sequence, Union
 
-from . import gis_error_message
+from . import gis_import_error_message
 
 try:
     import fiona
     import rasterio
     from pyproj import CRS
     from shapely.geometry import shape
 except (ImportError, ModuleNotFoundError) as e:
-    msg = gis_error_message.format(Path(__file__).stem)
+    msg = gis_import_error_message.format(Path(__file__).stem)
     raise ImportError(msg) from e
 
 LOGGER = logging.getLogger("RavenPy")

setup.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.2.3
+current_version = 0.3.0
 commit = False
 tag = False
 

setup.py

@@ -204,7 +204,7 @@ def run(self):
         gis=gis_requirements,
     ),
     url="https://github.com/CSHS-CWRA/ravenpy",
-    version="0.2.3",
+    version="0.3.0",
     zip_safe=False,
     cmdclass={
         "install": create_external_deps_install_class(install),