giswqs/earthengine-py-notebooks

A collection of 300+ Jupyter Python notebook examples for using Google Earth Engine with interactive mapping


repo name	giswqs/earthengine-py-notebooks
repo link	https://github.com/giswqs/earthengine-py-notebooks
homepage
language	Jupyter Notebook
size (curr.)	16674 kB
stars (curr.)	408
created	2020-01-25
license	MIT License

earthengine-py-notebooks

A collection of 300+ Jupyter Python notebook examples for using Google Earth Engine with interactive mapping

Contact: Qiusheng Wu (https://wetlands.io)

1. Description

This repository is a collection of 300+ Jupyter Python notebook examples. I developed these examples by converting my other repo qgis-earthengine-examples from Python scripts to Jupyter notebooks. Now you can display Earth Engine data layers interactively in Jupyter notebooks without having to install QGIS. Three Python packages are being used in these examples, including the Earth Engine Python API, folium, and geehydro. The geehydro Python package builds on the folium package and implements several methods for displaying Earth Engine data layers, such as Map.addLayer(), Map.setCenter(), Map.centerObject(), and Map.setOptions().

2. Usage

Step 1: Explore this repository and open any available Jupyter notebook in your browser (e.g., template.ipynb)
Step 2: When the selected Jupyter notebook is open, click the Notebook Viewer link to view the interactive map.
Step 3: If you would like to execute cells in the notebook interactively, you will need to Sign up for a Google Earth Engine account. Then you can click either Run in Google Colab or Run in binder to execute code interactively. This will allow you to add your own Earth Engine Python script.

3. How to automatically convert Earth Engine JavaScript to Python script?

Keep in mind that the conversion might not always work prefectly. Additional manual changes might still be needed. ui and chart are not supported.

Download convert_js_to_python.py.
To convert one GEE JavaScript to Python script: js_to_python(in_file_path, out_file_path)
To convert all GEE JavaScripts in a folder recursively to Python scripts: js_to_python_dir(in_dir, out_dir)
To convert all GEE Python scripts in a folder recursively to Jupyter notebooks: py_to_ipynb_dir(in_dir, in_template)
To execute all GEE Jupyter notebooks in a folder recursively: execute_notebook_dir(in_dir)

4. Demo

ee-py-notebooks

5. Examples

The Table of Contents below mimics the structure of the Google Earth Engine API Documentation. I strongly encourage you to check out the API Documentation if you need an in-depth explanation of each Python example. Please note that the list below does not include all the Python examples contained in this repository. You are welcome to explore the repository and find more examples to suit your needs.