ee.Dictionary.toArray

AI-generated Key Takeaways

• toArray() converts the numeric values of an Earth Engine Dictionary into an Earth Engine Array.

• Users can specify a list of keys to extract specific values or leave it empty to retrieve all values in the dictionary's key order.

• The method defaults to using axis 0 and allows specifying an alternative axis if needed.

Returns numeric values of a dictionary as an array. If no keys are specified, all values are returned in the natural ordering of the dictionary's keys. The default 'axis' is 0.

Usage	Returns
Dictionary.toArray(keys, axis)	Array

Argument	Type	Details
this: dictionary	Dictionary
keys	List, default: null
axis	Integer, default: 0

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
});

print('Values for selected keys converted to ee.Array',
      dict.toArray(['B1', 'B2']));
print('Values for all keys converted to ee.Array',
      dict.toArray());

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
})

print('Values for selected keys converted to ee.Array:',
      dic.toArray(['B1', 'B2']).getInfo())
print('Values for all keys converted to ee.Array:',
      dic.toArray().getInfo())