arosics 0.8.19

An Automated and Robust Open-Source Image Co-Registration Software for Multi-Sensor Satellite Data

An Automated and Robust Open-Source Image Co-Registration Software for Multi-Sensor Satellite Data

• Free software: GNU General Public License v3

• Documentation: http://danschef.gitext.gfz-potsdam.de/arosics/doc/

Status

See also the latest coverage report and the nosetests HTML report.

Features

• Detection and correction of local or global geometric displacements between two input images.

Installation

AROSICS depends on some open source packages which are usually installed without problems by the automatic install routine. However, for some projects, we strongly recommend resolving the dependency before the automatic installer is run. This approach avoids problems with conflicting versions of the same software. Using conda, the recommended approach is:

# create virtual environment for arosics, this is optional
conda create --name arosics python=3
source activate arosics
conda install -c conda-forge numpy gdal scikit-image matplotlib pyproj rasterio shapely geopandas cmocean

# optional libraries:
conda install -c conda-forge basemap pykrige
conda install -c conda-forge pyfftw  # Linux and MacOS
conda install -c jesserobertson pyfftw  # Windows

To install AROSICS, use the pip installer:

pip install arosics

Or clone the repository via GIT and update the PATH environment variable:

cd /your/installation/folder
git clone https://gitext.gfz-potsdam.de/danschef/arosics.git
git clone https://gitext.gfz-potsdam.de/danschef/geoarray.git
git clone https://gitext.gfz-potsdam.de/danschef/py_tools_ds.git
PATH=$PATH:/path/to/your/installation/folder/arosics:/path/to/your/installation/folder/geoarray:/path/to/your/installation/folder/py_tools_ds

Credits

AROSICS was developed within the context of the GeoMultiSens 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 data (2016).

History

0.1.0 (2017-06-15)

• Package creation.

0.2.1 (2017-07-03)

• First release on PyPI.

0.4.0 (2017-07-07)

New features:

• added a logo

• added auto-deploy to PyPI

• added test cases for local co-registration

Fixes and improvements:

• fixed warping issues in case only very few tie points could be identified

0.5.0 (2017-09-19)

New features:

• Added two test cases for local co-registration and the respective test data.

• Added test cases for global co-registration

• Added test of output writer and tie point grid visualization.

• Added nosetests. Resolved some setup requirements by conda during test_arosics_install.

• PEP8 code style now checked with automatic style checkers

Fixes and improvements:

• Coverage now also working in multiprocessing.

• Replaced test data of test case INTER1 with LZW compressed GeoTIFFs to speed up testing.

• Revised docker container builder.

• Bugfix for unexpected FFTW return value that caused the matching to fail

• Added some docstrings.

• Refactored command line interface ‘arosics.py’ to ‘arosics_cli.py’ to fix import issues.

• Added usage documentation for command line interface.

• Removed pykrige from automatically installed libraries during setup. It is now optional (Fixes issue #12)

• Bugfix in connection with optional library pyfftw.

• Revised installation guidelines within README.rst, README.md and installation.rst. Added link for nosetests HTML report.

• Fixed exception in case no arguments are provided to command line interface.

• Revised error handling and added additional check for projection.

• GDAL_DATA environment variable is now handled within py_tools_ds. Updated minimal version of py_tools_ds in setup.py.

• Fixed pickling error when running COREG_LOCAL in multiprocessing under a Windows environment.

• Replaced all occurrences of “quality grid” with “tie point grid”. Updated version info.