Skip to main content

SMARTpy: an open-source rainfall-runoff model in Python

Project description

[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0) [![PyPI Version](https://badge.fury.io/py/smartpy.svg)](https://pypi.python.org/pypi/smartpy) [![Travis CI Build Status](https://www.travis-ci.org/ThibHlln/smartpy.svg?branch=master)](https://www.travis-ci.org/ThibHlln/smartpy) [![AppVeyor Build Status](https://ci.appveyor.com/api/projects/status/github/ThibHlln/smartpy?branch=master&svg=true)](https://ci.appveyor.com/project/ThibHlln/smartpy)

# SMARTpy - An open-source version of the rainfall-runoff model SMART in Python

SMARTpy is an open-source hydrological catchment model in Python. It is licensed under GNU GPL-3.0 (see license file provided). SMART (Soil Moisture Accounting and Routing for Transport) is a top-down rainfall-runoff model composed of a soil moisture accounting component and linear routing components. It requires rainfall and potential evapotranspiration time series as inputs, it features a set of ten parameters, and it yields a discharge time series.

Mockler, E., O’Loughlin, F., and Bruen, M.: Understanding hydrological flow paths in conceptual catchment models using uncertainty and sensitivity analysis, Computers & Geosciences, 90, 66–77,[doi:10.1016/j.cageo.2015.08.015](https://dx.doi.org/10.1016/j.cageo.2015.08.015), 2016

## Model Specifications

### Model Inputs

  • aerial rainfall time series [mm/time step]

  • aerial potential evapotranspiration time series [mm/time step]

### Model Parameters

  • T: rainfall aerial correction coefficient [-]

  • C: evaporation decay parameter [-]

  • H: quick runoff coefficient [-]

  • D: drain flow parameter - fraction of saturation excess diverted to drain flow [-]

  • S: soil outflow coefficient [-]

  • Z: effective soil depth [mm]

  • SK: surface routing parameter [hours]

  • FK: inter flow routing parameter [hours]

  • GK: groundwater routing parameter [hours]

  • RK: river channel routing parameter [hours]

### Model Outputs

  • discharge time series at catchment outlet [m<sup>3</sup>/s]

## Version History

  • 0.1.0 [17 Jul 2018]: First version of SMARTpy

## Acknowledgment

This tool was developed with the financial support of Ireland’s Environmental Protection Agency (Grant Number 2014-W-LS-5).

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

smartpy-0.1.0.tar.gz (20.7 kB view hashes)

Uploaded Source

Built Distributions

smartpy-0.1.0-py3-none-any.whl (28.5 kB view hashes)

Uploaded Python 3

smartpy-0.1.0-py2-none-any.whl (30.8 kB view hashes)

Uploaded Python 2

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