ee.ImageCollection.loadZarrV2Array

Carica un array Zarr v2 con 3 o più dimensioni (ovvero 1 o più dimensioni non spaziali) come ImageCollection suddividendo lungo un asse non spaziale specificato. 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 meta-compressione blosc supportati sono "lz4", "lz4hc", "zlib" e "zstd" ("blosclz" non è supportato).

Utilizzo	Resi
ee.ImageCollection.loadZarrV2Array(uri, proj, axis, starts, ends)	ImageCollection

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.
axis	Numero intero, valore predefinito: null	L'asse non spaziale (indicizzato a 0) lungo il quale suddividere l'array per creare un ImageCollection. Ogni immagine della raccolta rappresenta una singola sezione (lunghezza 1) lungo questo asse. Se null, il valore predefinito è 0. Il valore deve essere compreso nell'intervallo [0, N-1], dove N è il numero di dimensioni non spaziali (ovvero, dimensioni totali - 2). L'array deve avere almeno una dimensione non spaziale (ovvero deve essere almeno tridimensionale).
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 = 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');

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 = 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