# 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=<your_username>
export LANDSATXPLORE_PASSWORD=<your_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=<your_username>
export LANDSATXPLORE_PASSWORD=<your_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=<LANDSATXPLORE_USERNAME> -p=<LANDSATXPLORE_PASSWORD> --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
```
Raw data
{
"_id": null,
"home_page": "https://github.com/yunica/landsat2geojson",
"name": "landsat2geojson",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "earth observation,remote sesing,GIS,satellite imagery,landsat,water,usgs,geojson,overpass",
"author": "Junior Flores",
"author_email": "junior@developmentseed.org",
"download_url": "https://files.pythonhosted.org/packages/42/f2/b1d0a2b8fe4911ac235902b1903c8691cbb8d71a2114f7913b5b2b75fe12/landsat2geojson-0.0.3.tar.gz",
"platform": null,
"description": "# Description\n\nThe landsat2geojson package is written in python and uses the [EarthExplorer](https://earthexplorer.usgs.gov/)\nand [Overpass](https://overpass-turbo.eu/) portal interface to search, download, and process scenes from Landsat\nCollections via the command line.\n\n# Requirements\n\nlandsat2geojson uses the [landsatxplore](https://github.com/yannforget/landsatxplore) package to connect and download\nthe landsat images, the credentials can be obtained in [Earth Explorer Page](https://ers.cr.usgs.gov/register/)\n\n`--username` and `--password` can be provided as command-line options or as environment variables:\n\n\n```sh \nexport LANDSATXPLORE_USERNAME=<your_username>\nexport LANDSATXPLORE_PASSWORD=<your_password>\n```\n\n# Installation\n## repository\nthe installation from the repository \n\n```sh \ngit clone https://github.com/yunica/landsat2geojson.git\ncd landsat2geojson\npip install .\n\n```\n## docker\nbuild\n\n```sh\nexport LANDSATXPLORE_USERNAME=<your_username>\nexport LANDSATXPLORE_PASSWORD=<your_password>\n\ndocker-compose build \n```\nrun\n\n```shell\ndocker run --rm -v ${PWD}:/mnt \\\n -e LANDSATXPLORE_USERNAME=$LANDSATXPLORE_USERNAME \\\n -e LANDSATXPLORE_PASSWORD=$LANDSATXPLORE_PASSWORD \\\n landsat2geojson:v1 \\\n landsat2geojson --geojson_file=test.geojson --data_folder=data/ --geojson_output=data/salida123.geojson \n\n```\nor \n```shell\ndocker run --rm -v ${PWD}:/mnt landsat2geojson:v1 \\\n landsat2geojson -u=<LANDSATXPLORE_USERNAME> -p=<LANDSATXPLORE_PASSWORD> --geojson_file=test.geojson --data_folder=data/ --geojson_output=data/salida123.geojson \n\n```\n# Usage\n\n\n## help\nyou can review the parameters menu with the param `--help`\n```sh\nlandsat2geojson --help\n```\n```sh\nUsage: landsat2geojson [OPTIONS]\n\nOptions:\n -u, --username TEXT EarthExplorer username.\n -p, --password TEXT EarthExplorer password.\n --geojson_file TEXT Pathfile from geojson input [required]\n --data_folder TEXT Path from download data\n --lansat_index [WATER] Landsar normalized index\n --geojson_output TEXT Pathfile from geojson output [required]\n --help Show this message and exit.\n```\n\n### example\n\n```sh\nlandsat2geojson --geojson_file=area.geojson --data_folder=data/ --geojson_output=data/output_data.geojson \n```\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "Script to extract features from landsat",
"version": "0.0.3",
"project_urls": {
"Homepage": "https://github.com/yunica/landsat2geojson"
},
"split_keywords": [
"earth observation",
"remote sesing",
"gis",
"satellite imagery",
"landsat",
"water",
"usgs",
"geojson",
"overpass"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "42f2b1d0a2b8fe4911ac235902b1903c8691cbb8d71a2114f7913b5b2b75fe12",
"md5": "4dbfc353430d9caa0c92426f0f9a2c6e",
"sha256": "8dffb33e6fb6903b5fe722bf2e3bcf001ea131529f87085272435bd0aca156bc"
},
"downloads": -1,
"filename": "landsat2geojson-0.0.3.tar.gz",
"has_sig": false,
"md5_digest": "4dbfc353430d9caa0c92426f0f9a2c6e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 10996,
"upload_time": "2023-07-04T17:53:58",
"upload_time_iso_8601": "2023-07-04T17:53:58.570643Z",
"url": "https://files.pythonhosted.org/packages/42/f2/b1d0a2b8fe4911ac235902b1903c8691cbb8d71a2114f7913b5b2b75fe12/landsat2geojson-0.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-04 17:53:58",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yunica",
"github_project": "landsat2geojson",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "landsat2geojson"
}
JSON
