eWaterCycle/forecast-docker

forecast-docker

Runs PGRCGLOB-WB global hydrology forecast using Cylc and CWL.

Dependencies

Cylc

Require version 7.6.x or higher of Cylc. Follow installation instructions or run the Ansible playbook

cwl-runner

Most tasks in the Cylc workflow are written in Common Workflow Language. The cwl-runner executable should be in your path by installing the reference cwl runner with:

pip2 install cwlref-runner

Docker

Most tasks run inside a Docker container by the cwl-runner. Follow installation instructions so docker can be run as the user.

Building docker images

Docker images of the forecast steps are available on docker hub. Building the docker images itself requires the use of boatswain.

pip install boatswain
boatswain build

Steps

The forecast consists of multiple steps. In order to get the forecast running, the following steps should be executed in order.

• Download forcings and observations
• Preprocess forcings and observations
• Configure and run forecast
• Postprocess forecast output

Configuration

Copy settings.rc.example to settings.rc and edit it.

The initial state tarballs (*.tar.bz2) have to be available on the host. The forecast archive root directory should exist on the host.

Run

cylc register ewatercycle_forecast .

cylc run ewatercycle_forecast

cylc monitor ewatercycle_forecast