Starter geeViz geeView Notebook#

  • Uses the stock GEE NLCD assets and extracts the palette, names, and values from image properties

  • Then uses those to color the raster and create a legend using the autoViz option setting it to True

  • Then provide a color dictionary with the format: {value:hex_color} ex({'1':'FF0','2':'F00'})

  • Conversion of numbers to labels is supported with the queryDict key in the viz params:

Ex. {'1':'Water','2':'Trees'}

  • Interactive time lapses can be created from most imageCollections

Copyright 2024 Ian Housman

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

github github

Importing geeViz.geeView#

#Import modules
try:
    import  geeViz.geeView as geeView
except:
    !python -m pip install geeViz
    import  geeViz.geeView as geeView

ee = geeView.ee
Map = geeView.Map
Map.clearMap()
print('done')

Initializing GEE
Cached project id file path: C:\Users\ihousman\.config\earthengine\credentials.proj_id
Cached project id: lcms-292214

*** Earth Engine *** Share your feedback by taking our Annual Developer Satisfaction Survey: https://google.qualtrics.com/jfe/form/SV_0JLhFqfSY1uiEaW?source=Init

Successfully initialized
geeViz package folder: c:\Users\ihousman\AppData\Local\Programs\Python\Python311\Lib\site-packages\geeViz
done

Adding a GEE image (NLCD) to the Map and viewing and querying it#

#Clear any layers added to Map object
#If map is not cleared, layers are simply appended to the existing list of layers if layers have been added previously
Map.clearMap()
#Bring in NLCD 2011
nlcd = ee.Image('USGS/NLCD_RELEASES/2016_REL/2011')

#Add the layers to the map
#If an image has class values, names, and a palette property available, use 'autoViz':True to pull those properties for first band of the image provided
#Image must be a single band for thematic visualization to work properly
#Then provide a dictionary of the values and colors ex: {value:hex_color}
#If nothing is to be added to the legend, set 'addToLegend' to False
Map.addLayer(nlcd.select(['landcover']),{'autoViz':True},'NLCD 2011 Landcover/Landuse',True)

#Can center map on a GEE object
Map.centerObject(nlcd)

#Turn on inspector to double-click and see values of visible layers
Map.turnOnInspector()

Map.view()

Adding layer: NLCD 2011 Landcover/Landuse
Starting webmap
Using default refresh token for geeView
Local web server at: http://localhost:8001/geeView/ already serving.
cwd a:\GEE\gee_py_modules_package\geeViz\examples
geeView URL: http://localhost:8001/geeView/?projectID=lcms-292214&accessToken=ya29.a0AeDClZC9ZMk9nE3alPEasRZHHuiqY9ioimY7gcSWjbR7C4CJ9eiKSJyGhiiF7OkJTdtJ6D6PcRWSTX1ZPnE1SgQsKdehpNOEMaFHJjpe-AG8DAKaqK2rFhx_8H_r47M2Sl5Sux95uFcCytus3cGehAIgJ0305osLh_eBpjAVq9waCgYKAXQSARESFQHGX2MiN1vvcKYW4oN6bshp7Owqdw0178&accessTokenCreationTime=1732564901727

Visualizing multiple layers on the map#

Map.clearMap()
#Images or image collections can be added.  If an image collection is added, the first non null value is displayed on the map. A time series will be displayed when the layer is queried
nlcd = ee.ImageCollection('USGS/NLCD_RELEASES/2016_REL')
nlcd = nlcd.filter(ee.Filter.calendarRange(2000,2020,'year'))
nlcd = nlcd.map(lambda img: img.set('bns',img.bandNames()))
nlcd = nlcd.filter(ee.Filter.listContains('bns','landcover')).select(['landcover'])

# Can optionally turn off class numbers in legend by setting 'includeClassValues':False,
Map.addLayer(nlcd.sort('system:time_start'),{'autoViz':True,'includeClassValues':False},'NLCD Landcover/Landuse Time Series',True)

# Continuous data automatically have a legend added
nlcd = ee.Image('USGS/NLCD_RELEASES/2016_REL/2016')
Map.addLayer(nlcd.select(['percent_tree_cover']),{'min':20,'max':80,'palette':'555,0A0','opacity':0.5,'legendLabelLeftAfter':'% TCC','legendLabelRightAfter':'% TCC'},'NLCD 2016 TCC',True)

Map.turnOnInspector()
Map.view()

Adding layer: NLCD Landcover/Landuse Time Series
Adding layer: NLCD 2016 TCC
Starting webmap
Using default refresh token for geeView
Local web server at: http://localhost:8001/geeView/ already serving.
cwd a:\GEE\gee_py_modules_package\geeViz\examples
geeView URL: http://localhost:8001/geeView/?projectID=lcms-292214&accessToken=ya29.a0AeDClZCdWbAp2YEv9OinAUuSbK8mjozVuITQXsLXww9NR_eSxgtWs-oCgfSQ0if6cygVUJ5K-9RKSMKUEhLcfmHUcsBrk4Sp73jOtg5ufkMA3rDwOeq-kfBO7ZzJ9iYtg8YO9CMPsGrJGsqfioRzr8vMjJlpl8hy3YvvMkrF-AwaCgYKAUMSARESFQHGX2MiaTjARdF2H_Ms2mb2DFeMHA0178&accessTokenCreationTime=1732565064272

Introducing map query lookup tables and custom styles#

Map.clearMap()
#Another example
mtbs = ee.ImageCollection('projects/gtac-mtbs/assets/burn_severity_mosaics/MTBS')
mtbs = mtbs.map(lambda img: img.updateMask(img.neq(0)).select([0],['Burn Severity']).byte())

#Set up MTBS legend and color properties
mtbsColors = ['006400','7fffd4','ffff00','ff0000','7fff00','ffffff']
mtbsLabels = ['1 Unburned to Low','2 Low','3 Moderate','4 High','5 Increased Greenness','6 Non-Processing Area Mask']
mtbsDict =  {mtbsLabels[i]: mtbsColors[i] for i in range(len(mtbsColors))}
mtbsQueryDict = {'1':'Unburned to Low','2':'Low','3':'Moderate','4':'High','5':'Increased Greenness','6':'Non-Processing Area Mask'}
severityViz = {'min':1,'max':6,'palette':mtbsColors	,'classLegendDict':mtbsDict,'queryDict':mtbsQueryDict}

#Add it to the map
Map.addLayer(mtbs.max(),severityViz,'MTBS 1984-2017 Highest Severity',True)

Map.turnOnInspector()
Map.view()

Adding layer: MTBS 1984-2017 Highest Severity
Starting webmap
Using default refresh token for geeView
Local web server at: http://localhost:8001/geeView/ already serving.
cwd a:\GEE\gee_py_modules_package\geeViz\examples
geeView URL: http://localhost:8001/geeView/?projectID=lcms-292214&accessToken=ya29.a0AeDClZDEzWma5X5W-oHKCexM8jy1fvuNiDAgP07VHbMN6HHAjJktIgzS97_mpORIntBzrleDIqRW4mzlY45PV5hL00AmDEMPk0yYKTvqhDUQkGuAKtjC1IWCv8x9KXU9aAkyI_6tdjC_ZjbMbACiNbZPgzWW6Pfa4VRfX5uHIysaCgYKAdoSARESFQHGX2Mis6lGLlm0ts5y8AVhKmIzgg0178&accessTokenCreationTime=1732565082937

Visualizing vectors and rasters on the map#

#Feature collections can be added to the map as well
#If they are very large, the geeVectorImage option is needed as the conversion from GEE object to geoJSON is too slow
#Instead of clearing the map, this time, we'll add it to the existing map above
perims = ee.FeatureCollection('projects/gtac-mtbs/assets/perimeters/mtbs_perims_DD')
Map.addLayer(perims,{'strokeColor':'00F'},'MTBS Burn Perimeters',True)

#Double click to see raster value of burn severity, as well as the attribute table of the feature
Map.view()

Adding layer: MTBS Burn Perimeters
Starting webmap
Using default refresh token for geeView
Local web server at: http://localhost:8001/geeView/ already serving.
cwd a:\GEE\gee_py_modules_package\geeViz\examples
geeView URL: http://localhost:8001/geeView/?projectID=lcms-292214&accessToken=ya29.a0AeDClZBtu0k2gNpi4vy_3WTk89zD7TnCY2jV_58KR3dZBzuK9IC30vpVunkWSZoLtvydJWpP6appk3GvnXLjghoFmxOlrXf4RBBkj6dkogsVR1TqAHrzRUmnJDyEjpwncoI-AUYvO5x8V_icMITvLjZT5it08wDuVNS5y07tIscaCgYKAXkSARESFQHGX2MiPJSgbTMg-G5QabpMKuznNg0178&accessTokenCreationTime=1732565101648

Visualizing GEE layers as a local geojson vector#

Map.clearMap()
#Smaller feature collections can be added to the map as a geojson vector by specifying 'layerType':'geeVector'
#They will render more quickly than the raterized version of the vector
nps = ee.FeatureCollection('projects/USFS/LCMS-NFS/CONUS-Ancillary-Data/NPS_Boundaries').filter(ee.Filter.eq('PARKNAME','Yellowstone'))
Map.addLayer(nps,{'layerType': 'geeVector'},'Yellowstone National Park',True)
Map.centerObject(nps)
Map.turnOnInspector()
Map.view()

Adding layer: Yellowstone National Park
Starting webmap
Using default refresh token for geeView
Local web server at: http://localhost:8001/geeView/ already serving.
cwd a:\GEE\gee_py_modules_package\geeViz\examples
geeView URL: http://localhost:8001/geeView/?projectID=lcms-292214&accessToken=ya29.a0AeDClZAezqp01cIEOBoAqg2IyAX7siCvpDiVQ4TJDvPJooEZjhmH9MBnk8awa4ut9LS2gQrVDTwmqwkbWmIdU0VGrsW0ZUlgojuBHakihs4LRgVNnnzWTLaqdQGkEdmlo2FHWqRNOW_JHyDw6AvyI6OdglQopqn53aer93wfaS4aCgYKAQASARESFQHGX2Mi4CooIU_ziSIVWHXLJOUy0A0178&accessTokenCreationTime=1732565130682

Using geeView’s Map.addTimeLapse function to visualize an imageCollection#

Map.clearMap()
#An interactive time lapse can also be created from an annual image collection
#Bring in the JRS Surface water data
water = ee.ImageCollection('JRC/GSW1_0/YearlyHistory')

#Here is another example of creating a lookup dictionary
waterColors = ['ffffff','99d9ea','0000ff']
waterLabels = ['1 Not Water','2 Seasonal Water','3 Permanent Water']
waterDict =  {waterLabels[i]: waterColors[i] for i in range(len(waterColors))}
waterQueryDict =  {str(i+1): waterLabels[i] for i in range(len(waterLabels))}

#The lookup table is applied to the image, but only a graph is created when querying the imageCollection
Map.addLayer(water,{'min':1,'max':3,'palette':waterColors,'classLegendDict':waterDict,'queryDict':waterQueryDict},'JRC Surface Water Time Series',False)
Map.addLayer(water.mode(),{'min':1,'max':3,'palette':waterColors,'classLegendDict':waterDict,'queryDict':waterQueryDict},'JRC Surface Water Mode',True)
Map.addTimeLapse(water,{'min':1,'max':3,'palette':waterColors,'classLegendDict':waterDict},'JRC Surface Water Time Lapse',False)
Map.centerObject(water)
Map.view()

c:\Users\ihousman\AppData\Local\Programs\Python\Python311\Lib\site-packages\ee\deprecation.py:207: DeprecationWarning: 

Attention required for JRC/GSW1_0/YearlyHistory! You are using a deprecated asset.
To ensure continued functionality, please update it.
Learn more: https://developers.google.com/earth-engine/datasets/catalog/JRC_GSW1_0_YearlyHistory

  warnings.warn(warning, category=DeprecationWarning)

Adding layer: JRC Surface Water Time Series
Adding layer: JRC Surface Water Mode
Adding layer: JRC Surface Water Time Lapse
Starting webmap
Using default refresh token for geeView
Local web server at: http://localhost:8001/geeView/ already serving.
cwd a:\GEE\gee_py_modules_package\geeViz\examples
geeView URL: http://localhost:8001/geeView/?projectID=lcms-292214&accessToken=ya29.a0AeDClZAlsuVMY4s0axMzoAGBFZnZSizbu-h175yGINMHpEhuMWniA9OD33KUXUISs376RMYK75_pp2b_JBw7M7G4VoeLjxS_je1EFmM7JS9H3saEhlD05NpN_W8RuRhAf9CZ4Jgm9ROrSqLI-QwUQSGo43THsCRWPfkIggX0veYaCgYKATYSARESFQHGX2Mi99zBRgnkVA3UetKqa0L6pQ0178&accessTokenCreationTime=1732565241221