Anúncio: todos os projetos não comerciais registrados para usar o Earth Engine antes de
15 de abril de 2025 precisam
verificar a qualificação não comercial para manter o acesso ao Earth Engine.
ee.Array.mask
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Cria uma submatriz ao extrair cada posição em uma matriz de entrada paralela a um elemento diferente de zero da matriz de máscara especificada.
Uso | Retorna |
---|
Array.mask(mask) | Matriz |
Argumento | Tipo | Detalhes |
---|
isso: input | Matriz | Matriz a ser mascarada. |
mask | Matriz | Matriz de máscara. |
Exemplos
Editor de código (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)); // []
Configuração do Python
Consulte a página
Ambiente Python para informações sobre a API Python e como usar
geemap
para desenvolvimento interativo.
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)) # []
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[null,null,["Última atualização 2025-07-26 UTC."],[[["\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```"]]