ST_ ConvexHull

ST_ ConvexHull restituisce una geometria che rappresenta il guscio convesso dei punti non vuoti contenuti nella geometria di input.

Per l'input vuoto, la geometria risultante è la stessa della geometria di input. Per tutti gli input non vuoti, la funzione opera sulla proiezione 2D della geometria di input. Tuttavia, la dimensione della geometria di output dipende dalla dimensione della geometria di input. Più specificamente, quando la geometria di input è una geometria 3DM o 3D non vuota, le coordinate m vengono eliminate. In altre parole, la dimensione della geometria restituita è 2D o 3DZ, rispettivamente. Se l'input è una geometria 2D o 3DZ non vuota, la geometria risultante ha la stessa dimensione.

Sintassi

ST_ConvexHull(geom)

Argomenti

geom

Un valore di tipo GEOMETRY o un'espressione che restituisce un valore di tipo GEOMETRY.

Tipo restituito

GEOMETRY

Il valore dell'identificatore del sistema di riferimento spaziale (SRID) della geometria restituito è il valore SRID della geometria di input.

Se geom è nullo, allora viene restituito il valore nullo.

I valori restituiti sono i seguenti.

Numero di punti sull'inviluppo convesso	Sottotipo dato di tipo geometry
0	Viene restituita una copia di geom.
1	Viene restituito un sottotipo POINT.
2	Viene restituito un sottotipo LINESTRING. I due punti della linestring restituita sono ordinati lessicograficamente.
3 o maggiore	Viene restituito un sottotipo POLYGON senza anelli interni. Il poligono è orientato in senso orario e il primo punto dell'anello esterno è il punto lessicograficamente più piccolo dell'anello.

Esempi

Il seguente SQL restituisce la rappresentazione estesa Well-Known Text (EWKT) di un linestring. In questo caso, l'inviluppo convesso restituito è un poligono.

SELECT ST_AsEWKT(ST_ConvexHull(ST_GeomFromText('LINESTRING(0 0,1 0,0 1,1 1,0.5 0.5)'))) as output;

output
-------------
POLYGON((0 0,0 1,1 1,1 0,0 0))

Il seguente comando SQL restituisce la rappresentazione in formato EWKT di una linestring. In questo caso, l'inviluppo convesso restituito è una linestring.

SELECT ST_AsEWKT(ST_ConvexHull(ST_GeomFromText('LINESTRING(0 0,1 1,0.2 0.2,0.6 0.6,0.5 0.5)'))) as output;

output
-------------
LINESTRING(0 0,1 1)

Il seguente SQL restituisce la rappresentazione EWKT di un multipunto. In questo caso, l'inviluppo convesso restituito è un punto.

SELECT ST_AsEWKT(ST_ConvexHull(ST_GeomFromText('MULTIPOINT(0 0,0 0,0 0)'))) as output;

output
-------------
POINT(0 0)