Tools for working with the Earth Engine from a Jupyter development environment
Project description
earthengine-jupyter
NOTICE: This is an experimental project and is not an officially supported Google project. You are welcome to use it, but we do not guarantee stability.
Setup
try:
import ee_jupyter
print('ee_jupyter was already installed.')
except ModuleNotFoundError:
print('ee_jupyter was not found. Installing now...')
import os
result = os.system('pip -q install earthengine-jupyter')
Make sure that the earthengine-jupyter package is installed...
How to use
This lib contains a
Map
class that can be used to display an interactive map.
import ee
from ee_jupyter.core import authenticate_if_needed
from ee_jupyter.ipyleaflet import Map
authenticate_if_needed()
✓ Authentication credentials were found.
# Intialize the Earth Engine client library.
ee.Initialize()
map1 = Map(center=(37.5924, -122.09), zoom=8)
map1
Map(center=[37.5924, -122.09], controls=(ZoomControl(options=['position', 'zoom_in_text', 'zoom_in_title', 'zo…
Define an Earth Engine image layer, and add it to the interactive map.
img1 = ee.Image("LANDSAT/LC09/C02/T1_L2/LC09_044034_20220127")
visualization = {
'bands': ['SR_B4', 'SR_B3', 'SR_B2'],
'min': 0.2 / 0.0000275,
'max': 0.4 / 0.0000275,
}
map1.addLayer(eeObject=img1, visParams=visualization, name='Landsat scene')
We can also create an inspector object and associate it with the previously created map.
from ee_jupyter.ipyleaflet import Inspector
inspector1 = Inspector(map_object=map1)
inspector1
Inspector(layout=Layout(border_bottom='solid', border_left='solid', border_right='solid', border_top='solid', …
Typically when you create a inspector object, you will want to display it near the map.
from ipywidgets import HBox
display(HBox([map1, inspector1]))
HBox(children=(Map(center=[37.5924, -122.09], controls=(ZoomControl(options=['position', 'zoom_in_text', 'zoom…
Tip With Caption
Note that when viewed on GitHub Pages you can manipulate Jupyter widgets independently, but the widgets do not interact with each other. To experience the cross-widget interactivity, open up this notebook in a Jupyter environment.
Displaying a Map Image
If you want to display a static (non-interactive) image, you can do that
as well. The embed=True
parameter will allow the image to be saved
within the notebook.
from IPython.display import Image
visualization['dimensions'] = 400 # maximum dimension for the image
url = img1.getThumbUrl(visualization)
Image(url=url, format='png', embed=True)
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for earthengine-jupyter-0.0.6.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 94aa3035869de8a747c0cab119b42b7c8e09e1b63583adbbbb77d07caf226cb6 |
|
MD5 | 78d26d224b34dd24dade7c967af15679 |
|
BLAKE2b-256 | 503f18b2731f624bd73b0f66aa3eca09254ba6e73e73644869d51982ada3255e |
Hashes for earthengine_jupyter-0.0.6-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 82ddee3b74f1dfa30f63d0e65ad6cdfd6bf74d17e64d2ff6c74447b076fe903e |
|
MD5 | 9e276e5cf622635522110a72209d08ae |
|
BLAKE2b-256 | 922faae228c4aefbca1ffaf8d2e9e1ff9bc9d4522e7b9f5b3d3611c6bb712a17 |