Skip to main content

A collection of tools to work with Google Earth Engine Python API

Project description

License: MIT conventional commit Black badge prettier badge pre-commit PyPI version Conda-forge version build Test Coverage Documentation Status

Google Earth Engine tools

https://raw.githubusercontent.com/gee-community/geetools/main/docs/_static/logo.svg

Google Earth Engine is a cloud-based service for geospatial processing of vector and raster data. The Earth Engine platform has a JavaScript and a Python API with different methods to process geospatial objects.

The geetools package extends the Google Earth Engine Python API with pre-processing and processing tools for the most used satellite platforms by adding utility methods for different Earth Engine Objects that are friendly with the Python method chaining using the geetools namespace.

There is JavaScript module that you can import from the code editor that has similar functions (not exactly the same) and it’s available here.

Installation

pip install geetools

Why using it ?

New utility methods and constructors are added to most of the GEE classes. They can be simple wrapper for repetitive tasks, complex algorithm or mandatory preprocessing steps. The goal is to make the code more fluid and easy to read for researchers, students and analysts.

The package design is mostly performing server-side computation making it also very friendly with commercial users of Earth Engine.

This small example wrapping of the excellent ee_extra package functionalities shows how to preprocess sentinel 2 data in 5 lines of code:

import ee
import geetools #noqa: F401
import pygaul # another gee-community package to access FAO GAUl 2015 dataset

# we assume you are already authenticated to GEE
ee.Initialize.geetools.from_account("toto") # yes we also support multi users

amazonas = pygaul.Items(name="Amazonas").centroid()

S2 = (
   ee.ImageCollection('COPERNICUS/S2_SR')
   .filterBounds(point)
   .geetools.closest('2020-10-15') # Extended (pre-processing)
   .geetools.maskClouds(prob = 70) # Extended (pre-processing)
   .geetools.scaleAndOffset() # Extended (pre-processing)
   .geetools.spectralIndices(['NDVI','NDWI','BAIS2'])) # Extended (processing)

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

geetools-1.4.0.tar.gz (1.8 MB view details)

Uploaded Source

Built Distribution

geetools-1.4.0-py3-none-any.whl (104.8 kB view details)

Uploaded Python 3

File details

Details for the file geetools-1.4.0.tar.gz.

File metadata

  • Download URL: geetools-1.4.0.tar.gz
  • Upload date:
  • Size: 1.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.14

File hashes

Hashes for geetools-1.4.0.tar.gz
Algorithm Hash digest
SHA256 4749fe6189f5d19ec40b10b68679fcb6dfc9c2d17df5e02e6cb3efe6f5fc21a0
MD5 e1affc006c5dc71a2794f9961cd8cb5c
BLAKE2b-256 619143d2ba0d4c7af3e7dea4a9cd4229c40e3bbc9e4b61864d14d68491d15fc4

See more details on using hashes here.

File details

Details for the file geetools-1.4.0-py3-none-any.whl.

File metadata

  • Download URL: geetools-1.4.0-py3-none-any.whl
  • Upload date:
  • Size: 104.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.14

File hashes

Hashes for geetools-1.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 54f373a56552c3ab4964c768bedb8e3aee000d1ce365348d24fc3ce668ef1a65
MD5 442d2f06d9387cc16267fb7644fd8e7d
BLAKE2b-256 abab8293fb8224d254c30553be284207df7c11b2c2bd753ac30615fa4ca01fbc

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page