Name

ST_MinimumClearance — Renvoie la clearance (le dégagement) d'une géométrie, une mesure de la robustesse d'une géométrie.

Synopsis

float ST_MinimumClearance(geometry g);

Description

Il est possible qu'une géométrie réponde aux critères de validité selon ST_IsValid (polygones) ou ST_IsSimple (lignes), mais qu'elle devienne invalide si l'un de ses sommets est déplacé d'une petite distance. Cela peut se produire en raison d'une perte de précision lors de la conversion vers des formats texte (tels que WKT, KML, GML, GeoJSON) ou des formats binaires qui n'utilisent pas de coordonnées en virgule flottante à double précision (par exemple, MapInfo TAB).

La clearance (le dégagement) minimum est une mesure quantitative de la résistance d'une géométrie aux changements de précision des coordonnées. Il s'agit de la plus grande distance à laquelle les sommets de la géométrie peuvent être déplacés sans créer une géométrie invalide. Des valeurs plus élevées de l'espace libre minimum indiquent une plus grande robustesse.

Si une géométrie a un dégagement minimal de e, alors.. :

  • Aucun des deux sommets distincts de la géométrie n'est plus proche que la distance e.

  • Aucun sommet n'est plus proche que e d'un segment de ligne dont il n'est pas l'extrémité.

S'il n'existe pas de dégagement minimum pour une géométrie (par exemple un point unique ou un MultiPoint dont les points sont identiques), la valeur de retour est Infinity.

Pour éviter les problèmes de validité causés par la perte de précision, ST_ReducePrecision peut réduire la précision des coordonnées tout en s'assurant que la géométrie polygonale reste valide.

Disponibilité : 2.3.0

Exemples

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

Voir aussi

ST_MinimumClearanceLine, ST_IsSimple, ST_IsValid, ST_ReducePrecision