kd-tree

Outdated egg!

This is an egg for CHICKEN 4, the unsupported old release. You're almost certainly looking for the CHICKEN 5 version of this egg, if it exists.

If it does not exist, there may be equivalent functionality provided by another egg; have a look at the egg index. Otherwise, please consider porting this egg to the current version of CHICKEN.

Documentation

This library implements a k-d tree, a data structure for organizing and searching points in k-dimensional space.

The k-d tree is a binary search tree in which every branching node contains a k-dimensional point, and every leaf node contains a set of points. Every branching node represents a splitting hyperplane that divides the space into two parts, known as half-spaces.

Points to the left of the splitting hyperplane are contained in the left subtree of the node and points right of the hyperplane are contained in the right subtree. The splitting hyperplane is chosen so as to be perpendicular to one of the axes in the k-dimensional space. The axis at each branching level is chosen in a round-robin fashion. For instance, in 3-D space, at level 0, the chosen axis is X, so points are divided according to their X-coordinates; at level 1, the chosen axis is Y, so the points are divided according to their Y-coordinates; at the next branch level the chosen axis is Z, and so on.

Point

This library currently only supports points in 3D space.

make-point3d:procedure: 3D point constructor.

point3d?procedure: 3D point predicate.

point3d-xprocedure
point3d-yprocedure
point3d-zprocedure: Accessors for the x,y,z coordinates of a 3D point.

A K-D tree (short for k-dimensional tree) is a space-partitioning data structure for organizing points in a k-dimensional space.

Constructors

list->kd-tree:procedure: Given a list of points, constructs and returns a K-D tree object.

Predicates

kd-tree?procedure: Returns #t if the given object is a K-D tree, #f otherwise.

kd-tree-empty?procedure: Returns #t if the given K-D tree object is empty, #f otherwise.

kd-tree-is-valid?procedure: Checks whether the K-D tree property holds for the given tree. Specifically, it tests that all points in the left subtree lie to the left of the plane, p is on the plane, and all points in the right subtree lie to the right.

kd-tree-all-subtrees-are-valid?procedure: Checks whether the K-D tree property holds for the given tree and all subtrees.

Accessors

kd-tree->listprocedure: Returns a list with the points contained in the tree.

kd-tree->list*procedure: Returns a list where every element has the form (i . p), where i is the relative index of this point, and p is the point.

kd-tree-subtreesprocedure

kd-tree-pointprocedure

4.1-4.8: Using f64vector for internal point representation
4.0-4.1: Added with-distance? flag to kd-tree-near-neighbors
3.2: Bug fix in kd-tree-near-neighbors
2.0: Improvements to internal representation
1.0: Initial release

License

Copyright 2012-2016 Ivan Raikov.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or (at
your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

A full copy of the GPL license can be found at
<http://www.gnu.org/licenses/>.

chickadee » kd-tree

Identifier search

Outdated egg!

kd-tree

TOC »

Usage

Documentation

Point

KD-tree

Constructors

Predicates

Accessors

Combinators

Query procedures

Modifiers

Examples

About this egg

Author

Version history

License

Contents »