Code Monkey home page Code Monkey logo

eodag-sentinelsat's Introduction

eodag-sentinelsat

This is a repository for sentinelsat plugin to EODAG. It's an Api plugin that enables to search and download EO products from catalogs implementing the SciHub / Copernicus Open Access Hub interface. It is basically a wrapper around sentinelsat, enabling it to be used on eodag.

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

Installation

eodag-sentinelsat is on PyPI:

python -m pip install eodag-sentinelsat

Configuration

  1. Register to Scihub to get the required credentials (username/password).

  2. Follow the guidelines provided in EODAG's documentation to configure the plugin. You can create a dedicated configuration file or edit the default one ~/.config/eodag/eodag.yml:

    scihub:
        priority: 2  # Must be higher than the other providers' priorities
        api:
            credentials:
                username: "PLEASE_CHANGE_ME"  # Your own username
                password: "PLEASE_CHANGE_ME"  # Your own password

Examples

Python API:

import eodag

dag = EODataAccessGateway()

search_results, _ = dag.search(
    productType="S2_MSI_L1C",
    start="2021-03-01",
    end="2021-03-31",
    geom={"lonmin": 1, "latmin": 43, "lonmax": 2, "latmax": 44}
)
product_paths = dag.download_all(search_results)

CLI:

eodag search \
   --productType S2_MSI_L1C \
   --start 2018-01-01 \
   --end 2018-01-31 \
   --box 1 43 2 44 \
   --storage my_search.geojson
eodag download --search-results my_search.geojson

Contribute

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

git clone https://github.com/CS-SI/eodag-sentinelsat.git
cd eodag-sentinelsat
python -m pip install -e .[dev]
pre-commit install

We use pre-commit to run a suite of linters, formatters and pre-commit hooks (black, isort, flake8) to ensure the code base is homogeneously formatted and easier to read. It's important that you install it, since we run the exact same hooks in the Continuous Integration.

To run the default test suite (which excludes end-to-end tests):

tox

To only run end-to-end test:

tox -- tests/test_end_to_end.py

LICENSE

eodag-sentinelsat is licensed under GPLv3. See LICENSE for details.

Authors

eodag-sentinelsat has been created by CS GROUP - France.

Credits

See NOTICE file.

eodag-sentinelsat's People

Contributors

adrcad avatar aoyono avatar maximlt avatar remi-braun avatar sbrunato avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.