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.
Cut an array along one or more axes.
Usage
Returns
Array.cut(position)
Array
Argument
Type
Details
this: array
Array
The array to cut.
position
List
Cut an array along one or more axes. The positions args specifies either a single value for each axis of the array, or -1, indicating the whole axis. The output will be an array that has the same dimensions as the input, with a length of 1 on each axis that was not -1 in the positions array.
[[["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 2024-07-13 UTC."],[[["\u003cp\u003e\u003ccode\u003eArray.cut()\u003c/code\u003e extracts a portion of an array along specified axes.\u003c/p\u003e\n"],["\u003cp\u003eIt takes a \u003ccode\u003eposition\u003c/code\u003e argument, a list indicating cut points on each axis.\u003c/p\u003e\n"],["\u003cp\u003eUsing \u003ccode\u003e-1\u003c/code\u003e in the \u003ccode\u003eposition\u003c/code\u003e list selects the entire axis.\u003c/p\u003e\n"],["\u003cp\u003eThe output is a new array with reduced dimensions based on the cut points.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eArray.cut()\u003c/code\u003e is useful for slicing and dicing multi-dimensional arrays within Earth Engine.\u003c/p\u003e\n"]]],[],null,["Cut an array along one or more axes.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------|---------|\n| Array.cut`(position)` | Array |\n\n| Argument | Type | Details |\n|---------------|-------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `array` | Array | The array to cut. |\n| `position` | List | Cut an array along one or more axes. The positions args specifies either a single value for each axis of the array, or -1, indicating the whole axis. The output will be an array that has the same dimensions as the input, with a length of 1 on each axis that was not -1 in the positions array. |\n\nExamples\n\nCode Editor (JavaScript) \n\n```javascript\nprint(ee.Array([9]).cut([0])); // [9]\nprint(ee.Array([9]).cut([-1])); // [9]\n\nvar array1x3 = ee.Array([0, 1, 2]);\nprint(array1x3.cut([-1])); // [0,1,2]\nprint(array1x3.cut([0])); // [0]\nprint(array1x3.cut([2])); // [2]\n\nvar array2x3 = ee.Array([[0, 1, 2], [3, 4, 5]]);\nprint(array2x3.cut([-1, -1])); // [[0,1,2],[3,4,5]]\nprint(array2x3.cut([-1, 0])); // [[0],[3]]\nprint(array2x3.cut([1, -1])); // [[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\nColab (Python) \n\n```python\ndisplay(ee.Array([9]).cut([0])) # [9]\ndisplay(ee.Array([9]).cut([-1])) # [9]\n\narray1x3 = ee.Array([0, 1, 2])\ndisplay(array1x3.cut([-1])) # [0, 1, 2]\ndisplay(array1x3.cut([0])) # [0]\ndisplay(array1x3.cut([2])) # [2]\n\narray2x3 = ee.Array([[0, 1, 2], [3, 4, 5]])\ndisplay(array2x3.cut([-1, -1])) # [[0, 1, 2], [3 , 4, 5]]\ndisplay(array2x3.cut([-1, 0])) # [[0], [3]]\ndisplay(array2x3.cut([1, -1])) # [[3, 4, 5]]\n```"]]