{ "info": { "author": "Feng Yin", "author_email": "ucfafyi@ucl.ac.uk", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.6" ], "description": "# A sensor invariant Atmospheric Correction (SIAC)\n### Feng Yin\n### Department of Geography, UCL\n### ucfafyi@ucl.ac.uk\n\n\n[![PyPI version](https://img.shields.io/pypi/v/siac.svg?longCache=true&style=flat)](https://pypi.org/project/SIAC/)\n[![conda](https://anaconda.org/f0xy/siac/badges/version.svg?longCache=true&style=flat)](https://anaconda.org/F0XY/siac)\n[![py version](https://img.shields.io/pypi/pyversions/siac.svg?longCache=true&style=flat)](https://pypi.org/project/SIAC/)\n[![build](https://img.shields.io/travis/MarcYin/SIAC/master.svg?longCache=true&style=flat)](https://travis-ci.org/MarcYin/SIAC/)\n[![Documentation Status](https://readthedocs.org/projects/siac/badge/?version=latest)](https://siac.readthedocs.io/en/latest/?badge=latest)\n[![codecov](https://codecov.io/gh/MarcYin/SIAC/branch/master/graph/badge.svg?longCache=true&style=flat)](https://codecov.io/gh/MarcYin/SIAC)\n[![Coverage Status](https://coveralls.io/repos/github/MarcYin/SIAC/badge.svg?branch=master)](https://coveralls.io/github/MarcYin/SIAC?branch=master)\n[![Lisence](https://img.shields.io/pypi/l/siac.svg?longCache=true&style=flat)](https://pypi.org/project/SIAC/)\n[![DOI](https://zenodo.org/badge/117815245.svg)](https://zenodo.org/badge/latestdoi/117815245)\n\nThis atmospheric correction method uses MODIS MCD43 BRDF product to get a coarse resolution simulation of earth surface. A model based on MODIS PSF is built to deal with the scale differences between MODIS and Sentinel 2 / Landsat 8. We uses the ECMWF CAMS prediction as a prior for the atmospheric states, coupling with 6S model to solve for the atmospheric parameters. We do not have topography correction and homogeneouse surface is used without considering the BRDF effects.\n\n## Data needed:\n* MCD43 : 16 days before and 16 days after the Sentinel 2 / Landsat 8 sensing date\n* ECMWF CAMS Near Real Time prediction: a time step of 3 hours with the start time of 00:00:00 over the date, and data from 01/04/2015 are mirrored in UCL server at: http://www2.geog.ucl.ac.uk/~ucfafyi/cams/\n* Global DEM: Global DEM VRT file built from ASTGTM2 DEM, and most of the DEM over land are mirrored in UCL server at: http://www2.geog.ucl.ac.uk/~ucfafyi/eles/\n* Emulators: emulators for atmospheric path reflectance, total transmitance and single scattering Albedo, and the emulators for Sentinel 2, Landsat 8 and MODIS trained with 6S.V2 can be found at: http://www2.geog.ucl.ac.uk/~ucfafyi/emus/\n\n## Installation:\n\n1. Directly from github \n\n```bash\npip install https://github.com/MarcYin/SIAC/archive/master.zip\n```\n\n\n2. Using PyPI\n\n```bash\npip install SIAC\n```\n\n\n3. Using anaconda\n\n```bash\nconda install -c f0xy -c conda-forge siac\n```\n\n\nTo save your time for installing GDAL:\n\n```bash\nconda install -c conda-forge gdal>2.1\n```\n\n\n\nThe typical usage for Sentinel 2 and Landsat 8:\n```python\nfrom SIAC import SIAC_S2\nSIAC_S2('/directory/where/you/store/S2/data/') # this can be either from AWS or Senitinel offical package\n```\n```python\nfrom SIAC import SIAC_L8 \nSIAC_L8('/directory/where/you/store/L8/data/') \n``` \n\nAn example of correction for Landsat 5 for a more detailed demostration of the usage is shown [here](https://github.com/MarcYin/Global-analysis-ready-dataset)\n\n## Examples and Map:\n\nA [page](http://www2.geog.ucl.ac.uk/~ucfafyi/Atmo_Cor/index.html) shows some correction samples.\n\nA [map](http://www2.geog.ucl.ac.uk/~ucfafyi/map) for comparison between TOA and BOA.\n\n## Citation:\n\nYin, F., Lewis, P. E., Gomez-Dans, J., & Wu, Q. (2019, February 21). A sensor-invariant atmospheric correction method: application to Sentinel-2/MSI and Landsat 8/OLI. https://doi.org/10.31223/osf.io/ps957\n\n### LICENSE\nGNU GENERAL PUBLIC LICENSE V3", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/MarcYin/SIAC", "keywords": "", "license": "GNU Affero General Public License v3.0", "maintainer": "", "maintainer_email": "", "name": "SIAC", "package_url": "https://pypi.org/project/SIAC/", "platform": "", "project_url": "https://pypi.org/project/SIAC/", "project_urls": { "Homepage": "https://github.com/MarcYin/SIAC" }, "release_url": "https://pypi.org/project/SIAC/2.3.0/", "requires_dist": null, "requires_python": "", "summary": "A sensor invariant Atmospheric Correction (SIAC)", "version": "2.3.0" }, "last_serial": 5460832, "releases": { "0.0.0": [ { "comment_text": "", "digests": { "md5": "4ee4ffe42a584169f58571ac476d636d", "sha256": "0a248b30e2b9d67db57715653925f10f29bb0b0c8d9eec38019024f2e41f41dc" }, "downloads": -1, "filename": "SIAC-0.0.0.tar.gz", "has_sig": false, "md5_digest": "4ee4ffe42a584169f58571ac476d636d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4930909, "upload_time": "2019-01-29T23:03:35", "url": "https://files.pythonhosted.org/packages/69/fb/51bb2a95ab69ae37d125855326f2b5d0dae8525e18e9667f62fdcda33bcb/SIAC-0.0.0.tar.gz" } ], "2.0.7": [ { "comment_text": "", "digests": { "md5": "4880d4b1018867807d9fa414d2c243f3", "sha256": "6a8a773d58c84386eef84e09eba7de65719eb0867f44659be491e507cfb1bf3a" }, "downloads": -1, "filename": "SIAC-2.0.7-py2-none-any.whl", "has_sig": false, "md5_digest": "4880d4b1018867807d9fa414d2c243f3", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 4951500, "upload_time": "2018-09-19T18:40:00", "url": "https://files.pythonhosted.org/packages/db/6a/43e79f60b371d32cac4bc9b49861a9502cd7dfd28ba76e82da2b33fe0733/SIAC-2.0.7-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "cc3f26e9e0c9ed153f8e843f9bf7c662", "sha256": "cd5f6f855f1a1ddbf7ad218edf7b9f941f9c1ed1322f73d57a71e43270d9d2e4" }, "downloads": -1, "filename": "SIAC-2.0.7.tar.gz", "has_sig": false, "md5_digest": "cc3f26e9e0c9ed153f8e843f9bf7c662", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4926439, "upload_time": "2018-09-19T18:40:09", "url": "https://files.pythonhosted.org/packages/22/49/f11666d97fa3bf15ea4d14cdf7e99e322084ff68d66234dd96122752891d/SIAC-2.0.7.tar.gz" } ], "2.0.8": [ { "comment_text": "", "digests": { "md5": "f9845ac6d5614aafa45da02717744604", "sha256": "0f2889378b49630cc2394ba940512c62deadd8303cbb4232f7b09984cf5779b5" }, "downloads": -1, "filename": "SIAC-2.0.8-py2-none-any.whl", "has_sig": false, "md5_digest": "f9845ac6d5614aafa45da02717744604", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 4952262, "upload_time": "2018-09-26T14:33:11", "url": "https://files.pythonhosted.org/packages/82/5a/3adef3b779545b5013f6fdbc01d918183655ef1044abf0ce9db6affad074/SIAC-2.0.8-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "c64c02658d17989004a7d446cf119339", "sha256": "7ffec2e58567568b2255cd0be55df80f06478e17543550ab3010b1b398ea81ce" }, "downloads": -1, "filename": "SIAC-2.0.8-py3-none-any.whl", "has_sig": false, "md5_digest": "c64c02658d17989004a7d446cf119339", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 4952265, "upload_time": "2018-09-27T08:24:36", "url": "https://files.pythonhosted.org/packages/09/ab/d7fd1683f4e1873acb2d5d288333e681cd0dee645d9c12bbb7ea92d33eeb/SIAC-2.0.8-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "8ff4ebbebecbca17bb7a5fdc7f7e521a", "sha256": "f51220753eff1a45ea9a52d6a3dbd1a46faccd26ef73cf4e0409c5cdd5fe23d2" }, "downloads": -1, "filename": "SIAC-2.0.8.tar.gz", "has_sig": false, "md5_digest": "8ff4ebbebecbca17bb7a5fdc7f7e521a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4927186, "upload_time": "2018-09-26T14:33:19", "url": "https://files.pythonhosted.org/packages/ea/1a/4b7e97667b466e1a92ea2753ddc4a17757d8f603f64c38827f0d8ff759e7/SIAC-2.0.8.tar.gz" } ], "2.0.9": [ { "comment_text": "", "digests": { "md5": "71c87d72bb1fc1e313339887ca82d35f", "sha256": "1d952b5278d14f73b85d5f46178e7cb47643f2b08142606e4a880af0024c9c8d" }, "downloads": -1, "filename": "SIAC-2.0.9-py2-none-any.whl", "has_sig": false, "md5_digest": "71c87d72bb1fc1e313339887ca82d35f", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 4952528, "upload_time": "2018-10-03T11:26:05", "url": "https://files.pythonhosted.org/packages/e9/50/54d69950f34344f04b7d7d144671af724d30f743d58df12c2dc74abc94c9/SIAC-2.0.9-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "29ca743a54672b22acba333205644560", "sha256": "5e1668257686731290fe720800cbe56f78fcd3d912f81d230eb7cecce12bec2a" }, "downloads": -1, "filename": "SIAC-2.0.9-py3-none-any.whl", "has_sig": false, "md5_digest": "29ca743a54672b22acba333205644560", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 4952527, "upload_time": "2018-10-03T11:27:17", "url": "https://files.pythonhosted.org/packages/bf/43/53dd13da3d8e9a704c2e519f5e613c009cdaa311d704eb59d4ba4668943a/SIAC-2.0.9-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f6fe6f42fae22bc3928955d2097807c5", "sha256": "8601c446bfdb5f545cdc00518db1bfa76aaa523bbb5eb6af68bccb7485244d08" }, "downloads": -1, "filename": "SIAC-2.0.9.tar.gz", "has_sig": false, "md5_digest": "f6fe6f42fae22bc3928955d2097807c5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4927458, "upload_time": "2018-10-03T11:26:09", "url": "https://files.pythonhosted.org/packages/96/77/6fddfa067df94dd693585fa9fff808728d229715c25d5f72017a1a2104a6/SIAC-2.0.9.tar.gz" } ], "2.1.1": [ { "comment_text": "", "digests": { "md5": "ae7b779ad482f369ac7f90a4b571eb63", "sha256": "7b35003c999aeec1eff0d2532713a43f5cd5e73de7683f3dc1140c8badf7303f" }, "downloads": -1, "filename": "SIAC-2.1.1.tar.gz", "has_sig": false, "md5_digest": "ae7b779ad482f369ac7f90a4b571eb63", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4932599, "upload_time": "2018-11-08T19:22:35", "url": "https://files.pythonhosted.org/packages/84/3b/e703e55c78fe41d8b255fe0d35bf42e709eca21a43351d4df50eb8321cfd/SIAC-2.1.1.tar.gz" } ], "2.1.2": [ { "comment_text": "", "digests": { "md5": "463e259927b5fd1a2e75fa872b1987b9", "sha256": "7f1b3e004c9f9fb2aa6a488378c504301cc67da4f6263c79307cde16c0a4bcd1" }, "downloads": -1, "filename": "SIAC-2.1.2.tar.gz", "has_sig": false, "md5_digest": "463e259927b5fd1a2e75fa872b1987b9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4932872, "upload_time": "2019-01-25T19:09:21", "url": "https://files.pythonhosted.org/packages/f2/06/a7917339eeb308f5b9844c7289c86f1db304b2e5508bb8f2a0ffb9c39506/SIAC-2.1.2.tar.gz" } ], "2.1.3": [ { "comment_text": "", "digests": { "md5": "5b05c5480278b0ed00a1d101652cb095", "sha256": "d579e1fadb09094d4692d97de3c03653d6c9c3388e82435c554d30426a8ca60b" }, "downloads": -1, "filename": "SIAC-2.1.3.tar.gz", "has_sig": false, "md5_digest": "5b05c5480278b0ed00a1d101652cb095", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4933746, "upload_time": "2019-02-18T11:22:53", "url": "https://files.pythonhosted.org/packages/0a/3b/f974cc69ee8be32d567d8e55836428e75472d19bbc34b3b1e582d658c504/SIAC-2.1.3.tar.gz" } ], "2.2.0": [ { "comment_text": "", "digests": { "md5": "fb31b386fb588a03ba58577166dcea0d", "sha256": "722d272cfc8f8fe1c8cf75d0b50687ad125b4695310d56c9a86b6f733ff5e09e" }, "downloads": -1, "filename": "SIAC-2.2.0.tar.gz", "has_sig": false, "md5_digest": "fb31b386fb588a03ba58577166dcea0d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4935927, "upload_time": "2019-02-21T16:45:55", "url": "https://files.pythonhosted.org/packages/09/f0/fd4391a1da4b38bcbeca4aa6bad57a1431c691a0faecdc7c59fc7f6c0433/SIAC-2.2.0.tar.gz" } ], "2.3.0": [ { "comment_text": "", "digests": { "md5": "20d1d52b9ba59a82ad617389b0e77bb7", "sha256": "768e0621722a791baf91b5cc94348bd3fdaa447bc236bc57ae84f7d77a0d961a" }, "downloads": -1, "filename": "SIAC-2.3.0.tar.gz", "has_sig": false, "md5_digest": "20d1d52b9ba59a82ad617389b0e77bb7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12666829, "upload_time": "2019-06-28T09:35:31", "url": "https://files.pythonhosted.org/packages/33/c5/e2bb39152a0c318dce6ebd24e7c541118920719f8b7e2161484d9cc28be7/SIAC-2.3.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "20d1d52b9ba59a82ad617389b0e77bb7", "sha256": "768e0621722a791baf91b5cc94348bd3fdaa447bc236bc57ae84f7d77a0d961a" }, "downloads": -1, "filename": "SIAC-2.3.0.tar.gz", "has_sig": false, "md5_digest": "20d1d52b9ba59a82ad617389b0e77bb7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12666829, "upload_time": "2019-06-28T09:35:31", "url": "https://files.pythonhosted.org/packages/33/c5/e2bb39152a0c318dce6ebd24e7c541118920719f8b7e2161484d9cc28be7/SIAC-2.3.0.tar.gz" } ] }