ee.FeatureCollection.remap

AI-generated Key Takeaways

• The remap function remaps the value of a specific property in a collection using two parallel lists for mapping values.

• Elements with property values not present in the first list are excluded from the output collection.

• It takes the collection, input mapping values, output mapping values, and the property name as arguments.

• The function returns a modified FeatureCollection.

Remaps the value of a specific property in a collection. Takes two parallel lists and maps values found in one to values in the other. Any element with a value that is not specified in the first list is dropped from the output collection.

Usage	Returns
FeatureCollection.remap(lookupIn, lookupOut, columnName)	FeatureCollection

Argument	Type	Details
this: collection	FeatureCollection	The collection to be modified.
lookupIn	List	The input mapping values. Restricted to strings and integers.
lookupOut	List	The output mapping values. Must be the same size as lookupIn.
columnName	String	The name of the property to remap.

Examples

Code Editor (JavaScript)

// Classify features based on a string property.
// The 'nonsense' category gets dropped.
var fc = ee.FeatureCollection([
  ee.Feature(ee.Geometry.Point([1, 2]), {isTree: 'Tree'}),
  ee.Feature(ee.Geometry.Point([3, 4]), {isTree: 'NotTree'}),
  ee.Feature(ee.Geometry.Point([5, 6]), {isTree: 'nonsense'}),
]);

var trees = fc.remap(['NotTree', 'Tree'], [0, 1], 'isTree');
print('remapped trees', trees);

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)

# Classify features based on a string property.
# The 'nonsense' category gets dropped.
fc = ee.FeatureCollection([
    ee.Feature(ee.Geometry.Point([1, 2]), {'isTree': 'Tree'}),
    ee.Feature(ee.Geometry.Point([3, 4]), {'isTree': 'NotTree'}),
    ee.Feature(ee.Geometry.Point([5, 6]), {'isTree': 'nonsense'}),
    ])

trees = fc.remap(['NotTree', 'Tree'], [0, 1], 'isTree')
print('Remapped trees:', trees.getInfo())