Announcement: All noncommercial projects registered to use Earth Engine before April 15, 2025 must verify noncommercial eligibility to maintain Earth Engine access.
Stay organized with collections
Save and categorize content based on your preferences.
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2023-10-06 UTC."],[[["\u003cp\u003eRemaps property values in a FeatureCollection using parallel lists for input and output mappings.\u003c/p\u003e\n"],["\u003cp\u003eElements with values not found in the input mapping list (\u003ccode\u003elookupIn\u003c/code\u003e) are excluded from the output.\u003c/p\u003e\n"],["\u003cp\u003eAccepts FeatureCollections, input and output mapping lists, and the property name for remapping as arguments.\u003c/p\u003e\n"],["\u003cp\u003eUseful for classifying features based on specific property values and simplifying data representation.\u003c/p\u003e\n"]]],[],null,["# ee.FeatureCollection.remap\n\nRemaps 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.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|------------------------------------------------------------|-------------------|\n| FeatureCollection.remap`(lookupIn, lookupOut, columnName)` | FeatureCollection |\n\n| Argument | Type | Details |\n|--------------------|-------------------|---------------------------------------------------------------|\n| this: `collection` | FeatureCollection | The collection to be modified. |\n| `lookupIn` | List | The input mapping values. Restricted to strings and integers. |\n| `lookupOut` | List | The output mapping values. Must be the same size as lookupIn. |\n| `columnName` | String | The name of the property to remap. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Classify features based on a string property.\n// The 'nonsense' category gets dropped.\nvar fc = ee.FeatureCollection([\n ee.Feature(ee.Geometry.Point([1, 2]), {isTree: 'Tree'}),\n ee.Feature(ee.Geometry.Point([3, 4]), {isTree: 'NotTree'}),\n ee.Feature(ee.Geometry.Point([5, 6]), {isTree: 'nonsense'}),\n]);\n\nvar trees = fc.remap(['NotTree', 'Tree'], [0, 1], 'isTree');\nprint('remapped trees', trees);\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# Classify features based on a string property.\n# The 'nonsense' category gets dropped.\nfc = ee.FeatureCollection([\n ee.Feature(ee.Geometry.Point([1, 2]), {'isTree': 'Tree'}),\n ee.Feature(ee.Geometry.Point([3, 4]), {'isTree': 'NotTree'}),\n ee.Feature(ee.Geometry.Point([5, 6]), {'isTree': 'nonsense'}),\n ])\n\ntrees = fc.remap(['NotTree', 'Tree'], [0, 1], 'isTree')\nprint('Remapped trees:', trees.getInfo())\n```"]]