ee.ImageCollection.loadZarrV2Array

Lädt ein Zarr v2-Array mit 3 oder mehr Dimensionen (d.h. 1 oder mehr nicht räumliche Dimensionen) als ImageCollection, indem Sie entlang einer angegebenen nicht räumlichen Achse schneiden. Die Array-Attribute (.zattrs) müssen das Feld „_ARRAY_DIMENSIONS“ enthalten, das eine Liste der Namen der einzelnen Dimensionen ist (z.B. ['time', 'y', 'x']). Es müssen mindestens zwei Dimensionen vorhanden sein, wobei die letzten beiden für Y und X stehen (z.B. ['lat', 'lon']). Die unterstützten Komprimierungscodecs sind „blosc“, „gzip“, „lz4“, „zlib“ und „zstd“. Die unterstützten Blosc-Metakomprimierungs-Codecs sind „lz4“, „lz4hc“, „zlib“ und „zstd“ („blosclz“ wird nicht unterstützt).

Nutzung	Ausgabe
ee.ImageCollection.loadZarrV2Array(uri, proj, axis, starts, ends)	ImageCollection

Argument	Typ	Details
uri	String	Der Cloud Storage-URI der zu ladenden .zarray-Datei. Im übergeordneten Verzeichnis des Array-Verzeichnisses muss eine .zmetadata-Datei vorhanden sein (z.B. muss für „gs://b/o/.zarray“ die Datei „gs://b/.zmetadata“ vorhanden sein). Die Bucket-Metadaten müssen zugänglich sein (erfordert die Berechtigung „storage.buckets.get“, die unter anderem von der Rolle „Storage Legacy Bucket Reader“ bereitgestellt wird, siehe https://cloud.google.com/storage/docs/access-control/iam-roles). Außerdem muss sich der Bucket in der Multiregion „US“, einer Dualregion einschließlich „US-CENTRAL1“ oder der Region „US-CENTRAL1“ befinden.
proj	Projektion	Die Projektion des Arrays.
axis	Ganzzahl, Standard: null	Die nicht räumliche Achse (0-indexiert), entlang der das Array aufgeteilt werden soll, um eine ImageCollection zu erstellen. Jedes Bild in der Sammlung stellt ein einzelnes Segment (Länge 1) entlang dieser Achse dar. Wenn null, wird standardmäßig 0 verwendet. Der Wert muss im Bereich [0, N-1] liegen, wobei N die Anzahl der nicht räumlichen Dimensionen ist (d.h. Gesamtdimensionen - 2). Das Array muss mindestens eine nicht räumliche Dimension haben (d.h. mindestens dreidimensional sein).
starts	Liste, Standard: null	Die Indizes (einschließlich), bei denen mit dem Erstellen von Slices entlang jeder nicht räumlichen Dimension begonnen werden soll. Wenn „null“, beginnen die Slices bei Index 0 für alle nicht räumlichen Dimensionen. Falls angegeben, muss die Länge dieser Liste der Anzahl der nicht räumlichen Dimensionen (Gesamtdimensionen – 2) entsprechen. Ein einzelnes Element in der Liste kann null sein. In diesem Fall wird für diese Dimension standardmäßig 0 verwendet. Negative Indexe werden vom Ende der Dimension gezählt (z.B. ist -1 das letzte Element).
ends	Liste, Standard: null	Die Indizes (exklusiv), bei denen die Erstellung von Segmenten entlang jeder nicht räumlichen Dimension beendet werden soll. Wenn „null“, werden die Slices bis zum Ende der entsprechenden nicht-räumlichen Dimension erweitert (d.h. standardmäßig auf die Länge der Dimension). Falls angegeben, muss die Länge dieser Liste der Anzahl der nicht räumlichen Dimensionen (Gesamtdimensionen – 2) entsprechen. Ein einzelnes Element in der Liste kann null sein. In diesem Fall wird standardmäßig die Länge dieser Dimension verwendet. Negative Indexe werden vom Ende der Dimension gezählt (z.B. ist -1 das letzte Element).

Beispiele

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

Python einrichten

Weitere Informationen zur Python API und zur Verwendung von geemap für die interaktive Entwicklung finden Sie auf der Seite Python-Umgebung.

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