{ "info": { "author": "AdamR", "author_email": "25871157+and-viceversa@users.noreply.github.com", "bugtrack_url": null, "classifiers": [], "description": "Anyone is free to copy, modify, publish, use, compile, sell, or\ndistribute this software, either in source code form or as a compiled\nbinary, for any purpose, commercial or non-commercial, and by any\nmeans.\n\nIn jurisdictions that recognize copyright laws, the author or authors\nof this software dedicate any and all copyright interest in the\nsoftware to the public domain. We make this dedication for the benefit\nof the public at large and to the detriment of our heirs and\nsuccessors. We intend this dedication to be an overt act of\nrelinquishment in perpetuity of all present and future rights to this\nsoftware under copyright law.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND,\nEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\nMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.\nIN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR\nOTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,\nARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR\nOTHER DEALINGS IN THE SOFTWARE.\n\nFor more information, please refer to \nDescription: ## Background\n \n Landsat-8 Level 1 scenes come with a quality assessment band (BQA) that shows various forms of atmospheric and other interference present in the image.\n \n The accompanying BQA file is a GeoTIFF with bit-packed values corresponding to an internal USGS numbering scheme. You can learn about these values and the BQA band in general by reading the USGS overview located [here](https://www.usgs.gov/land-resources/nli/landsat/landsat-collection-1-level-1-quality-assessment-band?qt-science_support_page_related_con=0#qt-science_support_page_related_con). There is also a more in-depth PDF titled 'Landsat Quality Assessment (QA) Tools User's Guide'.\n \n ## Usage\n \n This CLI tool may be useful to you if you are working with Landsat-8 quality assessment data in Python 3.\n \n This tool is written to search the directory where it is run, and all sub-directories for Landsat-8 BQA bands. It then 'unpacks' the bit packed BQA raster and creates a new GeoTIFF for each USGS quality measure that the user specifies. Finally, the tool takes the new quality bands for each scene and creates a composite image stack for each quality control measure.\n \n For example, you can take a directory of Landsat-8 scenes, pull out all cloudy pixels, and create a composite image showing all cloudy pixels in the stack.\n \n This is helpful for time series analysis because you can identify atmospheric interference over time.\n \n Flags correspond to each quality assessment layer identified by USGS.\n The following will produce individual BQA band files for every quality assessment type identified by USGS and then build composites from each quality assessment type.\n \n ```commandline\n cd /filepath/to/top_dir_for_landsat_scenes\n landsat_L1_qa_tool -c -f -t -r -cl -cc -cs -ci -s\n ```\n \n Quality assessment types:\n ```commandline\n -c --clear-terrain\n -f --fill\n -t --terrain-occlusion\n -r --radiometric-saturation\n -cl --clouds\n -cc --cloud-confidence\n -cs --cloud-shadow\n -ci --cirrus\n -s --snow-ice\n ```\n \n ## Other Tools\n \n Other great tools exist, and are more comprehensive.\n \n -USGS has several offerings [here](https://www.usgs.gov/land-resources/nli/landsat/landsat-quality-assessment-tools).\n \n -USGS EROS offers [landsat-qa-arcgis-toolbox](https://github.com/USGS-EROS/landsat-qa-arcgis-toolbox), [espa-science-validation](https://github.com/USGS-EROS/espa-science-validation), and [espa-l2qa-tools](https://github.com/USGS-EROS/espa-l2qa-tools).\n \n -Rasterio's Landsat-8 QA tools is [here](https://github.com/mapbox/rio-l8qa).\n \n \nPlatform: UNKNOWN\nClassifier: Programming Language :: Python :: 3\nClassifier: License :: Unlicense\nClassifier: Topic :: Landsat :: data conversion\nDescription-Content-Type: text/markdown\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/and-viceversa/landsat_L1_qa_tool", "keywords": "", "license": "This is free and unencumbered software released into the public domain.", "maintainer": "", "maintainer_email": "", "name": "landsat-L1-qa-tool", "package_url": "https://pypi.org/project/landsat-L1-qa-tool/", "platform": "", "project_url": "https://pypi.org/project/landsat-L1-qa-tool/", "project_urls": { "Homepage": "https://github.com/and-viceversa/landsat_L1_qa_tool" }, "release_url": "https://pypi.org/project/landsat-L1-qa-tool/0.1.2/", "requires_dist": null, "requires_python": "", "summary": "Unpack Landsat-8 BQA band into individual layers and create a composite image of each quality indicator.", "version": "0.1.2" }, "last_serial": 5198737, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "ff3083bd2c7408936c187e5696a2843a", "sha256": "61111d20384b1b5ae893202fb524e3ad3f593ff7e87fcad4700852633ab87e27" }, "downloads": -1, "filename": "landsat_L1_qa_tool-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "ff3083bd2c7408936c187e5696a2843a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 7646, "upload_time": "2019-04-21T23:47:24", "url": "https://files.pythonhosted.org/packages/b6/59/84aef1abcf3f9192ff2107cacef14dc9d5a478fe6385261a78da0cf17136/landsat_L1_qa_tool-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "078ffac0550b25f6a0e5c7c0745b3f61", "sha256": "a5d98244643802904b452ae8d768111cfa4b321b931fc7ce541f05d1b84cac6b" }, "downloads": -1, "filename": "landsat_L1_qa_tool-0.1.0.tar.gz", "has_sig": false, "md5_digest": "078ffac0550b25f6a0e5c7c0745b3f61", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6311, "upload_time": "2019-04-21T23:47:26", "url": "https://files.pythonhosted.org/packages/16/a3/7b918dc9c3ff9b1d15044b3a6522f61a5b5703def63111779bd116983d5d/landsat_L1_qa_tool-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "2d1d85362a35527c4f62020eaaed5c35", "sha256": "524477ebb55595bf3e2c8103796744760e18e834d6cd9633497953bb006c4dd6" }, "downloads": -1, "filename": "landsat_L1_qa_tool-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "2d1d85362a35527c4f62020eaaed5c35", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 7351, "upload_time": "2019-04-28T05:44:31", "url": "https://files.pythonhosted.org/packages/96/6a/3990a351d91020637d00c4facd7feab77c902c5f5482a2e6aef238a74e21/landsat_L1_qa_tool-0.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "12b3e25c1a6b497e016cb7857fad1375", "sha256": "e6f18495723fe5213dd2131d577ccbfd646a1386cd7c2e07db8ba9d3d49ebbba" }, "downloads": -1, "filename": "landsat_L1_qa_tool-0.1.1.tar.gz", "has_sig": false, "md5_digest": "12b3e25c1a6b497e016cb7857fad1375", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6005, "upload_time": "2019-04-28T05:44:33", "url": "https://files.pythonhosted.org/packages/e3/20/ce0faca985268eb573879b254d7e938111232759fea085f40dd264d18cd3/landsat_L1_qa_tool-0.1.1.tar.gz" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "1f13738708a875e26641e924e4f09f43", "sha256": "d31826ee25f8efee1d76241faf08924bf8e4673188f61a747dfd5d984e642e3b" }, "downloads": -1, "filename": "landsat_L1_qa_tool-0.1.2-py3-none-any.whl", "has_sig": false, "md5_digest": "1f13738708a875e26641e924e4f09f43", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 7350, "upload_time": "2019-04-28T06:26:17", "url": "https://files.pythonhosted.org/packages/a1/7d/5cf05984b57b7abb41f948f84110de9e27be0f74c0701ef4cbf286b05850/landsat_L1_qa_tool-0.1.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "10319ef9b52487bc3db4c8136c9eb711", "sha256": "436c924d3506e4ad5cf2fcb892efcc7a51933949586bd4d908d89e891f829ac9" }, "downloads": -1, "filename": "landsat_L1_qa_tool-0.1.2.tar.gz", "has_sig": false, "md5_digest": "10319ef9b52487bc3db4c8136c9eb711", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5999, "upload_time": "2019-04-28T06:26:19", "url": "https://files.pythonhosted.org/packages/38/a0/40a301476afbdce5990fc565fe9946bac47f3185922cf79e96a518474059/landsat_L1_qa_tool-0.1.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "1f13738708a875e26641e924e4f09f43", "sha256": "d31826ee25f8efee1d76241faf08924bf8e4673188f61a747dfd5d984e642e3b" }, "downloads": -1, "filename": "landsat_L1_qa_tool-0.1.2-py3-none-any.whl", "has_sig": false, "md5_digest": "1f13738708a875e26641e924e4f09f43", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 7350, "upload_time": "2019-04-28T06:26:17", "url": "https://files.pythonhosted.org/packages/a1/7d/5cf05984b57b7abb41f948f84110de9e27be0f74c0701ef4cbf286b05850/landsat_L1_qa_tool-0.1.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "10319ef9b52487bc3db4c8136c9eb711", "sha256": "436c924d3506e4ad5cf2fcb892efcc7a51933949586bd4d908d89e891f829ac9" }, "downloads": -1, "filename": "landsat_L1_qa_tool-0.1.2.tar.gz", "has_sig": false, "md5_digest": "10319ef9b52487bc3db4c8136c9eb711", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5999, "upload_time": "2019-04-28T06:26:19", "url": "https://files.pythonhosted.org/packages/38/a0/40a301476afbdce5990fc565fe9946bac47f3185922cf79e96a518474059/landsat_L1_qa_tool-0.1.2.tar.gz" } ] }