Skip to main content

Open-source Python package for numerical modeling of Earth surface dynamics.

Project description

https://zenodo.org/badge/DOI/10.5281/zenodo.3776837.svg https://readthedocs.org/projects/landlab/badge/?version=latest https://github.com/landlab/landlab/actions/workflows/test.yml/badge.svg https://github.com/landlab/landlab/actions/workflows/lint.yml/badge.svg https://github.com/landlab/landlab/actions/workflows/test-notebooks.yml/badge.svg https://github.com/landlab/landlab/actions/workflows/docs.yml/badge.svg https://coveralls.io/repos/landlab/landlab/badge.png https://mybinder.org/badge_logo.svg

Landlab

What does Landlab do?

Landlab is an open-source Python-language package for numerical modeling of Earth surface dynamics. It contains

  • A gridding engine which represents the model domain. Regular and irregular grids are supported.

  • A library of process components, each of which represents a physical process (e.g., generation of rain, erosion by flowing water). These components have a common interface and can be combined based on a user’s needs.

  • Utilities that support general numerical methods, file input/output, and visualization.

In addition Landlab contains a set of Jupyter notebook tutorials providing an introduction to core concepts and examples of use.

Landlab was designed for disciplines that quantify Earth surface dynamics such as geomorphology, hydrology, glaciology, and stratigraphy. It can also be used in related fields. Scientists who use this type of model often build their own unique model from the ground up, re-coding the basic building blocks of their landscape model rather than taking advantage of codes that have already been written. Landlab saves practitioners from the need for this kind of re-invention by providing standardized components that they can re-use.

Watch the webinar Landlab Toolkit Overview at CSDMS to learn more.


Read the documentation on ReadTheDocs!


Installation

To install the latest release of landlab using pip, simply run the following in your terminal of choice:

$ pip install landlab

For a full description of how to install Landlab, including using mamba/conda, please see the documentation for our installation instructions.

Source code

If you would like to modify or contribute code to Landlab or use the very latest development version, please see the documentation that describes how to install landlab from source.

Are there any examples of using Landlab I can look at?

The Landlab package contains a directory, landlab/notebooks, with Jupyter Notebooks describing core concepts and giving examples of using components. The file landlab/notebooks/welcome.ipynb provides a table of contents to the notebooks and is the recommended starting place. Additionally, there are a set of notebooks curated to teach physical processes located in the directory landlab/notebooks/teaching.

Run on Binder

To launch an instance of Binder and explore the notebooks click here.

To launch a Binder instance that goes straight to the teaching notebooks click here.

Run on EarthscapeHub

The Landlab notebooks can also be run on EarthscapeHub. Visit this link to learn how to sign up for a free account. Explore the example notebooks on the lab or jupyter Hub instance. Or, use the teaching notebooks on the lab or jupyter Hub instance. Be sure to run all notebooks with the CSDMS kernel.

License

landlab is licensed under the MIT License.

Citing Landlab

If you use any portion of Landlab, please see the documentation for our citation guidelines.

Contact

The recommended way to contact the Landlab team is with a GitHub Issue.

  • Bug reports: Please make an Issue describing the bug so we can address it, or work with you to address it. Please try to provide a minimal, reproducible example.

  • Documentation: If something in our documentation is not clear to you, please make an issue describing the what isn’t clear. Someone will tag the most appropriate member of the core Landlab team. We will work to clarify your question and revise the documentation so that it is clear for the next user.

Keep in touch with the latest landlab news by following us on Twitter.

During workshops and clinics, we sometimes use the Landlab Slack channel.

Credits

Development Leads

Contributors

Project details


Release history Release notifications | RSS feed

This version

2.7.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

landlab-2.7.0.tar.gz (1.7 MB view hashes)

Uploaded Source

Built Distributions

landlab-2.7.0-cp312-cp312-win_amd64.whl (3.3 MB view hashes)

Uploaded CPython 3.12 Windows x86-64

landlab-2.7.0-cp312-cp312-win32.whl (3.1 MB view hashes)

Uploaded CPython 3.12 Windows x86

landlab-2.7.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (12.1 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ x86-64

landlab-2.7.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (11.9 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ ARM64

landlab-2.7.0-cp312-cp312-macosx_11_0_arm64.whl (3.2 MB view hashes)

Uploaded CPython 3.12 macOS 11.0+ ARM64

landlab-2.7.0-cp312-cp312-macosx_10_9_x86_64.whl (3.3 MB view hashes)

Uploaded CPython 3.12 macOS 10.9+ x86-64

landlab-2.7.0-cp311-cp311-win_amd64.whl (3.3 MB view hashes)

Uploaded CPython 3.11 Windows x86-64

landlab-2.7.0-cp311-cp311-win32.whl (3.1 MB view hashes)

Uploaded CPython 3.11 Windows x86

landlab-2.7.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (11.8 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ x86-64

landlab-2.7.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (11.6 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ ARM64

landlab-2.7.0-cp311-cp311-macosx_11_0_arm64.whl (3.2 MB view hashes)

Uploaded CPython 3.11 macOS 11.0+ ARM64

landlab-2.7.0-cp311-cp311-macosx_10_9_x86_64.whl (3.3 MB view hashes)

Uploaded CPython 3.11 macOS 10.9+ x86-64

landlab-2.7.0-cp310-cp310-win_amd64.whl (3.3 MB view hashes)

Uploaded CPython 3.10 Windows x86-64

landlab-2.7.0-cp310-cp310-win32.whl (3.1 MB view hashes)

Uploaded CPython 3.10 Windows x86

landlab-2.7.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (10.8 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ x86-64

landlab-2.7.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (10.7 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ ARM64

landlab-2.7.0-cp310-cp310-macosx_11_0_arm64.whl (3.2 MB view hashes)

Uploaded CPython 3.10 macOS 11.0+ ARM64

landlab-2.7.0-cp310-cp310-macosx_10_9_x86_64.whl (3.3 MB view hashes)

Uploaded CPython 3.10 macOS 10.9+ x86-64

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page