ee.ImageCollection.loadZarrV2Array

يتم تحميل مصفوفة Zarr v2 تتضمّن 3 أبعاد أو أكثر (أي بُعد واحد أو أكثر غير مكاني) كـ ImageCollection عن طريق التقسيم على طول محور غير مكاني محدّد. يجب أن تحتوي سمات المصفوفة (‎.zattrs) على الحقل "_ARRAY_DIMENSIONS"، وهو قائمة بأسماء كل سمة (مثلاً، ['time', 'y', 'x']). يجب أن يكون هناك بُعدان على الأقل، ويمثّل البُعدان الأخيران Y وX على التوالي (على سبيل المثال، ['lat', 'lon']). برامج ترميز الضغط المتوافقة هي "blosc" و"gzip" و"lz4" و"zlib" و"zstd". برامج ترميز الضغط الوصفي المتوافقة مع 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` الذي يوفّره الدور "قارئ حزمة التخزين القديمة" من بين أدوار أخرى، يُرجى الاطّلاع على https://cloud.google.com/storage/docs/access-control/iam-roles)، ويجب أن تكون الحزمة متوفّرة في البلدان التي تضمّ مناطق متعددة في الولايات المتحدة أو في منطقة مزدوجة تشمل US-CENTRAL1 أو في منطقة US-CENTRAL1.
projالعرضThe projection of the array.
axisعدد صحيح، القيمة التلقائية: فارغةالمحور غير المكاني (المفهرس من 0) الذي يتم تقسيم الصفيف على طوله لإنشاء ImageCollection. وتمثّل كل صورة في المجموعة شريحة واحدة (بطول 1) على طول هذا المحور. إذا كانت القيمة فارغة، يتم ضبطها تلقائيًا على 0. يجب أن تكون القيمة في النطاق [0, N-1]، حيث N هو عدد الأبعاد غير المكانية (أي إجمالي الأبعاد - 2). يجب أن تحتوي المصفوفة على بُعد واحد على الأقل غير مكاني (أي أن تكون ثلاثية الأبعاد على الأقل).
startsقائمة، القيمة التلقائية: فارغةالفهارس (مشمولة) التي يجب أن يبدأ عندها أخذ الشرائح على طول كل بُعد غير مكاني. إذا كانت القيمة فارغة، ستبدأ الشرائح عند الفهرس 0 لجميع السمات غير المكانية. في حال تحديدها، يجب أن يكون طول هذه القائمة مساويًا لعدد الأبعاد غير المكانية (إجمالي الأبعاد - 2). قد يكون العنصر الفردي ضمن القائمة فارغًا، ويتم ضبطه تلقائيًا على 0 لهذا البُعد. يتم احتساب الفهارس السالبة من نهاية البُعد (على سبيل المثال، -1 هو العنصر الأخير).
endsقائمة، القيمة التلقائية: فارغةالفهارس (غير شاملة) التي يجب عندها التوقف عن أخذ الشرائح على طول كل بُعد غير مكاني. إذا كانت القيمة فارغة، ستمتد الشرائح إلى نهاية كل بُعد غير مكاني مقابل (أي يتم ضبطها تلقائيًا على طول البُعد). في حال تحديدها، يجب أن يكون طول هذه القائمة مساويًا لعدد الأبعاد غير المكانية (إجمالي الأبعاد - 2). قد يكون عنصر فردي ضمن القائمة فارغًا، ويتم ضبطه تلقائيًا على طول هذا البُعد. يتم احتساب الفهارس السالبة من نهاية البُعد (على سبيل المثال، -1 هو العنصر الأخير).

أمثلة

أداة تعديل الرموز (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 للحصول على معلومات حول واجهة برمجة التطبيقات Python API واستخدام 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