公告：所有在
2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件，才能继续使用 Earth Engine。
ee.Array.cat
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
沿指定轴将多个数组串联为一个数组。每个数组必须具有相同的维度，并且在除串联轴之外的所有轴上具有相同的长度。
| 用法 | 返回 |
|---|
ee.Array.cat(arrays, axis) | 数组 |
| 参数 | 类型 | 详细信息 |
|---|
arrays | 列表 | 要串联的数组。 |
axis | 整数，默认值：0 | 要沿其串联的轴。 |
示例
代码编辑器 (JavaScript)
// Requires an explicit PixelType if no data.
var empty = ee.Array([], ee.PixelType.int8()); // Empty []
var one = ee.Array([1]);
var two = ee.Array([2]);
print(ee.Array.cat([empty])); // []
print(ee.Array.cat([empty, empty])); // []
print(ee.Array.cat([empty, one])); // [1]
print(ee.Array.cat([one, empty])); // [1]
print(ee.Array.cat([one, two])); // [1, 2]
print(ee.Array.cat([one, two], 0)); // [1, 2]
print(ee.Array.cat([one, two], 1)); // [[1,2]]
var a = ee.Array([0, 1, 2]);
var b = ee.Array([3, 4, 5]);
print(ee.Array.cat([a, b])); // [0,1,2,3,4,5]
print(ee.Array.cat([a, b], 0)); // [0,1,2,3,4,5]
print(ee.Array.cat([a, b], 1)); // [[0,3],[1,4],[2,5]]
var c = ee.Array([[0], [1], [2]]);
var d = ee.Array([[3], [4], [5]]);
print(ee.Array.cat([c, d])); // [[0],[1],[2],[3],[4],[5]]
print(ee.Array.cat([c, d], 0)); // [[0],[1],[2],[3],[4],[5]]
print(ee.Array.cat([c, d], 1)); // [[0,3],[1,4],[2,5]]
print(ee.Array.cat([c, d], 2)); // [[[0,3]],[[1,4]],[[2,5]]]
var e = ee.Array([[[0, 1], [2, 3]], [[4, 5], [6, 7]]]);
var f = ee.Array([[[10, 11], [12, 13]], [[14, 15], [16, 17]]]);
// [[[0,1],[2,3]]
// [[4,5],[6,7]]
// [[10,11],[12,13]]
// [[14,15],[16,17]]
print(ee.Array.cat([e, f], 0));
// [[[0,1],[2,3],[10,11],[12,13]]
// [[4,5],[6,7],[14,15],[16,17]]]
print(ee.Array.cat([e, f], 1));
// [[[0,1,10,11],[2,3,12,13]]
// [[4,5,14,15],[6,7,16,17]]]
print(ee.Array.cat([e, f], 2));
// [[[[0,10],[1,11]],[[2,12],[3,13]]]
// [[[4,14],[5,15]],[[6,16],[7,17]]]]
print(ee.Array.cat([e, f], 3));
Python 设置
如需了解 Python API 和如何使用 geemap 进行交互式开发，请参阅
Python 环境页面。
import ee
import geemap.core as geemap
Colab (Python)
# Requires an explicit PixelType if no data.
empty = ee.Array([], ee.PixelType.int8()) # []
one = ee.Array([1])
two = ee.Array([2])
display(ee.Array.cat([empty])) # []
display(ee.Array.cat([empty, empty])) # []
display(ee.Array.cat([empty, one])) # [1]
display(ee.Array.cat([one, empty])) # [1]
display(ee.Array.cat([one, two])) # [1, 2]
display(ee.Array.cat([one, two], 0)) # [1, 2]
display(ee.Array.cat([one, two], 1)) # [[1, 2]]
a = ee.Array([0, 1, 2])
b = ee.Array([3, 4, 5])
display(ee.Array.cat([a, b])) # [0, 1, 2, 3, 4, 5]
display(ee.Array.cat([a, b], 0)) # [0, 1, 2, 3, 4, 5]
display(ee.Array.cat([a, b], 1)) # [[0, 3], [1, 4], [2, 5]]
c = ee.Array([[0], [1], [2]])
d = ee.Array([[3], [4], [5]])
display(ee.Array.cat([c, d])) # [[0], [1], [2], [3], [4], [5]]
display(ee.Array.cat([c, d], 0)) # [[0], [1], [2], [3], [4], [5]]
display(ee.Array.cat([c, d], 1)) # [[0, 3], [1, 4], [2, 5]]
display(ee.Array.cat([c, d], 2)) # [[[0, 3]], [[1, 4]], [[2, 5]]]
e = ee.Array([[[0, 1], [2, 3]], [[4, 5], [6, 7]]])
f = ee.Array([[[10, 11], [12, 13]], [[14, 15], [16, 17]]])
# [[[0, 1], [2, 3]]
# [[4, 5], [6, 7]]
# [[10, 11], [12, 13]]
# [[14, 15], [16, 17]]
display(ee.Array.cat([e, f], 0))
# [[[0, 1], [2, 3], [10, 11], [12, 13]]
# [[4, 5], [6, 7], [14, 15], [16, 17]]]
display(ee.Array.cat([e, f], 1))
# [[[0, 1, 10, 11], [2, 3, 12, 13]]
# [[4, 5, 14, 15], [6, 7, 16, 17]]]
display(ee.Array.cat([e, f], 2))
# [[[[0, 10], [1, 11]], [[2, 12], [3, 13]]]
# [[[4, 14], [5, 15]], [[6, 16], [7, 17]]]]
display(ee.Array.cat([e, f], 3))
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-26。
[null,null,["最后更新时间 (UTC)：2025-07-26。"],[[["\u003cp\u003e\u003ccode\u003eee.Array.cat()\u003c/code\u003e combines multiple arrays into a single array.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eaxis\u003c/code\u003e parameter specifies the dimension along which the concatenation occurs (defaults to 0).\u003c/p\u003e\n"],["\u003cp\u003eInput arrays must have the same dimensionality and be of the same length in all dimensions except the concatenation axis.\u003c/p\u003e\n"],["\u003cp\u003eThis function is useful for merging or extending array data in Earth Engine.\u003c/p\u003e\n"]]],["`ee.Array.cat(arrays, axis)` concatenates multiple arrays into one. Input arrays must have identical dimensions and lengths across all axes except the concatenation axis. The `arrays` argument is a list of arrays to merge. The `axis` argument, defaulting to 0, specifies the axis for concatenation. Concatenating empty arrays with others results in the non-empty array or an empty array. Examples in Javascript and Python are provided to demonstrate different `axis` argument and the resulting array.\n"],null,["# ee.Array.cat\n\nConcatenates multiple arrays into a single array along the given axis. Each array must have the same dimensionality and the same length on all axes except the concatenation axis.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|----------------------------------|---------|\n| `ee.Array.cat(arrays, `*axis*`)` | Array |\n\n| Argument | Type | Details |\n|----------|---------------------|----------------------------|\n| `arrays` | List | Arrays to concatenate. |\n| `axis` | Integer, default: 0 | Axis to concatenate along. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\n// Requires an explicit PixelType if no data.\nvar empty = ee.Array([], ee.PixelType.int8()); // Empty []\nvar one = ee.Array([1]);\nvar two = ee.Array([2]);\n\nprint(ee.Array.cat([empty])); // []\nprint(ee.Array.cat([empty, empty])); // []\nprint(ee.Array.cat([empty, one])); // [1]\nprint(ee.Array.cat([one, empty])); // [1]\nprint(ee.Array.cat([one, two])); // [1, 2]\n\nprint(ee.Array.cat([one, two], 0)); // [1, 2]\nprint(ee.Array.cat([one, two], 1)); // [[1,2]]\n\nvar a = ee.Array([0, 1, 2]);\nvar b = ee.Array([3, 4, 5]);\nprint(ee.Array.cat([a, b])); // [0,1,2,3,4,5]\nprint(ee.Array.cat([a, b], 0)); // [0,1,2,3,4,5]\nprint(ee.Array.cat([a, b], 1)); // [[0,3],[1,4],[2,5]]\n\nvar c = ee.Array([[0], [1], [2]]);\nvar d = ee.Array([[3], [4], [5]]);\nprint(ee.Array.cat([c, d])); // [[0],[1],[2],[3],[4],[5]]\nprint(ee.Array.cat([c, d], 0)); // [[0],[1],[2],[3],[4],[5]]\nprint(ee.Array.cat([c, d], 1)); // [[0,3],[1,4],[2,5]]\nprint(ee.Array.cat([c, d], 2)); // [[[0,3]],[[1,4]],[[2,5]]]\n\nvar e = ee.Array([[[0, 1], [2, 3]], [[4, 5], [6, 7]]]);\nvar f = ee.Array([[[10, 11], [12, 13]], [[14, 15], [16, 17]]]);\n\n// [[[0,1],[2,3]]\n// [[4,5],[6,7]]\n// [[10,11],[12,13]]\n// [[14,15],[16,17]]\nprint(ee.Array.cat([e, f], 0));\n\n// [[[0,1],[2,3],[10,11],[12,13]]\n// [[4,5],[6,7],[14,15],[16,17]]]\nprint(ee.Array.cat([e, f], 1));\n\n// [[[0,1,10,11],[2,3,12,13]]\n// [[4,5,14,15],[6,7,16,17]]]\nprint(ee.Array.cat([e, f], 2));\n\n// [[[[0,10],[1,11]],[[2,12],[3,13]]]\n// [[[4,14],[5,15]],[[6,16],[7,17]]]]\nprint(ee.Array.cat([e, f], 3));\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# Requires an explicit PixelType if no data.\nempty = ee.Array([], ee.PixelType.int8()) # []\none = ee.Array([1])\ntwo = ee.Array([2])\n\ndisplay(ee.Array.cat([empty])) # []\ndisplay(ee.Array.cat([empty, empty])) # []\ndisplay(ee.Array.cat([empty, one])) # [1]\ndisplay(ee.Array.cat([one, empty])) # [1]\ndisplay(ee.Array.cat([one, two])) # [1, 2]\n\ndisplay(ee.Array.cat([one, two], 0)) # [1, 2]\ndisplay(ee.Array.cat([one, two], 1)) # [[1, 2]]\n\na = ee.Array([0, 1, 2])\nb = ee.Array([3, 4, 5])\ndisplay(ee.Array.cat([a, b])) # [0, 1, 2, 3, 4, 5]\ndisplay(ee.Array.cat([a, b], 0)) # [0, 1, 2, 3, 4, 5]\ndisplay(ee.Array.cat([a, b], 1)) # [[0, 3], [1, 4], [2, 5]]\n\nc = ee.Array([[0], [1], [2]])\nd = ee.Array([[3], [4], [5]])\ndisplay(ee.Array.cat([c, d])) # [[0], [1], [2], [3], [4], [5]]\ndisplay(ee.Array.cat([c, d], 0)) # [[0], [1], [2], [3], [4], [5]]\ndisplay(ee.Array.cat([c, d], 1)) # [[0, 3], [1, 4], [2, 5]]\ndisplay(ee.Array.cat([c, d], 2)) # [[[0, 3]], [[1, 4]], [[2, 5]]]\n\ne = ee.Array([[[0, 1], [2, 3]], [[4, 5], [6, 7]]])\nf = ee.Array([[[10, 11], [12, 13]], [[14, 15], [16, 17]]])\n\n# [[[0, 1], [2, 3]]\n# [[4, 5], [6, 7]]\n# [[10, 11], [12, 13]]\n# [[14, 15], [16, 17]]\ndisplay(ee.Array.cat([e, f], 0))\n\n# [[[0, 1], [2, 3], [10, 11], [12, 13]]\n# [[4, 5], [6, 7], [14, 15], [16, 17]]]\ndisplay(ee.Array.cat([e, f], 1))\n\n# [[[0, 1, 10, 11], [2, 3, 12, 13]]\n# [[4, 5, 14, 15], [6, 7, 16, 17]]]\ndisplay(ee.Array.cat([e, f], 2))\n\n# [[[[0, 10], [1, 11]], [[2, 12], [3, 13]]]\n# [[[4, 14], [5, 15]], [[6, 16], [7, 17]]]]\ndisplay(ee.Array.cat([e, f], 3))\n```"]]
