https://github.com/yunica/landsat2geojson
The landsat2geojson package is written in python and uses the EarthExplorer and Overpass portal interface to search, download, and process scenes from Landsat Collections via the command line.
https://github.com/yunica/landsat2geojson
data-downloader landsat osm-data overpass python water
Last synced: 5 months ago
JSON representation
The landsat2geojson package is written in python and uses the EarthExplorer and Overpass portal interface to search, download, and process scenes from Landsat Collections via the command line.
- Host: GitHub
- URL: https://github.com/yunica/landsat2geojson
- Owner: yunica
- License: other
- Created: 2022-02-04T15:52:48.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-07-04T17:55:00.000Z (over 2 years ago)
- Last Synced: 2025-04-19T20:38:41.969Z (6 months ago)
- Topics: data-downloader, landsat, osm-data, overpass, python, water
- Language: Python
- Homepage:
- Size: 91.8 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Description
The landsat2geojson package is written in python and uses the [EarthExplorer](https://earthexplorer.usgs.gov/)
and [Overpass](https://overpass-turbo.eu/) portal interface to search, download, and process scenes from Landsat
Collections via the command line.
# Requirements
landsat2geojson uses the [landsatxplore](https://github.com/yannforget/landsatxplore) package to connect and download
the landsat images, the credentials can be obtained in [Earth Explorer Page](https://ers.cr.usgs.gov/register/)
`--username` and `--password` can be provided as command-line options or as environment variables:
```sh
export LANDSATXPLORE_USERNAME=
export LANDSATXPLORE_PASSWORD=
```
# Installation
## repository
the installation from the repository
```sh
git clone https://github.com/yunica/landsat2geojson.git
cd landsat2geojson
pip install .
```
## docker
build
```sh
export LANDSATXPLORE_USERNAME=
export LANDSATXPLORE_PASSWORD=
docker-compose build
```
run
```shell
docker run --rm -v ${PWD}:/mnt \
-e LANDSATXPLORE_USERNAME=$LANDSATXPLORE_USERNAME \
-e LANDSATXPLORE_PASSWORD=$LANDSATXPLORE_PASSWORD \
landsat2geojson:v1 \
landsat2geojson --geojson_file=test.geojson --data_folder=data/ --geojson_output=data/salida123.geojson
```
or
```shell
docker run --rm -v ${PWD}:/mnt landsat2geojson:v1 \
landsat2geojson -u= -p= --geojson_file=test.geojson --data_folder=data/ --geojson_output=data/salida123.geojson
```
# Usage
## help
you can review the parameters menu with the param `--help`
```sh
landsat2geojson --help
```
```sh
Usage: landsat2geojson [OPTIONS]
Options:
-u, --username TEXT EarthExplorer username.
-p, --password TEXT EarthExplorer password.
--geojson_file TEXT Pathfile from geojson input [required]
--data_folder TEXT Path from download data
--lansat_index [WATER] Landsar normalized index
--geojson_output TEXT Pathfile from geojson output [required]
--help Show this message and exit.
```
### example
```sh
landsat2geojson --geojson_file=area.geojson --data_folder=data/ --geojson_output=data/output_data.geojson
```
