Skip to main content

Tools to quickly find the Sentinel2, Landsat5, and Landsat8 tiles that a given region of interest.

Basically, the library returns a geodataframe with:

  • geometry: is the requested geometry to be matched against satellite tiles

  • match_polygon: is the intersection/contains WKT geometry (string) that matches each satellite tile

  • match: partial/total (str). total indicates a contains conditition.

  • TILE (Sentinel2) or PATH#ROW (Landsat): the satellite tile (path,row) matched in match condition (Sentinel/Landsat convention)

Usage

Basic library usage

For this case, import the library:

from eo_tilematcher import intersects

and run:

geo_match = intersects(spacecraft,ROI)

Where

  • ROI=geopandas geodataframe

  • spacecraft ={sentinel2,landsat8,landsat5}

Check the eo-tilematcher-101 tutorial notebook to see some plots.

Command-line usage

  1. Print the tiles intersecting a Region Of Interest (ROI) for a given satellite:

    python -m eo_tilematcher /path/to/ROI --spacecraft spacecraft

or:

eo_tilematcher /path/to/ROI --spacecraft spacecraft

Where: - /path/to/ROI is the path to any kind of file that fiona could open (shp,gpkg,geojson,…) - spacecraft ={sentinel2,landsat8,landsat5} (default sentinel2 no input required).

2. Find and save to a file the tiles intersecting a Region Of Interest (ROI) for a given satellite With dump:

python -m eo_tilematcher /path/to/ROI --spacecraft spacecraft  --output my_ouput.gpkg

or:

eo_tilematcher /path/to/ROI --spacecraft spacecraft  --output my_ouput.gpkg

Installation

You can install them from PyPI by simply running:

pip install eo_tilematcher

Installation from sources

To install the package, from the project root run:

pip install .  # Regular installation
pip install -e .  # Install in development mode

Metadata

Release files for eo-tilematcher 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for eo-tilematcher 0.1.3
File Size Uploaded
eo_tilematcher-0.1.3.tar.gz 10.2 MB Details

Release files / eo_tilematcher-0.1.3.tar.gz

Download URL eo_tilematcher-0.1.3.tar.gz
Size 10.2 MB
Tags Source
SHA-256 checksum
How to use checksums
5497dd500938edd1c3a14f276660ecd4bcf6084d8cd11d5bc36910c5ac55b560
BLAKE2b-256 checksum
How to use checksums
3760da662c4d99b3d5c3cfd85c71114512bf907e625178ddcbf1eeff629b66a6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/0.0.0 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

Release history Release notifications | RSS feed

This release

0.1.3 This release

1 release file

0.1.1

1 release file

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