Skip to main content

wflow hydrological modeling framework

Project description

wflow

wflow consists of a set of Python programs that can be run on the command line and perform hydrological simulations. The models are based on the PCRaster Python framework. In wflow this framework is extended (the wf_DynamicFramework) so that models build using the framework can be controlled using the API. Links to BMI, OpenMI and OpenDAP have been made.

A link to the latest version can always be found at https://github.com/openstreams/wflow

Reference documentation at:

Obtaining wflow

Go to https://github.com/openstreams/wflow. There you can download the source or a release. Also make sure you get the required third party models first (see below).

Which version to use

The master branch can change rapidly (and break functionality without warning) so please use one of the releases if possible. If you want to adjust things in the model(s) we assume you should be comfortable using the master branch.

Installation

Install as a conda package

By far the easiest way to install wflow, is using the conda package manager. This package manager comes with the Anaconda Python distribution. wflow is available in the conda-forge channel. To install you can use the following command:

  • conda install -c conda-forge wflow

If this works it will install wflow with all dependencies including Python and PCRaster, and you skip the rest of the installation instructions.

Installing Python and PCRaster dependencies

The main dependencies for wflow are an installation of Python 3.6+, and PCRaster 4.2+. Only 64 bit OS/Python is supported.

Installing Python

For Python we recommend using the Anaconda Distribution for Python 3, which is available for download from https://www.anaconda.com/download/. The installer gives the option to add python to your PATH environment variable. We will assume in the instructions below that it is available in the path, such that python, pip, and conda are all available from the command line.

Note that there is no hard requirement specifically for Anaconda’s Python, but often it makes installation of required dependencies easier using the conda package manager.

Installing pcraster

Install as a conda environment

The easiest and most robust way to install wflow is by installing it in a separate conda environment. In the root repository directory there is an environment.yml file. This file lists all dependencies. Either use the environment.yml file from the master branch (please note that the master branch can change rapidly and break functionality without warning), or from one of the releases {release}.

Run this command to start installing all wflow dependencies:

  • conda env create -f environment.yml

This creates a new environment with the name wflow. To activate this environment in a session, run:

  • activate wflow

For the installation of wflow there are two options (from the Python Package Index (PyPI) or from Github). To install a release of wflow from the PyPI (available from release 2018.1):

  • pip install wflow=={release}

To install directly from GitHub (from the HEAD of the master branch):

  • pip install git+https://github.com/openstreams/wflow.git

or from Github from a specific release:

  • pip install git+https://github.com/openstreams/wflow.git@{release}

Now you should be able to start this environment’s Python with python, try import wflow to see if the package is installed.

More details on how to work with conda environments can be found here: https://conda.io/docs/user-guide/tasks/manage-environments.html

If you are planning to make changes and contribute to the development of wflow, it is best to make a git clone of the repository, and do a editable install in the location of you clone. This will not move a copy to your Python installation directory, but instead create a link in your Python installation pointing to the folder you installed it from, such that any changes you make there are directly reflected in your install.

  • git clone https://github.com/openstreams/wflow.git

  • cd wflow

  • activate wflow

  • pip install -e .

Alternatively, if you want to avoid using git and simply want to test the latest version from the master branch, you can replace the first line with downloading a zip archive from GitHub: https://github.com/openstreams/wflow/archive/master.zip

Install using pip

Besides the recommended conda environment setup described above, you can also install wflow with pip. For the more difficult to install Python dependencies, it is best to use the conda package manager:

  • conda install numpy scipy gdal netcdf4 cftime xarray pyproj numba python-dateutil

Then install a release {release} of wflow (available from release 2018.1) with pip:

  • pip install wflow=={release}

If you want to avoid using conda, an example of a PCRaster build and pip install on Ubuntu Linux can be found in issue #36.

Check if the installation is successful

To check it the install is successful, go to the examples directory and run the following command:

  • python -m wflow.wflow_sbm -C wflow_rhine_sbm -R testing

This should run without errors.

Credits

Citation

See doi of the release you use. If you use a snapshot of the development (without a DOI) cite as follows:

Jaap Schellekens, Willem van Verseveld, Martijn Visser, Hessel Winsemius, Tanja Euser, Laurène Bouaziz, Christophe Thiange, Sander de Vries, Hélène Boisgontier, Dirk Eilander, Daniel Tollenaar, Albrecht Weerts, Fedor Baart, Pieter Hazenberg, Arthur Lutz, Corine ten Velden, Mischa Jansen, Imme Benedict, YEAR. openstreams/wflow: unstable-master. https://github.com/openstreams/wflow, obtained: DATE_OF_DOWNLOAD

Releases

To check the doi of releases you use: https://doi.org/10.5281/zenodo.593510

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wflow-2020.1.2.tar.gz (20.8 MB view details)

Uploaded Source

Built Distribution

wflow-2020.1.2-py3-none-any.whl (732.2 kB view details)

Uploaded Python 3

File details

Details for the file wflow-2020.1.2.tar.gz.

File metadata

  • Download URL: wflow-2020.1.2.tar.gz
  • Upload date:
  • Size: 20.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/45.2.0.post20200210 requests-toolbelt/0.9.1 tqdm/4.42.1 CPython/3.7.6

File hashes

Hashes for wflow-2020.1.2.tar.gz
Algorithm Hash digest
SHA256 325d5efc064d3fe005a1de8a70eba38e4cfafb8cb8862f066d842e55425abb6b
MD5 84d7f21aa682e83a1ae8b313afc69e53
BLAKE2b-256 fe719eac99daa3c74d63d68ec364b2f4fda848ceaa870654cbb29640f3b722e7

See more details on using hashes here.

File details

Details for the file wflow-2020.1.2-py3-none-any.whl.

File metadata

  • Download URL: wflow-2020.1.2-py3-none-any.whl
  • Upload date:
  • Size: 732.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/45.2.0.post20200210 requests-toolbelt/0.9.1 tqdm/4.42.1 CPython/3.7.6

File hashes

Hashes for wflow-2020.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 06de55a6777227d613e3f0459a5227c05f3b0b43486ef81062945e73289df1e4
MD5 7ef6bf13dd5e11d224c553ab7b921bcf
BLAKE2b-256 eb76ae7e5fb8d30107dcea9db566b22cf89292cac9d8d4f7b99dbb41333b362e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page