tile38/vendor/github.com/tidwall/rtree/rtree.go

478 lines
10 KiB
Go
Raw Normal View History

2021-02-08 03:54:56 +03:00
// Copyright 2021 Joshua J Baker. All rights reserved.
// Use of this source code is governed by an MIT-style
// license that can be found in the LICENSE file.
package rtree
2021-03-30 18:09:03 +03:00
import (
2021-07-31 17:45:09 +03:00
"math"
2021-03-30 18:09:03 +03:00
"github.com/tidwall/geoindex/child"
)
2021-02-08 03:54:56 +03:00
const (
maxEntries = 32
minEntries = maxEntries * 20 / 100
)
2021-02-08 03:54:56 +03:00
type rect struct {
min, max [2]float64
data interface{}
}
type node struct {
count int
2021-07-31 17:45:09 +03:00
rects [maxEntries]rect
}
2021-02-08 03:54:56 +03:00
// RTree ...
type RTree struct {
2021-02-08 03:54:56 +03:00
height int
root rect
count int
reinsert []rect
}
2021-02-08 03:54:56 +03:00
func (r *rect) expand(b *rect) {
if b.min[0] < r.min[0] {
r.min[0] = b.min[0]
}
if b.max[0] > r.max[0] {
r.max[0] = b.max[0]
}
2021-02-08 03:54:56 +03:00
if b.min[1] < r.min[1] {
r.min[1] = b.min[1]
}
if b.max[1] > r.max[1] {
r.max[1] = b.max[1]
}
}
func (r *rect) area() float64 {
return (r.max[0] - r.min[0]) * (r.max[1] - r.min[1])
}
2021-07-31 17:45:09 +03:00
// unionedArea returns the area of two rects expanded
func (r *rect) unionedArea(b *rect) float64 {
return (math.Max(r.max[0], b.max[0]) - math.Min(r.min[0], b.min[0])) *
(math.Max(r.max[1], b.max[1]) - math.Min(r.min[1], b.min[1]))
}
2021-07-31 17:45:09 +03:00
// Insert data into tree
2021-02-08 03:54:56 +03:00
func (tr *RTree) Insert(min, max [2]float64, value interface{}) {
var item rect
fit(min, max, value, &item)
tr.insert(&item)
}
func (tr *RTree) insert(item *rect) {
if tr.root.data == nil {
fit(item.min, item.max, new(node), &tr.root)
}
2021-02-08 03:54:56 +03:00
grown := tr.root.insert(item, tr.height)
if grown {
tr.root.expand(item)
}
2021-07-31 17:45:09 +03:00
if tr.root.data.(*node).count == maxEntries {
2021-02-08 03:54:56 +03:00
newRoot := new(node)
tr.root.splitLargestAxisEdgeSnap(&newRoot.rects[1])
newRoot.rects[0] = tr.root
newRoot.count = 2
tr.root.data = newRoot
tr.root.recalc()
tr.height++
}
2021-02-08 03:54:56 +03:00
tr.count++
}
2021-02-08 03:54:56 +03:00
func (r *rect) chooseLeastEnlargement(b *rect) (index int) {
n := r.data.(*node)
j, jenlargement, jarea := -1, 0.0, 0.0
for i := 0; i < n.count; i++ {
2021-07-31 17:45:09 +03:00
// calculate the enlarged area
uarea := n.rects[i].unionedArea(b)
2021-02-08 03:54:56 +03:00
area := n.rects[i].area()
2021-07-31 17:45:09 +03:00
enlargement := uarea - area
2021-02-08 03:54:56 +03:00
if j == -1 || enlargement < jenlargement ||
(enlargement == jenlargement && area < jarea) {
j, jenlargement, jarea = i, enlargement, area
}
}
2021-02-08 03:54:56 +03:00
return j
}
2021-02-08 03:54:56 +03:00
func (r *rect) recalc() {
n := r.data.(*node)
r.min = n.rects[0].min
r.max = n.rects[0].max
for i := 1; i < n.count; i++ {
r.expand(&n.rects[i])
}
}
2021-02-08 03:54:56 +03:00
// contains return struct when b is fully contained inside of n
func (r *rect) contains(b *rect) bool {
if b.min[0] < r.min[0] || b.max[0] > r.max[0] {
return false
}
2021-02-08 03:54:56 +03:00
if b.min[1] < r.min[1] || b.max[1] > r.max[1] {
return false
}
2021-02-08 03:54:56 +03:00
return true
}
func (r *rect) largestAxis() (axis int, size float64) {
if r.max[1]-r.min[1] > r.max[0]-r.min[0] {
return 1, r.max[1] - r.min[1]
}
2021-02-08 03:54:56 +03:00
return 0, r.max[0] - r.min[0]
}
func (r *rect) splitLargestAxisEdgeSnap(right *rect) {
axis, _ := r.largestAxis()
left := r
leftNode := left.data.(*node)
rightNode := new(node)
right.data = rightNode
var equals []rect
for i := 0; i < leftNode.count; i++ {
minDist := leftNode.rects[i].min[axis] - left.min[axis]
maxDist := left.max[axis] - leftNode.rects[i].max[axis]
if minDist < maxDist {
// stay left
} else {
if minDist > maxDist {
// move to right
rightNode.rects[rightNode.count] = leftNode.rects[i]
rightNode.count++
} else {
// move to equals, at the end of the left array
equals = append(equals, leftNode.rects[i])
}
2021-02-08 03:54:56 +03:00
leftNode.rects[i] = leftNode.rects[leftNode.count-1]
leftNode.rects[leftNode.count-1].data = nil
leftNode.count--
i--
}
}
2021-02-08 03:54:56 +03:00
for _, b := range equals {
if leftNode.count < rightNode.count {
leftNode.rects[leftNode.count] = b
leftNode.count++
} else {
2021-02-08 03:54:56 +03:00
rightNode.rects[rightNode.count] = b
rightNode.count++
}
}
2021-02-08 03:54:56 +03:00
left.recalc()
right.recalc()
}
func (r *rect) insert(item *rect, height int) (grown bool) {
n := r.data.(*node)
if height == 0 {
n.rects[n.count] = *item
n.count++
grown = !r.contains(item)
return grown
}
// choose subtree
index := -1
narea := 0.0
// first take a quick look for any nodes that contain the rect
for i := 0; i < n.count; i++ {
if n.rects[i].contains(item) {
area := n.rects[i].area()
if index == -1 || area < narea {
narea = area
index = i
}
}
2021-02-08 03:54:56 +03:00
}
// found nothing, now go the slow path
if index == -1 {
index = r.chooseLeastEnlargement(item)
}
// insert the item into the child node
child := &n.rects[index]
grown = child.insert(item, height-1)
if grown {
child.expand(item)
grown = !r.contains(item)
}
2021-07-31 17:45:09 +03:00
if child.data.(*node).count == maxEntries {
2021-02-08 03:54:56 +03:00
child.splitLargestAxisEdgeSnap(&n.rects[n.count])
n.count++
}
return grown
}
2021-02-08 03:54:56 +03:00
// fit an external item into a rect type
func fit(min, max [2]float64, value interface{}, target *rect) {
target.min = min
target.max = max
target.data = value
}
// contains return struct when b is fully contained inside of n
func (r *rect) intersects(b *rect) bool {
if b.min[0] > r.max[0] || b.max[0] < r.min[0] {
return false
}
2021-02-08 03:54:56 +03:00
if b.min[1] > r.max[1] || b.max[1] < r.min[1] {
return false
}
2021-02-08 03:54:56 +03:00
return true
}
func (r *rect) search(
target rect, height int,
iter func(min, max [2]float64, value interface{}) bool,
) bool {
n := r.data.(*node)
if height == 0 {
for i := 0; i < n.count; i++ {
if target.intersects(&n.rects[i]) {
if !iter(n.rects[i].min, n.rects[i].max, n.rects[i].data) {
return false
}
}
}
} else {
for i := 0; i < n.count; i++ {
if target.intersects(&n.rects[i]) {
if !n.rects[i].search(target, height-1, iter) {
return false
}
}
}
}
2021-02-08 03:54:56 +03:00
return true
}
2021-02-08 03:54:56 +03:00
func (tr *RTree) search(
target rect,
iter func(min, max [2]float64, value interface{}) bool,
) {
if tr.root.data == nil {
return
}
2021-02-08 03:54:56 +03:00
if target.intersects(&tr.root) {
tr.root.search(target, tr.height, iter)
}
}
// Search ...
func (tr *RTree) Search(
min, max [2]float64,
iter func(min, max [2]float64, value interface{}) bool,
) {
tr.search(rect{min: min, max: max}, iter)
}
func (r *rect) scan(
height int,
iter func(min, max [2]float64, value interface{}) bool,
) bool {
n := r.data.(*node)
if height == 0 {
for i := 0; i < n.count; i++ {
if !iter(n.rects[i].min, n.rects[i].max, n.rects[i].data) {
return false
}
}
} else {
for i := 0; i < n.count; i++ {
if !n.rects[i].scan(height-1, iter) {
return false
}
}
2021-02-08 03:54:56 +03:00
}
return true
}
// Scan iterates through all data in tree.
func (tr *RTree) Scan(iter func(min, max [2]float64, data interface{}) bool) {
if tr.root.data == nil {
return
}
2021-02-08 03:54:56 +03:00
tr.root.scan(tr.height, iter)
}
2021-02-08 03:54:56 +03:00
// Delete data from tree
func (tr *RTree) Delete(min, max [2]float64, data interface{}) {
2021-07-31 17:45:09 +03:00
tr.deleteWithResult(min, max, data)
}
func (tr *RTree) deleteWithResult(min, max [2]float64, data interface{}) bool {
2021-02-08 03:54:56 +03:00
var item rect
fit(min, max, data, &item)
if tr.root.data == nil || !tr.root.contains(&item) {
2021-07-31 17:45:09 +03:00
return false
2021-02-08 03:54:56 +03:00
}
var removed, recalced bool
removed, recalced = tr.root.delete(tr, &item, tr.height)
if !removed {
2021-07-31 17:45:09 +03:00
return false
2021-02-08 03:54:56 +03:00
}
tr.count -= len(tr.reinsert) + 1
if tr.count == 0 {
tr.root = rect{}
recalced = false
} else {
for tr.height > 0 && tr.root.data.(*node).count == 1 {
tr.root = tr.root.data.(*node).rects[0]
tr.height--
tr.root.recalc()
}
}
2021-02-08 03:54:56 +03:00
if recalced {
tr.root.recalc()
}
if len(tr.reinsert) > 0 {
for i := range tr.reinsert {
tr.insert(&tr.reinsert[i])
tr.reinsert[i].data = nil
}
2021-02-08 03:54:56 +03:00
tr.reinsert = tr.reinsert[:0]
}
2021-07-31 17:45:09 +03:00
return true
2021-02-08 03:54:56 +03:00
}
func (r *rect) delete(tr *RTree, item *rect, height int,
) (removed, recalced bool) {
n := r.data.(*node)
rects := n.rects[0:n.count]
if height == 0 {
for i := 0; i < len(rects); i++ {
if rects[i].data == item.data {
// found the target item to delete
recalced = r.onEdge(&rects[i])
rects[i] = rects[len(rects)-1]
rects[len(rects)-1].data = nil
n.count--
if recalced {
r.recalc()
}
return true, recalced
}
}
2021-02-08 03:54:56 +03:00
} else {
for i := 0; i < len(rects); i++ {
if !rects[i].contains(item) {
continue
}
removed, recalced = rects[i].delete(tr, item, height-1)
if !removed {
continue
}
if rects[i].data.(*node).count < minEntries {
// underflow
if !recalced {
recalced = r.onEdge(&rects[i])
}
2021-02-08 03:54:56 +03:00
tr.reinsert = rects[i].flatten(tr.reinsert, height-1)
rects[i] = rects[len(rects)-1]
rects[len(rects)-1].data = nil
n.count--
}
2021-02-08 03:54:56 +03:00
if recalced {
r.recalc()
}
2021-02-08 03:54:56 +03:00
return removed, recalced
}
}
2021-02-08 03:54:56 +03:00
return false, false
}
2021-02-08 03:54:56 +03:00
// flatten all leaf rects into a single list
func (r *rect) flatten(all []rect, height int) []rect {
n := r.data.(*node)
if height == 0 {
all = append(all, n.rects[:n.count]...)
} else {
for i := 0; i < n.count; i++ {
all = n.rects[i].flatten(all, height-1)
}
}
2021-02-08 03:54:56 +03:00
return all
}
// onedge returns true when b is on the edge of r
func (r *rect) onEdge(b *rect) bool {
if r.min[0] == b.min[0] || r.max[0] == b.max[0] {
return true
2021-02-08 03:54:56 +03:00
}
if r.min[1] == b.min[1] || r.max[1] == b.max[1] {
return true
}
return false
}
// Len returns the number of items in tree
func (tr *RTree) Len() int {
return tr.count
}
// Bounds returns the minimum bounding rect
func (tr *RTree) Bounds() (min, max [2]float64) {
if tr.root.data == nil {
return
}
return tr.root.min, tr.root.max
}
// Children is a utility function that returns all children for parent node.
// If parent node is nil then the root nodes should be returned. The min, max,
// data, and items slices all must have the same lengths. And, each element
// from all slices must be associated. Returns true for `items` when the the
// item at the leaf level. The reuse buffers are empty length slices that can
// optionally be used to avoid extra allocations.
func (tr *RTree) Children(
parent interface{},
reuse []child.Child,
) []child.Child {
children := reuse
if parent == nil {
if tr.Len() > 0 {
// fill with the root
children = append(children, child.Child{
Min: tr.root.min,
Max: tr.root.max,
Data: tr.root.data,
Item: false,
})
}
} else {
// fill with child items
n := parent.(*node)
item := true
if n.count > 0 {
if _, ok := n.rects[0].data.(*node); ok {
item = false
}
}
for i := 0; i < n.count; i++ {
children = append(children, child.Child{
Min: n.rects[i].min,
Max: n.rects[i].max,
Data: n.rects[i].data,
Item: item,
})
}
}
return children
}
// Replace an item.
2021-07-31 17:45:09 +03:00
// If the old item does not exist then the new item is not inserted.
2021-02-08 03:54:56 +03:00
func (tr *RTree) Replace(
oldMin, oldMax [2]float64, oldData interface{},
newMin, newMax [2]float64, newData interface{},
) {
2021-07-31 17:45:09 +03:00
if tr.deleteWithResult(oldMin, oldMax, oldData) {
tr.Insert(newMin, newMax, newData)
}
}