eo_tools

KO | EN

gitlite — search

#python #ai #typescript #machine-learning #rust #deep-learning #linux #java #nodejs #windows #cli #awesome-list #mcp #open-source

(★ 69)

A python toolbox for easily downloading and processing Sentinel-1 SLC, Sentinel-2 and DEM data.

eo_tools 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# A python Earth Observation toolbox

[![Conda Version](https://img.shields.io/conda/vn/conda-forge/eo-tools.svg)](https://anaconda.org/conda-forge/eo-tools) [![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/eo_tools.svg)](https://anaconda.org/conda-forge/eo_tools)

EO-Tools is a pure python toolbox that is currently able to search, download and process Sentinel-1 InSAR pairs, geocode and apply terrain correction to Sentinel-1 SLC products, download and mosaic Sentinel-2 tiles and download various publicly available DEM (Digital Elevation Models). The S1 processor can compute phase, amplitude and coherence in the SAR geometry and reproject them in a geographic coordinate system. Example notebooks demonstrating the different features are located in the notebooks-cf folder of the github repository.

## **New**

EO-Tools can now download and process Sentinel-1 SLC **partial products**. Instead of downloading an entire Sentinel-1 product, the partial-product downloader retrieves the metadata and only the consecutive bursts intersecting an area of interest. The result is stored as a SAFE-like `<product-id>.partial.SAFE` directory and can be passed directly to the existing Sentinel-1 processors.

Partial products provide several advantages:

- Smaller downloads and reduced local storage requirements.
- Faster access to the Sentinel-1 data needed for a specific area.
- The download AOI, available subswaths, polarizations, and burst ranges are stored with the product for reproducible processing.
- Existing high-level InSAR, SLC geocoding, H-Alpha, and polarimetric covariance processing APIs automatically recognize valid partial products.

See the [partial-product download tutorial](https://eo-tools.readthedocs.io/en/feature-s1-partial-product-s3/s1-partial-product-download/) and [partial-product processing tutorial](https://eo-tools.readthedocs.io/en/feature-s1-partial-product-s3/s1-partial-product-processing/) to get started.

## Examples

Here are examples of EO-Tools outputs showing amplitude, coherence and inteferometric phase of a 2023 earthquake in Morocco,

 <a href="https://raw.githubusercontent.com/odhondt/eo_tools/main/data/ex_amp.png" target="_blank">
 <img src="https://raw.githubusercontent.com/odhondt/eo_tools/main/data/ex_amp_lowres.png" width="220" alt="Amplitude.">
 </a>
 <a href="https://raw.githubusercontent.com/odhondt/eo_tools/main/data/ex_coh.png" target="_blank">
 <img src="https://raw.githubusercontent.com/odhondt/eo_tools/main/data/ex_coh_lowres.png" width="220" alt="Coherence.">
 </a>
 <a href="https://raw.githubusercontent.com/odhondt/eo_tools/main/data/ex_phi.png" target="_blank">
 <img src="https://raw.githubusercontent.com/odhondt/eo_tools/main/data/ex_phi_lowres.png" width="220" alt="Phase.">
 </a>

a comparison between Sentinel-1 amplitude, coherence, change map using two dates in 2021 and Sentinel-2 RGB image over the city of Berlin in Germany,

 <a href="https://raw.githubusercontent.com/odhondt/eo_tools/main/data/amp_vh_berlin.png" target="_blank">
 <img src="https://raw.githubusercontent.com/odhondt/eo_tools/main/data/amp_vh_berlin_lowres.png" width="350" alt="Amplitude Berlin.">
 </a>
 <a href="https://raw.githubusercontent.com/odhondt/eo_tools/main/data/coh_vh_berlin.png" target="_blank">
 <img src="https://raw.githubusercontent.com/odhondt/eo_tools/main/data/coh_vh_berlin_lowres.png" width="350" alt="Coherence Berlin.">
 </a>
 <a href="https://raw.githubusercontent.com/odhondt/eo_tools/main/data/change_berlin.png" target="_blank">
 <img src="https://raw.githubusercontent.com/odhondt/eo_tools/main/data/change_berlin_lowres.png" width="350" alt="Change Berlin.">
 </a>
 <a href="https://raw.githubusercontent.com/odhondt/eo_tools/main/data/s2_berlin.png" target="_blank">
 <img src="https://raw.githubusercontent.com/odhondt/eo_tools/main/data/s2_berlin_lowres.png" width="350" alt="S2 Berlin.">
 </a>

and the comparison between Beta nought calibration and terrain flattening using Copernicus DEM on Sentinel-1 data over Etna.

 <a href="https://raw.githubusercontent.com/odhondt/eo_tools/main/data/ex_etna_beta0.png" target="_blank">
 <img src="https://raw.githubusercontent.com/odhondt/eo_tools/main/data/ex_etna_beta0_lowres.png" width="300" alt="Beta0.">
 </a>
 <a href="https://raw.githubusercontent.com/odhondt/eo_tools/main/data/ex_etna_flattened.png" target="_blank">
 <img src="https://raw.githubusercontent.com/odhondt/eo_tools/main/data/ex_etna_flattened_lowres.png" width="300" alt="Flattened.">
 </a>

## Overview
- Currently, the available features are:
    - Sentinel-1
        - Interferometric processing of Sentinel-1 pairs, including TOPS processing steps like azimuth deramping, DEM assisted coregistration, Range-Doppler terrain correction and Enhanced Spectral Diversity. Individual bursts can be processed as well as full products and cropped to any area of interest provided by the user
        - Amplitude geocoding of SLC Sentinel-1 images, with Beta or Sigma Nought or terrain flattening calibration.
        - Ability to apply processing in the SAR geometry and further project the results in a geographic coordinate systems using lookup-tables.
        - Writing the result as a geocoded (terrain corrected) COG (Cloud Optimized GeoTIFF) file
        - Displaying these rasters on top of a folium map in a jupyter notebook (docker version only)
    - Sentinel-2
        - Tile merging and geocoding
        - Write any band to COG files
        - Visualization of color composites (Natural RGB, CIR, SWIR, etc) on a folium map (docker version only)
    - DEM
        - Automatically downloads and crops a DEM given a geometry 
    - All products
        - Search catalog (using EODAG) and download products
        - Explore products by displaying their footprint on a folium map (custom function)
        - Show remote and local images on top of folium maps in the notebook
- Example notebooks can be found in the `notebooks/` folder

## Install & quick start

- The package comes in two flavors
    - A conda package that contains the main functionality (Sentinel-1 InSAR, Sentinel-2 tile mosaic and DEM download)
    - A docker version (for more advanced users) that additonally works with a TiTiler server for interactive visualization in the notebooks

### Conda install (recommended)

- It is recommended to first create a conda environment to avoid package conflicts
- You need to have `conda` installed (or `mamba` / `micromamba`)
- Then the package can be installed with these commands (replace `conda` by `mamba` or `micromamba` if needed):

```bash
conda create -n eo_tools
conda activate eo_tools
conda install conda-forge::eo-tools 
```

### Docker install

- It works as a dev container for VSCode. 
    - Clone the github repository into the location of your choice.
    - Volumes paths can (and should) be changed in `docker-compose.yml`.
    - After opening the main directory, VSCode should detect the devcontainer file and ask to build the container. Once the container is running, the example notebooks in the `notebooks` directory can be used.
- Alternatively, it should also be possible to start the container from the main directory with `docker-compose up -d` in a terminal and attach to the container with any editor supporting docker.

### Getting started

- Please make sure `jupyter` is installed in your environment
- Example jupyter notebooks demonstrate the different features
- For conda use the notebooks in the `notebooks-cf` directory of the github repository
- For docker use the notebooks in the `notebooks` directory of the github repository
- To be able to download products with EODAG on Copernicus Dataspace, a file named `eodag_config.yaml` containing credentials must be created. The file `eodag_config_example.yml` located in the repository root directory may be used for this purpose. Feel free to copy, rename and edit this file with your credentials. It is recommended to store the file in a secure location outside of the local repository.

### Documentation

Documentation is available on [Read the Docs](https://eo-tools.readthedocs.io/en/latest/).

## Notice

- This project was originally forked from: https://github.com/eo2cube/s1_processor/, however since 99% of the code is now original, I have detached the fork.
- Visualization functions are using TiTiler https://developmentseed.org/titiler/
- Full-product discovery and download use EODAG https://github.com/CS-SI/eodag
- Sentinel-1 partial-product discovery and download use the Copernicus Data Space Ecosystem STAC and S3 services

eo_tools

eo_tools 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

eo_tools

eo_tools 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README