ee.Image.loadZarrV2Array

Wczytuje tablicę Zarr v2 jako obraz. Atrybuty tablicy (.zattrs) muszą zawierać pole „_ARRAY_DIMENSIONS”, które jest listą nazw poszczególnych wymiarów (np. ['time', 'y', 'x']). Muszą być co najmniej 2 wymiary, przy czym ostatnie 2 reprezentują odpowiednio Y i X (np. ['lat', 'lon']). Obsługiwane kodeki kompresji to „blosc”, „gzip”, „lz4”, „zlib” i „zstd”. Obsługiwane kodeki metakompresji blosc to „lz4”, „lz4hc”, „zlib” i „zstd” („blosclz” nie jest obsługiwany).

Wykorzystanie	Zwroty
ee.Image.loadZarrV2Array(uri, proj, starts, ends)	Obraz

Argument	Typ	Szczegóły
uri	Ciąg znaków	Identyfikator URI obiektu w Cloud Storage pliku .zarray do wczytania. Plik .zmetadata musi znajdować się w katalogu nadrzędnym katalogu tablicy (np. w przypadku „gs://b/o/.zarray” musi być obecny plik „gs://b/.zmetadata”). Metadane zasobnika muszą być dostępne (wymaga to uprawnienia `storage.buckets.get`, które jest udostępniane m.in. przez rolę „Odczytujący starsze zasobniki Cloud Storage”, patrz https://cloud.google.com/storage/docs/access-control/iam-roles), a zasobnik musi znajdować się w wielu regionach w USA, w dwóch regionach, w tym US-CENTRAL1, lub w regionie US-CENTRAL1.
proj	Odwzorowanie	Projekcja tablicy.
starts	Lista, domyślna: null	Indeksy (włącznie), od których należy zacząć pobieranie wycinków wzdłuż każdego wymiaru nieprzestrzennego. Jeśli wartość jest równa null, wycinki będą zaczynać się od indeksu 0 we wszystkich wymiarach nieprzestrzennych. Jeśli ta lista jest określona, musi mieć długość równą liczbie wymiarów nieprzestrzennych (łączna liczba wymiarów – 2). Pojedynczy element na liście może mieć wartość null, która domyślnie przyjmuje wartość 0 dla danego wymiaru. Indeksy ujemne są liczone od końca wymiaru (np. -1 to ostatni element).
ends	Lista, domyślna: null	Indeksy (wykluczające), przy których należy przestać pobierać wycinki wzdłuż każdego wymiaru nieprzestrzennego. Jeśli wartość jest równa null, wycinki będą rozciągać się do końca każdego odpowiedniego wymiaru nieprzestrzennego (czyli domyślnie do długości wymiaru). Jeśli ta lista jest określona, musi mieć długość równą liczbie wymiarów nieprzestrzennych (łączna liczba wymiarów – 2). Pojedynczy element na liście może mieć wartość null, która domyślnie odpowiada długości tego wymiaru. Indeksy ujemne są liczone od końca wymiaru (np. -1 to ostatni element).

Przykłady

Edytor kodu (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');

Konfiguracja Pythona

Informacje o interfejsie API dla Pythona oraz o używaniu geemap do interaktywnego programowania znajdziesz na stronie środowiska 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