Tools to quickly find the Sentinel2, Landasat5, and Landsat8 tiles that match a given region of interest.
Project description
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
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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.