earthchange

Multipurpose satellite change detection in pure Python. Map deforestation, mining, urbanisation, floods, burns, surface-water change and multi-epoch urban growth anywhere on Earth from free Sentinel-1/2 and Landsat data — via Google Earth Engine or Microsoft Planetary Computer (no account needed). Export georeferenced GeoTIFFs, quick-look PNGs, statistics, and print-ready A4 maps.

Install

Heavy dependencies are optional extras, so the install stays lean:

pip install 'earthchange[gee]'       # Google Earth Engine backend (free account)
pip install 'earthchange[mpc,maps]'  # Planetary Computer + maps (no account)
pip install 'earthchange[all]'       # everything

Quick start

# Deforestation around a coordinate, with a finished map
earthchange -s deforestation --lat -3.333 --lon 122.25 --radius 6 --map

# Flood extent from Sentinel-1 SAR — no Earth Engine account needed
earthchange -s flood --lat 27.2 --lon 68.3 \
    --pre 2022-07-01:2022-07-25 --post 2022-08-20:2022-09-10 --backend mpc

# Urban growth timing across 2010/2015/2020 (Landsat 5/8/9)
earthchange -s urban-trend --lat -6.30 --lon 107.15 --map

# List everything
earthchange --list

Each run writes a self-contained output/<run-id>/ folder containing the PNG, GeoTIFF, statistics JSON, metadata, and any maps.

Scenarios

Scenario Method Sensor
deforestation NDVI loss Sentinel-2
urbanization Built-up gain — NDBI (default), UI, BU, IBI, or thermal NDISI/EBBI via --method Sentinel-2 / Landsat
water NDWI change Sentinel-2
burn dNBR severity Sentinel-2
mining SIRAD radar temporal + NDVI loss Sentinel-1 + S2
flood SAR water extent (event vs baseline) Sentinel-1
urban-trend NDBI at 3 epochs → RGB growth-timing map Landsat 5/8/9
coastline Sea boundary + shoreline change (erosion/accretion) + retreat rate m/yr S1 / S2 / Landsat
transit-access % population with access to public transport (SDG 11.2.1) WorldPop + OSM
island-heat SST + LST + wet-bulb (humid heat) trends for small islands OISST / Landsat / ERA5
urban-heat Urban heat island (SUHII) + hot-spot map + decadal trend GHSL + Landsat + MODIS
forest-history Multi-epoch deforestation: year-of-loss map + forest-area trajectory S2 / Landsat NDVI

Two backends

--backend Data source Account?
gee (default) Google Earth Engine free account + earthengine authenticate
mpc Microsoft Planetary Computer (STAC) none — streams COGs, processes locally

Optical scenarios build cloud-masked median composites; radar scenarios auto-select the Sentinel-1 orbit with coverage. The AOI is a square centred on your coordinate. Landsat 7 is skipped (SLC-off gaps).

Make maps from a finished run

earthmap output/<run-id>            # render A4 map sheets offline (no GEE)

Map sheets include an OpenStreetMap basemap, the change layer, legend, a statistics panel, a location inset, coordinate grid, scale bar and north arrow.

License

MIT © Firman Hadi. Data: Copernicus Sentinel (ESA) and Landsat (USGS/NASA), via Google Earth Engine or Microsoft Planetary Computer.

Project links

Data verified by PyPI on Jul 28, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.86)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for firmanhadi from gravatar.com firmanhadi

Credits

Author/Maintainer: Firman Hadi

GitHub Statistics

Data verified by PyPI on Jul 28, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.11

Provides Extra

all gee maps mpc transit

Tags

change-detection deforestation earth-engine flood geospatial gis landsat ndbi ndvi planetary-computer remote-sensing sentinel

Classifiers

Report project as malware

Download files

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

Source Distribution

earthchange-0.1.33.tar.gz (103.4 kB view details)

Uploaded Source

Built Distribution

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

earthchange-0.1.33-py3-none-any.whl (98.9 kB view details)

Uploaded Python 3

File details

Details for the file earthchange-0.1.33.tar.gz.

File metadata

  • Download URL: earthchange-0.1.33.tar.gz
  • Upload date:
  • Size: 103.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for earthchange-0.1.33.tar.gz
Algorithm Hash digest
SHA256 9b440734a929cf11c9ae8d631b69e75d01bd0facbb71eafe14afd74cc813770f
MD5 cfc2975c823423f746f642f774273af5
BLAKE2b-256 760b0a6efb622e2d44025a94336ec36d8cf98e613356095e8076b12b0888a9fc

See more details on using hashes here.

Provenance

The following attestation bundles were made for earthchange-0.1.33.tar.gz:

Publisher: publish.yml on firmanhadi21/rs-change-detection

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

File details

Details for the file earthchange-0.1.33-py3-none-any.whl.

File metadata

  • Download URL: earthchange-0.1.33-py3-none-any.whl
  • Upload date:
  • Size: 98.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for earthchange-0.1.33-py3-none-any.whl
Algorithm Hash digest
SHA256 b0391a863e3be70168ecd38678ce95ce5aaedca59edf19409069d3e5a587759b
MD5 d6cc12ac92c487912e18d7a8edb69ac1
BLAKE2b-256 3ce2a2fa5009c1ecf7612cfc94522db8714fb02de0601bf99dfcd066819df16a

See more details on using hashes here.

Provenance

The following attestation bundles were made for earthchange-0.1.33-py3-none-any.whl:

Publisher: publish.yml on firmanhadi21/rs-change-detection

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

Release history Release notifications | RSS feed

0.1.86

2 files

0.1.85

2 files

0.1.84

2 files

0.1.83

2 files

0.1.82

2 files

0.1.81

2 files

0.1.79

2 files

0.1.78

2 files

0.1.77

2 files

0.1.76

2 files

0.1.75

2 files

0.1.74

2 files

0.1.73

2 files

0.1.72

2 files

0.1.71

2 files

0.1.70

2 files

0.1.69

2 files

0.1.68

2 files

0.1.67

2 files

0.1.66

2 files

0.1.64

2 files

0.1.63

2 files

0.1.62

2 files

0.1.61

2 files

0.1.60

2 files

0.1.59

2 files

0.1.56

2 files

0.1.55

2 files

0.1.54

2 files

0.1.53

2 files

0.1.52

2 files

0.1.51

2 files

0.1.50

2 files

0.1.48

2 files

0.1.47

2 files

0.1.46

2 files

0.1.45

2 files

0.1.44

2 files

0.1.43

2 files

0.1.42

2 files

0.1.41

2 files

0.1.40

2 files

0.1.39

2 files

0.1.38

2 files

0.1.37

2 files

0.1.36

2 files

0.1.35

2 files

0.1.34

2 files

This release

0.1.33 This release

2 files

0.1.32

2 files

0.1.31

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page