Announcement: All noncommercial projects registered to use Earth Engine before April 15, 2025 must verify noncommercial eligibility to maintain Earth Engine access.
[[["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\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```"]]