ee.ImageCollection.loadZarrV2Array
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Charge un tableau Zarr v2 avec au moins trois dimensions (c'est-à-dire, une ou plusieurs dimensions non spatiales) en tant qu'ImageCollection en effectuant un découpage le long d'un axe non spatial spécifié. Les attributs de tableau (.zattrs) doivent contenir le champ '_ARRAY_DIMENSIONS', qui est une liste des noms de chaque dimension (par exemple, ['time', 'y', 'x']). Il doit y avoir au moins deux dimensions, dont les deux dernières représentent respectivement Y et X (par exemple, ['lat', 'lon']). Les codecs de compression acceptés sont "blosc", "gzip", "lz4", "zlib" et "zstd". Les codecs de métacompression blosc compatibles sont 'lz4', lz4hc', 'zlib' et 'zstd' ('blosclz' n'est pas compatible).
| Utilisation | Renvoie |
|---|
ee.ImageCollection.loadZarrV2Array(uri, proj, axis, starts, ends) | ImageCollection |
| Argument | Type | Détails |
|---|
uri | Chaîne | URI Cloud Storage du fichier .zarray à charger. Un fichier .zmetadata doit être présent dans le répertoire parent du répertoire du tableau (par exemple, pour "gs://b/o/.zarray", "gs://b/.zmetadata" doit être présent). Les métadonnées du bucket doivent être accessibles (ce qui nécessite l'autorisation "storage.buckets.get", fournie par le rôle "Lecteur des anciens buckets de stockage", entre autres, consultez la page https://cloud.google.com/storage/docs/access-control/iam-roles). Le bucket doit se trouver dans l'emplacement multirégional des États-Unis, dans une région duale incluant US-CENTRAL1 ou dans la région US-CENTRAL1. |
proj | Projection | Projection du tableau. |
axis | Integer, default: null | Axe non spatial (indexé à 0) le long duquel découper le tableau pour créer une ImageCollection. Chaque image de la collection représente une seule tranche (longueur 1) le long de cette axe. Si la valeur est nulle, la valeur par défaut est 0. La valeur doit se situer dans la plage [0, N-1], où N correspond au nombre de dimensions non spatiales (c'est-à-dire le nombre total de dimensions - 2). Le tableau doit comporter au moins une dimension non spatiale (c'est-à-dire être au moins tridimensionnel). |
starts | Liste, valeur par défaut : "null" | Indices (inclusifs) à partir desquels commencer à prendre des tranches le long de chaque dimension non spatiale. Si cette valeur est nulle, les tranches commencent à l'indice 0 pour toutes les dimensions non spatiales. Si elle est spécifiée, cette liste doit avoir une longueur égale au nombre de dimensions non spatiales (nombre total de dimensions - 2). Un élément individuel de la liste peut être nul, ce qui correspond à 0 par défaut pour cette dimension. Les indices négatifs sont comptés à partir de la fin de la dimension (par exemple, -1 correspond au dernier élément). |
ends | Liste, valeur par défaut : "null" | Indices (exclusifs) à partir desquels arrêter de prendre des tranches le long de chaque dimension non spatiale. Si la valeur est nulle, les tranches s'étendent jusqu'à la fin de chaque dimension non spatiale correspondante (c'est-à-dire, la longueur de la dimension par défaut). Si elle est spécifiée, cette liste doit avoir une longueur égale au nombre de dimensions non spatiales (nombre total de dimensions - 2). Un élément individuel de la liste peut être nul, ce qui correspond également à la longueur par défaut de cette dimension. Les indices négatifs sont comptés à partir de la fin de la dimension (par exemple, -1 correspond au dernier élément). |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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). |"]]
