ee.Image.loadZarrV2Array

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

שימושהחזרות
ee.Image.loadZarrV2Array(uri, proj, starts, ends)תמונה
ארגומנטסוגפרטים
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היטלההקרנה של המערך.
startsרשימה, ברירת מחדל: nullהאינדקסים (כולל) שבהם מתחילים לחתוך לאורך כל מאפיין לא מרחבי. אם הערך הוא null, הפרוסות יתחילו באינדקס 0 לכל המאפיינים הלא מרחביים. אם מציינים את הרשימה הזו, האורך שלה צריך להיות שווה למספר המאפיינים הלא-מרחביים (סה"כ המאפיינים פחות 2). רכיב בודד ברשימה יכול להיות null, ובמקרה כזה ברירת המחדל היא 0 למאפיין הזה. אינדקסים שליליים נספרים מסוף המאפיין (למשל, ‎-1 הוא הרכיב האחרון).
endsרשימה, ברירת מחדל: nullהאינדקסים (לא כולל) שבהם צריך להפסיק את החיתוך לאורך כל מאפיין לא מרחבי. אם הערך הוא null, הפרוסות יורחבו עד לסוף של כל מאפיין לא מרחבי תואם (כלומר, ברירת המחדל היא אורך המאפיין). אם מציינים את הרשימה הזו, האורך שלה חייב להיות שווה למספר הממדים הלא מרחביים (סך כל הממדים פחות 2). רכיב בודד ברשימה יכול להיות null, וגם הוא מוגדר כברירת מחדל לאורך של המאפיין הזה. אינדקסים שליליים נספרים מסוף המאפיין (למשל, ‎-1 הוא הרכיב האחרון).

דוגמאות

Code Editor (JavaScript)

var timeStart = 1000000;
var timeEnd = 1000010;

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

print(temperature);

Map.addLayer(temperature, {min: 220, max: 350}, '2m Temperature');

הגדרה של Python

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

import ee
import geemap.core as geemap

Colab (Python)

time_start = 1000000
time_end = 1000010

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

display(temperature)

m.add_layer(temperature, {'min': 220, 'max': 350}, '2m Temperature')
m