.. figure:: https://danschef.git-pages.gfz-potsdam.de/arosics/images/arosics_logo.png
:target: https://git.gfz-potsdam.de/danschef/arosics
:align: center
==================================================================================================
An Automated and Robust Open-Source Image Co-Registration Software for Multi-Sensor Satellite Data
==================================================================================================
* Free software: Apache 2.0
* **Documentation:** https://danschef.git-pages.gfz-potsdam.de/arosics/doc/
* The (open-access) **paper** corresponding to this software repository can be found here:
`Scheffler et al. 2017 <https://www.mdpi.com/2072-4292/9/7/676>`__
(cite as: Scheffler D, Hollstein A, Diedrich H, Segl K, Hostert P. AROSICS: An Automated and Robust Open-Source
Image Co-Registration Software for Multi-Sensor Satellite Data. Remote Sensing. 2017; 9(7):676).
* Information on how to **cite the AROSICS Python package** can be found in the
`CITATION <https://git.gfz-potsdam.de/danschef/arosics/-/blob/main/CITATION>`__ file.
* Submit feedback by filing an issue `here <https://git.gfz-potsdam.de/danschef/arosics/issues>`__
or join our chat here: |Gitter|
.. |Gitter| image:: https://badges.gitter.im/Join%20Chat.svg
:target: https://gitter.im/arosics/Lobby?utm_source=share-link&utm_medium=link&utm_campaign=share-link
:alt: https://gitter.im/arosics/Lobby?utm_source=share-link&utm_medium=link&utm_campaign=share-link
Status
------
.. image:: https://git.gfz-potsdam.de/danschef/arosics/badges/main/pipeline.svg
:target: https://git.gfz-potsdam.de/danschef/arosics/commits/main
.. image:: https://git.gfz-potsdam.de/danschef/arosics/badges/main/coverage.svg
:target: https://danschef.git-pages.gfz-potsdam.de/arosics/coverage/
.. image:: https://img.shields.io/pypi/v/arosics.svg
:target: https://pypi.python.org/pypi/arosics
.. image:: https://img.shields.io/conda/vn/conda-forge/arosics.svg
:target: https://anaconda.org/conda-forge/arosics
.. image:: https://img.shields.io/pypi/l/arosics.svg
:target: https://git.gfz-potsdam.de/danschef/arosics/blob/main/LICENSE
.. image:: https://img.shields.io/pypi/pyversions/arosics.svg
:target: https://img.shields.io/pypi/pyversions/arosics.svg
.. image:: https://img.shields.io/pypi/dm/arosics.svg
:target: https://pypi.python.org/pypi/arosics
.. image:: https://zenodo.org/badge/253474603.svg
:target: https://zenodo.org/badge/latestdoi/253474603
See also the latest coverage_ report and the pytest_ HTML report.
Feature overview
----------------
AROSICS is a python package to perform **automatic subpixel co-registration** of two satellite image datasets
based on an image matching approach working in the frequency domain, combined with a multistage workflow for
effective detection of false-positives.
It detects and corrects **local as well as global misregistrations** between two input images in the subpixel scale,
that are often present in satellite imagery. The algorithm is robust against the typical difficulties of
multi-sensoral/multi-temporal images. Clouds are automatically handled by the implemented outlier detection algorithms.
The user may provide user-defined masks to exclude certain image areas from tie point creation. The image overlap area
is automatically detected. AROSICS supports a wide range of input data formats and can be used from the command
line (without any Python experience) or as a normal Python package.
Global co-registration - fast but only for static X/Y-shifts
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Only a global X/Y translation is computed within a small subset of the input images (window position is adjustable).
This allows very fast co-registration but only corrects for translational (global) X/Y shifts.
The calculated subpixel-shifts are (by default) applied to the geocoding information of the output image.
No spatial resampling is done automatically as long as both input images have the same projection. However, AROSICS
also allows to align the output image to the reference image coordinate grid if needed.
Here is an example of a Landsat-8 / Sentinel-2 image pair before and after co-registration using AROSICS:
.. image:: https://git.gfz-potsdam.de/danschef/arosics/raw/main/docs/images/animation_testcase1_zoom_L8_S2_global_coreg_before_after_900x456.gif
Local co-registration - for spatially variable shifts but a bit slower
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
A dense grid of tie points is automatically computed, whereas tie points are subsequently validated using a
multistage workflow. Only those tie points not marked as false-positives are used to compute the parameters of an
affine transformation. Warping of the target image is done using an appropriate resampling technique
(cubic by default).
Here is an example of the computed shift vectors after filtering false-positives
(mainly due to clouds in the target image):
.. image:: https://git.gfz-potsdam.de/danschef/arosics/raw/main/docs/images/shift_vectors_testcase1__900x824.gif
For further details check out the `documentation <https://danschef.git-pages.gfz-potsdam.de/arosics/doc/>`__!
History / Changelog
-------------------
You can find the protocol of recent changes in the AROSICS package
`here <https://git.gfz-potsdam.de/danschef/arosics/-/blob/main/HISTORY.rst>`__.
Credits
-------
AROSICS was developed by Daniel Scheffler (German Research Centre of Geosciences) within the context of the
`GeoMultiSens <http://www.geomultisens.gfz-potsdam.de/>`__ project funded by the German Federal Ministry of Education and Research
(project grant code: 01 IS 14 010 A-C).
This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.
The test data represent modified Copernicus Sentinel-2 data (ESA 2016). The input data for the figures in the
documentation have been provided by NASA (Landsat-8) and ESA (Sentinel-2).
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
.. _coverage: https://danschef.git-pages.gfz-potsdam.de/arosics/coverage/
.. _pytest: https://danschef.git-pages.gfz-potsdam.de/arosics/test_reports/report.html
.. _conda: https://docs.conda.io/
Raw data
{
"_id": null,
"home_page": "https://git.gfz-potsdam.de/danschef/arosics",
"name": "arosics",
"maintainer": "",
"docs_url": null,
"requires_python": ">3.8",
"maintainer_email": "",
"keywords": "arosics,image co-registration,geometric pre-processing,remote sensing,sensor fusion",
"author": "Daniel Scheffler",
"author_email": "daniel.scheffler@gfz-potsdam.de",
"download_url": "https://files.pythonhosted.org/packages/23/43/d78e11c194c7796c65178324864358ce4cd4bbe54ff1300ba94094ef923b/arosics-1.10.2.tar.gz",
"platform": null,
"description": ".. figure:: https://danschef.git-pages.gfz-potsdam.de/arosics/images/arosics_logo.png\n :target: https://git.gfz-potsdam.de/danschef/arosics\n :align: center\n\n==================================================================================================\nAn Automated and Robust Open-Source Image Co-Registration Software for Multi-Sensor Satellite Data\n==================================================================================================\n\n* Free software: Apache 2.0\n* **Documentation:** https://danschef.git-pages.gfz-potsdam.de/arosics/doc/\n* The (open-access) **paper** corresponding to this software repository can be found here:\n `Scheffler et al. 2017 <https://www.mdpi.com/2072-4292/9/7/676>`__\n (cite as: Scheffler D, Hollstein A, Diedrich H, Segl K, Hostert P. AROSICS: An Automated and Robust Open-Source\n Image Co-Registration Software for Multi-Sensor Satellite Data. Remote Sensing. 2017; 9(7):676).\n* Information on how to **cite the AROSICS Python package** can be found in the\n `CITATION <https://git.gfz-potsdam.de/danschef/arosics/-/blob/main/CITATION>`__ file.\n* Submit feedback by filing an issue `here <https://git.gfz-potsdam.de/danschef/arosics/issues>`__\n or join our chat here: |Gitter|\n\n.. |Gitter| image:: https://badges.gitter.im/Join%20Chat.svg\n :target: https://gitter.im/arosics/Lobby?utm_source=share-link&utm_medium=link&utm_campaign=share-link\n :alt: https://gitter.im/arosics/Lobby?utm_source=share-link&utm_medium=link&utm_campaign=share-link\n\nStatus\n------\n\n.. image:: https://git.gfz-potsdam.de/danschef/arosics/badges/main/pipeline.svg\n :target: https://git.gfz-potsdam.de/danschef/arosics/commits/main\n.. image:: https://git.gfz-potsdam.de/danschef/arosics/badges/main/coverage.svg\n :target: https://danschef.git-pages.gfz-potsdam.de/arosics/coverage/\n.. image:: https://img.shields.io/pypi/v/arosics.svg\n :target: https://pypi.python.org/pypi/arosics\n.. image:: https://img.shields.io/conda/vn/conda-forge/arosics.svg\n :target: https://anaconda.org/conda-forge/arosics\n.. image:: https://img.shields.io/pypi/l/arosics.svg\n :target: https://git.gfz-potsdam.de/danschef/arosics/blob/main/LICENSE\n.. image:: https://img.shields.io/pypi/pyversions/arosics.svg\n :target: https://img.shields.io/pypi/pyversions/arosics.svg\n.. image:: https://img.shields.io/pypi/dm/arosics.svg\n :target: https://pypi.python.org/pypi/arosics\n.. image:: https://zenodo.org/badge/253474603.svg\n :target: https://zenodo.org/badge/latestdoi/253474603\n\nSee also the latest coverage_ report and the pytest_ HTML report.\n\nFeature overview\n----------------\n\nAROSICS is a python package to perform **automatic subpixel co-registration** of two satellite image datasets\nbased on an image matching approach working in the frequency domain, combined with a multistage workflow for\neffective detection of false-positives.\n\nIt detects and corrects **local as well as global misregistrations** between two input images in the subpixel scale,\nthat are often present in satellite imagery. The algorithm is robust against the typical difficulties of\nmulti-sensoral/multi-temporal images. Clouds are automatically handled by the implemented outlier detection algorithms.\nThe user may provide user-defined masks to exclude certain image areas from tie point creation. The image overlap area\nis automatically detected. AROSICS supports a wide range of input data formats and can be used from the command\nline (without any Python experience) or as a normal Python package.\n\n\nGlobal co-registration - fast but only for static X/Y-shifts\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nOnly a global X/Y translation is computed within a small subset of the input images (window position is adjustable).\nThis allows very fast co-registration but only corrects for translational (global) X/Y shifts.\nThe calculated subpixel-shifts are (by default) applied to the geocoding information of the output image.\nNo spatial resampling is done automatically as long as both input images have the same projection. However, AROSICS\nalso allows to align the output image to the reference image coordinate grid if needed.\n\nHere is an example of a Landsat-8 / Sentinel-2 image pair before and after co-registration using AROSICS:\n\n.. image:: https://git.gfz-potsdam.de/danschef/arosics/raw/main/docs/images/animation_testcase1_zoom_L8_S2_global_coreg_before_after_900x456.gif\n\n\nLocal co-registration - for spatially variable shifts but a bit slower\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nA dense grid of tie points is automatically computed, whereas tie points are subsequently validated using a\nmultistage workflow. Only those tie points not marked as false-positives are used to compute the parameters of an\naffine transformation. Warping of the target image is done using an appropriate resampling technique\n(cubic by default).\n\nHere is an example of the computed shift vectors after filtering false-positives\n(mainly due to clouds in the target image):\n\n.. image:: https://git.gfz-potsdam.de/danschef/arosics/raw/main/docs/images/shift_vectors_testcase1__900x824.gif\n\n\nFor further details check out the `documentation <https://danschef.git-pages.gfz-potsdam.de/arosics/doc/>`__!\n\n\nHistory / Changelog\n-------------------\n\nYou can find the protocol of recent changes in the AROSICS package\n`here <https://git.gfz-potsdam.de/danschef/arosics/-/blob/main/HISTORY.rst>`__.\n\n\nCredits\n-------\n\nAROSICS was developed by Daniel Scheffler (German Research Centre of Geosciences) within the context of the\n`GeoMultiSens <http://www.geomultisens.gfz-potsdam.de/>`__ project funded by the German Federal Ministry of Education and Research\n(project grant code: 01 IS 14 010 A-C).\n\nThis package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.\nThe test data represent modified Copernicus Sentinel-2 data (ESA 2016). The input data for the figures in the\ndocumentation have been provided by NASA (Landsat-8) and ESA (Sentinel-2).\n\n.. _Cookiecutter: https://github.com/audreyr/cookiecutter\n.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage\n.. _coverage: https://danschef.git-pages.gfz-potsdam.de/arosics/coverage/\n.. _pytest: https://danschef.git-pages.gfz-potsdam.de/arosics/test_reports/report.html\n.. _conda: https://docs.conda.io/\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "An Automated and Robust Open-Source Image Co-Registration Software for Multi-Sensor Satellite Data",
"version": "1.10.2",
"project_urls": {
"Algorithm paper": "https://www.mdpi.com/2072-4292/9/7/676",
"Change log": "https://git.gfz-potsdam.de/danschef/arosics/-/blob/main/HISTORY.rst",
"Documentation": "https://danschef.git-pages.gfz-potsdam.de/arosics/doc/",
"Homepage": "https://git.gfz-potsdam.de/danschef/arosics",
"Issue Tracker": "https://git.gfz-potsdam.de/danschef/arosics/-/issues",
"Source code": "https://git.gfz-potsdam.de/danschef/arosics",
"Zenodo": "https://zenodo.org/record/5093940"
},
"split_keywords": [
"arosics",
"image co-registration",
"geometric pre-processing",
"remote sensing",
"sensor fusion"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2343d78e11c194c7796c65178324864358ce4cd4bbe54ff1300ba94094ef923b",
"md5": "19456099c7993258b91a032306f33355",
"sha256": "f213919063eea5db79566da7a0a3f3c5baf3fdeda842520a0817cf3d8f0ee0d4"
},
"downloads": -1,
"filename": "arosics-1.10.2.tar.gz",
"has_sig": false,
"md5_digest": "19456099c7993258b91a032306f33355",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">3.8",
"size": 7043102,
"upload_time": "2024-02-12T23:45:04",
"upload_time_iso_8601": "2024-02-12T23:45:04.421599Z",
"url": "https://files.pythonhosted.org/packages/23/43/d78e11c194c7796c65178324864358ce4cd4bbe54ff1300ba94094ef923b/arosics-1.10.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-12 23:45:04",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "arosics"
}
JSON