Quadtree · Lablypedia

The subdivided regions may be square or rectangular, or may have arbitrary shapes. Although similar subdivisions were used much earlier (for instance in the Whitney covering lemma of 1934), this data structure was named a quadtree by Raphael Finkel and J.L. Bentley in 1974. A similar partitioning is also known as a Q-tree.

All forms of quadtrees share some common features:

They decompose space into adaptable cells.
Each cell (or bucket) has a maximum capacity. When maximum capacity is reached, the bucket splits.
The tree directory follows the spatial decomposition of the quadtree.

A tree-pyramid (T-pyramid) is a "complete" tree; every node of the T-pyramid has four child nodes except leaf nodes; all leaves are on the same level, the level that corresponds to individual pixels in the image. The data in a tree-pyramid can be stored compactly in an array as an implicit data structure similar to the way a binary heap can store a complete binary tree compactly in an array.

Types

Quadtrees may be classified according to the type of data they represent, including areas, points, lines and curves. Quadtrees may also be classified by whether the shape of the tree is independent of the order in which data is processed. The following are common types of quadtrees.

Region quadtree

The region quadtree represents a partition of space in two dimensions by decomposing the region into four equal quadrants, subquadrants, and so on with each leaf node containing data corresponding to a specific subregion. It can be also interpreted as a method for "subpaving the region", based on set of hierarchical grids; or as a method of image compression, when an image is discretizated as a mosaic of "equal color regions".

Each node in the tree either has exactly four children, or has no children (a leaf node). The height of quadtrees that follow this decomposition strategy (i.e. subdividing subquadrants as long as there is interesting data in the subquadrant for which more refinement is desired) is sensitive to and dependent on the spatial distribution of interesting areas in the space being decomposed. The region quadtree is a type of trie.

A region quadtree with a depth of n may be used to represent an image consisting of 2ⁿ × 2ⁿ pixels, where each pixel value is 0 or 1. The root node represents the entire image region. If the pixels in any region are not entirely 0s or 1s, it is subdivided. In this application, each leaf node represents a block of pixels that are all 0s or all 1s. Note the potential savings in terms of space when these trees are used for storing images; images often have many regions of considerable size that have the same colour value throughout. Rather than store a big 2-D array of every pixel in the image, a quadtree can capture the same information potentially many divisive levels higher than the pixel-resolution sized cells that we would otherwise require. The tree resolution and overall size is bounded by the pixel and image sizes.

A region quadtree may also be used as a variable resolution representation of a data field. For example, the temperatures in an area may be stored as a quadtree, with each leaf node storing the average temperature over the subregion it represents.

Point quadtree

The point quadtree is an adaptation of a binary tree used to represent two-dimensional point data. It shares the features of all quadtrees but is a true tree as the center of a subdivision is always on a point. It is often very efficient in comparing two-dimensional, ordered data points, usually operating in O(log n) time. Point quadtrees are worth mentioning for completeness, but they have been surpassed by k-d trees as tools for generalized binary search. Point quadtrees with random insertion have been studied under the name weighted planar stochastic lattices.

Point quadtrees are constructed as follows. Given the next point to insert, we find the cell in which it lies and add it to the tree. The new point is added such that the cell that contains it is divided into quadrants by the vertical and horizontal lines that run through the point. Consequently, cells are rectangular but not necessarily square. In these trees, each node contains one of the input points.

Since the division of the plane is decided by the order of point-insertion, the tree's height is sensitive to and dependent on insertion order. Inserting in a "bad" order can lead to a tree of height linear in the number of input points (at which point it becomes a linked-list). If the point-set is static, pre-processing can be done to create a tree of balanced height.

Node structure for a point quadtree

A node of a point quadtree is similar to a node of a binary tree, with the major difference being that it has four pointers (one for each quadrant) instead of two ("left" and "right") as in an ordinary binary tree. Also a key is usually decomposed into two parts, referring to x and y coordinates. Therefore, a node contains the following information:

four pointers: quad['NW'], quad['NE'], quad['SW'], and quad['SE']
point; which in turn contains:
- key; usually expressed as x, y coordinates
- value; for example a name

Point-region (PR) quadtree

Point-region (PR) quadtrees are very similar to region quadtrees. The difference is the type of information stored about the cells. In a region quadtree, a uniform value is stored that applies to the entire area of the cell of a leaf. The cells of a PR quadtree, however, store a list of points that exist within the cell of a leaf. As mentioned previously, for trees following this decomposition strategy the height depends on the spatial distribution of the points. Like the point quadtree, the PR quadtree may also have a linear height when given a "bad" set.

Edge quadtree

Edge quadtrees (much like PM quadtrees) are used to store lines rather than points. Curves are approximated by subdividing cells to a very fine resolution, specifically until there is a single line segment per cell. Near corners/vertices, edge quadtrees will continue dividing until they reach their maximum level of decomposition. This can result in extremely unbalanced trees which may defeat the purpose of indexing.

Polygonal map (PM) quadtree

The polygonal map quadtree (or PM Quadtree) is a variation of quadtree which is used to store collections of polygons that may be degenerate (meaning that they have isolated vertices or edges). A big difference between PM quadtrees and edge quadtrees is that the cell under consideration is not subdivided if the segments meet at a vertex in the cell.

There are three main classes of PM Quadtrees, which vary depending on what information they store within each black node. PM3 quadtrees can store any amount of non-intersecting edges and at most one point. PM2 quadtrees are the same as PM3 quadtrees except that all edges must share the same end point. Finally PM1 quadtrees are similar to PM2, but black nodes can contain a point and its edges or just a set of edges that share a point, but you cannot have a point and a set of edges that do not contain the point.

Compressed quadtrees

This section summarizes a subsection from a book by Sariel Har-Peled.

If we were to store every node corresponding to a subdivided cell, we may end up storing a lot of empty nodes. We can cut down on the size of such sparse trees by only storing subtrees whose leaves have interesting data (i.e. "important subtrees"). We can actually cut down on the size even further. When we only keep important subtrees, the pruning process may leave long paths in the tree where the intermediate nodes have degree two (a link to one parent and one child). It turns out that we only need to store the node $u$ at the beginning of this path (and associate some meta-data with it to represent the removed nodes) and attach the subtree rooted at its end to $u$ . It is still possible for these compressed trees to have a linear height when given "bad" input points.

Although we trim a lot of the tree when we perform this compression, it is still possible to achieve logarithmic-time search, insertion, and deletion by taking advantage of Z-order curves. The Z-order curve maps each cell of the full quadtree (and hence even the compressed quadtree) in $O (1)$ time to a one-dimensional line (and maps it back in $O (1)$ time too), creating a total order on the elements. Therefore, we can store the quadtree in a data structure for ordered sets (in which we store the nodes of the tree).

We must state a reasonable assumption before we continue: we assume that given two real numbers $α, β \in [0, 1)$ expressed as binary, we can compute in $O (1)$ time the index of the first bit in which they differ. We also assume that we can compute in $O (1)$ time the lowest common ancestor of two points/cells in the quadtree and establish their relative Z-ordering, and we can compute the floor function in $O (1)$ time.

With these assumptions, point location of a given point $q$ (i.e. determining the cell that would contain $q$ ), insertion, and deletion operations can all be performed in $O (\log n)$ time (i.e. the time it takes to do a search in the underlying ordered set data structure).

To perform a point location for $q$ (i.e. find its cell in the compressed tree):

Find the existing cell in the compressed tree that comes before $q$ in the Z-order. Call this cell $v$ .
If $q \in v$ , return $v$ .
Else, find what would have been the lowest common ancestor of the point $q$ and the cell $v$ in an uncompressed quadtree. Call this ancestor cell $u$ .
Find the existing cell in the compressed tree that comes before $u$ in the Z-order and return it.

Without going into specific details, to perform insertions and deletions we first do a point location for the thing we want to insert/delete, and then insert/delete it. Care must be taken to reshape the tree as appropriate, creating and removing nodes as needed.

4 more chapters are free with a Lably account.

Some common uses of quadtrees

Image representation
Image processing
Mesh generation
Spatial indexing, point location queries, and range queries
Efficient collision detection in two dimensions
View frustum culling of terrain data
Storing sparse data, such as a formatting information for a spreadsheet or for some matrix calculations
Solution of multidimensional fields (computational fluid dynamics, electromagnetism)
Conway's Game of Life simulation program.
State estimation
Fractal image analysis
Maximum disjoint sets

Image processing using quadtrees

Quadtrees, particularly the region quadtree, have lent themselves well to image processing applications. We will limit our discussion to binary image data, though region quadtrees and the image processing operations performed on them are just as suitable for colour images.

Image union / intersection

One of the advantages of using quadtrees for image manipulation is that the set operations of union and intersection can be done simply and quickly. Given two binary images, the image union (also called overlay) produces an image wherein a pixel is black if either of the input images has a black pixel in the same location. That is, a pixel in the output image is white only when the corresponding pixel in both input images is white, otherwise the output pixel is black. Rather than do the operation pixel by pixel, we can compute the union more efficiently by leveraging the quadtree's ability to represent multiple pixels with a single node. For the purposes of discussion below, if a subtree contains both black and white pixels we will say that the root of that subtree is coloured grey.

The algorithm works by traversing the two input quadtrees ( $T_{1}$ and $T_{2}$ ) while building the output quadtree $T$ . Informally, the algorithm is as follows. Consider the nodes $v_{1} \in T_{1}$ and $v_{2} \in T_{2}$ corresponding to the same region in the images.

If $v_{1}$ or $v_{2}$ is black, the corresponding node is created in $T$ and is colored black. If only one of them is black and the other is gray, the gray node will contain a subtree underneath. This subtree need not be traversed.
If $v_{1}$ (respectively, $v_{2}$ ) is white, $v_{2}$ (respectively, $v_{1}$ ) and the subtree underneath it (if any) is copied to $T$ .
If both $v_{1}$ and $v_{2}$ are gray, then the corresponding children of $v_{1}$ and $v_{2}$ are considered.

While this algorithm works, it does not by itself guarantee a minimally sized quadtree. For example, consider the result if we were to union a checkerboard (where every tile is a pixel) of size $2^{k} \times 2^{k}$ with its complement. The result is a giant black square which should be represented by a quadtree with just the root node (coloured black), but instead the algorithm produces a full 4-ary tree of depth $k$ . To fix this, we perform a bottom-up traversal of the resulting quadtree where we check if the four children nodes have the same colour, in which case we replace their parent with a leaf of the same colour.

The intersection of two images is almost the same algorithm. One way to think about the intersection of the two images is that we are doing a union with respect to the white pixels. As such, to perform the intersection we swap the mentions of black and white in the union algorithm.

Connected component labelling

Consider two neighbouring black pixels in a binary image. They are adjacent if they share a bounding horizontal or vertical edge. In general, two black pixels are connected if one can be reached from the other by moving only to adjacent pixels (i.e. there is a path of black pixels between them where each consecutive pair is adjacent). Each maximal set of connected black pixels is a connected component. Using the quadtree representation of images, Samet showed how we can find and label these connected components in time proportional to the size of the quadtree. This algorithm can also be used for polygon colouring.

The algorithm works in three steps:

establish the adjacency relationships between black pixels
process the equivalence relations from the first step to obtain one unique label for each connected component
label the black pixels with the label associated with their connected component

To simplify the discussion, let us assume the children of a node in the quadtree follow the Z-order (SW, NW, SE, NE). Since we can count on this structure, for any cell we know how to navigate the quadtree to find the adjacent cells in the different levels of the hierarchy.

Step one is accomplished with a post-order traversal of the quadtree. For each black leaf $v$ we look at the node or nodes representing cells that are Northern neighbours and Eastern neighbours (i.e. the Northern and Eastern cells that share edges with the cell of $v$ ). Since the tree is organized in Z-order, we have the invariant that the Southern and Western neighbours have already been taken care of and accounted for. Let the Northern or Eastern neighbour currently under consideration be $u$ . If $u$ represents black pixels:

If only one of $u$ or $v$ has a label, assign that label to the other cell
If neither of them have labels, create one and assign it to both of them
If $u$ and $v$ have different labels, record this label equivalence and move on

Step two can be accomplished using the union-find data structure. We start with each unique label as a separate set. For every equivalence relation noted in the first step, we union the corresponding sets. Afterwards, each distinct remaining set will be associated with a distinct connected component in the image.

Step three performs another post-order traversal. This time, for each black node $v$ we use the union-find's find operation (with the old label of $v$ ) to find and assign $v$ its new label (associated with the connected component of which $v$ is part).

Mesh generation using quadtrees

This section summarizes a chapter from a book by Har-Peled and de Berg et al.

Mesh generation is essentially the triangulation of a point set for which further processing may be performed. As such, it is desirable for the resulting triangulation to have certain properties (like non-uniformity, triangles that are not "too skinny", large triangles in sparse areas and small triangles in dense ones, etc.) to make further processing quicker and less error-prone. Quadtrees built on the point set can be used to create meshes with these desired properties.

Consider a leaf of the quadtree and its corresponding cell $v$ . We say $v$ is balanced (for mesh generation) if the cell's sides are intersected by the corner points of neighbouring cells at most once on each side. This means that the quadtree levels of leaves adjacent to $v$ differ by at most one from the level of $v$ . When this is true for all leaves, we say the whole quadtree is balanced (for mesh generation).

Consider the cell $v$ and the $5 \times 5$ neighbourhood of same-sized cells centred at $v$ . We call this neighbourhood the extended cluster. We say the quadtree is well-balanced if it is balanced, and for every leaf $u$ that contains a point of the point set, its extended cluster is also in the quadtree and the extended cluster contains no other point of the point set.

Creating the mesh is done as follows:

Build a quadtree on the input points.
Ensure the quadtree is balanced. For every leaf, if there is a neighbour that is too large, subdivide the neighbour. This is repeated until the tree is balanced. We also make sure that for a leaf with a point in it, the nodes for each leaf's extended cluster are in the tree.
For every leaf node $v$ that contains a point, if the extended cluster contains another point, we further subdivide the tree and rebalance as necessary. If we needed to subdivide, for each child $u$ of $v$ we ensure the nodes of $u$ 's extended cluster are in the tree (and re-balance as required).
Repeat the previous step until the tree is well-balanced.
Transform the quadtree into a triangulation.

We consider the corner points of the tree cells as vertices in our triangulation. Before the transformation step we have a bunch of boxes with points in some of them. The transformation step is done in the following manner: for each point, warp the closest corner of its cell to meet it and triangulate the resulting four quadrangles to make "nice" triangles (the interested reader is referred to chapter 12 of Har-Peled for more details on what makes "nice" triangles).

The remaining squares are triangulated according to some simple rules. For each regular square (no points within and no corner points in its sides), introduce the diagonal. Due to the way in which we separated points with the well-balancing property, no square with a corner intersecting a side is one that was warped. As such, we can triangulate squares with intersecting corners as follows. If there is one intersected side, the square becomes three triangles by adding the long diagonals connecting the intersection with opposite corners. If there are four intersected sides, we split the square in half by adding an edge between two of the four intersections, and then connect these two endpoints to the remaining two intersection points. For the other squares, we introduce a point in the middle and connect it to all four corners of the square as well as each intersection point.

The resulting triangulation forms a well-shaped mesh of the input point set, constructed from the structure of the quadtree.

Pseudocode

The following pseudo code shows one means of implementing a quadtree which handles only points. There are other approaches available.

Prerequisites

It is assumed these structures are used.

<span id="mwAYY"></span><span class="w" id="mwAYc"> </span><span class="c1" id="mwAYg">// Simple coordinate object to represent points and vectors</span> <span class="w" id="mwAYk"> </span><span class="k" id="mwAYo">struct</span><span class="w" id="mwAYs"> </span><span class="nc" id="mwAYw">XY</span> <span class="w" id="mwAY0"> </span><span class="p" id="mwAY4">{</span> <span class="w" id="mwAY8"> </span><span class="kt" id="mwAZA">float</span><span class="w" id="mwAZE"> </span><span class="n" id="mwAZI">x</span><span class="p" id="mwAZM">;</span> <span class="w" id="mwAZQ"> </span><span class="kt" id="mwAZU">float</span><span class="w" id="mwAZY"> </span><span class="n" id="mwAZc">y</span><span class="p" id="mwAZg">;</span> <span class="w" id="mwAZk"> </span> <span class="w" id="mwAZo"> </span><span class="n" id="mwAZs">function</span><span class="w" id="mwAZw"> </span><span class="nf" id="mwAZ0">__construct</span><span class="p" id="mwAZ4">(</span><span class="kt" id="mwAZ8">float</span><span class="w" id="mwAaA"> </span><span class="n" id="mwAaE">_x</span><span class="p" id="mwAaI">,</span><span class="w" id="mwAaM"> </span><span class="kt" id="mwAaQ">float</span><span class="w" id="mwAaU"> </span><span class="n" id="mwAaY">_y</span><span class="p" id="mwAac">)</span><span class="w" id="mwAag"> </span><span class="p" id="mwAak">{...}</span> <span class="w" id="mwAao"> </span><span class="p" id="mwAas">}</span> <span class="w" id="mwAaw"> </span> <span class="w" id="mwAa0"> </span><span class="c1" id="mwAa4">// Axis-aligned bounding box with half dimension and center</span> <span class="w" id="mwAa8"> </span><span class="k" id="mwAbA">struct</span><span class="w" id="mwAbE"> </span><span class="nc" id="mwAbI">AABB</span> <span class="w" id="mwAbM"> </span><span class="p" id="mwAbQ">{</span> <span class="w" id="mwAbU"> </span><span class="n" id="mwAbY">XY</span><span class="w" id="mwAbc"> </span><span class="n" id="mwAbg">center</span><span class="p" id="mwAbk">;</span> <span class="w" id="mwAbo"> </span><span class="kt" id="mwAbs">float</span><span class="w" id="mwAbw"> </span><span class="n" id="mwAb0">halfDimension</span><span class="p" id="mwAb4">;</span> <span class="w" id="mwAb8"> </span> <span class="w" id="mwAcA"> </span><span class="n" id="mwAcE">function</span><span class="w" id="mwAcI"> </span><span class="nf" id="mwAcM">__construct</span><span class="p" id="mwAcQ">(</span><span class="n" id="mwAcU">XY</span><span class="w" id="mwAcY"> </span><span class="n" id="mwAcc">_center</span><span class="p" id="mwAcg">,</span><span class="w" id="mwAck"> </span><span class="kt" id="mwAco">float</span><span class="w" id="mwAcs"> </span><span class="n" id="mwAcw">_halfDimension</span><span class="p" id="mwAc0">)</span><span class="w" id="mwAc4"> </span><span class="p" id="mwAc8">{...}</span> <span class="w" id="mwAdA"> </span><span class="n" id="mwAdE">function</span><span class="w" id="mwAdI"> </span><span class="nf" id="mwAdM">containsPoint</span><span class="p" id="mwAdQ">(</span><span class="n" id="mwAdU">XY</span><span class="w" id="mwAdY"> </span><span class="n" id="mwAdc">point</span><span class="p" id="mwAdg">)</span><span class="w" id="mwAdk"> </span><span class="p" id="mwAdo">{...}</span> <span class="w" id="mwAds"> </span><span class="n" id="mwAdw">function</span><span class="w" id="mwAd0"> </span><span class="nf" id="mwAd4">intersectsAABB</span><span class="p" id="mwAd8">(</span><span class="n" id="mwAeA">AABB</span><span class="w" id="mwAeE"> </span><span class="n" id="mwAeI">other</span><span class="p" id="mwAeM">)</span><span class="w" id="mwAeQ"> </span><span class="p" id="mwAeU">{...}</span> <span class="w" id="mwAeY"> </span><span class="p" id="mwAec">}</span>

QuadTree class

This class represents both one quad tree and the node where it is rooted.

<span id="mwAew"></span><span class="w" id="mwAe0"> </span><span class="k" id="mwAe4">class</span><span class="w" id="mwAe8"> </span><span class="nc" id="mwAfA">QuadTree</span> <span class="w" id="mwAfE"> </span><span class="p" id="mwAfI">{</span> <span class="w" id="mwAfM"> </span><span class="c1" id="mwAfQ">// Arbitrary constant to indicate how many elements can be stored in this quad tree node</span> <span class="w" id="mwAfU"> </span><span class="n" id="mwAfY">constant</span><span class="w" id="mwAfc"> </span><span class="kt" id="mwAfg">int</span><span class="w" id="mwAfk"> </span><span class="n" id="mwAfo">QT_NODE_CAPACITY</span><span class="w" id="mwAfs"> </span><span class="o" id="mwAfw">=</span><span class="w" id="mwAf0"> </span><span class="mi" id="mwAf4">4</span><span class="p" id="mwAf8">;</span> <span class="w" id="mwAgA"> </span> <span class="w" id="mwAgE"> </span><span class="c1" id="mwAgI">// Axis-aligned bounding box stored as a center with half-dimensions</span> <span class="w" id="mwAgM"> </span><span class="c1" id="mwAgQ">// to represent the boundaries of this quad tree</span> <span class="w" id="mwAgU"> </span><span class="n" id="mwAgY">AABB</span><span class="w" id="mwAgc"> </span><span class="n" id="mwAgg">boundary</span><span class="p" id="mwAgk">;</span> <span class="w" id="mwAgo"> </span> <span class="w" id="mwAgs"> </span><span class="c1" id="mwAgw">// Points in this quad tree node</span> <span class="w" id="mwAg0"> </span><span class="n" id="mwAg4">Array</span><span class="w" id="mwAg8"> </span><span class="n" id="mwAhA">of</span><span class="w" id="mwAhE"> </span><span class="n" id="mwAhI">XY</span><span class="w" id="mwAhM"> </span><span class="p" id="mwAhQ">[</span><span class="n" id="mwAhU">size</span><span class="w" id="mwAhY"> </span><span class="o" id="mwAhc">=</span><span class="w" id="mwAhg"> </span><span class="n" id="mwAhk">QT_NODE_CAPACITY</span><span class="p" id="mwAho">]</span><span class="w" id="mwAhs"> </span><span class="n" id="mwAhw">points</span><span class="p" id="mwAh0">;</span> <span class="w" id="mwAh4"> </span> <span class="w" id="mwAh8"> </span><span class="c1" id="mwAiA">// Children</span> <span class="w" id="mwAiE"> </span><span class="n" id="mwAiI">QuadTree</span><span class="o" id="mwAiM">*</span><span class="w" id="mwAiQ"> </span><span class="n" id="mwAiU">northWest</span><span class="p" id="mwAiY">;</span> <span class="w" id="mwAic"> </span><span class="n" id="mwAig">QuadTree</span><span class="o" id="mwAik">*</span><span class="w" id="mwAio"> </span><span class="n" id="mwAis">northEast</span><span class="p" id="mwAiw">;</span> <span class="w" id="mwAi0"> </span><span class="n" id="mwAi4">QuadTree</span><span class="o" id="mwAi8">*</span><span class="w" id="mwAjA"> </span><span class="n" id="mwAjE">southWest</span><span class="p" id="mwAjI">;</span> <span class="w" id="mwAjM"> </span><span class="n" id="mwAjQ">QuadTree</span><span class="o" id="mwAjU">*</span><span class="w" id="mwAjY"> </span><span class="n" id="mwAjc">southEast</span><span class="p" id="mwAjg">;</span> <span class="w" id="mwAjk"> </span> <span class="w" id="mwAjo"> </span><span class="c1" id="mwAjs">// Methods</span> <span class="w" id="mwAjw"> </span><span class="n" id="mwAj0">function</span><span class="w" id="mwAj4"> </span><span class="nf" id="mwAj8">__construct</span><span class="p" id="mwAkA">(</span><span class="n" id="mwAkE">AABB</span><span class="w" id="mwAkI"> </span><span class="n" id="mwAkM">_boundary</span><span class="p" id="mwAkQ">)</span><span class="w" id="mwAkU"> </span><span class="p" id="mwAkY">{...}</span> <span class="w" id="mwAkc"> </span><span class="n" id="mwAkg">function</span><span class="w" id="mwAkk"> </span><span class="nf" id="mwAko">insert</span><span class="p" id="mwAks">(</span><span class="n" id="mwAkw">XY</span><span class="w" id="mwAk0"> </span><span class="n" id="mwAk4">p</span><span class="p" id="mwAk8">)</span><span class="w" id="mwAlA"> </span><span class="p" id="mwAlE">{...}</span> <span class="w" id="mwAlI"> </span><span class="n" id="mwAlM">function</span><span class="w" id="mwAlQ"> </span><span class="nf" id="mwAlU">subdivide</span><span class="p" id="mwAlY">()</span><span class="w" id="mwAlc"> </span><span class="p" id="mwAlg">{...}</span><span class="w" id="mwAlk"> </span><span class="c1" id="mwAlo">// create four children that fully divide this quad into four quads of equal area</span> <span class="w" id="mwAls"> </span><span class="n" id="mwAlw">function</span><span class="w" id="mwAl0"> </span><span class="nf" id="mwAl4">queryRange</span><span class="p" id="mwAl8">(</span><span class="n" id="mwAmA">AABB</span><span class="w" id="mwAmE"> </span><span class="n" id="mwAmI">range</span><span class="p" id="mwAmM">)</span><span class="w" id="mwAmQ"> </span><span class="p" id="mwAmU">{...}</span> <span class="w" id="mwAmY"> </span><span class="p" id="mwAmc">}</span>

Insertion

The following method inserts a point into the appropriate quad of a quadtree, splitting if necessary.

<span id="mwAmw"></span><span class="w" id="mwAm0"> </span><span class="k" id="mwAm4">class</span><span class="w" id="mwAm8"> </span><span class="nc" id="mwAnA">QuadTree</span> <span class="w" id="mwAnE"> </span><span class="p" id="mwAnI">{</span> <span class="w" id="mwAnM"> </span><span class="p" id="mwAnQ">...</span> <span class="w" id="mwAnU"> </span> <span class="w" id="mwAnY"> </span><span class="c1" id="mwAnc">// Insert a point into the QuadTree</span> <span class="w" id="mwAng"> </span><span class="n" id="mwAnk">function</span><span class="w" id="mwAno"> </span><span class="n" id="mwAns">insert</span><span class="p" id="mwAnw">(</span><span class="n" id="mwAn0">XY</span><span class="w" id="mwAn4"> </span><span class="n" id="mwAn8">p</span><span class="p" id="mwAoA">)</span> <span class="w" id="mwAoE"> </span><span class="p" id="mwAoI">{</span> <span class="w" id="mwAoM"> </span><span class="c1" id="mwAoQ">// Ignore objects that do not belong in this quad tree</span> <span class="w" id="mwAoU"> </span><span class="k" id="mwAoY">if</span><span class="w" id="mwAoc"> </span><span class="p" id="mwAog">(</span><span class="o" id="mwAok">!</span><span class="n" id="mwAoo">boundary</span><span class="p" id="mwAos">.</span><span class="n" id="mwAow">containsPoint</span><span class="p" id="mwAo0">(</span><span class="n" id="mwAo4">p</span><span class="p" id="mwAo8">))</span> <span class="w" id="mwApA"> </span><span class="k" id="mwApE">return</span><span class="w" id="mwApI"> </span><span class="nb" id="mwApM">false</span><span class="p" id="mwApQ">;</span><span class="w" id="mwApU"> </span><span class="c1" id="mwApY">// object cannot be added</span> <span class="w" id="mwApc"> </span> <span class="w" id="mwApg"> </span><span class="c1" id="mwApk">// If there is space in this quad tree and if it doesn't have subdivisions, add the object here</span> <span class="w" id="mwApo"> </span><span class="k" id="mwAps">if</span><span class="w" id="mwApw"> </span><span class="p" id="mwAp0">(</span><span class="n" id="mwAp4">points</span><span class="p" id="mwAp8">.</span><span class="n" id="mwAqA">size</span><span class="w" id="mwAqE"> </span><span class="o" id="mwAqI"><</span><span class="w" id="mwAqM"> </span><span class="n" id="mwAqQ">QT_NODE_CAPACITY</span><span class="w" id="mwAqU"> </span><span class="o" id="mwAqY">&&</span><span class="w" id="mwAqc"> </span><span class="n" id="mwAqg">northWest</span><span class="w" id="mwAqk"> </span><span class="o" id="mwAqo">==</span><span class="w" id="mwAqs"> </span><span class="n" id="mwAqw">null</span><span class="p" id="mwAq0">)</span> <span class="w" id="mwAq4"> </span><span class="p" id="mwAq8">{</span> <span class="w" id="mwArA"> </span><span class="n" id="mwArE">points</span><span class="p" id="mwArI">.</span><span class="n" id="mwArM">append</span><span class="p" id="mwArQ">(</span><span class="n" id="mwArU">p</span><span class="p" id="mwArY">);</span> <span class="w" id="mwArc"> </span><span class="k" id="mwArg">return</span><span class="w" id="mwArk"> </span><span class="nb" id="mwAro">true</span><span class="p" id="mwArs">;</span> <span class="w" id="mwArw"> </span><span class="p" id="mwAr0">}</span> <span class="w" id="mwAr4"> </span> <span class="w" id="mwAr8"> </span><span class="c1" id="mwAsA">// Otherwise, subdivide and then add the point to whichever node will accept it</span> <span class="w" id="mwAsE"> </span><span class="k" id="mwAsI">if</span><span class="w" id="mwAsM"> </span><span class="p" id="mwAsQ">(</span><span class="n" id="mwAsU">northWest</span><span class="w" id="mwAsY"> </span><span class="o" id="mwAsc">==</span><span class="w" id="mwAsg"> </span><span class="n" id="mwAsk">null</span><span class="p" id="mwAso">)</span> <span class="w" id="mwAss"> </span><span class="n" id="mwAsw">subdivide</span><span class="p" id="mwAs0">();</span> <span class="w" id="mwAs4"> </span><span class="c1" id="mwAs8">// We have to add the points/data contained in this quad array to the new quads if we only want</span> <span class="w" id="mwAtA"> </span><span class="c1" id="mwAtE">// the last node to hold the data</span> <span class="w" id="mwAtI"> </span> <span class="w" id="mwAtM"> </span><span class="k" id="mwAtQ">if</span><span class="w" id="mwAtU"> </span><span class="p" id="mwAtY">(</span><span class="n" id="mwAtc">northWest</span><span class="o" id="mwAtg">-></span><span class="n" id="mwAtk">insert</span><span class="p" id="mwAto">(</span><span class="n" id="mwAts">p</span><span class="p" id="mwAtw">))</span><span class="w" id="mwAt0"> </span><span class="k" id="mwAt4">return</span><span class="w" id="mwAt8"> </span><span class="nb" id="mwAuA">true</span><span class="p" id="mwAuE">;</span> <span class="w" id="mwAuI"> </span><span class="k" id="mwAuM">if</span><span class="w" id="mwAuQ"> </span><span class="p" id="mwAuU">(</span><span class="n" id="mwAuY">northEast</span><span class="o" id="mwAuc">-></span><span class="n" id="mwAug">insert</span><span class="p" id="mwAuk">(</span><span class="n" id="mwAuo">p</span><span class="p" id="mwAus">))</span><span class="w" id="mwAuw"> </span><span class="k" id="mwAu0">return</span><span class="w" id="mwAu4"> </span><span class="nb" id="mwAu8">true</span><span class="p" id="mwAvA">;</span> <span class="w" id="mwAvE"> </span><span class="k" id="mwAvI">if</span><span class="w" id="mwAvM"> </span><span class="p" id="mwAvQ">(</span><span class="n" id="mwAvU">southWest</span><span class="o" id="mwAvY">-></span><span class="n" id="mwAvc">insert</span><span class="p" id="mwAvg">(</span><span class="n" id="mwAvk">p</span><span class="p" id="mwAvo">))</span><span class="w" id="mwAvs"> </span><span class="k" id="mwAvw">return</span><span class="w" id="mwAv0"> </span><span class="nb" id="mwAv4">true</span><span class="p" id="mwAv8">;</span> <span class="w" id="mwAwA"> </span><span class="k" id="mwAwE">if</span><span class="w" id="mwAwI"> </span><span class="p" id="mwAwM">(</span><span class="n" id="mwAwQ">southEast</span><span class="o" id="mwAwU">-></span><span class="n" id="mwAwY">insert</span><span class="p" id="mwAwc">(</span><span class="n" id="mwAwg">p</span><span class="p" id="mwAwk">))</span><span class="w" id="mwAwo"> </span><span class="k" id="mwAws">return</span><span class="w" id="mwAww"> </span><span class="nb" id="mwAw0">true</span><span class="p" id="mwAw4">;</span> <span class="w" id="mwAw8"> </span> <span class="w" id="mwAxA"> </span><span class="c1" id="mwAxE">// Otherwise, the point cannot be inserted for some unknown reason (this should never happen)</span> <span class="w" id="mwAxI"> </span><span class="k" id="mwAxM">return</span><span class="w" id="mwAxQ"> </span><span class="nb" id="mwAxU">false</span><span class="p" id="mwAxY">;</span> <span class="w" id="mwAxc"> </span><span class="p" id="mwAxg">}</span> <span class="w" id="mwAxk"> </span><span class="p" id="mwAxo">}</span>

Query range

The following method finds all points contained within a range.

<span id="mwAx8"></span><span class="w" id="mwAyA"> </span><span class="k" id="mwAyE">class</span><span class="w" id="mwAyI"> </span><span class="nc" id="mwAyM">QuadTree</span> <span class="w" id="mwAyQ"> </span><span class="p" id="mwAyU">{</span> <span class="w" id="mwAyY"> </span><span class="p" id="mwAyc">...</span> <span class="w" id="mwAyg"> </span> <span class="w" id="mwAyk"> </span><span class="c1" id="mwAyo">// Find all points that appear within a range</span> <span class="w" id="mwAys"> </span><span class="n" id="mwAyw">function</span><span class="w" id="mwAy0"> </span><span class="n" id="mwAy4">queryRange</span><span class="p" id="mwAy8">(</span><span class="n" id="mwAzA">AABB</span><span class="w" id="mwAzE"> </span><span class="n" id="mwAzI">range</span><span class="p" id="mwAzM">)</span> <span class="w" id="mwAzQ"> </span><span class="p" id="mwAzU">{</span> <span class="w" id="mwAzY"> </span><span class="c1" id="mwAzc">// Prepare an array of results</span> <span class="w" id="mwAzg"> </span><span class="n" id="mwAzk">Array</span><span class="w" id="mwAzo"> </span><span class="n" id="mwAzs">of</span><span class="w" id="mwAzw"> </span><span class="n" id="mwAz0">XY</span><span class="w" id="mwAz4"> </span><span class="n" id="mwAz8">pointsInRange</span><span class="p" id="mwA0A">;</span> <span class="w" id="mwA0E"> </span> <span class="w" id="mwA0I"> </span><span class="c1" id="mwA0M">// Automatically abort if the range does not intersect this quad</span> <span class="w" id="mwA0Q"> </span><span class="k" id="mwA0U">if</span><span class="w" id="mwA0Y"> </span><span class="p" id="mwA0c">(</span><span class="o" id="mwA0g">!</span><span class="n" id="mwA0k">boundary</span><span class="p" id="mwA0o">.</span><span class="n" id="mwA0s">intersectsAABB</span><span class="p" id="mwA0w">(</span><span class="n" id="mwA00">range</span><span class="p" id="mwA04">))</span> <span class="w" id="mwA08"> </span><span class="k" id="mwA1A">return</span><span class="w" id="mwA1E"> </span><span class="n" id="mwA1I">pointsInRange</span><span class="p" id="mwA1M">;</span><span class="w" id="mwA1Q"> </span><span class="c1" id="mwA1U">// empty list</span> <span class="w" id="mwA1Y"> </span> <span class="w" id="mwA1c"> </span><span class="c1" id="mwA1g">// Check objects at this quad level</span> <span class="w" id="mwA1k"> </span><span class="k" id="mwA1o">for</span><span class="w" id="mwA1s"> </span><span class="p" id="mwA1w">(</span><span class="kt" id="mwA10">int</span><span class="w" id="mwA14"> </span><span class="n" id="mwA18">p</span><span class="w" id="mwA2A"> </span><span class="o" id="mwA2E">=</span><span class="w" id="mwA2I"> </span><span class="mi" id="mwA2M">0</span><span class="p" id="mwA2Q">;</span><span class="w" id="mwA2U"> </span><span class="n" id="mwA2Y">p</span><span class="w" id="mwA2c"> </span><span class="o" id="mwA2g"><</span><span class="w" id="mwA2k"> </span><span class="n" id="mwA2o">points</span><span class="p" id="mwA2s">.</span><span class="n" id="mwA2w">size</span><span class="p" id="mwA20">;</span><span class="w" id="mwA24"> </span><span class="n" id="mwA28">p</span><span class="o" id="mwA3A">++</span><span class="p" id="mwA3E">)</span> <span class="w" id="mwA3I"> </span><span class="p" id="mwA3M">{</span> <span class="w" id="mwA3Q"> </span><span class="k" id="mwA3U">if</span><span class="w" id="mwA3Y"> </span><span class="p" id="mwA3c">(</span><span class="n" id="mwA3g">range</span><span class="p" id="mwA3k">.</span><span class="n" id="mwA3o">containsPoint</span><span class="p" id="mwA3s">(</span><span class="n" id="mwA3w">points</span><span class="p" id="mwA30">[</span><span class="n" id="mwA34">p</span><span class="p" id="mwA38">]))</span> <span class="w" id="mwA4A"> </span><span class="n" id="mwA4E">pointsInRange</span><span class="p" id="mwA4I">.</span><span class="n" id="mwA4M">append</span><span class="p" id="mwA4Q">(</span><span class="n" id="mwA4U">points</span><span class="p" id="mwA4Y">[</span><span class="n" id="mwA4c">p</span><span class="p" id="mwA4g">]);</span> <span class="w" id="mwA4k"> </span><span class="p" id="mwA4o">}</span> <span class="w" id="mwA4s"> </span> <span class="w" id="mwA4w"> </span><span class="c1" id="mwA40">// Terminate here, if there are no children</span> <span class="w" id="mwA44"> </span><span class="k" id="mwA48">if</span><span class="w" id="mwA5A"> </span><span class="p" id="mwA5E">(</span><span class="n" id="mwA5I">northWest</span><span class="w" id="mwA5M"> </span><span class="o" id="mwA5Q">==</span><span class="w" id="mwA5U"> </span><span class="n" id="mwA5Y">null</span><span class="p" id="mwA5c">)</span> <span class="w" id="mwA5g"> </span><span class="k" id="mwA5k">return</span><span class="w" id="mwA5o"> </span><span class="n" id="mwA5s">pointsInRange</span><span class="p" id="mwA5w">;</span> <span class="w" id="mwA50"> </span> <span class="w" id="mwA54"> </span><span class="c1" id="mwA58">// Otherwise, add the points from the children</span> <span class="w" id="mwA6A"> </span><span class="n" id="mwA6E">pointsInRange</span><span class="p" id="mwA6I">.</span><span class="n" id="mwA6M">appendArray</span><span class="p" id="mwA6Q">(</span><span class="n" id="mwA6U">northWest</span><span class="o" id="mwA6Y">-></span><span class="n" id="mwA6c">queryRange</span><span class="p" id="mwA6g">(</span><span class="n" id="mwA6k">range</span><span class="p" id="mwA6o">));</span> <span class="w" id="mwA6s"> </span><span class="n" id="mwA6w">pointsInRange</span><span class="p" id="mwA60">.</span><span class="n" id="mwA64">appendArray</span><span class="p" id="mwA68">(</span><span class="n" id="mwA7A">northEast</span><span class="o" id="mwA7E">-></span><span class="n" id="mwA7I">queryRange</span><span class="p" id="mwA7M">(</span><span class="n" id="mwA7Q">range</span><span class="p" id="mwA7U">));</span> <span class="w" id="mwA7Y"> </span><span class="n" id="mwA7c">pointsInRange</span><span class="p" id="mwA7g">.</span><span class="n" id="mwA7k">appendArray</span><span class="p" id="mwA7o">(</span><span class="n" id="mwA7s">southWest</span><span class="o" id="mwA7w">-></span><span class="n" id="mwA70">queryRange</span><span class="p" id="mwA74">(</span><span class="n" id="mwA78">range</span><span class="p" id="mwA8A">));</span> <span class="w" id="mwA8E"> </span><span class="n" id="mwA8I">pointsInRange</span><span class="p" id="mwA8M">.</span><span class="n" id="mwA8Q">appendArray</span><span class="p" id="mwA8U">(</span><span class="n" id="mwA8Y">southEast</span><span class="o" id="mwA8c">-></span><span class="n" id="mwA8g">queryRange</span><span class="p" id="mwA8k">(</span><span class="n" id="mwA8o">range</span><span class="p" id="mwA8s">));</span> <span class="w" id="mwA8w"> </span> <span class="w" id="mwA80"> </span><span class="k" id="mwA84">return</span><span class="w" id="mwA88"> </span><span class="n" id="mwA9A">pointsInRange</span><span class="p" id="mwA9E">;</span> <span class="w" id="mwA9I"> </span><span class="p" id="mwA9M">}</span> <span class="w" id="mwA9Q"> </span><span class="p" id="mwA9U">}</span>