Provides the HEFS-FEWS Hub container image, designed for use on TEEHRHub and similar JupyterHub deployments, to support the exploration of HEFS ensembles using FEWS. Part of a CIROH-supported project.
The image is based on AlmaLinux 8.10 (chosen for official FEWS support), and includes:
- JupyterLab for interactive Python development and dashboarding
- XFCE desktop environment and TurboVNC for a full-featured remote desktop, allowing users to run FEWS in a graphical environment
- Pre-installed FEWS binaries, and AWS CLI for data access
- The
hefs-fews-hubpython package (also part of this repository)
This setup enables users to analyze hydrologic ensemble forecasts and interact with FEWS in a cloud-hosted desktop environment.
Warning! This is currently highly experimental!
- Go to
https://teehr-hub.rtiamanzi.org/hub/spawn - Sign in with your github account (you'll need to create one if you don't have it)
- From the list, select
HEFS-FEWS Evaluation System. ClickStart - When JupyterHub starts, Go to Desktop
- The first time you login, open the terminal in the Desktop and run
cp /opt/hefs_fews_dashboard/dashboard.desktop .This will create a desktop icon to start the dashboard. You should only need to do this once. - Select the RFC you wish to work with
- Specify a directory path. Data downloaded to the
/home/jovyandirectory will persist between sessions. - After downloading the configuration, click the FEWS icon to start FEWS.
Things to watch out for:
- If the remote desktop is idle for too long, you may get logged out and may need to restart TEEHRHub!
Dashboard approach:
- Start up TEEHRHub
- Select appropriate image
- Go to Remote Desktop
- Click on "Launch" icon to launch dashboard
- Select the desired standalone
- Click
Configure Standalonebutton - Double-click the FEWS desktop icon when it appears
OR, Notebook approach:
- Run the notebook
dashboard.ipynb - Follow steps 5-7 above