ee.ImageCollection.loadZarrV2Array

3 つ以上のディメンション（1 つ以上の非空間ディメンション）を、指定された非空間軸に沿ってスライスすることで、ImageCollection として読み込みます。配列属性（.zattrs）には、各ディメンションの名前のリスト（['time', 'y', 'x'] など）である「_ARRAY_DIMENSIONS」フィールドが含まれている必要があります。少なくとも 2 つのディメンションが必要で、最後の 2 つはそれぞれ Y と X を表します（例: ['lat', 'lon']）。サポートされている圧縮コーデックは、「blosc」、「gzip」、「lz4」、「zlib」、「zstd」です。サポートされている blosc メタ圧縮コーデックは、「lz4」、「lz4hc」、「zlib」、「zstd」です（「blosclz」はサポートされていません）。

用途戻り値
ee.ImageCollection.loadZarrV2Array(uri, proj, axis, starts, ends)ImageCollection
引数タイプ詳細
uri文字列読み込む .zarray ファイルの Cloud Storage URI。.zmetadata ファイルは、配列のディレクトリの親ディレクトリに存在する必要があります（例: 「gs://b/o/.zarray」の場合、「gs://b/.zmetadata」が存在する必要があります）。バケットのメタデータにアクセスできる必要があります（「Storage レガシー バケット読み取り」などのロールによって提供される「storage.buckets.get」権限が必要です。https://cloud.google.com/storage/docs/access-control/iam-roles をご覧ください）。また、バケットは、US マルチリージョン、US-CENTRAL1 を含むデュアルリージョン、または US-CENTRAL1 リージョンに配置されている必要があります。
proj予測配列の投影。
axis整数、デフォルト: nullImageCollection を作成するために配列をスライスする非空間軸（0 インデックス）。コレクション内の各画像は、この軸に沿った 1 つのスライス（長さ 1）を表します。null の場合、デフォルトは 0 です。値は [0, N-1] の範囲にする必要があります。ここで、N は空間以外のディメンションの数（合計ディメンション - 2）です。配列には、少なくとも 1 つの非空間ディメンション（つまり、少なくとも 3 次元）が必要です。
startsリスト、デフォルト: null各非空間ディメンションに沿ってスライスの取得を開始するインデックス（両端を含む）。null の場合、スライスはすべての非空間ディメンションのインデックス 0 から開始されます。指定する場合、このリストの長さは、空間以外のディメンションの数（合計ディメンション - 2）と同じにする必要があります。リスト内の個々の要素は null になることがあり、そのディメンションのデフォルトは 0 です。負のインデックスは、ディメンションの末尾からカウントされます（例: -1 は最後の要素）。
endsリスト、デフォルト: null各非空間ディメンションに沿ってスライスの取得を停止するインデックス（排他的）。null の場合、スライスは対応する各非空間ディメンションの末尾まで拡張されます（つまり、デフォルトはディメンションの長さになります）。指定する場合、このリストの長さは、空間以外のディメンションの数（合計ディメンション - 2）と同じにする必要があります。リスト内の個々の要素は null になることがあり、その場合もデフォルトでそのディメンションの長さになります。負のインデックスは、ディメンションの末尾からカウントされます（例: -1 は最後の要素）。

例

コードエディタ（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');

Python の設定

Python API と、インタラクティブな開発に geemap を使用する方法については、 Python 環境のページをご覧ください。

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