Home

Awesome

LHMP

Lumped Hydrological Models Playgroud

General aim

To provide opportunity for hydrologists and local communities to become closer to water-related problems, its assessment and solving for the large domain of Russian Arctic.

Spatial coverage

Nadym, Pur, and Taz river basins.

Installation

You can use LHMP easily on your local machine. Please, follow instructions:

  1. Install Docker on your machine - please, refer to the official Docker documentation (https://docs.docker.com/engine/installation/);
  2. There is a Docker image available to try out LHMP without concerns about the further installation process. To run interactive shell of LHMP (just the jupyter notebook), please copy-paste following code to your command prompt: docker run -d -p 8888:8888 hydrogo/lhmp
  3. Once started, point a web browser to
    • http://localhost:8888 (on Linux);
    • If using docker-machine (Win or Mac users), this will not be http://localhost:8888. The IP address will be given by tapping in your command prompt: docker-machine ip [name-of-your-docker-machine-vm]. If you unsure about the name of your docker-machine VM, check the output of the command docker-machine ls. Do not forget to add link to the port :8888 in the end of your ip address (e.g. 001.002.003.04:8888). And do not forget about the great power of classical system reboot in solving installation problems on Win (smile).

Using as your own playground

After the installation you should go to the folder called "interfaces", select the model you like to test and run appropriate jupyter notebook (.ipynb). There are few model playgrounds for:

Inside every jupiter notebook you can find additional information about model playgroung.

Using as framework for your own tasks

Inside LHMP repository you can find:

How to cite

You can use presented code and data without any restrictions, but do not forget to properly cite separate items. We recommend to follow citations below: