Annuncio: tutti i progetti non commerciali registrati per l'utilizzo di Earth Engine prima del
15 aprile 2025 devono
verificare l'idoneità non commerciale per mantenere l'accesso a Earth Engine.
ee.ImageCollection.loadZarrV2Array
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Carica un array Zarr v2 con tre o più dimensioni (ad es. 1 o più dimensioni non spaziali) come ImageCollection mediante l'applicazione di un taglio lungo un asse non spaziale specificato. Gli attributi array (.zattrs) devono contenere il campo "_ARRAY_DIMENSIONS", che è un elenco dei nomi di ogni dimensione (ad es. ['time', 'y', 'x']). Devono essere presenti almeno due dimensioni, con le ultime due che rappresentano rispettivamente Y e X (ad es. ['lat', 'lon']). I codec di compressione supportati sono "blosc", "gzip", "lz4", "zlib" e "zstd". I codec di metacompressione blosc supportati sono "lz4", "lz4hc", "zlib" e "zstd" ("blosclz" non è supportato).
| Utilizzo | Resi |
|---|
ee.ImageCollection.loadZarrV2Array(uri, proj, axis, starts, ends) | ImageCollection |
| Argomento | Tipo | Dettagli |
|---|
uri | Stringa | L'URI Cloud Storage del file .zarray da caricare. Nella directory principale della directory dell'array deve essere presente un file .zmetadata (ad es. per "gs://b/o/.zarray" deve essere presente "gs://b/.zmetadata"). I metadati del bucket devono essere accessibili (è richiesta l'autorizzazione "storage.buckets.get" fornita, tra gli altri, dal ruolo "Lettore di bucket legacy di archiviazione"; consulta la pagina https://cloud.google.com/storage/docs/access-control/iam-roles) e il bucket deve trovarsi nella regione multipla degli Stati Uniti, in una regione doppia che include US-CENTRAL1 o nella regione US-CENTRAL1. |
proj | Projection | La proiezione dell'array. |
axis | Integer, default: null | L'asse non spaziale (indicizzato da 0) lungo il quale tagliare l'array per creare una raccolta di immagini. Ogni immagine della raccolta rappresenta un singolo slice (lunghezza 1) lungo questo asse. Se è null, il valore predefinito è 0. Il valore deve rientrare nell'intervallo [0, N-1], dove N è il numero di dimensioni non spaziali (ovvero le dimensioni totali - 2). L'array deve avere almeno una dimensione non spaziale (ovvero essere almeno tridimensionale). |
starts | Elenco, predefinito: null | Gli indici (inclusi) a partire dai quali iniziare a prendere i sezioni lungo ogni dimensione non spaziale. Se il valore è null, gli slice inizieranno dall'indice 0 per tutte le dimensioni non spaziali. Se specificato, questo elenco deve avere una lunghezza pari al numero di dimensioni non spaziali (dimensioni totali - 2). Un singolo elemento all'interno dell'elenco può essere nullo, il che corrisponde a 0 per quella dimensione. Gli indici negativi vengono conteggiati dalla fine della dimensione (ad es. -1 è l'ultimo elemento). |
ends | Elenco, predefinito: null | Gli indici (esclusivi) a cui interrompere l'estrazione di sezioni lungo ogni dimensione non spaziale. Se è nullo, gli spicchi si estenderanno fino alla fine di ogni dimensione non spaziale corrispondente (ovvero il valore predefinito è la lunghezza della dimensione). Se specificato, questo elenco deve avere una lunghezza pari al numero di dimensioni non spaziali (dimensioni totali - 2). Un singolo elemento all'interno dell'elenco può essere nullo, il che corrisponde anche alla lunghezza predefinita della dimensione. Gli indici negativi vengono conteggiati dalla fine della dimensione (ad es. -1 è l'ultimo elemento). |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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). |"]]
