PostGIS  2.5.7dev-r@@SVN_REVISION@@

◆ lwgeom_voronoi_diagram()

LWGEOM* lwgeom_voronoi_diagram ( const LWGEOM g,
const GBOX env,
double  tolerance,
int  output_edges 
)

Take vertices of a geometry and build the Voronoi diagram.

Parameters
gthe input geometry
envan optional envelope for clipping the results
tolerancean optional snapping tolerance for improved robustness
output_edgesif non-zero the result will be a MULTILINESTRING, otherwise it'll be a COLLECTION of polygons.

Definition at line 1872 of file liblwgeom/lwgeom_geos.c.

1873 {
1874  uint32_t num_points = lwgeom_count_vertices(g);
1875  LWGEOM* lwgeom_result;
1876  char is_3d = LW_FALSE;
1877  int srid = lwgeom_get_srid(g);
1878  GEOSCoordSequence* coords;
1879  GEOSGeometry* geos_geom;
1880  GEOSGeometry* geos_env = NULL;
1881  GEOSGeometry* geos_result;
1882 
1883  if (num_points < 2)
1884  {
1886  return lwcollection_as_lwgeom(empty);
1887  }
1888 
1889  initGEOS(lwnotice, lwgeom_geos_error);
1890 
1891  /* Instead of using the standard LWGEOM2GEOS transformer, we read the vertices of the LWGEOM directly and put
1892  * them into a single GEOS CoordinateSeq that can be used to define a LineString. This allows us to process
1893  * geometry types that may not be supported by GEOS, and reduces the memory requirements in cases of many
1894  * geometries with few points (such as LWMPOINT).*/
1895  coords = lwgeom_get_geos_coordseq_2d(g, num_points);
1896  if (!coords) return NULL;
1897 
1898  geos_geom = GEOSGeom_createLineString(coords);
1899  if (!geos_geom)
1900  {
1901  GEOSCoordSeq_destroy(coords);
1902  return NULL;
1903  }
1904 
1905  if (env) geos_env = GBOX2GEOS(env);
1906 
1907  geos_result = GEOSVoronoiDiagram(geos_geom, geos_env, tolerance, output_edges);
1908 
1909  GEOSGeom_destroy(geos_geom);
1910  if (env) GEOSGeom_destroy(geos_env);
1911 
1912  if (!geos_result)
1913  {
1914  lwerror("GEOSVoronoiDiagram: %s", lwgeom_geos_errmsg);
1915  return NULL;
1916  }
1917 
1918  lwgeom_result = GEOS2LWGEOM(geos_result, is_3d);
1919  GEOSGeom_destroy(geos_result);
1920 
1921  lwgeom_set_srid(lwgeom_result, srid);
1922 
1923  return lwgeom_result;
1924 }
char lwgeom_geos_errmsg[LWGEOM_GEOS_ERRMSG_MAXSIZE]
GEOSGeometry * GBOX2GEOS(const GBOX *box)
LWGEOM * GEOS2LWGEOM(const GEOSGeometry *geom, uint8_t want3d)
void lwgeom_geos_error(const char *fmt,...)
static GEOSCoordSequence * lwgeom_get_geos_coordseq_2d(const LWGEOM *g, uint32_t num_points)
#define LW_FALSE
Definition: liblwgeom.h:77
LWGEOM * lwcollection_as_lwgeom(const LWCOLLECTION *obj)
Definition: lwgeom.c:300
#define COLLECTIONTYPE
Definition: liblwgeom.h:91
int32_t lwgeom_get_srid(const LWGEOM *geom)
Return SRID number.
Definition: lwgeom.c:916
LWCOLLECTION * lwcollection_construct_empty(uint8_t type, int srid, char hasz, char hasm)
Definition: lwcollection.c:94
uint32_t lwgeom_count_vertices(const LWGEOM *geom)
Count the total number of vertices in any LWGEOM.
Definition: lwgeom.c:1235
void lwgeom_set_srid(LWGEOM *geom, int srid)
Set the SRID on an LWGEOM For collections, only the parent gets an SRID, all the children get SRID_UN...
void lwerror(const char *fmt,...)
Write a notice out to the error handler.
Definition: lwutil.c:190
void lwnotice(const char *fmt,...)
Write a notice out to the notice handler.
Definition: lwutil.c:177
unsigned int uint32_t
Definition: uthash.h:78

References COLLECTIONTYPE, GBOX2GEOS(), GEOS2LWGEOM(), LW_FALSE, lwcollection_as_lwgeom(), lwcollection_construct_empty(), lwerror(), lwgeom_count_vertices(), lwgeom_geos_errmsg, lwgeom_geos_error(), lwgeom_get_geos_coordseq_2d(), lwgeom_get_srid(), lwgeom_set_srid(), and lwnotice().

Referenced by ST_Voronoi(), test_lwgeom_voronoi_diagram(), and test_lwgeom_voronoi_diagram_custom_envelope().

Here is the call graph for this function:
Here is the caller graph for this function: