ee.ImageCollection.loadZarrV2Array

3개 이상의 차원이 있는 Zarr v2 배열을 로드합니다 (예: 지정된 비공간 축을 따라 슬라이스하여 ImageCollection으로 변환합니다. 배열 속성 (.zattrs)에는 각 차원의 이름 목록인 '_ARRAY_DIMENSIONS' 필드가 포함되어야 합니다 (예: ['time', 'y', 'x']). 측정기준이 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.buckets.get` 권한이 필요함, https://cloud.google.com/storage/docs/access-control/iam-roles 참고), 버킷은 미국 멀티 리전, US-CENTRAL1을 포함하는 이중 리전 또는 US-CENTRAL1 리전에 있어야 합니다.
proj투영배열의 프로젝션입니다.
axis정수, 기본값: nullImageCollection을 만들기 위해 배열을 슬라이스할 비공간 축 (0 색인)입니다. 컬렉션의 각 이미지는 이 축을 따라 단일 슬라이스 (길이 1)를 나타냅니다. null인 경우 기본값은 0입니다. 값은 [0, N-1] 범위 내에 있어야 합니다. 여기서 N은 비공간 차원 수 (즉, 총 차원 수 - 2)입니다. 배열에는 공간이 아닌 차원이 하나 이상 있어야 합니다 (즉, 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