void c_csvoro(int, float , float ,
int, int, float , float , float ,
int *, int *, int , int *);
void *c_csvoro (n, rlat, rlon, ni, nf, plat, plon, rc,
nca, numv, nv, ier);
- The number of input data points, n > 2.
- An array containing the latitudes of the input data, expressed in degrees. The first three points must not be collinear (lie on a common great circle).
- An array containing the longitudes of the input data, expressed in degrees.
- The index of the input coordinate for which you want to determine the Voronoi polygon (0 <= ni < n).
- Flag indicating if this is the first call to c_csvoro to retrieve Voronoi polygons for this dataset (1=yes, 0=no). Calls subsequent to the first call for a given dataset are much faster than the first call.
- The latitudes for the vertices of the Voronoi polygons. These are circumcenters of circles passing through the Delaunay triangles. If a coordinate is a boundary point, then the circle may pass through certain "pseudo points" that have been added to the original dataset in order to complete the Voronoi polygon.
- The longitudes for the vertices of the Voronoi polygons.
- Array containing circumradii (arc lengths in degrees of the angle between a circumcenter and its associated triangle vertices).
- *nca is the actual number of circumcenters returned in plat and plon. This number may be larger than n if the input dataset has boundary points, since certain "pseudo points" may have been added to the original dataset in order to complete the Voronoi polygon set.
- *numv is the number of vertices in the Voronoi polygon enclosing the coordinate (rlat[ni],rlon[ni]).
- An array containing numv indices for the Voronoi polygon enclosing the coordinate (rlat[ni],rlon[ni]). The indices returned in this array refer to the coordinates returned in plat and plon. For example, if the integer "j" is an element of the nv array, then (plat[j],plon[j]) is a vertex of the Voronoi polygon enclosing (rlat[ni],rlon[ni]). The indices in nv list out the vertices of the Voronoi polygon in counter-clockwise order.
- An error return value. If *ier is returned as 0, then no errors were detected. If *ier is non-zero, then refer to the error list in the error table for details.
USAGEc_csvoro is called if you want to determine the Voronoi polygons for data randomly positioned on a sphere. Each call to c_csvoro calculates the vertices for the Voronoi polygon surrounding a specified input point.
ACCESSTo use c_csvoro, load the NCAR Graphics library ngmath.
COPYRIGHTCopyright (C) 2000
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.