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	رشته	‫Cloud Storage URI فایل .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	فهرست، پیش‌فرض: تهی	شاخص‌هایی (شامل) که در آن‌ها برش‌ها در امتداد هر بُعد غیرفضایی شروع می‌شود. اگر تهی باشد، برش‌ها از نمایه ۰ برای همه ابعاد غیرفضایی شروع می‌شود. درصورت مشخص شدن، طول این فهرست باید برابر با تعداد ابعاد غیرفضایی (مجموع ابعاد - ۲) باشد. یک عنصر تکی در فهرست ممکن است تهی باشد که به‌طور پیش‌فرض برای آن بُعد ۰ است. شاخص‌های منفی از انتهای بُعد شمرده می‌شوند (مثلاً، ‎-۱ آخرین عنصر است).
ends	فهرست، پیش‌فرض: تهی	شاخص‌هایی (انحصاری) که در آن‌ها گرفتن برش در امتداد هر بُعد غیرفضایی متوقف می‌شود. اگر تهی باشد، برش‌ها تا انتهای هر بُعد غیرفضایی مربوطه گسترش می‌یابند (یعنی به‌طور پیش‌فرض به طول بُعد). درصورت مشخص شدن، طول این فهرست باید برابر با تعداد ابعاد غیرفضایی (مجموع ابعاد - ۲) باشد. یک عنصر مجزا در فهرست می‌تواند تهی باشد که به‌طور پیش‌فرض به طول آن بُعد نیز تبدیل می‌شود. شاخص‌های منفی از انتهای بُعد شمرده می‌شوند (مثلاً، ‎-۱ آخرین عنصر است).

مثال‌ها

ویرایشگر کد (جاوا اسکریپت)

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 و استفاده از geemap برای توسعه تعاملی، به صفحه محیط Python مراجعه کنید.

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