ee.Image.loadZarrV2Array

Charge un tableau Zarr v2 en tant qu'image. 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.Image.loadZarrV2Array(uri, proj, starts, ends)	Image

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.
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 = 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');

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