إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ee.Array.mask
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تنشئ هذه الدالة مصفوفة فرعية عن طريق تقسيم كل موضع في مصفوفة إدخال موازٍ لعنصر غير صفري في مصفوفة القناع المحدّدة.
الاستخدام | المرتجعات |
---|
Array.mask(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 للحصول على معلومات حول واجهة برمجة التطبيقات Python واستخدام
geemap
للتطوير التفاعلي.
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)) # []
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 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```"]]