Skip to content

Python module for managing SUMMA simulations

License

Notifications You must be signed in to change notification settings

ashleymedin/pysumma

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Binder

pySUMMA

The pySUMMA is an Object-Oriented Python wrapper for the manipulation, display and analysis of SUMMA model (Structure for Unifying Multiple Modeling Alternatives)

The pySUMMA is intended to provide

  • Get and set model parameters and method (fileManager and Decision file)
  • Run SUMMA Model
  • Visualize netcdf of SUMMA outputs
  • Operate pySUMMA with jupyter notebook environment
  • Interact Hydorshare to download SUMMA TestCases and post the output of SUMMA
  • Automate model calibration or sensitivity analysis (Future work)

How to run pySUMMA on HydroShare

(Link YouTube: https://www.youtube.com/watch?v=pL-LNd474Tw)

  1. log in HydoShare(https://www.hydroshare.org)
  2. Start CUAHSI JupyterHub from APPS menu on HydroShare(https://www.hydroshare.org/apps/)
  3. 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'".
  1. You can see the list of Jupyter Notebooks and click one of Jupyter Notebook.
  2. Run one of Jupyter Notebooks.

Examples of manipulating and running pySUMMA :

Refereed paper : Clark, M. P., B. Nijssen, J. D. Lundquist, D. Kavetski, D. E. Rupp, R. A. Woods, J. E. Freer, E. D. Gutmann, A. W. Wood, D. J. Gochis, R. M. Rasmussen, D. G. Tarboton, V. Mahat, G. N. Flerchinger, D. G. Marks, 2015b: A unified approach for process-based hydrologic modeling: Part 2. Model implementation and case studies. Water Resources Research, doi:10.1002/2015WR017200.

HydroShare resources

(Composite Resource) Jupyter Notebooks to demonstrate SUMMA Model at Reynolds Mountain East on HydroShare

(Composite Resource) Procedure and Supplementary documents Collaborative hydrologic modeling on HydroShare

(Model Program) SUMMA 2.0.0 Sopron version (lubuntu-16.10)

(Model Program) SUMMA 2.0.0 Sopron version (lubuntu-16.04.4)

(Model Instance) Sensitivity to Stomatal Resistance Parameterization of SUMMA Model in Aspen stand at Reynolds Mountain East)

(Model Instance) The Impact of Root Distributions Parameters of SUMMA Model in Aspen stand at Reynolds Mountain East)

(Model Instance) The Impact of Lateral Flow Parameterizations on ET of SUMMA Model at Reynolds Mountain East)

(Model Instance) The Impact of Lateral Flow Parameterizations on Runoff of SUMMA Model at Reynolds Mountain East)

(Model Instance) The Impact of the canopy shortwave radiation parameterizations of SUMMA Model at Reynolds Mountain East)

(Model Instance) The Impact of LAI parameter on the below canopy shortwave radiation of SUMMA Model at Reynolds Mountain East)

(Model Instance) The Impact of the canopy wind parameter for the exponential wind profile of SUMMA Model at Reynolds Mountain East)

(Collection Resource) Test Cases of SUMMA modeling that include model instances and Jupyter notebooks for SUMMA 2nd Paper(2015))

How to run pySUMMA locally

Installation and Usage

pySUMMA requires Python 3.6 and following packages :

  • xarray 0.10.7 : N-D labeled arrays and datasets in python
  • numpy 1.16.1 : the fundamental package for scientific computing with Python
  • matplotlib 3.0.2 : a Python 2D plotting library
  • seaborn 0.9.0 : statistical data visualization
  • jupyterthemes 0.20.0 : select and install a Jupyter notebook theme
  • hs-restclient 1.3.3 : HydroShare REST API python client library
  • ipyleaflet 0.9.2 : A jupyter widget for dynamic Leaflet maps
  • Linux Environment (VirtualBox 5.2.8)

Download and Install pySUMMA:

1.) Download pySUMMA

~/Downloads$ git clone https://github.com/uva-hydroinformatics/pysumma.git

2.) change directory into pysumma folder same level with setup.py.

~/Downloads/pysumma$ pip install .

The UML of pySUMMA

Image of UML

Reference of SUMMA

  • Document : SUMMA documentation is available online and remains a work in progress.
  • Source Code : NCAR github

Bugs

Our issue tracker is at https://github.com/uva-hydroinformatics/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).

License

Distributed with a MIT license; see LICENSE.txt::

Copyright (C) 2017 pySUMMA Developers YoungDon Choi [email protected]

About

Python module for managing SUMMA simulations

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 68.6%
  • Fortran 31.4%