ee.ImageCollection.loadZarrV2Array
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tải một mảng Zarr v2 có 3 phương diện trở lên (tức là 1 hoặc nhiều phương diện không gian) dưới dạng ImageCollection bằng cách cắt dọc theo một trục không gian được chỉ định. Thuộc tính mảng (.zattrs) phải chứa trường "_ARRAY_DIMENSIONS", là danh sách tên của từng phương diện (ví dụ: ['time', 'y', 'x']). Phải có ít nhất hai phương diện, trong đó hai phương diện cuối cùng lần lượt đại diện cho Y và X (ví dụ: ['lat', 'lon']). Các bộ mã hoá và giải mã nén được hỗ trợ là "blosc", "gzip", "lz4", "zlib" và "zstd". Các bộ mã hoá và giải mã nén siêu dữ liệu blosc được hỗ trợ là "lz4", lz4hc", "zlib" và "zstd" ("blosclz" không được hỗ trợ).
Cách sử dụng | Giá trị trả về |
---|
ee.ImageCollection.loadZarrV2Array(uri, proj, axis, starts, ends) | ImageCollection |
Đối số | Loại | Thông tin chi tiết |
---|
uri | Chuỗi | URI Cloud Storage của tệp .zarray cần tải. Tệp .zmetadata phải có trong thư mục mẹ của thư mục mảng (ví dụ: đối với "gs://b/o/.zarray", bạn phải có "gs://b/.zmetadata"). Bạn phải truy cập được siêu dữ liệu của bộ chứa (yêu cầu quyền "storage.buckets.get" do vai trò "Storage Legacy Bucket Reader" (Người đọc bộ chứa cũ của Google Cloud Storage) cung cấp, xem https://cloud.google.com/storage/docs/access-control/iam-roles) và bộ chứa phải nằm ở nhiều khu vực ở Hoa Kỳ, một khu vực kép bao gồm US-CENTRAL1 hoặc khu vực US-CENTRAL1. |
proj | Dự đoán | Hình chiếu của mảng. |
axis | Integer, default: null | Trục không gian (được lập chỉ mục từ 0) để cắt dải ô nhằm tạo một ImageCollection. Mỗi hình ảnh trong bộ sưu tập đại diện cho một lát cắt (dài 1) dọc theo trục này. Nếu giá trị này là rỗng, giá trị mặc định sẽ là 0. Giá trị này phải nằm trong phạm vi [0, N-1], trong đó N là số lượng phương diện không gian (tức là tổng số phương diện – 2). Mảng phải có ít nhất một phương diện không gian (tức là ít nhất 3 phương diện). |
starts | Danh sách, mặc định: rỗng | Các chỉ mục (bao gồm cả) để bắt đầu lấy lát cắt dọc theo mỗi phương diện không gian. Nếu giá trị này là rỗng, các lát cắt sẽ bắt đầu tại chỉ mục 0 cho tất cả các phương diện không phải không gian. Nếu được chỉ định, danh sách này phải có độ dài bằng số lượng phương diện không gian (tổng số phương diện – 2). Một phần tử riêng lẻ trong danh sách có thể có giá trị rỗng, giá trị mặc định là 0 cho phương diện đó. Chỉ mục âm được tính từ cuối phương diện (ví dụ: -1 là phần tử cuối cùng). |
ends | Danh sách, mặc định: rỗng | Các chỉ mục (không bao gồm) tại đó bạn sẽ ngừng lấy lát cắt dọc theo mỗi phương diện không gian. Nếu giá trị này là rỗng, các lát cắt sẽ kéo dài đến cuối mỗi phương diện không gian tương ứng (tức là mặc định là chiều dài của phương diện). Nếu được chỉ định, danh sách này phải có độ dài bằng số lượng phương diện không gian (tổng số phương diện – 2). Một phần tử riêng lẻ trong danh sách có thể có giá trị rỗng, giá trị này cũng mặc định là độ dài của phương diện đó. Chỉ mục âm được tính từ cuối phương diện (ví dụ: -1 là phần tử cuối cùng). |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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). |"]]