ee.ImageCollection.loadZarrV2Array

Carrega uma matriz Zarr v2 com três ou mais dimensões (ou seja, uma ou mais dimensões não espaciais) como uma ImageCollection, dividindo ao longo de um eixo não espacial especificado. Os atributos da matriz (.zattrs) precisam conter o campo "_ARRAY_DIMENSIONS", que é uma lista dos nomes de cada dimensão (por exemplo, ["time", "y", "x"]). É preciso haver pelo menos duas dimensões, com as duas últimas representando Y e X, respectivamente (por exemplo, ['lat', 'lon']). Os codecs de compactação compatíveis são "blosc", "gzip", "lz4", "zlib" e "zstd". Os codecs de metacompressão blosc compatíveis são "lz4", "lz4hc", "zlib" e "zstd" ("blosclz" não é compatível).

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

Argumento	Tipo	Detalhes
uri	String	O URI do Cloud Storage do arquivo .zarray a ser carregado. Um arquivo .zmetadata precisa estar presente no diretório pai do diretório da matriz (por exemplo, para "gs://b/o/.zarray", "gs://b/.zmetadata" precisa estar presente). Os metadados do bucket precisam estar acessíveis (requer a permissão "storage.buckets.get", fornecida pelo papel "Leitor de bucket legado do Storage", entre outros, consulte https://cloud.google.com/storage/docs/access-control/iam-roles) e o bucket precisa estar localizado na multirregião dos EUA, em uma birregião que inclua US-CENTRAL1 ou na região US-CENTRAL1.
proj	Projeção	A projeção da matriz.
axis	Número inteiro, padrão: nulo	O eixo não espacial (indexado em 0) ao longo do qual a matriz será dividida para criar uma ImageCollection. Cada imagem na coleção representa uma única fração (comprimento 1) ao longo desse eixo. Se for nulo, o padrão será 0. O valor precisa estar no intervalo [0, N-1], em que N é o número de dimensões não espaciais (ou seja, total de dimensões - 2). A matriz precisa ter pelo menos uma dimensão não espacial (ou seja, ter pelo menos três dimensões).
starts	Lista, padrão: nulo	Os índices (inclusive) em que as fatias começam a ser extraídas em cada dimensão não espacial. Se for nulo, as frações vão começar no índice 0 para todas as dimensões não espaciais. Se especificada, essa lista precisa ter um comprimento igual ao número de dimensões não espaciais (dimensões totais - 2). Um elemento individual na lista pode ser nulo, o que assume o valor padrão 0 para essa dimensão. Os índices negativos são contados a partir do final da dimensão (por exemplo, -1 é o último elemento).
ends	Lista, padrão: nulo	Os índices (exclusivos) em que as fatias deixam de ser feitas em cada dimensão não espacial. Se for nulo, as fatias vão se estender até o final de cada dimensão não espacial correspondente (ou seja, o padrão é o comprimento da dimensão). Se especificada, essa lista precisa ter um comprimento igual ao número de dimensões não espaciais (dimensões totais - 2). Um elemento individual na lista pode ser nulo, o que também assume como padrão o comprimento dessa dimensão. Os índices negativos são contados a partir do final da dimensão (por exemplo, -1 é o último elemento).

Exemplos

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

Configuração do Python

Consulte a página Ambiente Python (em inglês) para informações sobre a API Python e como usar geemap para desenvolvimento interativo.

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