Metadata-Version: 2.1
Name: pcrglobwb-utils
Version: 0.2.5
Summary: Handy functions to work with PCR-GLOBWB input and output
Home-page: https://pcrglobwb-utils.readthedocs.io/
Author: Jannis M. Hoch
Author-email: j.m.hoch@uu.nl
License: GNU General Public License v3
Keywords: pcrglobwb_utils
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3.7
License-File: LICENSE.rst
License-File: AUTHORS.rst

===============
Overview
===============


.. image:: https://img.shields.io/pypi/v/pcrglobwb_utils.svg
        :target: https://pypi.python.org/pypi/pcrglobwb_utils

.. image:: https://readthedocs.org/projects/pcrglobwb-utils/badge/?version=latest
        :target: https://pcrglobwb-utils.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status

.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.3725813.svg
   :target: https://doi.org/10.5281/zenodo.3725813
   :alt: DOI

.. image:: https://img.shields.io/badge/License-GPLv3-blue.svg
   :target: https://www.gnu.org/licenses/gpl-3.0
   :alt: License

.. image:: https://codecov.io/gh/JannisHoch/pcrglobwb_utils/branch/dev/graph/badge.svg?token=61HVIA952S
   :target: https://codecov.io/gh/JannisHoch/pcrglobwb_utils
   :alt: Codecov
 
Handy functions to work with PCR-GLOBWB input and output.

* Free software: GNU General Public License v3
* Documentation: https://pcrglobwb-utils.readthedocs.io.


Features
--------

Most mature: 

* evaluation of timeseries simulated by PCR-GLOBWB with observations from GRDC.
  
  * multiple GRDC-stations and properties can be provided via a yml-file.
  * using command line functions and wide range of user-defined options.
  
* command line functions to validate model output against GRACE and GLEAM data for multiple polygons.

Other:

* aggregating and averaging over time scales.
* water balance assessments of PCR-GLOBWB runs.
* statistical analyses.
* ensemble analysis.


Credits
-------

Contributions from Jannis M. Hoch (j.m.hoch@uu.nl).

The package structure was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


=======
History
=======

**0.1.3 (2020-05-07)**

* Analysing the water balance components of a PCR-GLOBWB run
* Calculating statistics of ensemble output and plotting it

**0.1.2 (2020-04-23)**

Additional functionality.

* Added functions for temporal aggregation (daily to monthly, daily to yearly)
* Statistics of simulated discharge (mean, max, min etc) can be computed

**0.1.1 (2020-04-20)**

Minor updates.

* Moved towards object based programming
* Reading from 'normal' csv-files supported now

**0.1.0 (2020-03-24)**

First stable release with minimal functionality.

* Extracting timeseries from netCDF-files for certain lon/lat
* Reading of GRDC station files and extracting meta-data
* Aggregating daily values to monthly averages
* Validating timeseries of observed and simulated values for common time period
* Provision of example data and jupyter notebook
* (Shell)scripts for validating and benchmarking timeseries



