Image overview

Image Overview

Raster data are represented as Image objects in Earth Engine. Images are composed of one or more bands and each band has its own name, data type, scale, mask and projection. Each image has metadata stored as a set of properties.

In addition to loading images from the archive by an image ID, you can also create images from constants, lists or other suitable Earth Engine objects. The following illustrates methods for creating images, getting band subsets, and manipulating bands.

More information about ee.Image can be found in the Earth Engine Documentation.

In [1]:

# !pip isntall geemap

# !pip isntall geemap

In [2]:

import ee
import geemap

import ee import geemap

Loading a single-band image¶

Images can be loaded by pasting an Earth Engine asset ID into the ee.Image constructor. You can find image IDs in the data catalog. For example, to load SRTM Digital Elevation Data:

In [3]:

Map = geemap.Map(center=(40, -100), zoom=4)
Map

Map = geemap.Map(center=(40, -100), zoom=4) Map

Out[3]:

Make this Notebook Trusted to load map: File -> Trust Notebook

In [4]:

dem = ee.Image('CGIAR/SRTM90_V4')
Map.addLayer(dem, {}, "DEM")

dem = ee.Image('CGIAR/SRTM90_V4') Map.addLayer(dem, {}, "DEM")

In [5]:

# Set visualization parameters.
vis_params = {
    'min': 0,
    'max': 4000,
    'palette': ['006633', 'E5FFCC', '662A00', 'D8D8D8', 'F5F5F5'],
}
Map.addLayer(dem, vis_params, "DEM Vis")

# Set visualization parameters. vis_params = { 'min': 0, 'max': 4000, 'palette': ['006633', 'E5FFCC', '662A00', 'D8D8D8', 'F5F5F5'], } Map.addLayer(dem, vis_params, "DEM Vis")

Loading a multi-band image¶

In [6]:

Map = geemap.Map()
# Load an image.
image = ee.Image('LANDSAT/LC08/C01/T1_SR/LC08_044034_20140318')

# Center the map and display the image.
Map.centerObject(image, zoom=8)
Map.addLayer(image, {}, 'Landsat')

Map

Map = geemap.Map() # Load an image. image = ee.Image('LANDSAT/LC08/C01/T1_SR/LC08_044034_20140318') # Center the map and display the image. Map.centerObject(image, zoom=8) Map.addLayer(image, {}, 'Landsat') Map

Out[6]:

Make this Notebook Trusted to load map: File -> Trust Notebook

In [7]:

vis_params = {
    'bands': ['B5', 'B4', 'B3'],
    'min': 0.0,
    'max': 3000,
    'opacity': 1.0,
    'gamma': 1.2,
}
Map.addLayer(image, vis_params, "Landsat Vis")

vis_params = { 'bands': ['B5', 'B4', 'B3'], 'min': 0.0, 'max': 3000, 'opacity': 1.0, 'gamma': 1.2, } Map.addLayer(image, vis_params, "Landsat Vis")

Getting image properties¶

In [8]:

image = ee.Image('LANDSAT/LC08/C01/T1_SR/LC08_044034_20140318')
props = geemap.image_props(image)

image = ee.Image('LANDSAT/LC08/C01/T1_SR/LC08_044034_20140318') props = geemap.image_props(image)

In [9]:

props.getInfo()

props.getInfo()

Out[9]:

{'CLOUD_COVER': 0.06,
 'CLOUD_COVER_LAND': 0.1,
 'EARTH_SUN_DISTANCE': 0.995371,
 'ESPA_VERSION': '2_23_0_1a',
 'GEOMETRIC_RMSE_MODEL': 6.78,
 'GEOMETRIC_RMSE_MODEL_X': 4.841,
 'GEOMETRIC_RMSE_MODEL_Y': 4.747,
 'IMAGE_DATE': '2014-03-18',
 'IMAGE_QUALITY_OLI': 9,
 'IMAGE_QUALITY_TIRS': 9,
 'LANDSAT_ID': 'LC08_L1TP_044034_20140318_20170307_01_T1',
 'LEVEL1_PRODUCTION_DATE': 1488849349000,
 'NOMINAL_SCALE': 30,
 'PIXEL_QA_VERSION': 'generate_pixel_qa_1.6.0',
 'SATELLITE': 'LANDSAT_8',
 'SENSING_TIME': '2014-03-18T18:46:32.0535800Z',
 'SOLAR_AZIMUTH_ANGLE': 146.239578,
 'SOLAR_ZENITH_ANGLE': 43.528934,
 'SR_APP_VERSION': 'LaSRC_1.3.0',
 'WRS_PATH': 44,
 'WRS_ROW': 34,
 'system:asset_size': '540.072009 MB',
 'system:band_names': ['B1',
  'B2',
  'B3',
  'B4',
  'B5',
  'B6',
  'B7',
  'B10',
  'B11',
  'sr_aerosol',
  'pixel_qa',
  'radsat_qa'],
 'system:id': 'LANDSAT/LC08/C01/T1_SR/LC08_044034_20140318',
 'system:index': 'LC08_044034_20140318',
 'system:time_end': '2014-03-18 18:46:32',
 'system:time_start': '2014-03-18 18:46:32',
 'system:version': 1522720282729760.0}

Selecting image bands¶

In [10]:

image = ee.Image('LANDSAT/LC08/C01/T1_SR/LC08_044034_20140318')
bands = image.select(['B5', 'B4', 'B3'])

image = ee.Image('LANDSAT/LC08/C01/T1_SR/LC08_044034_20140318') bands = image.select(['B5', 'B4', 'B3'])

In [11]:

Map.addLayer(bands, vis_params, 'Landsat B543')
Map

Map.addLayer(bands, vis_params, 'Landsat B543') Map

Out[11]:

Make this Notebook Trusted to load map: File -> Trust Notebook

Renaming band names¶

In [12]:

image = ee.Image('LANDSAT/LC08/C01/T1_SR/LC08_044034_20140318')
new_image = image.select(['B5', 'B4', 'B3'], ['NIR', 'Red', 'Green'])
band_names = new_image.bandNames()

image = ee.Image('LANDSAT/LC08/C01/T1_SR/LC08_044034_20140318') new_image = image.select(['B5', 'B4', 'B3'], ['NIR', 'Red', 'Green']) band_names = new_image.bandNames()

In [13]:

band_names.getInfo()

band_names.getInfo()

Out[13]:

['NIR', 'Red', 'Green']

Adding a legend¶

In [14]:

Map = geemap.Map()
Map.add_basemap('HYBRID')
Map

Map = geemap.Map() Map.add_basemap('HYBRID') Map

Out[14]:

Make this Notebook Trusted to load map: File -> Trust Notebook

In [15]:

landcover = ee.Image('USGS/NLCD/NLCD2016').select('landcover')
Map.addLayer(landcover, {}, 'Land Cover')
Map.add_legend(builtin_legend='NLCD', layer_name='Land Cover')

landcover = ee.Image('USGS/NLCD/NLCD2016').select('landcover') Map.addLayer(landcover, {}, 'Land Cover') Map.add_legend(builtin_legend='NLCD', layer_name='Land Cover')

---

Last update: 2022-03-25