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

README.md

WAM2layers

DOI
Documentation Status
PyPI

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:

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


GitHub Events

Total
Last Year

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 Email 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:


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

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/wam2layers/wam2layers

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

pypi.org: wam2layers

Atmospheric moisture tracking model


Dependencies

pyproject.toml pypi
  • click *
  • cmocean *
  • dask >=2022.11
  • distributed >=2022.11
  • matplotlib *
  • netcdf4 *
  • numpy *
  • pandas >=1.4.0
  • psutil *
  • pydantic *
  • pyyaml *
  • scipy *
  • xarray *
.github/workflows/ci.yaml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • actions/setup-python v4 composite

Score: 12.70584743310908