ee.ImageCollection.loadZarrV2Array

โหลดอาร์เรย์ Zarr v2 ที่มีมิติข้อมูลอย่างน้อย 3 รายการ (เช่น มิติข้อมูลที่ไม่ใช่เชิงพื้นที่อย่างน้อย 1 รายการ) เป็น ImageCollection โดยการแบ่งตามแกนที่ไม่ใช่เชิงพื้นที่ที่ระบุ แอตทริบิวต์อาร์เรย์ (.zattrs) ต้องมีช่อง "_ARRAY_DIMENSIONS" ซึ่งเป็นรายการชื่อของแต่ละมิติข้อมูล (เช่น ["time", "y", "x"]) ต้องมีอย่างน้อย 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	สตริง	URI ของ Cloud Storage ของไฟล์ .zarray ที่จะโหลด ไฟล์ .zmetadata ต้องอยู่ในไดเรกทอรีระดับบนของไดเรกทอรีอาร์เรย์ (เช่น สำหรับ "gs://b/o/.zarray" ต้องมี "gs://b/.zmetadata") ข้อมูลเมตาของที่เก็บข้อมูลต้องเข้าถึงได้ (ต้องมีสิทธิ์ `storage.buckets.get` ซึ่งได้รับจากบทบาท "Storage Legacy Bucket Reader" และอื่นๆ โปรดดู https://cloud.google.com/storage/docs/access-control/iam-roles) และที่เก็บข้อมูลต้องอยู่ในหลายภูมิภาคของสหรัฐอเมริกา, 2 ภูมิภาคซึ่งรวมถึง US-CENTRAL1 หรือภูมิภาค US-CENTRAL1
proj	Projection	การฉายภาพของอาร์เรย์
axis	จำนวนเต็ม ค่าเริ่มต้น: null	แกนที่ไม่ใช่เชิงพื้นที่ (0-indexed) ที่จะแบ่งอาร์เรย์เพื่อสร้าง ImageCollection รูปภาพแต่ละรูปในคอลเล็กชันแสดงถึงส่วนเดียว (ความยาว 1) ตามแกนนี้ หากเป็นค่าว่าง ค่าเริ่มต้นจะเป็น 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