公告:凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案,都必須
驗證非商業用途資格,才能繼續存取 Earth Engine。
ee.Image.arrayArgmax
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
計算陣列值圖片中最大值的位置索引。如果最大值出現多次,索引會反映第一個最大值。
用量 | 傳回 |
---|
Image.arrayArgmax() | 圖片 |
範例
程式碼編輯器 (JavaScript)
// A function to print the array for a selected pixel in the following examples.
function sampArrImg(arrImg) {
var point = ee.Geometry.Point([-121, 42]);
return arrImg.sample(point, 500).first().get('array');
}
// Create a 1D array image.
var arrayImg1D = ee.Image([0, 1, 5, 2, 3, 4]).toArray();
print('1D array image (pixel)', sampArrImg(arrayImg1D));
// [0, 1, 5, 2, 3, 4]
// Get the position of the maximum value in a 1D array.
var maxValue1D = arrayImg1D.arrayArgmax();
print('Position of the maximum 1D array value', sampArrImg(maxValue1D));
// [2]
// Create a 2D 2x3 array image (reshape the 1D array image).
var arrayImg2D = arrayImg1D.arrayReshape(ee.Image([2, 3]).toArray(), 2);
print('2D 2x3 array image (pixel)', sampArrImg(arrayImg2D));
// [[0, 1, 5],
// [2, 3, 4]]
// Get the position of the maximum value in a 2D array.
var maxValue2D = arrayImg2D.arrayArgmax();
print('Position of the maximum 2D array value', sampArrImg(maxValue2D));
// [0, 2]
Python 設定
請參閱
Python 環境頁面,瞭解 Python API 和如何使用 geemap
進行互動式開發。
import ee
import geemap.core as geemap
Colab (Python)
# A function to print the array for a selected pixel in the following examples.
def samp_arr_img(arr_img):
point = ee.Geometry.Point([-121, 42])
return arr_img.sample(point, 500).first().get('array')
# Create a 1D array image.
array_img_1d = ee.Image([0, 1, 5, 2, 3, 4]).toArray()
print('1D array image (pixel):', samp_arr_img(array_img_1d).getInfo())
# [0, 1, 5, 2, 3, 4]
# Get the position of the maximum value in a 1D array.
max_value_1d = array_img_1d.arrayArgmax()
print(
'Position of the maximum 1D array value:',
samp_arr_img(max_value_1d).getInfo()
)
# [2]
# Create a 2D 2x3 array image (reshape the 1D array image).
array_img_2d = array_img_1d.arrayReshape(ee.Image([2, 3]).toArray(), 2)
print('2D 2x3 array image (pixel):', samp_arr_img(array_img_2d).getInfo())
# [[0, 1, 5],
# [2, 3, 4]]
# Get the position of the maximum value in a 2D array.
max_value_2d = array_img_2d.arrayArgmax()
print(
'Position of the maximum 2D array value:',
samp_arr_img(max_value_2d).getInfo()
)
# [0, 2]
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\u003cp\u003e\u003ccode\u003eImage.arrayArgmax()\u003c/code\u003e identifies the positional index of the maximum value within an image's array of values.\u003c/p\u003e\n"],["\u003cp\u003eIn cases where the maximum value appears multiple times, the function returns the index of the first occurrence.\u003c/p\u003e\n"],["\u003cp\u003eThe function works with both 1D and multidimensional arrays, providing the index or indices corresponding to the maximum value's location.\u003c/p\u003e\n"],["\u003cp\u003eThis method returns a new Image where each pixel represents the index or indices of the maximum value in the input image's corresponding pixel array.\u003c/p\u003e\n"]]],[],null,["# ee.Image.arrayArgmax\n\nComputes the positional indices of the maximum value in image of array values. If there are multiple occurrences of the maximum, the indices reflect the first.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------|---------|\n| Image.arrayArgmax`()` | Image |\n\n| Argument | Type | Details |\n|---------------|-------|------------------|\n| this: `image` | Image | The input image. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A function to print the array for a selected pixel in the following examples.\nfunction sampArrImg(arrImg) {\n var point = ee.Geometry.Point([-121, 42]);\n return arrImg.sample(point, 500).first().get('array');\n}\n\n// Create a 1D array image.\nvar arrayImg1D = ee.Image([0, 1, 5, 2, 3, 4]).toArray();\nprint('1D array image (pixel)', sampArrImg(arrayImg1D));\n// [0, 1, 5, 2, 3, 4]\n\n// Get the position of the maximum value in a 1D array.\nvar maxValue1D = arrayImg1D.arrayArgmax();\nprint('Position of the maximum 1D array value', sampArrImg(maxValue1D));\n// [2]\n\n// Create a 2D 2x3 array image (reshape the 1D array image).\nvar arrayImg2D = arrayImg1D.arrayReshape(ee.Image([2, 3]).toArray(), 2);\nprint('2D 2x3 array image (pixel)', sampArrImg(arrayImg2D));\n// [[0, 1, 5],\n// [2, 3, 4]]\n\n// Get the position of the maximum value in a 2D array.\nvar maxValue2D = arrayImg2D.arrayArgmax();\nprint('Position of the maximum 2D array value', sampArrImg(maxValue2D));\n// [0, 2]\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\n# A function to print the array for a selected pixel in the following examples.\ndef samp_arr_img(arr_img):\n point = ee.Geometry.Point([-121, 42])\n return arr_img.sample(point, 500).first().get('array')\n\n# Create a 1D array image.\narray_img_1d = ee.Image([0, 1, 5, 2, 3, 4]).toArray()\nprint('1D array image (pixel):', samp_arr_img(array_img_1d).getInfo())\n# [0, 1, 5, 2, 3, 4]\n\n# Get the position of the maximum value in a 1D array.\nmax_value_1d = array_img_1d.arrayArgmax()\nprint(\n 'Position of the maximum 1D array value:',\n samp_arr_img(max_value_1d).getInfo()\n )\n# [2]\n\n# Create a 2D 2x3 array image (reshape the 1D array image).\narray_img_2d = array_img_1d.arrayReshape(ee.Image([2, 3]).toArray(), 2)\nprint('2D 2x3 array image (pixel):', samp_arr_img(array_img_2d).getInfo())\n# [[0, 1, 5],\n# [2, 3, 4]]\n\n# Get the position of the maximum value in a 2D array.\nmax_value_2d = array_img_2d.arrayArgmax()\nprint(\n 'Position of the maximum 2D array value:',\n samp_arr_img(max_value_2d).getInfo()\n)\n# [0, 2]\n```"]]