ee.Image.loadZarrV2Array

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

أمثلة

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