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

Download files

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

Source Distribution

eo_tilematcher-0.1.3.tar.gz (10.2 MB view details)

Uploaded Source

File details

Details for the file eo_tilematcher-0.1.3.tar.gz.

File metadata

  • Download URL: eo_tilematcher-0.1.3.tar.gz
  • Upload date:
  • Size: 10.2 MB
  • Tags: Source
  • Uploaded using 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

File hashes

Hashes for eo_tilematcher-0.1.3.tar.gz
Algorithm Hash digest
SHA256 5497dd500938edd1c3a14f276660ecd4bcf6084d8cd11d5bc36910c5ac55b560
MD5 6ffc816504d2e87ee03b49095a076bbd
BLAKE2b-256 3760da662c4d99b3d5c3cfd85c71114512bf907e625178ddcbf1eeff629b66a6

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.1.3 This release

1 file

0.1.1

1 file

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page