| pysumma Links & Badges | |
|---|---|
| pysumma Tutorial |  |
| pysumma Documentation | |
| Travis-CI Build |  |
pysumma is a Python wrapper for manipulating, running, managing, and analyzing of SUMMA (Structure for Unifying Multiple Modeling Alternatives)
pysumma provides methods for:
- Running SUMMA
- Modifying SUMMA input files
- Automatically parallelizing distributed and sensitivity analysis type experiments
- Calibration via OSTRICH
- Visualizing output
pysumma can be installed from either conda or pip. Installation using conda is preferred, because
it will also install a compatible version of SUMMA.
To install via conda use:
conda install -c conda-forge pysumma
To install via pip use:
pip install pysumma
A conda environment is available for management of pysumma's dependencies. You can create your own environment from this file by running:
conda env create -f environment.yml
Then, you can activate this environment with conda activate pysumma.
Before installing pysumma into this environment you may also wish to install it as a kernel in your Jupyter environments.
This can be accomplished by running:
python -m ipykernel install --user --name=pysumma
With this environment active you can install pysumma this environment with the instructions below.
Installing pysumma from source can be useful for developing new features. This can be accomplished by running:
git clone https://github.com/UW-Hydro/pysumma.git
cd pysumma
python setup.py develop
- Document : SUMMA documentation is available online and remains a work in progress.
- Source Code : NCAR github
Our issue tracker is at https://github.com/UW-Hydro/pysumma/issues. Please report any bugs that you find. Or, even better, fork the repository on GitHub and create a pull request. All changes are welcome, big or small, and we will help you make the pull request if you are new to git (just ask on the issue).
(Link YouTube: https://www.youtube.com/watch?v=pL-LNd474Tw)
- log in HydoShare(https://www.hydroshare.org)
- Start CUAHSI JupyterHub from APPS menu on HydroShare(https://www.hydroshare.org/apps/)
- Open "Welcome.ipynb" to download pySUMMA resources from HydroShare
- run the code "1.How to connect with HydroShare"
- change the code from "resid = os.environ['HS_RES_ID']" to "resid = 'c1bb4a12bff44bf08c5958cba7947348'".
- You can see the list of Jupyter Notebooks and click one of Jupyter Notebook.
- Run one of Jupyter Notebooks.