Material for a four week ParFlow course for CUAHSI Virtual University taught November 2026. This repo contains all of the hands on activities used for the course.
A Codespace is a computer in the cloud that runs VS Code in your web browser. This repository's Codespace comes with ParFlow and all of the Python packages used in class already installed, so you do not need to install anything on your own computer. All you need is a GitHub account and a web browser (Chrome, Edge or Firefox work best).
- Sign in to GitHub.
- Click the Open in GitHub Codespaces button above. Or, on this repository's GitHub page, click the green Code button, open the Codespaces tab, and click Create codespace on main.
- Leave the defaults and click Create codespace.
- Wait for the build to finish. The first launch is slow: it compiles ParFlow and its libraries from source, which can take 30 minutes or more. You can click View logs to watch it. Start it before class, not at the start of class. After the first launch, reopening the same Codespace takes under a minute.
When it is ready you will see VS Code in your browser, with the course files in the Explorer panel on the left and a terminal at the bottom.
- Do your work in the
my_workfolder. Git ignores everything in it, so your files never get mixed up with the course materials. - Treat the other course files as read-only, so you can always get the
newest versions (see below). To work on a course notebook, copy it into
my_workfirst: right-click it, choose Copy, then right-clickmy_workand choose Paste.
To get course materials posted after you made your Codespace, open a terminal (Terminal > New Terminal from the ☰ menu) and run:
cd /workspaces/ParFlow_CUAHSI_VU && git pullThis only works if you have not changed the course files, which is why your
own work goes in my_work.
- Your files stay in your Codespace between sessions, but only there.
To keep a copy, right-click a file or folder (such as
my_work) in the Explorer panel and choose Download.... - Stop the Codespace when you are done. Free GitHub accounts include a limited number of Codespace hours each month (students with the GitHub Student Developer Pack get more). A Codespace stops by itself after 30 minutes without activity, but stopping it yourself saves hours: go to github.com/codespaces, click ... next to your Codespace, and choose Stop codespace.
- To come back, go to github.com/codespaces and click your Codespace's name. Do not create a new one each time: a new Codespace has to build from scratch again and does not have your files.
- GitHub deletes a Codespace that has not been used for 30 days, along with any files in it you have not downloaded.
- ParFlow v3.15.0 (the latest release) with CLM, Hypre, HDF5 and NetCDF,
installed in
/opt/parflow($PARFLOW_DIR) - Python with
pftools,subsettools,hf_hydrodata,numpy,pandas,xarray,netCDF4,matplotlib,bokehand Jupyter
The setup is in .devcontainer/.