Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.Dictionary.toImage
Stay organized with collections
Save and categorize content based on your preferences.
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.
| Usage | Returns | Dictionary.toImage(names) | Image |
| Argument | Type | Details | this: dictionary | Dictionary | The dictionary to convert. |
names | List, default: null | The 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())
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-07-13 UTC.
[null,null,["Last updated 2024-07-13 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eDictionary.toImage()\u003c/code\u003e function transforms a dictionary of values into an image where each key represents a band.\u003c/p\u003e\n"],["\u003cp\u003eBand order in the output image can be customized using the optional \u003ccode\u003enames\u003c/code\u003e argument, otherwise, keys are sorted alphanumerically.\u003c/p\u003e\n"],["\u003cp\u003eThis function is useful for visualizing dictionary data, such as results from \u003ccode\u003eee.Image.reduceRegion\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eUsage involves calling \u003ccode\u003etoImage()\u003c/code\u003e on a dictionary object, optionally providing a list of band names for desired ordering.\u003c/p\u003e\n"]]],[],null,["# ee.Dictionary.toImage\n\nCreates 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.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|---------------------------------|---------|\n| Dictionary.toImage`(`*names*`)` | Image |\n\n| Argument | Type | Details |\n|--------------------|---------------------|--------------------------------|\n| this: `dictionary` | Dictionary | The dictionary to convert. |\n| `names` | List, default: null | The order of the output bands. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image).\nvar dict = ee.Dictionary({\n B1: 182,\n B2: 219,\n B3: 443\n});\n\nvar selectedKeysImg = dict.toImage(['B1', 'B2']);\nprint('Selected keys image band names', selectedKeysImg.bandNames());\n\nvar allKeysImg = dict.toImage();\nprint('All keys image band names', allKeysImg.bandNames());\n```\nPython setup\n\nSee the [Python Environment](/earth-engine/guides/python_install) page for information on the Python API and using\n`geemap` for interactive development. \n\n```python\nimport ee\nimport geemap.core as geemap\n```\n\n### Colab (Python)\n\n```python\n# A dictionary (e.g. results of ee.Image.reduceRegion of an S2 image).\ndic = ee.Dictionary({\n 'B1': 182,\n 'B2': 219,\n 'B3': 443\n})\n\nselected_keys_img = dic.toImage(['B1', 'B2'])\nprint('Selected keys image band names:',\n selected_keys_img.bandNames().getInfo())\n\nall_keys_img = dic.toImage()\nprint('All keys image band names:', all_keys_img.bandNames().getInfo())\n```"]]