ee.Array.first
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
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
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."],[[["`Array.first()` is an Earth Engine function that selects the values of the first array provided, regardless of the second array provided."],["The function operates element-wise on the input array(s)."],["The `right` argument, representing the second array, does not influence the output of the function."],["The return value will always be the first array (`left`)."]]],["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"]]