ee.Array.mask
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
با برش دادن هر موقعیت در یک آرایه ورودی که موازی با یک عنصر غیر صفر از آرایه ماسک داده شده است، یک زیرآرایه ایجاد می کند.
| استفاده | برمی گرداند | Array. mask (mask) | آرایه |
| استدلال | تایپ کنید | جزئیات | این: input | آرایه | آرایه به ماسک. |
mask | آرایه | آرایه ماسک. |
نمونه ها
ویرایشگر کد (جاوا اسکریپت)
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)); // []
راه اندازی پایتون
برای اطلاعات در مورد API پایتون و استفاده از geemap برای توسعه تعاملی به صفحه محیط پایتون مراجعه کنید.
import ee
import geemap.core as geemap
کولب (پایتون)
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)) # []
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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```"]]
