# stactools-landsat
[](https://pypi.org/project/stactools-landsat/)
- Name: landsat
- Package: `stactools.landsat`
- PyPI: <https://pypi.org/project/stactools-landsat/>
- Owners:
- @lossyrob
- @pjhartzell
- @gadomski
- Dataset homepages:
- <https://www.usgs.gov/landsat-missions>
- <https://landsat.gsfc.nasa.gov/>
- STAC extensions used:
- [classification](https://github.com/stac-extensions/classification)
- [eo](https://github.com/stac-extensions/eo)
- [landsat](https://landsat.usgs.gov/stac/landsat-extension/v1.1.1/schema.json)
- [proj](https://github.com/stac-extensions/projection/)
- [raster](https://github.com/stac-extensions/raster)
- [scientific](https://github.com/stac-extensions/scientific)
- [view](https://github.com/stac-extensions/view)
This repository will assist you in the generation of STAC files for Landsat datasets. The table below provides an overview on Landsat Mission's sensors and band wavelengths.
<!-- markdownlint-disable MD033 -->
<img width="1147" alt="Landsat Missions - Sensors and Band Wavelengths" src="https://user-images.githubusercontent.com/1312546/190440352-0b6e2c81-f1b4-48ff-bcf1-5b5addba1bd9.png">
<!-- markdownlint-enable MD033 -->
Source: <https://pubs.usgs.gov/fs/2015/3081/fs20153081.pdf>
## Examples
### STAC Collections and Items
- [Collection](examples/landsat-c2-l2/collection.json)
- [Item](examples/landsat-c2-l1/LM01_L1GS_001010_19720908_02_T2/LM01_L1GS_001010_19720908_02_T2.json)
### Command-line usage
To create a STAC `Item`:
```bash
stac landsat create-item --mtl tests/data-files/oli-tirs/LC08_L2SP_047027_20201204_20210313_02_T1_MTL.xml --output examples --usgs_geometry
```
To create a STAC `Collection` from a text file containing a list of Landsat scene XML metadata files:
```bash
stac landsat create-collection --file_list examples/c2-l2-file-list.txt --output examples/landsat-c2-l2 --id landsat-c2-l2 --usgs_geometry
```
The above `create-collection` command is exactly how the contents of the `examples/landsat-c2-l2` directory are generated.
Raw data
{
"_id": null,
"home_page": "https://github.com/stactools-packages/landsat",
"name": "stactools-landsat",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "stactools,pystac,catalog,STAC,Landsat",
"author": "stac-utils",
"author_email": "stac@radiant.earth",
"download_url": "https://files.pythonhosted.org/packages/5e/d6/22d92ebc8be0aed09f2ec90048a7f51044a49d8d687ea3bd7f400c01a24e/stactools-landsat-0.4.1.tar.gz",
"platform": null,
"description": "# stactools-landsat\n\n[](https://pypi.org/project/stactools-landsat/)\n\n- Name: landsat\n- Package: `stactools.landsat`\n- PyPI: <https://pypi.org/project/stactools-landsat/>\n- Owners:\n - @lossyrob\n - @pjhartzell\n - @gadomski\n- Dataset homepages:\n - <https://www.usgs.gov/landsat-missions>\n - <https://landsat.gsfc.nasa.gov/>\n- STAC extensions used:\n - [classification](https://github.com/stac-extensions/classification)\n - [eo](https://github.com/stac-extensions/eo)\n - [landsat](https://landsat.usgs.gov/stac/landsat-extension/v1.1.1/schema.json)\n - [proj](https://github.com/stac-extensions/projection/)\n - [raster](https://github.com/stac-extensions/raster)\n - [scientific](https://github.com/stac-extensions/scientific)\n - [view](https://github.com/stac-extensions/view)\n\nThis repository will assist you in the generation of STAC files for Landsat datasets. The table below provides an overview on Landsat Mission's sensors and band wavelengths.\n\n<!-- markdownlint-disable MD033 -->\n<img width=\"1147\" alt=\"Landsat Missions - Sensors and Band Wavelengths\" src=\"https://user-images.githubusercontent.com/1312546/190440352-0b6e2c81-f1b4-48ff-bcf1-5b5addba1bd9.png\">\n<!-- markdownlint-enable MD033 -->\n\nSource: <https://pubs.usgs.gov/fs/2015/3081/fs20153081.pdf>\n\n## Examples\n\n### STAC Collections and Items\n\n- [Collection](examples/landsat-c2-l2/collection.json)\n- [Item](examples/landsat-c2-l1/LM01_L1GS_001010_19720908_02_T2/LM01_L1GS_001010_19720908_02_T2.json)\n\n### Command-line usage\n\nTo create a STAC `Item`:\n\n```bash\nstac landsat create-item --mtl tests/data-files/oli-tirs/LC08_L2SP_047027_20201204_20210313_02_T1_MTL.xml --output examples --usgs_geometry\n```\n\nTo create a STAC `Collection` from a text file containing a list of Landsat scene XML metadata files:\n\n```bash\nstac landsat create-collection --file_list examples/c2-l2-file-list.txt --output examples/landsat-c2-l2 --id landsat-c2-l2 --usgs_geometry\n```\n\nThe above `create-collection` command is exactly how the contents of the `examples/landsat-c2-l2` directory are generated.\n",
"bugtrack_url": null,
"license": "",
"summary": "stactools package for Landsat data",
"version": "0.4.1",
"project_urls": {
"Homepage": "https://github.com/stactools-packages/landsat",
"Issues": "https://github.com/stactools-packages/landsat/issues"
},
"split_keywords": [
"stactools",
"pystac",
"catalog",
"stac",
"landsat"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7d1d321a63f7109dd0ed4c6d1ffe6a388e69b3b0ac86be6293052c3869ec3074",
"md5": "af7b19b95cedd03a9cd11cccf9936af2",
"sha256": "9db1b66fe4e009e5c5e780950542d04ad547447c9619ec05ebd8d2cab264a73c"
},
"downloads": -1,
"filename": "stactools_landsat-0.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "af7b19b95cedd03a9cd11cccf9936af2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 36449,
"upload_time": "2023-08-31T12:17:36",
"upload_time_iso_8601": "2023-08-31T12:17:36.366733Z",
"url": "https://files.pythonhosted.org/packages/7d/1d/321a63f7109dd0ed4c6d1ffe6a388e69b3b0ac86be6293052c3869ec3074/stactools_landsat-0.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5ed622d92ebc8be0aed09f2ec90048a7f51044a49d8d687ea3bd7f400c01a24e",
"md5": "a1542a84e81b3042a4c0fa0238d88756",
"sha256": "5aec54ef8abda7407621f7a1f40b260b4da3a1353b2140f9649383cdd7aa21b6"
},
"downloads": -1,
"filename": "stactools-landsat-0.4.1.tar.gz",
"has_sig": false,
"md5_digest": "a1542a84e81b3042a4c0fa0238d88756",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 29596,
"upload_time": "2023-08-31T12:17:38",
"upload_time_iso_8601": "2023-08-31T12:17:38.158097Z",
"url": "https://files.pythonhosted.org/packages/5e/d6/22d92ebc8be0aed09f2ec90048a7f51044a49d8d687ea3bd7f400c01a24e/stactools-landsat-0.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-31 12:17:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "stactools-packages",
"github_project": "landsat",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "stactools-landsat"
}
JSON
