eodag.rst

EODAG
======

| `EODAG <https://eodag.readthedocs.io/en/stable/>`_ is a command-line tool and a Python package for searching and downloading remotely sensed images while offering a unified API for data access regardless of the data provider. 

| As of June 2023, Sen2chain only supports EODAG v2.10.0. A specific plugin was released for the Scihub provider. Both packages can be installed with pip.


.. code-block:: bash
    
    python -m pip install eodag==2.10.0
    python3 -m pip install eodag-sentinelsat
    
Then, import eodag in a python console to initialize the package :

.. code-block:: python

    from eodag import EODataAccessGateway
    dag=EODataAccessGateway()
    exit()
    
    
Hubs logins & EODAG configuration file  
=======================================

`Register <https://eodag.readthedocs.io/en/stable/getting_started_guide/register.html>`_ to PEPS, Scihub or any provider you deem relevant for your work, and get the required credentials (username/password).

| Follow the guidelines provided in `EODAG's documentation <https://eodag.readthedocs.io/en/stable/getting_started_guide/configure.html>`_ to configure the plugin. 
| You can create a dedicated configuration file or edit the default one in: 

.. code-block:: bash
    
    ~/.config/eodag/eodag.yml


.. code-block:: bash
	
	scihub:
		  priority: 1 # Highest number for your preferred provider, see more in eodag documentation 
		  api: 
			  credentials: 
				  username: "PLEASE_CHANGE_ME" # Your own username 
				  password: "PLEASE_CHANGE_ME" # Your own password