ee.Image.loadZarrV2Array

Carrega uma matriz Zarr v2 como uma imagem. 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).

UsoRetorna
ee.Image.loadZarrV2Array(uri, proj, starts, ends)Imagem
ArgumentoTipoDetalhes
uriStringO 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.
projProjeçãoA projeção da matriz.
startsLista, padrão: nuloOs í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).
endsLista, padrão: nuloOs í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 = 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');

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