ee.Image.loadZarrV2Array

Carica un array Zarr v2 come immagine. Gli attributi dell'array (.zattrs) devono contenere il campo "_ARRAY_DIMENSIONS", che è un elenco dei nomi di ogni dimensione (ad es. ["time", "y", "x"]). Devono essere presenti almeno due dimensioni, con le ultime due che rappresentano rispettivamente Y e X (ad es. ['lat', 'lon']). I codec di compressione supportati sono "blosc", "gzip", "lz4", "zlib" e "zstd". I codec di metacompressone blosc supportati sono "lz4", "lz4hc", "zlib" e "zstd" ("blosclz" non è supportato).

Utilizzo	Restituisce
ee.Image.loadZarrV2Array(uri, proj, starts, ends)	Immagine

Argomento	Tipo	Dettagli
uri	Stringa	L'URI Cloud Storage del file .zarray da caricare. Nella directory principale della directory dell'array deve essere presente un file .zmetadata (ad esempio, per "gs://b/o/.zarray", deve essere presente "gs://b/.zmetadata"). I metadati del bucket devono essere accessibili (richiede l'autorizzazione "storage.buckets.get" fornita, tra gli altri, dal ruolo "Storage Legacy Bucket Reader", consulta https://cloud.google.com/storage/docs/access-control/iam-roles) e il bucket deve trovarsi nella multiregione US, in una regione a due regioni che include US-CENTRAL1 o nella regione US-CENTRAL1.
proj	Proiezione	La proiezione dell'array.
starts	Elenco, predefinito: null	Gli indici (inclusi) da cui iniziare a prendere le sezioni lungo ogni dimensione non spaziale. Se il valore è null, le sezioni inizieranno dall'indice 0 per tutte le dimensioni non spaziali. Se specificato, questo elenco deve avere una lunghezza pari al numero di dimensioni non spaziali (dimensioni totali - 2). Un singolo elemento all'interno dell'elenco può essere null, che per impostazione predefinita è 0 per quella dimensione. Gli indici negativi vengono conteggiati dalla fine della dimensione (ad es. -1 è l'ultimo elemento).
ends	Elenco, predefinito: null	Gli indici (esclusivi) in cui interrompere l'acquisizione di sezioni lungo ogni dimensione non spaziale. Se null, le sezioni si estenderanno fino alla fine di ogni dimensione non spaziale corrispondente (ovvero, per impostazione predefinita, alla lunghezza della dimensione). Se specificato, questo elenco deve avere una lunghezza pari al numero di dimensioni non spaziali (dimensioni totali - 2). Un singolo elemento all'interno dell'elenco può essere null, che per impostazione predefinita corrisponde alla lunghezza della dimensione. Gli indici negativi vengono conteggiati dalla fine della dimensione (ad es. -1 è l'ultimo elemento).

Esempi

Editor di codice (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');

Configurazione di Python

Consulta la pagina Ambiente Python per informazioni sull'API Python e sull'utilizzo di geemap per lo sviluppo interattivo.

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