GISarabia.org
PostGIS › الدليل الرسمي › 7. مرجع PostGIS › 7.12. دوال القياس
PostGIS 3.6 · Official Manual · ترجمة عربية

ST_MinimumClearance

الصفحة الأصلية بالإنجليزية postgis.net ↗

الاسم

ST_MinimumClearance — تُعيد الخلوص الأدنى (minimum clearance) لشكل هندسي، وهو مقياس لمتانة الشكل الهندسي.

المختصر

float ST_MinimumClearance(geometry g);

الوصف

قد يستوفي شكل هندسي معايير الصلاحية وفق ST_IsValid (للمضلعات) أو ST_IsSimple (للخطوط)، لكنه يصبح غير صالح إذا حُرّك أحد رؤوسه مسافة صغيرة. وقد يحدث ذلك بسبب فقدان الدقة أثناء التحويل إلى صيغ نصية (مثل WKT وKML وGML وGeoJSON)، أو إلى صيغ ثنائية لا تستخدم إحداثيات فاصلة عائمة مزدوجة الدقة (مثل MapInfo TAB).

الخلوص الأدنى مقياس كمّي لمتانة الشكل الهندسي أمام تغيّر دقة الإحداثيات. وهو أكبر مسافة يمكن تحريك رؤوس الشكل الهندسي بها دون إنشاء شكل هندسي غير صالح. وتدل القيم الأكبر للخلوص الأدنى على متانة أكبر.

إذا كان الخلوص الأدنى لشكل هندسي هو e، فإن:

  • لا يوجد في الشكل الهندسي رأسان مختلفان المسافة بينهما أقل من e.

  • لا يوجد رأس تقل مسافته عن e من قطعة خطية ليس هو أحد طرفيها.

إذا لم يكن للشكل الهندسي خلوص أدنى (مثل نقطة مفردة، أو MultiPoint نقاطه متطابقة)، تكون القيمة المُعادة Infinity.

لتجنّب مشكلات الصلاحية الناتجة عن فقدان الدقة، يمكن استخدام ST_ReducePrecision لتقليل دقة الإحداثيات مع ضمان بقاء الأشكال المضلعية صالحة.

متاحة منذ: 2.3.0

أمثلة

SELECT ST_MinimumClearance('POLYGON ((0 0, 1 0, 1 1, 0.5 3.2e-4, 0 0))');
 st_minimumclearance
---------------------
             0.00032