公告：所有在
2025 年 4 月 15 日之前注册使用 Earth Engine 的非商业项目都必须
验证是否符合非商业性质的资格条件，才能继续使用 Earth Engine。
ee.Array.mask
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
通过切分输入数组中与给定掩码数组的非零元素平行的每个位置，创建一个子数组。
| 参数 | 类型 | 详细信息 |
|---|
此：input | 数组 | 要遮盖的数组。 |
mask | 数组 | 遮罩数组。 |
示例
代码编辑器 (JavaScript)
print(ee.Array([1]).mask([0])); // []
print(ee.Array([1]).mask([1])); // [1]
print(ee.Array([0, 1, 2, 3]).mask([0, 4, -1, 1.2])); // [1,2,3]
print(ee.Array([[1, 2, 3, 4]]).mask([[0, 0, 0, 0]])); // [[]]
print(ee.Array([[1, 2, 3, 4]]).mask([[1, 0, 1, 1]])); // [[1,3,4]]
var array = ee.Array([[1], [2], [3], [4]]);
print(array.mask([[0], [0], [0], [0]])); // []
print(array.mask([[1], [0], [1], [1]])); // [[1],[3],[4]]
var empty = ee.Array([], ee.PixelType.int8());
print(empty.mask(empty)); // []
Python 设置
如需了解 Python API 和如何使用 geemap 进行交互式开发，请参阅
Python 环境页面。
import ee
import geemap.core as geemap
Colab (Python)
display(ee.Array([1]).mask([0])) # []
display(ee.Array([1]).mask([1])) # [1]
display(ee.Array([0, 1, 2, 3]).mask([0, 4, -1, 1.2])) # [1, 2, 3]
display(ee.Array([[1, 2, 3, 4]]).mask([[0, 0, 0, 0]])) # [[]]
display(ee.Array([[1, 2, 3, 4]]).mask([[1, 0, 1, 1]])) # [[1, 3, 4]]
array = ee.Array([[1], [2], [3], [4]])
display(array.mask([[0], [0], [0], [0]])) # []
display(array.mask([[1], [0], [1], [1]])) # [[1], [3], [4]]
empty = ee.Array([], ee.PixelType.int8())
display(empty.mask(empty)) # []
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-26。
[null,null,["最后更新时间 (UTC)：2025-07-26。"],[[["\u003cp\u003e\u003ccode\u003eArray.mask()\u003c/code\u003e creates a new array by selecting elements from the input array where corresponding elements in the mask array are non-zero.\u003c/p\u003e\n"],["\u003cp\u003eThe input and mask arrays must have the same dimensions.\u003c/p\u003e\n"],["\u003cp\u003eZero values in the mask array effectively "hide" corresponding elements in the input array, resulting in their exclusion from the output.\u003c/p\u003e\n"],["\u003cp\u003eThis function is useful for filtering or selectively extracting data from arrays based on a criteria represented by the mask.\u003c/p\u003e\n"]]],[],null,["# ee.Array.mask\n\nCreates a subarray by slicing out each position in an input array that is parallel to a non-zero element of the given mask array.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|--------------------|---------|\n| Array.mask`(mask)` | Array |\n\n| Argument | Type | Details |\n|---------------|-------|----------------|\n| this: `input` | Array | Array to mask. |\n| `mask` | Array | Mask array. |\n\nExamples\n--------\n\n### Code Editor (JavaScript)\n\n```javascript\nprint(ee.Array([1]).mask([0])); // []\nprint(ee.Array([1]).mask([1])); // [1]\n\nprint(ee.Array([0, 1, 2, 3]).mask([0, 4, -1, 1.2])); // [1,2,3]\n\nprint(ee.Array([[1, 2, 3, 4]]).mask([[0, 0, 0, 0]])); // [[]]\nprint(ee.Array([[1, 2, 3, 4]]).mask([[1, 0, 1, 1]])); // [[1,3,4]]\n\nvar array = ee.Array([[1], [2], [3], [4]]);\nprint(array.mask([[0], [0], [0], [0]])); // []\nprint(array.mask([[1], [0], [1], [1]])); // [[1],[3],[4]]\n\nvar empty = ee.Array([], ee.PixelType.int8());\nprint(empty.mask(empty)); // []\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\ndisplay(ee.Array([1]).mask([0])) # []\ndisplay(ee.Array([1]).mask([1])) # [1]\n\ndisplay(ee.Array([0, 1, 2, 3]).mask([0, 4, -1, 1.2])) # [1, 2, 3]\n\ndisplay(ee.Array([[1, 2, 3, 4]]).mask([[0, 0, 0, 0]])) # [[]]\ndisplay(ee.Array([[1, 2, 3, 4]]).mask([[1, 0, 1, 1]])) # [[1, 3, 4]]\n\narray = ee.Array([[1], [2], [3], [4]])\ndisplay(array.mask([[0], [0], [0], [0]])) # []\ndisplay(array.mask([[1], [0], [1], [1]])) # [[1], [3], [4]]\n\nempty = ee.Array([], ee.PixelType.int8())\ndisplay(empty.mask(empty)) # []\n```"]]
