Skip to content

DeltaRCM/pyDeltaRCM

Repository files navigation

pyDeltaRCM

https://app.codacy.com/project/badge/Grade/1c137d0227914741a9ba09f0b00a49a7

pyDeltaRCM is a computationally efficient, free and open source, and easy-to-customize numerical delta model based on the original DeltaRCM model design (Matlab deltaRCM model by Man Liang; Liang et al., 2015). pyDeltaRCM delivers improved model stability and capabilities, infrastructure to support exploration with minimal boilerplate code, and establishes an approach to extending model capabilities that ensures reproducible and comparable studies.

https://deltarcm.org/pyDeltaRCM/_images/cover.png

Weighted random walks for 20 water parcels, in a pyDeltaRCM model run with default parameters.

Documentation

Find the complete documentation here.

Documentation includes an installation guide, a thorough guide for users, detailed API documentation for developers, a plethora of examples to use and develop pyDeltaRCM in novel scientific experiments, and more!

Installation

See our complete installation guide, especially if you are a developer planning to modify or contribute code (developer installation guide), or if you are new to managing Python venv or conda environments.

For a quick installation into an existing Python 3.x environment:

$ pip install pyDeltaRCM

Executing the model

We recommend you check out our pyDeltaRCM in 10 minutes tutorial, which is part of our documentation.

Beyond that brief tutorial, we have a comprehensive User Documentation and Developer Documentation to check out.

Citing pyDeltaRCM

When citing pyDeltaRCM, please cite the JOSS paper:

Moodie et al., (2021). pyDeltaRCM: a flexible numerical delta model. Journal of Open Source Software, 6(64), 3398, https://doi.org/10.21105/joss.03398

If you use BibTeX, you can add pyDeltaRCM to your .bib file using the following code:

@article{Moodie2021,
doi = {10.21105/joss.03398},
url = {https://doi.org/10.21105/joss.03398},
year = {2021},
publisher = {The Open Journal},
volume = {6},
number = {64},
pages = {3398},
author = {Andrew J. Moodie and Jayaram Hariharan and Eric Barefoot and Paola Passalacqua},
title = {*pyDeltaRCM*: a flexible numerical delta model},
journal = {Journal of Open Source Software}
}

Additional notes

This repository no longer includes the Basic Model Interface (BMI) wrapper to the DeltaRCM model. pyDeltaRCM maintains BMI compatibility through another repository (the BMI_pyDeltaRCM model).