ee.Array.cut

  • Array.cut() extracts a portion of an array along specified axes.

  • It takes a position argument, a list indicating cut points on each axis.

  • Using -1 in the position list selects the entire axis.

  • The output is a new array with reduced dimensions based on the cut points.

  • Array.cut() is useful for slicing and dicing multi-dimensional arrays within Earth Engine.

 Cut an array along one or more axes.

UsageReturns
Array.cut(position)Array
ArgumentTypeDetails
this: arrayArrayThe array to cut.
positionListCut 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.

Examples

Code Editor (JavaScript)

print(ee.Array([9]).cut([0]));  // [9]
print(ee.Array([9]).cut([-1]));  // [9]

var array1x3 = ee.Array([0, 1, 2]);
print(array1x3.cut([-1]));  // [0,1,2]
print(array1x3.cut([0]));  // [0]
print(array1x3.cut([2]));  // [2]

var array2x3 = ee.Array([[0, 1, 2], [3, 4, 5]]);
print(array2x3.cut([-1, -1]));  // [[0,1,2],[3,4,5]]
print(array2x3.cut([-1, 0]));  // [[0],[3]]
print(array2x3.cut([1, -1]));  // [[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)

display(ee.Array([9]).cut([0]))  # [9]
display(ee.Array([9]).cut([-1]))  # [9]

array1x3 = ee.Array([0, 1, 2])
display(array1x3.cut([-1]))  # [0, 1, 2]
display(array1x3.cut([0]))  # [0]
display(array1x3.cut([2]))  # [2]

array2x3 = ee.Array([[0, 1, 2], [3, 4, 5]])
display(array2x3.cut([-1, -1]))  # [[0, 1, 2], [3 , 4, 5]]
display(array2x3.cut([-1, 0]))  # [[0], [3]]
display(array2x3.cut([1, -1]))  # [[3, 4, 5]]