ee.ImageCollection.loadZarrV2Array

Charge un tableau Zarr v2 avec au moins trois dimensions (c'est-à-dire, une ou plusieurs dimensions non spatiales) en tant qu'ImageCollection en découpant le long d'un axe non spatial spécifié. Les attributs de tableau (.zattrs) doivent contenir le champ "_ARRAY_DIMENSIONS", qui est une liste des noms de chaque dimension (par exemple, ['time', 'y', 'x']). Il doit y avoir au moins deux dimensions, les deux dernières représentant respectivement Y et X (par exemple, ['lat', 'lon']). Les codecs de compression compatibles sont "blosc", "gzip", "lz4", "zlib" et "zstd". Les codecs de métacompression blosc compatibles sont "lz4", "lz4hc", "zlib" et "zstd" ("blosclz" n'est pas compatible).

Utilisation	Renvoie
ee.ImageCollection.loadZarrV2Array(uri, proj, axis, starts, ends)	ImageCollection

Argument	Type	Détails
uri	Chaîne	URI Cloud Storage du fichier .zarray à charger. Un fichier .zmetadata doit être présent dans le répertoire parent du répertoire du tableau (par exemple, pour "gs://b/o/.zarray", "gs://b/.zmetadata" doit être présent). Les métadonnées du bucket doivent être accessibles (nécessite l'autorisation "storage.buckets.get" fournie par le rôle "Lecteur des anciens buckets Storage", entre autres ; consultez https://cloud.google.com/storage/docs/access-control/iam-roles) et le bucket doit se trouver dans l'emplacement multirégional US, un emplacement birégional incluant US-CENTRAL1 ou la région US-CENTRAL1.
proj	Projection	Projection du tableau.
axis	Entier, valeur par défaut : null	Axe non spatial (indexé à partir de 0) le long duquel découper le tableau pour créer une ImageCollection. Chaque image de la collection représente une seule tranche (longueur 1) le long de cet axe. Si la valeur est nulle, la valeur par défaut est 0. La valeur doit être comprise dans la plage [0, N-1], où N est le nombre de dimensions non spatiales (c'est-à-dire le nombre total de dimensions - 2). Le tableau doit comporter au moins une dimension non spatiale (c'est-à-dire au moins trois dimensions).
starts	Liste, valeur par défaut : null	Indices (inclus) auxquels commencer à prendre des tranches le long de chaque dimension non spatiale. Si la valeur est nulle, les tranches commencent à l'index 0 pour toutes les dimensions non spatiales. Si elle est spécifiée, cette liste doit avoir une longueur égale au nombre de dimensions non spatiales (dimensions totales - 2). Un élément individuel de la liste peut être nul, ce qui correspond par défaut à 0 pour cette dimension. Les indices négatifs sont comptés à partir de la fin de la dimension (par exemple, -1 est le dernier élément).
ends	Liste, valeur par défaut : null	Indices (exclusifs) auxquels arrêter de prendre des tranches le long de chaque dimension non spatiale. Si la valeur est nulle, les tranches s'étendent jusqu'à la fin de chaque dimension non spatiale correspondante (c'est-à-dire que la valeur par défaut est la longueur de la dimension). Si elle est spécifiée, cette liste doit avoir une longueur égale au nombre de dimensions non spatiales (dimensions totales - 2). Un élément individuel de la liste peut être nul, ce qui correspond également par défaut à la longueur de cette dimension. Les indices négatifs sont comptés à partir de la fin de la dimension (par exemple, -1 est le dernier élément).

Exemples

Éditeur de code (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');

Configuration de Python

Consultez la page Environnement Python pour en savoir plus sur l'API Python et l'utilisation de geemap pour le développement interactif.

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