ee.Image.stratifiedSample

تستخرج هذه الدالة عيّنة عشوائية طبقية من النقاط من صورة. تستخرِج هذه الدالة عدد العيّنات المحدّد لكل قيمة مميّزة تم اكتشافها ضمن classBand. تعرض هذه الدالة مجموعة FeatureCollection تتضمّن ميزة واحدة لكل نقطة مستخرَجة، مع تضمين كل ميزة لسمة واحدة لكل نطاق في الصورة المدخلة. إذا كان عدد العيّنات المتاحة لقيمة فئة معيّنة أقل من العدد المحدّد، سيتم تضمين جميع النقاط الخاصة بهذه الفئة. يجب أن يحتوي classBand على قيم أعداد صحيحة.

الاستخدام	المرتجعات
Image.stratifiedSample(numPoints, classBand, region, scale, projection, seed, classValues, classPoints, dropNulls, tileScale, geometries)	FeatureCollection

الوسيطة	النوع	التفاصيل
هذا: image	صورة	الصورة المطلوب أخذ عيّنة منها
numPoints	عدد صحيح	عدد النقاط التلقائي المطلوب أخذ عيّنات منها في كل فئة. يمكن تجاهل هذه السياسة لفئات محدّدة باستخدام السمتَين "classValues" و"classPoints".
classBand	سلسلة، القيمة التلقائية: null	اسم النطاق الذي يحتوي على الفئات المطلوب استخدامها للتصنيف الطبقي في حال عدم تحديدها، يتم استخدام النطاق الأول من الصورة المُدخَلة.
region	Geometry, default: null	المنطقة التي سيتم أخذ عيّنات منها في حال عدم تحديدها، يتم استخدام المساحة الكاملة للصورة المُدخَلة.
scale	عدد عائم، القيمة التلقائية: null	مقياس اسمي بالأمتار للعرض الذي سيتم أخذ عينات منه يتم ضبط القيمة التلقائية على مقياس النطاق الأول من الصورة المُدخَلة.
projection	التوقعات، القيمة التلقائية: null	نظام الإحداثيات الذي سيتم أخذ العيّنات فيه. في حال عدم تحديدها، يتم استخدام إسقاط النطاق الأول لصورة الإدخال. إذا تم تحديدها بالإضافة إلى المقياس، سيتم إعادة قياسها وفقًا للمقياس المحدّد.
seed	عدد صحيح، القيمة التلقائية: 0	قيمة عشوائية تُستخدَم لأخذ عينات فرعية.
classValues	قائمة، القيمة التلقائية: null	قائمة بقيم الفئات التي سيتم إلغاء مَعلمة numPoints لها. يجب أن يكون بالحجم نفسه الذي يظهر به classPoints أو أن تكون قيمته فارغة.
classPoints	قائمة، القيمة التلقائية: null	قائمة بالحد الأقصى لعدد وحدات البكسل التي سيتم أخذ عينات منها لكل فئة في قائمة classValues. يجب أن يكون الحجم هو نفسه حجم classValues أو null.
dropNulls	قيمة منطقية، القيمة التلقائية: true	تخطّي وحدات البكسل التي يتم إخفاء أي نطاق فيها
tileScale	عدد عشري، القيمة التلقائية: 1	عامل قياس يُستخدَم لتقليل حجم مربّع التجميع، وقد يتيح استخدام tileScale أكبر (مثل 2 أو 4) إجراء عمليات حسابية تنفد فيها الذاكرة مع القيمة التلقائية.
geometries	قيمة منطقية، القيمة التلقائية: false	إذا كانت القيمة صحيحة، ستتضمّن النتائج شكلاً هندسيًا لكل بكسل تم أخذ عيّنة منه. وإلا سيتم حذف الأشكال الهندسية (لتوفير مساحة تخزين).