ee.FeatureCollection.remap

AI-generated Key Takeaways

• Remaps property values in a FeatureCollection using parallel lists for input and output mappings.

• Elements with values not found in the input mapping list (lookupIn) are excluded from the output.

• Accepts FeatureCollections, input and output mapping lists, and the property name for remapping as arguments.

• Useful for classifying features based on specific property values and simplifying data representation.

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