WAM2layers

WAM2layers is an atmospheric moisture tracking model. It can be used to determine where precipitation originally evaporated (backward tracking), or where evaporated moisture eventually ends up (forward tracking).

Reference paper: Atmospheric moisture tracking with WAM2layers v3

https://user-images.githubusercontent.com/17080502/233834536-a82ca96d-e303-4592-a588-472097ebe6c5.mp4

The animation above illustrates the concept of backward tracking: you first see the water content and fluxes in the tracking domain move forward in time (left panel). Midway through, the animation reverses and the moisture from the "tagging region" is tracked backward in time (right panel).

How does it work

The simplest experiment with WAM2layers could look like this

pip install wam2layers[viz]
wam2layers download example-input-eiffel
cd example-input-eiffel
wam2layers preprocess era5 config-eiffel.yaml
wam2layers track config-eiffel.yaml
wam2layers visualize output config-eiffel.yaml

See the documentation for a more detailed description. We also have a video walkthrough!

Finding help

graph TD
    A[Question or idea?] --> B[Check existing resources:<br><a href='https://wam2layers.readthedocs.io'>Documentation</a>, <a href='https://github.com/WAM2layers/WAM2layers/discussions'>Discussion forum</a>, <a href='https://github.com/WAM2layers/WAM2layers/issues'>Open issues</a>]
    B --> |Still unresolved?| C[<a href="https://github.com/WAM2layers/WAM2layers/discussions/new">Start a new discussion</a><br>Briefly introduce yourself and your use case and provide relevant context, e.g. config files]
    C --> |Work needed?| D[Discussion is converted to issue]
    D --> |Want to contribute?| E[See <a href='https://wam2layers.readthedocs.io/en/latest/develop.html'>Developer guide</a>]
    D --> F[Wait for others to hopefully work on it]

    class A startStep;
    classDef startStep fill:#f9f,stroke:#333,stroke-width:4px,font-size:16px;

Other versions

This is the official codebase for the WAM-2layers moisture tracking model as of 18/03/2022, but there are still several other (older) versions around:

• Original Python code for ERA-Interim by Ruud van der Ent
• Adapted version for EC-Earth by Imme Benedict
• Adapted version for MERRA2 by Pat Keys
• Adapted version for ERA5 pressure levels by Mingzhong Xiao
• Adapted version for ERA5 by Theo Carr

Reuse and acknowledgement

This code is currently developed by a core team: Ruud van der Ent (Delft University of Technology) Imme Benedict (Wageningen University) Chris Weijenborg (Wageningen University) Peter Kalverla (Netherlands eScienceCenter) Bart Schilperoort (Netherlands eScience Center)

We are proudly part of open-sustainable-technology.

If you use the code for a publication, please cite it using the DOI of the appropriate release and the following paper : Atmospheric moisture tracking with WAM2layers v3