Amanzi-ATS Transport Tutorial

This tutorial offers a hands-on experience in setting up and running transport simulations based on hydrology models in Amanzi-ATS. This is part of the IDEAS-Watershed all-hands meeting 2024 in Denver, CO.

Instructors: Phong Le, Ethan Coon, Daniil Svyatsky

---

1. Learning Objectives 🎯

By the end of this workshop, participants will be able to:

• Understand the basics of the transport process kernel (PK) in Amanzi-ATS;
• Develop workflows that couple transport PK with hydrology PK;
• Visualize and analyze Amanzi-ATS model outputs.

---

2. Prerequisites 💡

To get the most out of this tutorial, participants should have:

• Basic skills in python and jupyter notebook. We will use pyvista and ipywidgets for interactive visualization.
• A fundamental understanding of watershed hydrology is encouraged.

---

3. Setup Instructions 🔧

The slides for the tutorial can be found here.

The tutorial will be run in a docker container. The container includes the terminal, text editor, ats, python, jupyter notebook, and other dependencies. The text editor is customized to better work with the ats input files in xml format. Follow the steps below to set up the environment.

1. Pull the docker image: Make sure to pull the Docker container for this tutorial:

docker pull --platform linux/amd64 metsi/ideas-watersheds-all-hands-2024:latest

2. Run the container: Start the container and open the Jupyter Notebook interface:

docker run -p 8888:8888 metsi/ideas-watersheds-all-hands-2024:latest

3. Access Jupyter notebooks: Open the link displayed in your terminal to access jupyter notebook in your browser.

4. Clone the tutorial repository: Open a terminal in the Jupyter notebook interface and run:

git clone https://github.com/amanzi/ats-hands-on-transport.git

Important

If you're familiar with the VSCode editor, you can use the Dev Containers extension to connect to the container and edit XML files. You can also use the jupyter extension in VSCode to run notebooks directly within the Docker container.

---

4. Workshop Outline 📝

• Introduction to Hydrology and Transport PKs in ATS:

  • Overview of governing equations
  • Review of ATS input files

• Hands-On Session: Building Transport Simulations:

  • Step-by-step guidance on developing transport simulations in ATS based on the integrated hydrology model*

• Discussion and Feedback:

  • Open session for questions, insights, and feedback*