ee.Dictionary.toImage

  • The Dictionary.toImage() function transforms a dictionary of values into an image where each key represents a band.

  • Band order in the output image can be customized using the optional names argument, otherwise, keys are sorted alphanumerically.

  • This function is useful for visualizing dictionary data, such as results from ee.Image.reduceRegion.

  • Usage involves calling toImage() on a dictionary object, optionally providing a list of band names for desired ordering.

 Creates an image of constants from values in a dictionary. The bands of the image are ordered and named according to the names argument. If no names are specified, the bands are sorted alpha-numerically.

UsageReturns
Dictionary.toImage(names)Image
ArgumentTypeDetails
this: dictionaryDictionaryThe dictionary to convert.
namesList, default: nullThe order of the output bands.

Examples

Code Editor (JavaScript)

// A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image).
var dict = ee.Dictionary({
  B1: 182,
  B2: 219,
  B3: 443
});

var selectedKeysImg = dict.toImage(['B1', 'B2']);
print('Selected keys image band names', selectedKeysImg.bandNames());

var allKeysImg = dict.toImage();
print('All keys image band names', allKeysImg.bandNames());

Python setup

See the Python Environment page for information on the Python API and using geemap for interactive development.

import ee
import geemap.core as geemap

Colab (Python)

# A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image).
dic = ee.Dictionary({
    'B1': 182,
    'B2': 219,
    'B3': 443
})

selected_keys_img = dic.toImage(['B1', 'B2'])
print('Selected keys image band names:',
      selected_keys_img.bandNames().getInfo())

all_keys_img = dic.toImage()
print('All keys image band names:', all_keys_img.bandNames().getInfo())