Anúncio: todos os projetos não comerciais registrados para usar o Earth Engine antes de
15 de abril de 2025 precisam
verificar a qualificação não comercial para manter o acesso ao Earth Engine.
ee.ImageCollection.loadZarrV2Array
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Carrega uma matriz Zarr v2 com três ou mais dimensões (ou seja, 1 ou mais dimensões não espaciais) como uma ImageCollection, fatiando em um eixo não espacial especificado. Os atributos de matriz (.zattrs) precisam conter o campo "_ARRAY_DIMENSIONS", que é uma lista dos nomes de cada dimensão (por exemplo, ['time', 'y', 'x']). É preciso ter pelo menos duas dimensões, com as duas últimas representando Y e X, respectivamente (por exemplo, ['lat', 'lon']). Os codecs de compactação aceitos são "blosc", "gzip", "lz4", "zlib" e "zstd". Os codecs de metacompactação blosc compatíveis são "lz4", "lz4hc", "zlib" e "zstd". Não há suporte para "blosclz".
| 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 array (por exemplo, para "gs://b/o/.zarray", "gs://b/.zmetadata" precisa estar presente). Os metadados do bucket precisam ser acessíveis (requer a permissão "storage.buckets.get", que é fornecida pela função "Leitor de bucket legado do Storage", entre outras. Consulte https://cloud.google.com/storage/docs/access-control/iam-roles). O bucket também precisa estar localizado na multirregião dos EUA, em uma região dupla, incluindo a US-CENTRAL1, ou na região US-CENTRAL1. |
proj | Projeção | A projeção da matriz. |
axis | Integer, default: null | O eixo não espacial (indexado em 0) ao longo do qual o array é fatiado para criar uma ImageCollection. Cada imagem da coleção representa uma única fatia (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, dimensões totais - 2). A matriz precisa ter pelo menos uma dimensão não espacial (ou seja, pelo menos três dimensões). |
starts | Lista, padrão: null | Os índices (inclusive) em que começar a fazer cortes em cada dimensão não espacial. Se for nulo, as fatias 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 (total de dimensões - 2). Um elemento individual na lista pode ser nulo, o que significa que o valor padrão para essa dimensão é 0. Os índices negativos são contados a partir do final da dimensão (por exemplo, -1 é o último elemento). |
ends | Lista, padrão: null | Os índices (exclusivos) em que as fatias param de ser tiradas 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 (total de dimensões - 2). Um elemento individual na lista pode ser nulo, o que também é o padrão para o comprimento dessa dimensão. Os índices negativos são contados a partir do final da dimensão (por exemplo, -1 é o último elemento). |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 2025-07-25 UTC."],[],[],null,["# ee.ImageCollection.loadZarrV2Array\n\nLoads a Zarr v2 array with 3 or more dimensions (i.e., 1 or more non-spatial dimensions) as an ImageCollection by slicing along a specified non-spatial axis. The array attributes (.zattrs) must contain the field '_ARRAY_DIMENSIONS', which is a list of the names of each dimension (e.g., \\['time', 'y', 'x'\\]). There must be at least two dimensions, with the final two representing Y and X respectively (e.g., \\['lat', 'lon'\\]). The supported compression codecs are 'blosc', 'gzip', 'lz4', 'zlib', and 'zstd'. The supported blosc meta-compression codecs are 'lz4', lz4hc', 'zlib', and 'zstd' ('blosclz' is not supported).\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|-----------------------------------------------------------------------------------|-----------------|\n| `ee.ImageCollection.loadZarrV2Array(uri, proj, `*axis* `, `*starts* `, `*ends*`)` | ImageCollection |\n\n| Argument | Type | Details |\n|----------|------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `uri` | String | The Cloud Storage URI of the .zarray file to load. A .zmetadata file must be present in the parent directory of the array's directory (e.g., for 'gs://b/o/.zarray', 'gs://b/.zmetadata' must be present). The bucket metadata must be accessible (requires the \\`storage.buckets.get\\` permission which is provided by the role \"Storage Legacy Bucket Reader\" among others, see https://cloud.google.com/storage/docs/access-control/iam-roles) and the bucket must be located in the US multi-region, a dual-region including US-CENTRAL1, or the US-CENTRAL1 region. |\n| `proj` | Projection | The projection of the array. |\n| `axis` | Integer, default: null | The non-spatial axis (0-indexed) along which to slice the array to create an ImageCollection. Each image in the collection represents a single slice (length 1) along this axis. If null, defaults to 0. The value must be in the range \\[0, N-1\\], where N is the number of non-spatial dimensions (i.e., total dimensions - 2). The array must have at least one non-spatial dimension (i.e., be at least 3 dimensional). |\n| `starts` | List, default: null | The indices (inclusive) at which to start taking slices along each non-spatial dimension. If null, slices will start at index 0 for all non-spatial dimensions. If specified, this list must have a length equal to the number of non-spatial dimensions (total dimensions - 2). An individual element within the list may be null, which defaults to 0 for that dimension. Negative indices are counted from the end of the dimension (e.g., -1 is the last element). |\n| `ends` | List, default: null | The indices (exclusive) at which to stop taking slices along each non-spatial dimension. If null, slices will extend to the end of each corresponding non-spatial dimension (i.e., defaults to the length of the dimension). If specified, this list must have a length equal to the number of non-spatial dimensions (total dimensions - 2). An individual element within the list may be null, which also defaults to the length of that dimension. Negative indices are counted from the end of the dimension (e.g., -1 is the last element). |"]]
