ST_Aggr_ConvexHull

NoteNote:

Oracle and SQLite only

Definition

ST_Aggr_ConvexHull creates a single geometry that is a convex hull of a geometry that resulted from a union of all input geometries. In effect, ST_Aggr_ConvexHull is equivalent to ST_ConvexHull(ST_Aggr_Union(geometries)).

Syntax

Oracle

sde.st_aggr_convexhull (geometry sde.st_geometry)

SQLite

st_aggr_convexhull (geometry st_geometry)

Return type

Oracle

ST_Geometry

SQLite

Geometryblob

Example

The example creates a service_territories table and executes a SELECT statement that aggregates all the geometries, thereby generating a single geometry representing the convex hull of the union of all the shapes.

Oracle

CREATE TABLE service_territories 
 (ID integer not null, UNITS number, SHAPE sde.st_geometry);

INSERT INTO service_territories (id, units, shape) VALUES (
 1, 
 1250, 
 sde.st_polygon ('polygon ((20 30, 30 30, 30 40, 20 40, 20 30))', 4326)
);
 
INSERT INTO service_territories (id, units, shape) VALUES (
 2, 
 875, 
 sde.st_polygon ('polygon ((30 30, 30 50, 50 50, 50 30, 30 30))', 4326)
);
 
INSERT INTO service_territories (id, units, shape) VALUES (
 3, 
 1700, 
 sde.st_polygon ('polygon ((40 40, 40 60, 60 60, 60 40, 40 40))', 4326)
);

SELECT sde.st_astext(sde.st_aggr_convexhull(shape)) CONVEX_HULL
 FROM service_territories 
 WHERE units >= 1000;

CONVEX_HULL

POLYGON  (( 20.00000000 40.00000000, 20.00000000 30.00000000, 30.00000000 30.00000000, 
60.00000000 40.00000000, 60.00000000 60.00000000, 40.00000000 60.00000000, 20.00000000 40.00000000))

SQLite

CREATE TABLE service_territories (
  ID integer primary key autoincrement not null, 
  UNITS numeric
);

SELECT AddGeometryColumn(
 NULL,
 'service_territories',
 'shape',
 4326,
 'polygon',
 'xy',
 'null'
);

INSERT INTO service_territories (units, shape) VALUES (
 1250, 
 st_polygon ('polygon ((20 30, 30 30, 30 40, 20 40, 20 30))', 4326)
);
 
INSERT INTO service_territories (units, shape) VALUES (
 875, 
 st_polygon ('polygon ((30 30, 30 50, 50 50, 50 30, 30 30))', 4326)
);
 
INSERT INTO service_territories (units, shape) VALUES (
 1700, 
 st_polygon ('polygon ((40 40, 40 60, 60 60, 60 40, 40 40))', 4326)
);

SELECT st_astext(st_aggr_convexhull(shape)) AS "CONVEX HULL"
 FROM service_territories 
 WHERE units >= 1000;

CONVEX HULL

POLYGON  (( 20.00000000 40.00000000, 20.00000000 30.00000000, 30.00000000 30.00000000, 
60.00000000 40.00000000, 60.00000000 60.00000000, 40.00000000 60.00000000, 20.00000000 40.00000000))

Related Topics

6/19/2015