Dashboard Global Water Balance & Human Water Demand

https://globalwaterbalance.herokuapp.com/

Overview

Dashboard Global Water Balance & Human Water Demand shows the historical water balance and human water demand.

It is using the ISIMIP3a protocol with historical climate data on a 0.5 deg resolution.

The hydrology is calculated with the oper-source hydrological model CWatM https://cwatm.iiasa.ac.at/

Project

The dashboard is related to the project

Water and land management trajectories –best bet options for sustainable agricultural intensification

funded by IMWI

With the Partners:

• International Institute for Applied Systems Analysis (IIASA)
• IMWI Sri Lanka

Publication

• Burek, P., Satoh, Y., Kahil, T., Tang, T., Greve, P., Smilovic, M., Guillaumot, L., Zhao, F., and Wada, Y.: Development of the Community Water Model (CWatM v1.04) - a high-resolution hydrological model for global and regional assessment of integrated water resources management, Geosci. Model Dev., 13, 3267–3298, https://doi.org/10.5194/gmd-13-3267-2020, 2020.

Requirements

The dashboard is using Python 3.8, + libraries (see requirements.txt) It is created uisng plotly for the figures, dash for the webinterface at at the moment Heroku for web deployment

https://dash.plotly.com/deployment

https://dashboard.heroku.com/apps/globalwaterbalanc

Deploy with Heroku

Initialization of a virtuel envirionment

(Done only once at the beginning)

• cd P:\watmodel\dashboards\globalwaterbalance
• git init # initializes an empty git repo
• virtualenv venv
• .\venv\Scripts\activate
• pip list

Instalation of libraries

(also only once)

• pip install plotly
• pip install gunicorn
• pip install numpy
• pip install dash
• pip install dash-bootstrap-components

To create new requirement.txt:

• pip freeze > requirements.txt

All the libraries in your app.py

In the directory should be:

• app.py
• .gitignore
• Procfile
• requirements.txt

Warm start

• cd P:\watmodel\dashboards\globalwaterbalance
• virtualenv venv

Test app.py

P:/watmodel/dashboards/globalwaterbalance/venv/Scripts/python app.py

First time deploy to heroku

• heroku login
• heroku create globalwaterbalance # change my-dash-app to a unique name -> only small letters no underscore
• git add . # add all files to git
• git commit -m 'Initial app water1'
• git push heroku master # deploy code to heroku
• heroku ps:scale web=1 # run the app with a 1 heroku "dyno"

You should be able to view your app at https://globalwaterbalance.herokuapp.com

if errors:

• heroku logs --tail
• heroku logs > log1.txt

Update the code and redeploy

When you modify app.py with your own code, you will need to add the changes to git and push those changes to heroku.

• heroku login
• change Tourtoise-git/ settings / remote -> https://git.heroku.com/globalwaterbalance.git

Update git and deploy

• git status
• git add .
• git commit -m "a description of the changes"
• git push heroku master

https://globalwaterbalance.herokuapp.com