Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.Array.first
Stay organized with collections
Save and categorize content based on your preferences.
On an element-wise basis, selects the value of the first value.
| Usage | Returns | Array.first(right) | Array |
| Argument | Type | Details | this: left | Array | The left-hand value. |
right | Array | The right-hand value. |
Examples
Code Editor (JavaScript)
var empty = ee.Array([], ee.PixelType.int8());
print(empty.first(empty)); // []
print(ee.Array([0]).first(0)); // [0]
print(ee.Array([0, 1, 2]).first(1)); // [0,1,2]
print(ee.Array([0, 1, 2]).first(ee.Array([3, 4, 5]))); // [0,1,2]
print(ee.Array([3, 4, 5]).first(ee.Array([0, 1, 2]))); // [3,4,5]
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)
empty = ee.Array([], ee.PixelType.int8())
display(empty.first(empty)) # []
display(ee.Array([0]).first(0)) # [0]
display(ee.Array([0, 1, 2]).first(1)) # [0,1,2]
display(ee.Array([0, 1, 2]).first(ee.Array([3, 4, 5]))) # [0, 1, 2]
display(ee.Array([3, 4, 5]).first(ee.Array([0, 1, 2]))) # [3, 4, 5]
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 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[[["\u003cp\u003e\u003ccode\u003eArray.first()\u003c/code\u003e is an Earth Engine function that selects the values of the first array provided, regardless of the second array provided.\u003c/p\u003e\n"],["\u003cp\u003eThe function operates element-wise on the input array(s).\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eright\u003c/code\u003e argument, representing the second array, does not influence the output of the function.\u003c/p\u003e\n"],["\u003cp\u003eThe return value will always be the first array (\u003ccode\u003eleft\u003c/code\u003e).\u003c/p\u003e\n"]]],["The `first()` method selects values element-wise, prioritizing the left-hand array (`this: left`). If the left-hand array is empty, it returns an empty array. When used with a scalar value, it treats the value as an array of one element. The right-hand array, provided as an argument, is only used when there is no element in the left-hand array at a specific index. It returns an array object. The code snippets illustrate this in JavaScript and Python.\n"],null,["# ee.Array.first\n\nOn an element-wise basis, selects the value of the first value.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|----------------------|---------|\n| Array.first`(right)` | Array |\n\n| Argument | Type | Details |\n|--------------|-------|-----------------------|\n| this: `left` | Array | The left-hand value. |\n| `right` | Array | The right-hand value. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\nvar empty = ee.Array([], ee.PixelType.int8());\nprint(empty.first(empty)); // []\n\nprint(ee.Array([0]).first(0)); // [0]\nprint(ee.Array([0, 1, 2]).first(1)); // [0,1,2]\nprint(ee.Array([0, 1, 2]).first(ee.Array([3, 4, 5]))); // [0,1,2]\nprint(ee.Array([3, 4, 5]).first(ee.Array([0, 1, 2]))); // [3,4,5]\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\nempty = ee.Array([], ee.PixelType.int8())\ndisplay(empty.first(empty)) # []\n\ndisplay(ee.Array([0]).first(0)) # [0]\ndisplay(ee.Array([0, 1, 2]).first(1)) # [0,1,2]\ndisplay(ee.Array([0, 1, 2]).first(ee.Array([3, 4, 5]))) # [0, 1, 2]\ndisplay(ee.Array([3, 4, 5]).first(ee.Array([0, 1, 2]))) # [3, 4, 5]\n```"]]