ee.ImageCollection.loadZarrV2Array

טעינת מערך Zarr v2 עם 3 מאפיינים או יותר (למשל, ממד אחד או יותר שאינו מרחבי) כ-ImageCollection על ידי חיתוך לאורך ציר שאינו מרחבי שצוין. מאפייני המערך (‎.zattrs) חייבים להכיל את השדה "_ARRAY_DIMENSIONS", שהוא רשימה של השמות של כל מאפיין (למשל, ['time', 'y', 'x']). חייבים להיות לפחות שני מאפיינים, כאשר שני המאפיינים האחרונים מייצגים את Y ו-X בהתאמה (למשל, ['lat', 'lon']). רכיבי ה-codec הנתמכים לדחיסה הם blosc,‏ gzip,‏ lz4,‏ zlib ו-zstd. רכיבי ה-codec הנתמכים לדחיסת מטא-נתונים של blosc הם lz4,‏ lz4hc,‏ zlib ו-zstd (אין תמיכה ב-blosclz).

שימושהחזרות
ee.ImageCollection.loadZarrV2Array(uri, proj, axis, starts, ends)ImageCollection
ארגומנטסוגפרטים
uriמחרוזתה-URI של Cloud Storage של קובץ ה-‎ .zarray שרוצים לטעון. קובץ ‎.zmetadata חייב להיות בספריית האם של ספריית המערך (למשל, עבור 'gs://b/o/.zarray', הקובץ 'gs://b/.zmetadata' חייב להיות נוכח). צריכה להיות גישה למטא-נתונים של הקטגוריה (נדרשת ההרשאה `storage.buckets.get` שניתנת על ידי התפקיד "Storage Legacy Bucket Reader" בין היתר, ראו https://cloud.google.com/storage/docs/access-control/iam-roles) והקטגוריה צריכה להיות ממוקמת באזור מספר אזורים בארה"ב, באזור בשני אזורים שכולל את US-CENTRAL1 או באזור US-CENTRAL1.
projהיטלההקרנה של המערך.
axisמספר שלם, ברירת המחדל: nullהציר הלא מרחבי (עם אינדקס 0) שלאורכו צריך לחתוך את המערך כדי ליצור ImageCollection. כל תמונה באוסף מייצגת פרוסה אחת (באורך 1) לאורך הציר הזה. אם הערך הוא null, ערך ברירת המחדל הוא 0. הערך חייב להיות בטווח [0, N-1], כאשר N הוא מספר הממדים הלא מרחביים (כלומר, סך כל הממדים - 2). המערך חייב לכלול לפחות מימד אחד שאינו מרחבי (כלומר, להיות לפחות תלת-מימדי).
startsרשימה, ברירת מחדל: nullהאינדקסים (כולל) שבהם מתחילים לחתוך לאורך כל מאפיין לא מרחבי. אם הערך הוא null, הפרוסות יתחילו באינדקס 0 לכל המאפיינים הלא מרחביים. אם מציינים את הרשימה הזו, האורך שלה צריך להיות שווה למספר המאפיינים הלא-מרחביים (סה"כ המאפיינים פחות 2). רכיב בודד ברשימה יכול להיות null, ובמקרה כזה ברירת המחדל היא 0 למאפיין הזה. אינדקסים שליליים נספרים מסוף המאפיין (למשל, ‎-1 הוא הרכיב האחרון).
endsרשימה, ברירת מחדל: nullהאינדקסים (לא כולל) שבהם צריך להפסיק את החיתוך לאורך כל מאפיין לא מרחבי. אם הערך הוא null, הפרוסות יורחבו עד לסוף של כל מאפיין לא מרחבי תואם (כלומר, ברירת המחדל היא אורך המאפיין). אם מציינים את הרשימה הזו, האורך שלה צריך להיות שווה למספר המאפיינים הלא-מרחביים (סה"כ המאפיינים פחות 2). רכיב בודד ברשימה יכול להיות null, וגם הוא מוגדר כברירת מחדל לאורך של המאפיין הזה. אינדקסים שליליים נספרים מסוף המאפיין (למשל, ‎-1 הוא הרכיב האחרון).

דוגמאות

Code Editor (JavaScript)

var timeStart = 1000000;
var timeEnd = 1000048;

// Load a 2m temperature Zarr v2 array.
var temperature = ee.ImageCollection.loadZarrV2Array({
  uri: 'gs://gcp-public-data-arco-era5/ar/' +
      'full_37-1h-0p25deg-chunk-1.zarr-v3/2m_temperature/.zarray',
  proj: 'EPSG:4326',
  axis: 0,
  starts: [timeStart],
  ends: [timeEnd]
});

print(temperature);

var visParams = {
  min: 220,
  max: 350,
  palette: [
    'darkblue', 'blue', 'cyan', 'green', 'yellow', 'orange', 'red', 'darkred'
  ]
};
Map.addLayer(temperature, visParams, '2m Temperature');

הגדרה של Python

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

import ee
import geemap.core as geemap

Colab (Python)

time_start = 1000000
time_end = 1000048

# Load a 2m temperature Zarr v2 array.
temperature = ee.ImageCollection.loadZarrV2Array(
    uri=(
        'gs://gcp-public-data-arco-era5/ar/'
        'full_37-1h-0p25deg-chunk-1.zarr-v3/2m_temperature/.zarray'
    ),
    proj='EPSG:4326',
    axis=0,
    starts=[time_start],
    ends=[time_end],
)

display(temperature)

vis_params = {
    'min': 220,
    'max': 350,
    'palette': [
        'darkblue',
        'blue',
        'cyan',
        'green',
        'yellow',
        'orange',
        'red',
        'darkred',
    ],
}
m.add_layer(temperature, vis_params, '2m Temperature')
m