ee.ImageCollection.loadZarrV2Array
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یک آرایه Zarr v2 را با 3 بعد یا بیشتر (یعنی 1 یا بیشتر بعد غیر مکانی) به عنوان ImageCollection با برش در امتداد یک محور غیرمکانی مشخص بارگیری می کند. ویژگی‌های آرایه (zattrs.) باید حاوی فیلد «_ARRAY_DIMENSIONS» باشد، که فهرستی از نام‌های هر بعد است (به عنوان مثال، ['time'، 'y'، 'x']). باید حداقل دو بعد وجود داشته باشد که دو بعد آخر به ترتیب نشان دهنده 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 | رشته | Cloud Storage URI فایل 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 مراجعه کنید) و سطل باید در منطقه چندگانه ایالات متحده یا ENT واقع شده باشد. منطقه US-CENTRAL1. |
proj | فرافکنی | طرح ریزی آرایه. |
axis | عدد صحیح، پیش فرض: null | محور غیر فضایی (0-index) که در امتداد آن آرایه را برای ایجاد یک ImageCollection برش می دهیم. هر تصویر در مجموعه نشان دهنده یک تکه تکه (طول ۱) در امتداد این محور است. اگر null باشد، به طور پیش فرض روی 0 قرار می گیرد. مقدار باید در محدوده [0، N-1] باشد، که در آن N تعداد ابعاد غیر مکانی است (یعنی کل ابعاد - 2). آرایه باید حداقل یک بعد غیر مکانی داشته باشد (یعنی حداقل 3 بعدی باشد). |
starts | لیست، پیش فرض: null | شاخص‌هایی (شامل) که در آن برش‌هایی در امتداد هر بعد غیر فضایی شروع می‌شود. اگر تهی باشد، برش ها برای همه ابعاد غیر مکانی با شاخص 0 شروع می شوند. در صورت مشخص شدن، این لیست باید طولی برابر با تعداد ابعاد غیر مکانی داشته باشد (ابعاد کل - 2). یک عنصر منفرد در لیست ممکن است تهی باشد، که به طور پیش فرض برای آن بعد 0 است. شاخص های منفی از انتهای بعد شمارش می شوند (مثلاً 1- آخرین عنصر است). |
ends | لیست، پیش فرض: null | شاخص‌هایی (انحصاری) که در آن برش‌ها در امتداد هر بعد غیر مکانی متوقف می‌شود. در صورت تهی، برش ها تا انتهای هر بعد غیر مکانی متناظر گسترش می یابند (یعنی به طور پیش فرض به طول بعد می رسد). در صورت مشخص شدن، این لیست باید طولی برابر با تعداد ابعاد غیر مکانی داشته باشد (ابعاد کل - 2). یک عنصر منفرد در لیست ممکن است تهی باشد، که همچنین طول آن بعد را پیش‌فرض می‌کند. شاخص های منفی از انتهای بعد شمارش می شوند (مثلاً 1- آخرین عنصر است). |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[],[],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). |"]]
