Metadata-Version: 1.2
Name: wflow
Version: 2018.1
Summary: the wflow hydrological models (part of OpenStreams)
Home-page: http://wflow.readthedocs.io/en/latest/
Author: J. Schellekens
Author-email: jaap.schellekens@deltares.nl
License: GPL
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:
        
        + http://wflow.readthedocs.io/en/latest/
        
        
        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). The documentation can be found at
        http://wflow.readthedocs.org
        
        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.
        
        
        Binaries for windows
        ====================
        For windows binaries check the releases (https://github.com/openstreams/wflow/releases). These can be used 
        if you do not have a python installation. However, it is recommended to install wflow as a python package (see below).
        There is absolutely no guarantee the executables will work on your computer.
        
        Install as a python package (windows quick install instructions)
        ================================================================
        
        *Installing Anaconda (scientific python distribution)*
        
        Download Anaconda for python 3, 64 bit from https://www.anaconda.com/download/.
        We will assume that this python is available in the path, such that ``python``,
        ``pip``, and ``conda`` are available from the command line.
        
        Note that there is no hard requirement for Anaconda Python, but often it makes installation
        of required dependecies easier using ``conda``.
        
        Once Anaconda is installed open a command window and install netCDF4, gdal and pyproj using the following command:
        
        + conda install netCDF4 gdal pyproj
        
        *Installing pcraster*
        
        + Download pcraster from http://pcraster.geo.uu.nl/ website (version 4.2)
        + Follow the installation instructions at http://pcraster.geo.uu.nl/quick-start-guide/
        
        *Installing wflow itself*
        
        Clone with git or download the latest zip with the source code of wflow. Go to the ``wflow-py`` directory and run:
        
        + ``pip install -e .``
        
        This will create a link.
        
        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
        =======
        
        + The stats.py script was made by Keith Cherkauer (https://engineering.purdue.edu/~cherkaue/software.htm)
        
        + pcraster is developed and maintained by Utrecht University (http://www.pcraster.eu)
        
        + netCDF4 is developed by unidata (http://unidata.github.io/netcdf4-python/)
        
        + GDAL is released under an X/MIT style Open Source license by the Open Source Geospatial Foundation (http://www.gdal.org).
        
        
        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, Tanja Euser, Hessel Winsemius, Christophe Thiange, Laurène Bouaziz, Daniel Tollenaar, Sander de Vries, Albrecht Weerts, YEAR. openstreams/wflow: unstable-master. https://github.com/openstreams/wflow, obtained: DATE_OF_DOWNLOAD
        
        
        Recent releases
        ---------------
        
        .. image:: https://zenodo.org/badge/17738134.svg
           :target: https://zenodo.org/badge/latestdoi/17738134
           
        Jaap Schellekens, Willem van Verseveld, Tanja Euser, Hessel Winsemius, Christophe Thiange, Laurène Bouaziz, Daniel Tollenaar, Sander de Vries, 2016. openstreams/wflow: 2016.04 Test release. doi:10.5281/zenodo.167057
        
        .. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.155389.svg
           :target: https://doi.org/10.5281/zenodo.155389
           
        Jaap Schellekens, Willem van Verseveld, Tanja Euser, Hessel Winsemius, Christophe Thiange, Laurène Bouaziz, Daniel Tollenaar, Sander de Vries, 2016. openstreams/wflow: 2016.03. doi:10.5281/zenodo.155389
           
        
Platform: UNKNOWN
Requires-Python: >=3.6
