إشعار: يجب
إثبات أهلية جميع المشاريع غير التجارية المسجّلة لاستخدام Earth Engine قبل
15 أبريل 2025 من أجل الحفاظ على إمكانية الوصول إلى Earth Engine.
ee.ImageCollection.loadZarrV2Array
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تحميل مصفوفة Zarr v2 تحتوي على 3 سمات أو أكثر (أي سمة واحدة أو أكثر غير مكانية) كمجموعة صور من خلال تقطيعها على طول محور غير مكاني محدّد. يجب أن تحتوي سمات الصفيف (.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 | سلسلة | معرّف الموارد المنتظم (URI) الخاص بخدمة Cloud Storage لملف .zarray المطلوب تحميله يجب أن يكون ملف .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 | Integer, default: null | المحور غير المكاني (المُفهرس بـ 0) الذي يتم تقسيم الصفيف على طوله لإنشاء مجموعة صور تمثّل كل صورة في المجموعة شريحة واحدة (طولها 1) على طول هذا المحور. إذا كانت القيمة فارغة، يتم ضبطها تلقائيًا على 0. يجب أن تكون القيمة في النطاق [0، N-1]، حيث يكون N هو عدد السمات غير المكانية (أي إجمالي السمات - 2). يجب أن يحتوي الصفيف على سمة واحدة على الأقل غير مكانية (أي أن يكون ثلاثي الأبعاد على الأقل). |
starts | قائمة، القيمة التلقائية: فارغة | المؤشرات (شاملة) التي يجب أن تبدأ عندها عملية أخذ الشرائح على طول كل سمة غير مكانية إذا كانت القيمة فارغة، ستبدأ الشرائح من الفهرس 0 لجميع السمات غير المكانية. في حال تحديدها، يجب أن يكون طول هذه القائمة مساويًا لعدد السمات غير المكانية (إجمالي السمات - 2). قد يكون عنصر فردي ضمن القائمة فارغًا، ما يؤدي تلقائيًا إلى ضبطه على 0 لهذه السمة. يتم احتساب المؤشرات السالبة من نهاية السمة (مثل، -1 هو العنصر الأخير). |
ends | قائمة، القيمة التلقائية: فارغة | الفهارس (الحصرية) التي يتم عندها إيقاف أخذ الشرائح على طول كل سمة غير مكانية إذا كانت القيمة فارغة، ستمتد الشرائح إلى نهاية كل سمة غير مكانية مقابلة (أي القيمة التلقائية هي طول السمة). في حال تحديدها، يجب أن يكون طول هذه القائمة مساويًا لعدد السمات غير المكانية (إجمالي السمات - 2). قد يكون عنصر فردي ضمن القائمة فارغًا، ما يؤدي تلقائيًا إلى ضبط طول تلك السمة. يتم احتساب المؤشرات السالبة من نهاية السمة (مثل، -1 هو العنصر الأخير). |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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). |"]]
