README.rst 3.12 KB
Newer Older
1
.. figure:: http://danschef.gitext.gfz-potsdam.de/arosics/images/arosics_logo.png
Daniel Scheffler's avatar
Daniel Scheffler committed
2
        :target: https://gitext.gfz-potsdam.de/danschef/arosics
3

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


Daniel Scheffler's avatar
Daniel Scheffler committed
7
* Free software: GNU General Public License v3
8
9
* Documentation: http://danschef.gitext.gfz-potsdam.de/arosics/doc/

10

11
12
13
14
Status
------

.. .. image:: https://img.shields.io/travis/danschef/arosics.svg
15
16
        :target: https://travis-ci.org/danschef/arosics

17
.. .. image:: https://readthedocs.org/projects/arosics/badge/?version=latest
18
19
20
        :target: https://arosics.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status

21
.. .. image:: https://pyup.io/repos/github/danschef/arosics/shield.svg
22
23
24
25
     :target: https://pyup.io/repos/github/danschef/arosics/
     :alt: Updates


26
.. image:: https://gitext.gfz-potsdam.de/danschef/arosics/badges/master/build.svg
Daniel Scheffler's avatar
Daniel Scheffler committed
27
        :target: https://gitext.gfz-potsdam.de/danschef/arosics/commits/master
28
.. image:: https://gitext.gfz-potsdam.de/danschef/arosics/badges/master/coverage.svg
Daniel Scheffler's avatar
Daniel Scheffler committed
29
        :target: http://danschef.gitext.gfz-potsdam.de/arosics/coverage/
Daniel Scheffler's avatar
Daniel Scheffler committed
30
31
.. image:: https://img.shields.io/pypi/v/arosics.svg
        :target: https://pypi.python.org/pypi/arosics
32

33
See also the latest coverage_ report and the nosetests_ HTML report.
34
35
36
37
38


Features
--------

39
* Detection and correction of local or global geometric displacements between two input images.
40

41
42
43
44

Installation
------------

45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
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:

 .. code-block:: console

    # create virtual environment for arosics, this is optional
    conda create -y -q --name arosics python=3
    source activate arosics
    conda install -y -q -c conda-forge numpy gdal scikit-image matplotlib


To install AROSICS, use the pip installer:

 .. code-block:: console
61

62
    pip install arosics
63
64


Daniel Scheffler's avatar
Daniel Scheffler committed
65
Or clone the repository via GIT and update the PATH environment variable:
66

67
 .. code-block:: console
68

69
    cd /your/installation/folder
70
    git clone https://gitext.gfz-potsdam.de/danschef/arosics.git
Daniel Scheffler's avatar
Daniel Scheffler committed
71
72
73
    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
74
75


76
77
78
79
Credits
-------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.
80
The test data represent modified Copernicus Sentinel data (2016).
81
82
83

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage
84
.. _coverage: http://danschef.gitext.gfz-potsdam.de/arosics/coverage/
85
86
.. _nosetests: http://danschef.gitext.gfz-potsdam.de/arosics/nosetests_reports/nosetests.html
.. _conda: https://conda.io/docs/
87