VEX Dictionary / nearpoints
nearpoints
Lists the point numbers nearest to a position, closest first, within a search radius.
group: geopointproximity
Available in every context
Usage
int[] nearpoints(<geometry>, vector pt, float maxdist)
int[] nearpoints(<geometry>, vector pt, float maxdist, int maxpts)
int[] nearpoints(<geometry>, string ptgroup, vector pt, float maxdist)
int[] nearpoints(<geometry>, string ptgroup, vector pt, float maxdist, int maxpts)
Examples
// Point Wrangle, run over Points
int pts[] = nearpoints(0, @P, chf("radius"), chi("maxpts"));
foreach (int pt; pts) {
if (pt <= @ptnum) continue; // one line per pair
addprim(0, "polyline", @ptnum, pt);
}nearpoints returns point numbers sorted from nearest to farthest, and includes the point itself. Skipping pt <= @ptnum avoids building each line twice.
Use cases
- Plexus and web effects Build lines between nearby points.
- Neighbour lookups When you need the point numbers themselves rather than a filtered average.
Signatures (from vcc -X)
int[] nearpoints(int, string, vector, float)all contextsint[] nearpoints(int, string, vector, float, int)all contextsint[] nearpoints(int, vector, float)all contextsint[] nearpoints(int, vector, float, int)all contextsint[] nearpoints(string, string, vector, float)all contextsint[] nearpoints(string, string, vector, float, int)all contextsint[] nearpoints(string, vector, float)all contextsint[] nearpoints(string, vector, float, int)all contexts