ee.ImageCollection.loadZarrV2Array

Carga un array de Zarr v2 con 3 o más dimensiones (es decir, 1 o más dimensiones no espaciales) como una ImageCollection dividiendo a lo largo de un eje no espacial especificado. Los atributos del array (.zattrs) deben contener el campo "_ARRAY_DIMENSIONS", que es una lista de los nombres de cada dimensión (p.ej., ["time", "y", "x"]). Debe haber al menos dos dimensiones, y las dos últimas deben representar Y y X, respectivamente (p.ej., ['lat', 'lon']). Los códecs de compresión compatibles son "blosc", "gzip", "lz4", "zlib" y "zstd". Los códecs de metacompresión de blosc admitidos son 'lz4', 'lz4hc', 'zlib' y 'zstd' (no se admite 'blosclz').

Uso	Muestra
ee.ImageCollection.loadZarrV2Array(uri, proj, axis, starts, ends)	ImageCollection

Argumento	Tipo	Detalles
uri	String	Es el URI de Cloud Storage del archivo .zarray que se cargará. Debe haber un archivo .zmetadata en el directorio superior del directorio del array (p.ej., para "gs://b/o/.zarray", debe estar presente "gs://b/.zmetadata"). Se debe poder acceder a los metadatos del bucket (se requiere el permiso "storage.buckets.get", que proporciona el rol "Lector de buckets heredados de Storage", entre otros; consulta https://cloud.google.com/storage/docs/access-control/iam-roles) y el bucket debe estar ubicado en la multirregión de EE.UU., una birregión que incluya US-CENTRAL1 o la región US-CENTRAL1.
proj	Proyección	La proyección del array.
axis	Número entero, valor predeterminado: nulo	Es el eje no espacial (indexado en 0) a lo largo del cual se cortará el array para crear una ImageCollection. Cada imagen de la colección representa un solo corte (longitud 1) a lo largo de este eje. Si es nulo, el valor predeterminado es 0. El valor debe estar en el rango [0, N-1], donde N es la cantidad de dimensiones no espaciales (es decir, dimensiones totales - 2). El array debe tener al menos una dimensión no espacial (es decir, debe ser de al menos 3 dimensiones).
starts	Lista, valor predeterminado: nulo	Los índices (inclusive) en los que se deben comenzar a tomar porciones a lo largo de cada dimensión no espacial. Si es nulo, los cortes comenzarán en el índice 0 para todas las dimensiones no espaciales. Si se especifica, esta lista debe tener una longitud igual a la cantidad de dimensiones no espaciales (dimensiones totales - 2). Un elemento individual de la lista puede ser nulo, lo que se establece de forma predeterminada en 0 para esa dimensión. Los índices negativos se cuentan desde el final de la dimensión (p.ej., -1 es el último elemento).
ends	Lista, valor predeterminado: nulo	Los índices (exclusivos) en los que se debe dejar de tomar porciones a lo largo de cada dimensión no espacial. Si es nulo, los segmentos se extenderán hasta el final de cada dimensión no espacial correspondiente (es decir, el valor predeterminado es la longitud de la dimensión). Si se especifica, esta lista debe tener una longitud igual a la cantidad de dimensiones no espaciales (dimensiones totales - 2). Un elemento individual dentro de la lista puede ser nulo, lo que también se establece de forma predeterminada en la longitud de esa dimensión. Los índices negativos se cuentan desde el final de la dimensión (p.ej., -1 es el último elemento).

Ejemplos

Editor de código (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');

Configuración de Python

Consulta la página Entorno de Python para obtener información sobre la API de Python y el uso de geemap para el desarrollo interactivo.

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