The Earth Library

A spectral library for continuous satellite land cover mapping.

Documentation: earth-chris.github.io/earthlib

:earth_asia: Introduction

earthlib is a python package featuring a global spectral library. It was developed to support satellite-based land cover mapping.

The library contains a diverse catalog of unique spectral endmembers representing green vegetation, bare soil, non-photosynthetic vegetation, urban materials, and burned materials.

The reflectance data cover the visible to the shortwave infrared wavelengths (400-2450 nm) at 10 nm band widths.

earthlib provides tools to resample these spectra to match the wavelengths of popular satellite and airborne earth observing sensors. The purpose is to support running spectral mixture analysis in a sensor-agnostic fashion.

Running spectral mixture analysis across sensors with a consistent spectral library presents a new approach to creating consistent, analysis-ready data.

The goal of earthlib is to help users quantify spatial and temporal patterns of global land cover change in a sensor-generic fashion.

:seedling: Installation

This library can be installed via pip.

pip install earthlib

You can also clone the source repository and install it locally.

git clone https://github.com/earth-chris/earthlib.git
cd earthlib
pip install -e .

The Earth Engine routines (earthlib.geelib) are not currently available. They are out of date with the v1.1 API and are being reworked. The spectral library is unaffected.

:hammer_and_wrench: Development

earthlib uses pixi to manage environments.

git clone https://github.com/earth-chris/earthlib.git
cd earthlib
pixi install

Common tasks:

pixi run test                    # run tests with coverage
pixi run -e lint lint            # format and lint (installs pre-commit hooks)
pixi run -e typecheck typecheck  # run mypy
pixi run -e docs docs-serve      # serve docs locally

Please commit using the development environment to ensure code is well-formatted.

:deciduous_tree: Developed by

Christopher Anderson¹

This package was primarily developed at the Stanford Center for Conservation Biology and Salo Sciences.

Planet Labs PBC ↩

Download files

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

Source Distribution

earthlib-1.1.0.tar.gz (5.0 MB view details)

Uploaded Aug 19, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

earthlib-1.1.0-py3-none-any.whl (4.9 MB view details)

Uploaded Aug 19, 2026 Python 3

File details

Details for the file earthlib-1.1.0.tar.gz.

File metadata

Download URL: earthlib-1.1.0.tar.gz
Upload date: Aug 19, 2026
Size: 5.0 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for earthlib-1.1.0.tar.gz
Algorithm	Hash digest
SHA256	`08ba231776513bc2dcd78cc3eb1a4a9d352aee52cd551968086b93811524663e`
MD5	`f55a4978488b3d7e85d686e5e3db3f40`
BLAKE2b-256	`49c9c9d78eedc0509efc99ebc51609779608796de85ee728ae73b1331fc57a18`

See more details on using hashes here.

Provenance

The following attestation bundles were made for earthlib-1.1.0.tar.gz:

Publisher: publish-pypi.yaml on earth-chris/earthlib

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: earthlib-1.1.0.tar.gz
- Subject digest: 08ba231776513bc2dcd78cc3eb1a4a9d352aee52cd551968086b93811524663e
- Sigstore transparency entry: 2512449807
- Sigstore integration time: Aug 19, 2026
Source repository:
- Permalink: earth-chris/earthlib@0336f284d2905163392cd6807e98cc0f0c15fda0
- Branch / Tag: refs/heads/main
- Owner: https://github.com/earth-chris
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-pypi.yaml@0336f284d2905163392cd6807e98cc0f0c15fda0
- Trigger Event: workflow_dispatch