AeoLiS

Simulating aeolian sediment transport in situations where supply-limiting factors are important, like in coastal environments.
https://github.com/openearth/aeolis-python

Category: Hydrosphere
Sub Category: Coastal and Reefs

Last synced: about 21 hours ago
JSON representation

Repository metadata

A process-based model for simulating supply-limited aeolian sediment transport

README.md

AeoLiS Banner

ReadTheDocs
PyPI
PyPI_versions
PyPI_status
PyPI_format
License
DOI

AeoLiS

AeoLiS is a process-based model for simulating aeolian sediment transport in situations where supply-limiting factors are important,
like in coastal environments. Supply-limitations currently supported
are soil moisture contents, sediment sorting and armouring, bed slope
effects, air humidity and roughness elements.

https://github.com/openearth/aeolis-python/assets/14054272/128684d6-73ac-4a5f-a186-51559679bd66

Installation

Requirements:

  • Python 3.9 or newer
  • pip 22.0 or newer
  • netCDF4

Installing from PyPI

On the comand line of your working environment (Bash/Shell, Conda, Mamba, or similar), run the following:

pip install aeolis

For Windows users, the recommend way to install AeoLiS is to use Anaconda.

Installing from source

  1. Clone the repository using Git, or download the source code.

  2. AeoLiS users may install the package with only the required dependencies. Go to aeolis-python directory and install using pip

    cd aeolis-python/
    pip install .
    
  3. AeoLiS users who intend to modify the sourcecode can install additional dependencies for test and documentation as follows. Go to root directory aeolis-python/ and:

    pip install -e .[dev]
    

Running AeoLiS

Examples from command line:

aeolis run <path/to/aeolis.txt/>
# or wind module
aeolis wind <path/to/wind.txt> --mean=6 --duration=3600

Documentation

Detailed documentation can be found at AeoLiS ReadTheDocs

AeoLiS Developer Team

The maintenance and development is done by a group of very enthusiastic people.

Get Involved:
Read our Contribution Guidelines to know how you can help to develop AeoLiS.

Current Members:

Previous Members & Contributors:

  • Bas Hoonhout (founder)
  • Tom Pak
  • Pieter Rauwoens
  • Lisa Meijer

Citation

Please, cite this software as follows:

de Vries, S., Hallin, C., van IJzendoorn, C., van Westen, B., Cohn, N., Strypsteen, G., Skaden, J., Agrawal, N., & Garcia Alvarez, M. (2023). AeoLiS (Version 3.0.1) [Computer software]. https://github.com/openearth/aeolis-python

Acknowlegdements

© (2023) AeoLiS Development Team, Delft, The Netherlands.

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: AeoLiS
message: >-
  If you use this software, please cite it using the
  metadata from this file.
type: software
contact:
  - affiliation: AeoLis Development Team
    email: Sierd.deVries@tudelft.nl
    family-names: Sierd
    given-names: de Vries
authors:
  - given-names: Sierd
    name-particle: de
    family-names: Vries
    affiliation: Delft University of Technology
    email: Sierd.deVries@tudelft.nl
    orcid: 'https://orcid.org/0000-0001-5865-3715'
  - given-names: Caroline
    family-names: Hallin
    email: e.c.hallin@tudelft.nl
    affiliation: Lund University (Division of Water Resources Engineering)
    orcid: 'https://orcid.org/0000-0001-9921-5754'
  - given-names: Christa
    name-particle: van
    family-names: IJzendoorn
    email: C.O.vanIJzendoorn@tudelft.nl
    affiliation: Delft University of Technology
    orcid: 'https://orcid.org/0000-0001-9756-1856'
  - given-names: Bart
    name-particle: van
    family-names: Westen
    affiliation: Delft University of Technology
    orcid: 'https://orcid.org/0000-0001-7903-6062'
  - given-names: Nicholas
    family-names: Cohn
    email: nick.cohn@usace.army.mil
    affiliation: US Army Engineer Research and Development Center
    orcid: 'https://orcid.org/0000-0003-4287-039X'
  - given-names: Glen
    family-names: Strypsteen
    email: glenn.strypsteen@kuleuven.be
    affiliation: Katholieke Universiteit Leuven
    orcid: 'https://orcid.org/0000-0002-0078-7259'
  - given-names: Janelle
    family-names: Skaden
    email: Janelle.E.Skaden@usace.army.mil
    affiliation: US Army Engineer Research and Development Center
    orcid: ''
  - given-names: Niket
    family-names: Agrawal
    email: N.Agrawal@tudelft.nl
    affiliation: Delft University of Technology
    orcid: 'https://orcid.org/0000-0002-3208-3440'
  - given-names: Manuel
    family-names: Garcia Alvarez
    email: m.g.garciaalvarez@tudelft.nl
    affiliation: Delft University of Technology
    orcid: 'https://orcid.org/0000-0003-1579-9989'
repository-code: 'https://github.com/openearth/aeolis-python'
url: 'https://aeolis.readthedocs.io/'
abstract: AeoLiS is a process-based model for simulating aeolian sediment transport in situations where supply-limiting factors are important, like in costal environments. 
keywords:
  - python
  - simulation
  - sediment
license: GPL-3.0
commit: 0adaedfc8015f18b3b551bed1dda38d630cd8c95
version: 3.0.1
date-released: '2025-07-11'

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 4 days ago

Total Commits: 779
Total Committers: 15
Avg Commits per committer: 51.933
Development Distribution Score (DDS): 0.751

Commits in past year: 48
Committers in past year: 3
Avg Commits per committer in past year: 16.0
Development Distribution Score (DDS) in past year: 0.333

Name Email Commits
Sierd s****s@t****l 194
Bas Hoonhout b****s@h****m 121
Manuel G. Garcia g****2@g****m 117
bartvanwesten b****w@l****l 79
Nick Cohn n****n@g****m 61
Bas Hoonhout b****t@d****l 58
CarolineHalllin c****n@t****e 56
Niket 1****l 25
tomspak t****k@t****l 21
christavanijzendoorn c****n@g****m 14
copilot-swe-agent[bot] 1****t 14
Nellskaden 6****n 9
GlennStrypsteen g****n@k****e 7
OlivierBurvingt o****t@b****r 2
Bas Hoonhout h****t@B****x 1

Committer domains:


Issue and Pull Request metadata

Last synced: about 2 months ago

Total issues: 103
Total pull requests: 103
Average time to close issues: 2 months
Average time to close pull requests: 19 days
Total issue authors: 18
Total pull request authors: 9
Average comments per issue: 1.0
Average comments per pull request: 0.62
Merged pull request: 77
Bot issues: 0
Bot pull requests: 0

Past year issues: 4
Past year pull requests: 24
Past year average time to close issues: N/A
Past year average time to close pull requests: 3 days
Past year issue authors: 4
Past year pull request authors: 4
Past year average comments per issue: 0.25
Past year average comments per pull request: 1.13
Past year merged pull request: 12
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/openearth/aeolis-python

Top Issue Authors

  • manuGil (28)
  • Sierd (19)
  • niketagrawal (15)
  • bartvanwesten (12)
  • GlennStrypsteen (5)
  • christavanijzendoorn (5)
  • maddykelley (3)
  • frederikvand (3)
  • CarolineHalllin (3)
  • Jan-MarkusHomberger (2)
  • JiHuGUO (1)
  • ghendrickx (1)
  • QuentinLf (1)
  • saeb-faraji-gargari (1)
  • lzhu5 (1)

Top Pull Request Authors

  • Sierd (33)
  • manuGil (23)
  • niketagrawal (11)
  • bartvanwesten (11)
  • christavanijzendoorn (8)
  • CarolineHalllin (6)
  • GlennStrypsteen (6)
  • Copilot (3)
  • ssheminway (2)

Top Issue Labels

  • documentation (17)
  • enhancement (15)
  • bug (14)
  • question (14)
  • test (8)
  • refactoring (7)
  • help wanted (3)
  • wontfix (2)

Top Pull Request Labels

  • documentation (14)
  • bug (7)
  • enhancement (3)
  • test (3)
  • refactoring (1)

Package metadata

proxy.golang.org: github.com/openearth/aeolis-python

  • Homepage:
  • Documentation: https://pkg.go.dev/github.com/openearth/aeolis-python#section-documentation
  • Licenses: gpl-3.0
  • Latest release: v3.0.1+incompatible (published about 1 year ago)
  • Last Synced: 2026-07-20T20:00:50.730Z (4 days ago)
  • Versions: 11
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Rankings:
    • Dependent packages count: 5.395%
    • Average: 5.576%
    • Dependent repos count: 5.758%
pypi.org: aeolis

A process-based model for simulating supply-limited aeolian sediment transport

  • Homepage: https://github.com/openearth/aeolis-python
  • Documentation: https://aeolis-python.readthedocs.io
  • Licenses: GNU General Public License v3 (GPLv3)
  • Latest release: 3.0.1 (published about 1 year ago)
  • Last Synced: 2026-07-20T20:00:49.032Z (4 days ago)
  • Versions: 26
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 299 Last month
  • Rankings:
    • Dependent packages count: 9.991%
    • Downloads: 11.435%
    • Average: 29.674%
    • Dependent repos count: 67.598%
  • Maintainers (2)

Dependencies

docs/requirements.txt pypi
  • AeoLiS ==2.0.0.dev2
  • sphinxcontrib-bibtex <2.0.0
  • sphinxcontrib-napoleon *
requirements.txt pypi
  • bmi-python *
  • codecov *
  • coverage *
  • ipykernel *
  • matplotlib *
  • netCDF4 *
  • nose *
  • scipy *
setup.py pypi
  • bmi-python *
  • docopt ==0.6.1
  • matplotlib *
  • netCDF4 *
  • numpy *
  • scipy *

Score: 13.124690667163419