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
population-change Two-epoch population change: Miloš-style spike poster + map + optional true GPU 3D via forge3d GHSL GHS_POP
haze Smoke & air quality during fires: PM2.5 (ISPU), aerosol index, hotspots CAMS + Sentinel-5P + FIRMS
fire-history Multi-year fire record: burned area per year (peat vs mineral), recurrence map, fire season MODIS MCD64A1 + FIRMS

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 29, 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 29, 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 forge3d 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.46.tar.gz (141.1 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.46-py3-none-any.whl (135.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: earthchange-0.1.46.tar.gz
  • Upload date:
  • Size: 141.1 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.46.tar.gz
Algorithm Hash digest
SHA256 d0414ec0812ebef936989b7b29d743042c0b889554e549915a2f28b3e85aecae
MD5 1b7acc7844517b79055ec7557afe3c09
BLAKE2b-256 8468f637c1e1cad9af6f0f7f8a6bd1cce03665a1e330444e497614ab8c4c1160

See more details on using hashes here.

Provenance

The following attestation bundles were made for earthchange-0.1.46.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.46-py3-none-any.whl.

File metadata

  • Download URL: earthchange-0.1.46-py3-none-any.whl
  • Upload date:
  • Size: 135.5 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.46-py3-none-any.whl
Algorithm Hash digest
SHA256 3d2bb7e4f94e765920429acef6f402e8d70336052999e088576ed9007eb697bc
MD5 2048372a5e1ce5473c3f5e3044253b22
BLAKE2b-256 59a8cc137b3bccbcd171bd8d76271951c987de9860fa82b4190926190dcfbc1b

See more details on using hashes here.

Provenance

The following attestation bundles were made for earthchange-0.1.46-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

This release

0.1.46 This release

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

0.1.33

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