https://github.com/cs-si/eodag-cube

Data access for EODAG
https://github.com/cs-si/eodag-cube

catalog datacube downloader eodag lib remote-sensing search spatial-imagery

Last synced: 24 days ago
JSON representation

Data access for EODAG

• Host: GitHub
• URL: https://github.com/cs-si/eodag-cube
• Owner: CS-SI
• License: apache-2.0
• Created: 2020-12-18T18:12:50.000Z (over 4 years ago)
• Default Branch: develop
• Last Pushed: 2025-02-07T14:45:46.000Z (4 months ago)
• Last Synced: 2025-05-07T02:29:40.578Z (24 days ago)
• Topics: catalog, datacube, downloader, eodag, lib, remote-sensing, search, spatial-imagery
• Language: Python
• Homepage:
• Size: 6.32 MB
• Stars: 12
• Watchers: 6
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
.. image:: https://badge.fury.io/py/eodag-cube.svg

    :target: https://badge.fury.io/py/eodag-cube

.. image:: https://img.shields.io/pypi/l/eodag-cube.svg

    :target: https://pypi.org/project/eodag-cube/

.. image:: https://img.shields.io/pypi/pyversions/eodag-cube.svg

    :target: https://pypi.org/project/eodag-cube/

.. image:: https://mybinder.org/badge_logo.svg

    :target: https://mybinder.org/v2/git/https%3A%2F%2Fgithub.com%2FCS-SI%2Feodag-cube.git/package-data?filepath=docs%2Fnotebooks%2Fclip-reproject.ipynb

EODAG-cube

==========

This project is the data-access part of `EODAG `_

.. image:: https://eodag.readthedocs.io/en/latest/_static/eodag_bycs.png

    :target: https://github.com/CS-SI/eodag

|

Installation

============

EODAG-cube is on `PyPI `_::

    python -m pip install eodag-cube

Documentation

=============

Documentation is available through `EODAG API User Guide / Data access with eodag-cube `_.

See also:

* `Python API Reference / EOProduct - pixel access `_

* `Python API Reference / Assets - pixel access `_

* `Python API Reference / utils - xarray `_

Usage - Python API

==================

Example usage for interacting with the api in your Python code:

.. code-block:: python

    from eodag import EODataAccessGateway

    from rasterio.crs import CRS

    dag = EODataAccessGateway()

    search_criteria = dict(

        provider='earth_search',

        productType='S2_MSI_L1C',

        geom=[1, 43.5, 2, 44],

        start='2020-06-04',

        end='2020-06-05',

    )

    search_results = dag.search(**search_criteria)

    product = search_results[0]

    product

.. image:: docs/_static/eoproduct.png?raw=true

   :alt: EOProduct

Whole product as ``XarrayDict``:

.. code-block:: python

    product.to_xarray()

.. image:: docs/_static/xarray_dict.png?raw=true

   :alt: XarrayDict

Single asset as ``xarray.Dataset``:

.. code-block:: python

    product.assets["blue"].to_xarray()

.. image:: docs/_static/dataset.png?raw=true

   :alt: Dataset

``fsspec.core.OpenFile`` file object:

.. code-block:: python

    product.assets["blue"].get_file_obj()

````

Contribute

==========

If you intend to contribute to eodag-cube source code::

    git clone https://github.com/CS-SI/eodag-cube.git

    cd eodag-cube

    python -m pip install -e .[dev]

    pre-commit install

    tox

LICENSE

=======

EODAG is licensed under Apache License v2.0.

See LICENSE file for details.

AUTHORS

=======

EODAG is developed by `CS GROUP - France `_.