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	قائمة، القيمة التلقائية: فارغة	قائمة بقيم الفئات التي سيتم إلغاء المعلمة numPoints لها. يجب أن يكون بالحجم نفسه الذي يظهر به classPoints أو أن تكون قيمته فارغة.
classPoints	قائمة، القيمة التلقائية: فارغة	قائمة بالحد الأقصى لعدد وحدات البكسل التي سيتم أخذ عينات منها لكل فئة في قائمة classValues. يجب أن يكون الحجم هو نفسه حجم classValues أو null.
dropNulls	قيمة منطقية، القيمة التلقائية: true	تخطّي وحدات البكسل التي تم إخفاء أي نطاق فيها
tileScale	عدد عائم، القيمة التلقائية: 1	عامل قياس يُستخدَم لتقليل حجم مربّع التجميع، ويؤدي استخدام قيمة أكبر لـ tileScale (مثل 2 أو 4) قد تتيح إجراء عمليات حسابية تنفد فيها الذاكرة مع القيمة التلقائية.
geometries	قيمة منطقية، القيمة التلقائية: false	إذا كانت القيمة صحيحة، ستتضمّن النتائج شكلاً هندسيًا لكل بكسل تم أخذ عيّنة منه. وإلا سيتم حذف الأشكال الهندسية (لتوفير مساحة في الذاكرة).