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
- Host: GitHub
- URL: https://github.com/openearth/aeolis-python
- Owner: openearth
- License: gpl-3.0
- Created: 2015-12-30T11:32:38.000Z (over 10 years ago)
- Default Branch: main
- Last Pushed: 2026-07-02T08:24:51.000Z (22 days ago)
- Last Synced: 2026-07-20T20:03:32.483Z (4 days ago)
- Language: Jupyter Notebook
- Homepage: http://aeolis.readthedocs.io/
- Size: 147 MB
- Stars: 41
- Watchers: 7
- Forks: 31
- Open Issues: 70
- Releases: 13
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Citation: CITATION.cff
README.md

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
-
Clone the repository using Git, or download the source code.
-
AeoLiS users may install the package with only the required dependencies. Go to
aeolis-pythondirectory and install using pipcd aeolis-python/ pip install . -
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:
- Bart van Westen at Deltares
- Nick Cohn at U.S. Army Engineer Research and Development Center (ERDC)
- Sierd de Vries (founder) at Delft University of Technology
- Christa van IJzendoorn at Delft University of Technology
- Caroline Hallin at Delft University of Technology
- Glenn Strypsteen at Katholieke Universiteit Leuven
- Janelle Skaden at U.S. Army Engineer Research and Development Center (ERDC)
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
- AeoLiS is supported by the Digital Competence Centre, Delft University of Technology.
- The contributing guidelines for AeoLiS are derived from the NLeSC/python-template and numpy contributing guide
© (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
- Name: OpenEarth
- Login: openearth
- Email:
- Kind: organization
- Description:
- Website: http://publicwiki.deltares.nl/display/OET
- Location: Delft
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/6883038?v=4
- Repositories: 197
- Last ynced at: 2024-04-09T19:08:09.196Z
- Profile URL: https://github.com/openearth
GitHub Events
Total
- Release event: 1
- Delete event: 11
- Member event: 1
- Pull request event: 27
- Fork event: 1
- Issues event: 6
- Watch event: 3
- Issue comment event: 14
- Push event: 169
- Pull request review event: 16
- Pull request review comment event: 44
- Create event: 17
Last Year
- Delete event: 4
- Pull request event: 15
- Fork event: 1
- Issues event: 2
- Watch event: 2
- Issue comment event: 12
- Push event: 142
- Pull request review event: 13
- Pull request review comment event: 41
- Create event: 9
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 | 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:
- tudelft.nl: 2
- bass-mbp.fritz.box: 1
- brgm.fr: 1
- kuleuven.be: 1
- tvrl.lth.se: 1
- deltares.nl: 1
- live.nl: 1
- hoonhout.com: 1
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
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
- Total packages: 2
-
Total downloads:
- pypi: 299 last-month
- Total dependent packages: 0 (may contain duplicates)
- Total dependent repositories: 0 (may contain duplicates)
- Total versions: 37
- Total maintainers: 2
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
- AeoLiS ==2.0.0.dev2
- sphinxcontrib-bibtex <2.0.0
- sphinxcontrib-napoleon *
- bmi-python *
- codecov *
- coverage *
- ipykernel *
- matplotlib *
- netCDF4 *
- nose *
- scipy *
- bmi-python *
- docopt ==0.6.1
- matplotlib *
- netCDF4 *
- numpy *
- scipy *
Score: 13.124690667163419