Framework for calculating hydrological indices
Project description
HydroAnalysis
HydroAnalysis is a Python package to calculate indices and metrics useful in the everyday job of an hydrologist.
The package is the result of the re-organization of code that I have used during my research and that I have decided to publish because of its supposed usefulness.
Generic interface
Please refer to the docstrings of the single functions for documentation.
Generally all the functions have the same interface
def calculate_index_name(flux1, quality, flux2, fluxN, other_time_series):
# code
where:
flux1
,flux2
,fluxN
are fluxes needed to calculate the index/metricquality
is a vector that is used to signal time steps where the quality of the data is not good and, therefore, are not used to calculate the index/metric.other_time_series
: are other time series needed to calculate the index/metric. Example could be the season.
Files in the package
- meteo_indices.py: contains the functions to calculate the indices related to meteorological data
- metrics.py: contains the functions to calculate the metrics related to the hydrological data
- streamflow_signatures.py: contains the functions to calculate the signatures related to the hydrological data
- utils.py: contains the functions used by the other files
Documentation
The documentation is work in progress. It is not complete yet but can be found in ReadTheDocs.
Examples
Examples of the usage of the package are not available yet. However, the code should be self-explanatory..just read carefully the docstrings.
Testing
There is no systematic testing implemented here. However, the code has been manually tested against other available code (e.g., R code from Addor et al. (2017)) when possible.
Your contribution
Please feel free to contribute to the package. If you have any suggestion or you want to contribute to the documentation, please contact the author and have a look at the documentation page explaining how to do it.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.