WAM2layers
Used to determine where precipitation originally evaporated (backtracking), or where evaporated moisture eventually ends up (forward tracking).
https://github.com/wam2layers/wam2layers
Category: Atmosphere
Sub Category: Atmospheric Dispersion and Transport
Keywords from Contributors
hydrology
Last synced: about 5 hours ago
JSON representation
Repository metadata
Atmospheric moisture tracking
- Host: GitHub
- URL: https://github.com/wam2layers/wam2layers
- Owner: WAM2layers
- License: apache-2.0
- Created: 2022-03-17T13:31:28.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2025-03-28T15:48:41.000Z (about 1 month ago)
- Last Synced: 2025-04-18T22:18:53.358Z (12 days ago)
- Language: Python
- Homepage: https://wam2layers.readthedocs.io/en/latest
- Size: 58.2 MB
- Stars: 50
- Watchers: 8
- Forks: 18
- Open Issues: 24
- Releases: 11
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Citation: CITATION.cff
README.md
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
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 (currently in preprint):
Atmospheric moisture tracking with WAM2layers v3
Citation (CITATION.cff)
# This CITATION.cff file was generated with cffinit. # Visit https://bit.ly/cffinit to generate yours today! cff-version: 1.2.0 title: WAM2layers message: >- Please use the citation information if you used the WAM2layers code in your (academic) work. type: software authors: - given-names: Ruud J family-names: van der Ent affiliation: Delft University of Technology orcid: 'https://orcid.org/0000-0001-5450-4333' - given-names: Imme Bo family-names: Benedict affiliation: Wageningen University orcid: 'https://orcid.org/0000-0002-1946-6332' - given-names: Chris family-names: Weijenborg affiliation: Wageningen University orcid: 'https://orcid.org/0000-0003-1663-2806' - given-names: Bart family-names: Schilperoort affiliation: Netherlands eScience Center orcid: 'https://orcid.org/0000-0003-4487-9822' - given-names: Yang family-names: Liu affiliation: Netherlands eScience Center orcid: 'https://orcid.org/0000-0002-1966-8460' - given-names: Elizabeth family-names: Barnes affiliation: Colorado State University orcid: 'https://orcid.org/0000-0001-7471-9980' - given-names: Tolga family-names: Cömert - given-names: Niek family-names: van de Koppel - given-names: Liang family-names: Guo orcid: 'https://orcid.org/0000-0002-6004-3884' - given-names: Vincent family-names: de Feiter orcid: 'https://orcid.org/0009-0006-6363-7932' - given-names: Peter family-names: Kalverla affiliation: Netherlands eScience Center orcid: 'https://orcid.org/0000-0002-5025-7862' repository-code: 'https://github.com/WAM2layers/WAM2layers' abstract: >- WAM2layers is an atmospheric moisture-tracking model that can be used to determine where precipitation originally evaporated (backtracking), or where evaporated moisture eventually ends up (forward tracking). keywords: - moisture tracking - hydrological cycle - meteorology - python - moisture recycling - atmospheric rivers license: Apache-2.0 identifiers: - description: Latest version of software type: doi value: '10.5281/zenodo.7010594'
Owner metadata
- Name: WAM2layersTeam
- Login: WAM2layers
- Email:
- Kind: organization
- Description:
- Website:
- Location:
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/101812219?v=4
- Repositories: 1
- Last ynced at: 2023-03-05T01:02:27.014Z
- Profile URL: https://github.com/WAM2layers
GitHub Events
Total
- Create event: 21
- Release event: 2
- Issues event: 26
- Watch event: 11
- Delete event: 17
- Issue comment event: 57
- Push event: 71
- Pull request review event: 30
- Pull request review comment event: 17
- Pull request event: 36
- Fork event: 1
Last Year
- Create event: 21
- Release event: 2
- Issues event: 26
- Watch event: 11
- Delete event: 17
- Issue comment event: 57
- Push event: 71
- Pull request review event: 30
- Pull request review comment event: 17
- Pull request event: 36
- Fork event: 1
Committers metadata
Last synced: 1 day ago
Total Commits: 330
Total Committers: 9
Avg Commits per committer: 36.667
Development Distribution Score (DDS): 0.585
Commits in past year: 43
Committers in past year: 3
Avg Commits per committer in past year: 14.333
Development Distribution Score (DDS) in past year: 0.628
Name | Commits | |
---|---|---|
Peter Kalverla | p****a@g****m | 137 |
Ruud van der Ent | r****t@t****l | 63 |
Bart Schilperoort | b****t@e****l | 39 |
Imme1992 | i****t@w****l | 35 |
Chris weijenborg | C****g@w****l | 19 |
Yang | y****u@e****l | 17 |
vincentdefeiter | v****r@h****m | 16 |
Yang | l****h@g****m | 3 |
Elizabeth Barnes | 2****0 | 1 |
Committer domains:
- wur.nl: 2
- esciencecenter.nl: 2
- tudelft.nl: 1
- gmx.com: 1
Issue and Pull Request metadata
Last synced: 1 day ago
Total issues: 168
Total pull requests: 148
Average time to close issues: 5 months
Average time to close pull requests: 30 days
Total issue authors: 16
Total pull request authors: 9
Average comments per issue: 2.16
Average comments per pull request: 1.7
Merged pull request: 125
Bot issues: 0
Bot pull requests: 0
Past year issues: 44
Past year pull requests: 39
Past year average time to close issues: about 1 month
Past year average time to close pull requests: 22 days
Past year issue authors: 9
Past year pull request authors: 4
Past year average comments per issue: 1.7
Past year average comments per pull request: 1.46
Past year merged pull request: 34
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- Peter9192 (51)
- ruudvdent (32)
- BSchilperoort (27)
- Imme1992 (20)
- chrisweij (8)
- vincentdefeiter (6)
- everson-ufsm (6)
- longbiao1993 (3)
- 1277820238 (3)
- geek-yang (3)
- damianinsua (2)
- WenyuZhou-4 (2)
- eabarnes1010 (2)
- supershy44 (1)
- cccccoldrun (1)
Top Pull Request Authors
- Peter9192 (50)
- ruudvdent (29)
- BSchilperoort (26)
- chrisweij (12)
- vincentdefeiter (10)
- geek-yang (10)
- Imme1992 (7)
- WenyuZhou-4 (2)
- eabarnes1010 (2)
Top Issue Labels
- preprocessing (18)
- tracking (14)
- documentation (13)
- bug (11)
- enhancement (10)
- testing (7)
- student project (5)
- visualization (5)
- cli (3)
- prio:low (3)
- prio (3)
- good first issue (1)
Top Pull Request Labels
- bug (4)
- prio:low (2)
Package metadata
- Total packages: 1
-
Total downloads:
- pypi: 490 last-month
- Total dependent packages: 0
- Total dependent repositories: 0
- Total versions: 9
- Total maintainers: 5
pypi.org: wam2layers
Atmospheric moisture tracking model
- Homepage:
- Documentation: https://wam2layers.readthedocs.io/en/latest
- Licenses: Apache 2.0
- Latest release: 3.2.2 (published about 1 month ago)
- Last Synced: 2025-04-29T15:36:47.466Z (1 day ago)
- Versions: 9
- Dependent Packages: 0
- Dependent Repositories: 0
- Downloads: 490 Last month
-
Rankings:
- Dependent packages count: 6.633%
- Average: 18.622%
- Dependent repos count: 30.611%
- Maintainers (5)
Dependencies
- click *
- cmocean *
- dask >=2022.11
- distributed >=2022.11
- matplotlib *
- netcdf4 *
- numpy *
- pandas >=1.4.0
- psutil *
- pydantic *
- pyyaml *
- scipy *
- xarray *
- actions/cache v3 composite
- actions/checkout v3 composite
- actions/setup-python v4 composite
Score: 12.70584743310908