公告:所有在
2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件,才能继续使用 Earth Engine。
ee.Image.toArray
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
将每个波段的像素串联成每个像素的单个数组。如果任何输入波段被遮盖,结果也会被遮盖。
用法 | 返回 |
---|
Image.toArray(axis) | 图片 |
参数 | 类型 | 详细信息 |
---|
此:image | 图片 | 要转换为每个像素一个数组的波段的图片。波段必须具有标量像素或维度相等的数组像素。 |
axis | 整数,默认值:0 | 要沿其进行串联的轴;必须至少为 0,且不得超过输入的维度。如果轴等于输入的维度,则结果的维度将比输入多 1。 |
示例
代码编辑器 (JavaScript)
// A function to print arrays 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');
}
// A 3-band image of constants.
var img = ee.Image([0, 1, 2]);
print('3-band image', img);
// Convert the 3-band image to an array image. The resulting array image has a
// single band named "array". The "array" band stores the per-pixel band values
// from the input ee.Image as a 1D array.
var arrayImg1D = img.toArray();
print('1D array image', arrayImg1D);
// Sample a single pixel to see its 1D array using the `sampArrImg` function
// defined above. Similar arrays are present for all pixels in a given array
// image; looking at just one helps conceptualize the structure.
print('1D array image (pixel)', sampArrImg(arrayImg1D));
// [0, 1, 2]
// Array images can be displayed to the Code Editor map and queried with the
// inspector tool. Per-pixel, the first element in the array is shown.
// Single-band grayscale is used to represent the data. Style parameters `min`
// and `max` are valid. Styling the layer with the Code Editor's layer
// visualization tool is invalid.
Map.addLayer(arrayImg1D, {min: 0, max: 2}, 'Image array');
// Create a 2D array image by concatenating the values in a 1D array image
// along the 1-axis using `toArray(1)`. For a 3D array, apply `toArray(2)` to
// the result.
var arrayImg2D = arrayImg1D.toArray(1);
print('2D array image (pixel)', sampArrImg(arrayImg2D));
// [[0],
// [1],
// [2]]
Python 设置
如需了解 Python API 和如何使用 geemap
进行交互式开发,请参阅
Python 环境页面。
import ee
import geemap.core as geemap
Colab (Python)
# A function to print arrays 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')
# A 3-band image of constants.
img = ee.Image([0, 1, 2])
display('3-band image', img)
# Convert the 3-band image to an array image. The resulting array image has a
# single band named "array". The "array" band stores the per-pixel band values
# from the input ee.Image as a 1D array.
array_img_1_d = img.toArray()
display('1D array image', array_img_1_d)
# Sample a single pixel to see its 1D array using the `samp_arr_img` function
# defined above. Similar arrays are present for all pixels in a given array
# image looking at just one helps conceptualize the structure.
display('1D array image (pixel)', samp_arr_img(array_img_1_d))
# [0, 1, 2]
# Array images can be displayed to the Code Editor map and queried with the
# inspector tool. Per-pixel, the first element in the array is shown.
# Single-band grayscale is used to represent the data. Style parameters `min`
# and `max` are valid. Styling the layer with the Code Editor's layer
# visualization tool is invalid.
m = geemap.Map()
m.add_layer(array_img_1_d, {'min': 0, 'max': 2}, 'Image array')
display(m)
# Create a 2D array image by concatenating the values in a 1D array image
# along the 1-axis using `toArray(1)`. For a 3D array, apply `toArray(2)` to
# the result.
array_img_2_d = array_img_1_d.toArray(1)
display('2D array image (pixel)', samp_arr_img(array_img_2_d))
# [[0],
# [1],
# [2]]
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\u003cp\u003e\u003ccode\u003eImage.toArray()\u003c/code\u003e converts an image's band values into an array for each pixel, creating an "array image".\u003c/p\u003e\n"],["\u003cp\u003eThe optional \u003ccode\u003eaxis\u003c/code\u003e argument controls the dimension along which the bands are concatenated in the array image.\u003c/p\u003e\n"],["\u003cp\u003eArray images can be displayed and inspected, with the first element of the array represented visually.\u003c/p\u003e\n"],["\u003cp\u003eThis function enables analysis and manipulation of multi-band images by treating pixel values as arrays.\u003c/p\u003e\n"]]],["The `toArray()` method concatenates pixel values from an image's bands into a single array per pixel. It takes an optional `axis` argument to specify the concatenation direction; the default is 0. The method converts the multi-band image to an array image, resulting in a single \"array\" band. If any input band has masked pixels, the resulting array will also be masked. You can use `toArray(1)` to create 2D array image or `toArray(2)` to create 3D array.\n"],null,["# ee.Image.toArray\n\nConcatenates pixels from each band into a single array per pixel. The result will be masked if any input bands are masked.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|---------------------------|---------|\n| Image.toArray`(`*axis*`)` | Image |\n\n| Argument | Type | Details |\n|---------------|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `image` | Image | Image of bands to convert to an array per pixel. Bands must have scalar pixels, or array pixels with equal dimensionality. |\n| `axis` | Integer, default: 0 | Axis to concatenate along; must be at least 0 and at most the dimension of the inputs. If the axis equals the dimension of the inputs, the result will have 1 more dimension than the inputs. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// A function to print arrays 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// A 3-band image of constants.\nvar img = ee.Image([0, 1, 2]);\nprint('3-band image', img);\n\n// Convert the 3-band image to an array image. The resulting array image has a\n// single band named \"array\". The \"array\" band stores the per-pixel band values\n// from the input ee.Image as a 1D array.\nvar arrayImg1D = img.toArray();\nprint('1D array image', arrayImg1D);\n\n// Sample a single pixel to see its 1D array using the `sampArrImg` function\n// defined above. Similar arrays are present for all pixels in a given array\n// image; looking at just one helps conceptualize the structure.\nprint('1D array image (pixel)', sampArrImg(arrayImg1D));\n// [0, 1, 2]\n\n// Array images can be displayed to the Code Editor map and queried with the\n// inspector tool. Per-pixel, the first element in the array is shown.\n// Single-band grayscale is used to represent the data. Style parameters `min`\n// and `max` are valid. Styling the layer with the Code Editor's layer\n// visualization tool is invalid.\nMap.addLayer(arrayImg1D, {min: 0, max: 2}, 'Image array');\n\n// Create a 2D array image by concatenating the values in a 1D array image\n// along the 1-axis using `toArray(1)`. For a 3D array, apply `toArray(2)` to\n// the result.\nvar arrayImg2D = arrayImg1D.toArray(1);\nprint('2D array image (pixel)', sampArrImg(arrayImg2D));\n// [[0],\n// [1],\n// [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 arrays 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\n# A 3-band image of constants.\nimg = ee.Image([0, 1, 2])\ndisplay('3-band image', img)\n\n# Convert the 3-band image to an array image. The resulting array image has a\n# single band named \"array\". The \"array\" band stores the per-pixel band values\n# from the input ee.Image as a 1D array.\narray_img_1_d = img.toArray()\ndisplay('1D array image', array_img_1_d)\n\n# Sample a single pixel to see its 1D array using the `samp_arr_img` function\n# defined above. Similar arrays are present for all pixels in a given array\n# image looking at just one helps conceptualize the structure.\ndisplay('1D array image (pixel)', samp_arr_img(array_img_1_d))\n# [0, 1, 2]\n\n# Array images can be displayed to the Code Editor map and queried with the\n# inspector tool. Per-pixel, the first element in the array is shown.\n# Single-band grayscale is used to represent the data. Style parameters `min`\n# and `max` are valid. Styling the layer with the Code Editor's layer\n# visualization tool is invalid.\nm = geemap.Map()\nm.add_layer(array_img_1_d, {'min': 0, 'max': 2}, 'Image array')\ndisplay(m)\n\n# Create a 2D array image by concatenating the values in a 1D array image\n# along the 1-axis using `toArray(1)`. For a 3D array, apply `toArray(2)` to\n# the result.\narray_img_2_d = array_img_1_d.toArray(1)\ndisplay('2D array image (pixel)', samp_arr_img(array_img_2_d))\n# [[0],\n# [1],\n# [2]]\n```"]]