Metadata-Version: 2.4
Name: sicor
Version: 0.20.5
Summary: Sensor Independent Atmospheric Correction
Project-URL: Source code, https://git.gfz.de/EnMAP/sicor
Project-URL: Issue Tracker, https://git.gfz.de/EnMAP/sicor/-/issues
Project-URL: Documentation, https://enmap.git-pages.gfz-potsdam.de/sicor/doc/
Project-URL: Change log, https://git.gfz.de/EnMAP/sicor/-/blob/main/HISTORY.rst
Project-URL: Zenodo, https://zenodo.org/records/5535505
Author-email: Daniel Scheffler <daniel.scheffler@gfz.de>, Niklas Bohn <nbohn@gfz.de>
Maintainer-email: Daniel Scheffler <daniel.scheffler@gfz.de>
License-Expression: GPL-3.0-only
License-File: AUTHORS.rst
License-File: LICENSE
Keywords: EnMAP,EnMAP-Box,SICOR,atmospheric correction,hyperspectral,remote sensing,satellite
Classifier: Development Status :: 4 - Beta
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: arosics>=1.2.4
Requires-Dist: cachetools
Requires-Dist: cdsapi
Requires-Dist: cerberus
Requires-Dist: dicttoxml
Requires-Dist: dill
Requires-Dist: ecmwf-api-client
Requires-Dist: gdal
Requires-Dist: gdown
Requires-Dist: geoarray
Requires-Dist: glymur
Requires-Dist: h5py
Requires-Dist: iso8601
Requires-Dist: isofit
Requires-Dist: jsmin
Requires-Dist: matplotlib
Requires-Dist: mpld3
Requires-Dist: netcdf4
Requires-Dist: numba
Requires-Dist: numpy
Requires-Dist: numpy-indexed
Requires-Dist: openpyxl
Requires-Dist: pandas
Requires-Dist: pillow
Requires-Dist: pint
Requires-Dist: psutil
Requires-Dist: py-tools-ds
Requires-Dist: pygrib
Requires-Dist: pyprind
Requires-Dist: pyproj
Requires-Dist: pyrsr
Requires-Dist: requests
Requires-Dist: scikit-image>=0.20.0
Requires-Dist: scikit-learn
Requires-Dist: scipy
Requires-Dist: spectral
Requires-Dist: sympy
Requires-Dist: tables
Requires-Dist: tqdm
Requires-Dist: xlrd
Provides-Extra: dev
Requires-Dist: enpt>=0.20.0; extra == 'dev'
Requires-Dist: flake8; extra == 'dev'
Requires-Dist: ipython-memory-usage; extra == 'dev'
Requires-Dist: pycodestyle; extra == 'dev'
Requires-Dist: pydocstyle; extra == 'dev'
Requires-Dist: pyorbital; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: pytest-cov; extra == 'dev'
Requires-Dist: pytest-reporter-html1; extra == 'dev'
Requires-Dist: sphinx-argparse; extra == 'dev'
Requires-Dist: sphinx-rtd-theme; extra == 'dev'
Requires-Dist: urlchecker; extra == 'dev'
Provides-Extra: doc
Requires-Dist: sphinx-argparse; extra == 'doc'
Requires-Dist: sphinx-rtd-theme; extra == 'doc'
Provides-Extra: lint
Requires-Dist: flake8; extra == 'lint'
Requires-Dist: pycodestyle; extra == 'lint'
Requires-Dist: pydocstyle; extra == 'lint'
Provides-Extra: test
Requires-Dist: enpt>=0.20.0; extra == 'test'
Requires-Dist: ipython-memory-usage; extra == 'test'
Requires-Dist: pyorbital; extra == 'test'
Requires-Dist: pytest; extra == 'test'
Requires-Dist: pytest-cov; extra == 'test'
Requires-Dist: pytest-reporter-html1; extra == 'test'
Requires-Dist: urlchecker; extra == 'test'
Description-Content-Type: text/x-rst


.. image:: https://enmap.git-pages.gfz-potsdam.de/sicor/doc/_static/sicor_logo_lr.png
   :width: 300px
   :alt: SICOR Logo

=================================================
SICOR - Sensor Independent Atmospheric Correction
=================================================

Sensor Independent Atmospheric Correction of optical Earth Observation (EO) data from both multispectral and
hyperspectral instruments. Currently, SICOR can be applied to Sentinel-2 and EnMAP data but the implementation of
additional space- and airborne sensors is under development. As unique features for the processing of hyperspectral
data, SICOR incorporates a coupled retrieval of the three phases of water and a snow and ice surface property
inversion based on a simultaneous optimization of atmosphere and surface state (Bohn et al., 2020; Bohn et al., 2021).
Both algorithms are based on Optimal Estimation (OE) including the calculation of several measures of retrieval
uncertainties. The atmospheric modeling in case of hyperspectral data is based on the MODTRAN® radiative transfer code
whereas the atmospheric correction of multispectral data relies on the MOMO code. The MODTRAN® trademark is being used
with the express permission of the owner, Spectral Sciences, Inc.

* Please check the documentation_ for installation and usage instructions and in depth information.
* Information on how to **cite the SICOR Python package** can be found in the
  `CITATION <https://git.gfz.de/EnMAP/sicor/-/blob/main/CITATION>`__ file.

Alternatively, you can cite the following publications when using specific features of SICOR:

Bohn, N., Guanter, L., Kuester, T., Preusker, R., Segl, K. (2020). Coupled retrieval of the three phases of water from
spaceborne imaging spectroscopy measurements. Remote Sens. Environ., 242, 111708,
https://doi.org/10.1016/j.rse.2020.111708.

Bohn, N., Painter, T. H., Thompson, D. R., Carmon, N., Susiluoto, J., Turmon, M. J., Helmlinger, M. C., Green, R. O.,
Cook, J. M., Guanter, L. (2021). Optimal estimation of snow and ice surface parameters from imaging spectroscopy
measurements. Remote Sens. Environ., 264, 112613, https://doi.org/10.1016/j.rse.2021.112613.


License
-------
Free software: GNU General Public License v3 or later (GPLv3+)

All images contained in any (sub-)directory of this repository are licensed under the CC0 license which can be found
`here <https://creativecommons.org/publicdomain/zero/1.0/legalcode.txt>`__.

Feature overview
----------------

* Sentinel-2 L1C to L2A processing
* EnMAP L1B to L2A processing
* generic atmospheric correction for hyperspectral airborne and spaceborne data
* retrieval of the three phases of water from hyperspectral data
* 'lazy Gaussian inversion' of snow and ice surface properties
* calculation of various retrieval uncertainties
  (including a posteriori errors, averaging kernels, gain matrices, degrees of freedom, information content)
* atmospheric correction for Landsat-8: work in progress
* CH4 retrieval from hyperspectral data: work in progress

Status
------

|badge1| |badge2| |badge3| |badge4| |badge5| |badge6| |badge7| |badge8| |badge9|

.. |badge1| image:: https://git.gfz.de/EnMAP/sicor/badges/main/pipeline.svg
    :target: https://git.gfz.de/EnMAP/sicor/pipelines

.. |badge2| image:: https://git.gfz.de/EnMAP/sicor/badges/main/coverage.svg
    :target: https://git.gfz.de/EnMAP/sicor/coverage/

.. |badge3| image:: https://img.shields.io/static/v1?label=Documentation&message=GitLab%20Pages&color=orange
    :target: https://enmap.git-pages.gfz-potsdam.de/sicor/doc/

.. |badge4| image:: https://img.shields.io/pypi/v/sicor.svg
    :target: https://pypi.python.org/pypi/sicor

.. |badge5| image:: https://img.shields.io/conda/vn/conda-forge/sicor.svg
        :target: https://anaconda.org/conda-forge/sicor

.. |badge6| image:: https://img.shields.io/pypi/l/sicor.svg
    :target: https://git.gfz.de/EnMAP/sicor/-/blob/main/LICENSE

.. |badge7| image:: https://img.shields.io/pypi/pyversions/sicor.svg
    :target: https://img.shields.io/pypi/pyversions/sicor.svg

.. |badge8| image:: https://img.shields.io/pypi/dm/sicor.svg
    :target: https://pypi.python.org/pypi/sicor

.. |badge9| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.5535505.svg
   :target: https://doi.org/10.5281/zenodo.5535505

See also the latest coverage_ report and the pytest_ HTML report.

History / Changelog
-------------------

You can find the protocol of recent changes in the SICOR package
`here <https://git.gfz.de/EnMAP/sicor/-/blob/main/HISTORY.rst>`__.

Credits
-------

This software was developed within the context of the EnMAP project supported by the DLR Space Administration with
funds of the German Federal Ministry of Economic Affairs and Energy (on the basis of a decision by the German
Bundestag: 50 EE 1529) and contributions from DLR, GFZ and OHB System AG.

The MODTRAN® trademark is being used with the express permission of the owner, Spectral Sciences, Inc.

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
.. _documentation: https://enmap.git-pages.gfz-potsdam.de/sicor/doc/
.. _coverage: https://enmap.git-pages.gfz-potsdam.de/sicor/coverage/
.. _pytest: https://enmap.git-pages.gfz-potsdam.de/sicor/test_reports/report.html
