=====================
Installation
=====================

Installing sen2chain
--------------------

This package requires pip3, Python 3, GDAL, OTB and `Sen2Cor <http://step.esa.int/main/third-party-plugins-2/sen2cor/>`_.

.. note:: The current version of sen2chain is not available on Windows.


Prerequisites
^^^^^^^^^^^^^
pip3, GDAL and OTB

.. code-block:: console

    sudo apt install gdal-bin libgdal-dev python3-gdal otb-bin python3-otb python3-pip
    
As indicated in the `OTB installation <https://www.orfeo-toolbox.org/CookBook/Installation.html#linux-x86-64>`_, do not forget to initialize the environment when you launch a new terminal with

.. code-block:: console

    source otbenv.profile



Sen2Cor

.. code-block:: console

    wget http://step.esa.int/thirdparties/sen2cor/2.5.5/Sen2Cor-02.05.05-Linux64.run
    chmod +x Sen2Cor-02.05.05-Linux64.run && ./Sen2Cor-02.05.05-Linux64.run

Install sen2chain from sources
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code-block:: console

    git clone https://framagit.org/jebins/sen2chain.git
    cd sen2chain
    pip3 install --user -e .


Configuration
-------------

The configuration file is located at: ``~/sen2chain_data/config/config.cfg``.
This file (and corresponding path) is only created after the first sen2chain import in python.

Configure Sentinel-2 images library
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

At first launch default folders are created in ``~/sen2chain_data/data``. You can change the settings by editing the configuration file.

Sen2cor configuration
^^^^^^^^^^^^^^^^^^^^^

The full path to the sen2cor bashrc file is needed to process L1C to L2A.
e.g.: ``/home/user/Sen2Cor-02.05.05-Linux64/L2A_Bashrc``

Hubs logins
^^^^^^^^^^^
In order to dowload images, you need a login on the `PEPS <https://peps.cnes.fr/rocket/#/home/>`_  and `Scihub <https://scihub.copernicus.eu/dhus>`_ servers.

* The PEPS login and password must be stored in ``~/sen2chain_data/config/peps.txt`` like so:

.. code-block:: html

    username password

* The Scihub login and password are stored in the configuration file.