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 هو العنصر الأخير).