ee.ImageCollection.toArrayPerBand

הפונקציה משלבת כמה תמונות למערך תמונות אחד.

שימוש	החזרות
ImageCollection.toArrayPerBand(axis, dropMasked)	תמונה

ארגומנט	סוג	פרטים
זה: collection	ImageCollection	תמונות לשרשור. מתבצעת שרשור נפרד לכל פס, ולכן לכל התמונות צריכים להיות אותם ממדים וצורה לכל פס, למעט האורך לאורך ציר השרשור.
axis	מספר שלם, ברירת מחדל: 0	הציר לאורך השרשור. הערך חייב להיות לפחות 0, ולכל היותר המימד המינימלי של כל פס באוסף.
dropMasked	בוליאני, ברירת מחדל: false	אם הערך הוא false (ברירת המחדל), ערך המסכה של פיקסל הפלט הוא המינימום של המסכות של פיקסלי הקלט. אם תמונה כלשהי באוסף שבתיבת התוחמת של החישוב מוסתרת לחלוטין בפיקסל, הפיקסל הזה בפלט יוסתר. כתוצאה מכך, לכל מערך פיקסלים של פלט לא מוסתר יהיה גודל זהה. אם הערך הוא True, ערך המסכה של פיקסל הפלט הוא המקסימום של המסכה של הקלט. תמונות עם מסכה מלאה בפיקסל הזה מוזנחות ולא תורמות נתונים למערך הפלט. לכן, לא בהכרח יהיה לכל פיקסל אותו גודל במערכי הפלט.

דוגמאות

Code Editor (JavaScript)

// A function to extract and print the array of a selected pixel.
function sampleArrayImage(arrImg) {
  var point = ee.Geometry.Point([0, 0]);
  return arrImg.sample(point, 1).first().get('b1');
}

// Define three single-band constant images with unified data types.
var img0 = ee.Image(0).byte().rename('b1');
var img1 = ee.Image(1).byte().rename('b1');
var img2 = ee.Image(2).byte().rename('b1');

// 1. Basic usage: concatenate fully valid images along axis 0.
var colSimple = ee.ImageCollection([img0, img1, img2]);

var arrayBasic = colSimple.toArrayPerBand();
print('Basic toArrayPerBand (pixel array):', sampleArrayImage(arrayBasic));
// Result: [0, 1, 2]

// 2. Masking behavior: introduce an image with a masked pixel.
// Update mask so img1 has no valid data at the sampled pixel.
var img1Masked = img1.updateMask(0);
var colMasked = ee.ImageCollection([img0, img1Masked, img2]);

// By default (dropMasked = false), if any input image is masked at a pixel,
// the output array is masked at that pixel. Since sampling a masked pixel
// returns no features, we inspect the output image's mask directly.
var arrayDefault = colMasked.toArrayPerBand();
print('Default masking behavior (pixel mask is 0):',
      sampleArrayImage(arrayDefault.mask()));
// Result: 0

// With dropMasked = true, if any input image is masked at a specific pixel,
// its value is omitted from the output array at that pixel. As a result,
// array lengths can vary across different pixels.
var arrayDropped = colMasked.toArrayPerBand(0, true);
print('dropMasked=true (pixel array omits image-specific masked pixels):',
      sampleArrayImage(arrayDropped));
// Result: [0, 2]

הגדרה של Python

בדף סביבת Python מפורט מידע על Python API ועל השימוש ב-geemap לפיתוח אינטראקטיבי.

import ee
import geemap.core as geemap

Colab (Python)

# A function to extract and print the array of a selected pixel.
def sample_array_image(arr_img):
  point = ee.Geometry.Point([0, 0])
  return arr_img.sample(point, 1).first().get('b1')


# Define three single-band constant images with unified data types.
img0 = ee.Image(0).byte().rename('b1')
img1 = ee.Image(1).byte().rename('b1')
img2 = ee.Image(2).byte().rename('b1')

# 1. Basic usage: concatenate fully valid images along axis 0.
col_simple = ee.ImageCollection([img0, img1, img2])

array_basic = col_simple.toArrayPerBand()
display('Basic toArrayPerBand (pixel array):', sample_array_image(array_basic))
# Result: [0, 1, 2]

# 2. Masking behavior: introduce an image with a masked pixel.
# Update mask so img1 has no valid data at the sampled pixel.
img1_masked = img1.updateMask(0)
col_masked = ee.ImageCollection([img0, img1_masked, img2])

# By default (dropMasked = False), if any input image is masked at a pixel,
# the output array is masked at that pixel. Since sampling a masked pixel
# returns no features, we inspect the output image's mask directly.
array_default = col_masked.toArrayPerBand()
display(
    'Default masking behavior (pixel mask is 0):',
    sample_array_image(array_default.mask()),
)
# Result: 0

# With dropMasked = true, if any input image is masked at a specific pixel,
# its value is omitted from the output array at that pixel. As a result,
# array lengths can vary across different pixels.
array_dropped = col_masked.toArrayPerBand(0, True)
display(
    'dropMasked=True (pixel array omits image-specific masked pixels):',
    sample_array_image(array_dropped),
)
# Result: [0, 2]