Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/alyst/spatialindexing.jl

Spatial data indexing in pure Julia (R*-trees etc)
https://github.com/alyst/spatialindexing.jl

julia r-star-tree r-tree spatial-data spatial-indexing

Last synced: 3 months ago
JSON representation

Spatial data indexing in pure Julia (R*-trees etc)

Host: GitHub
URL: https://github.com/alyst/spatialindexing.jl
Owner: alyst
License: mit
Created: 2018-11-22T14:23:48.000Z (about 6 years ago)
Default Branch: master
Last Pushed: 2024-05-06T07:06:02.000Z (9 months ago)
Last Synced: 2024-10-27T02:31:33.172Z (3 months ago)
Topics: julia, r-star-tree, r-tree, spatial-data, spatial-indexing
Language: Julia
Size: 799 KB
Stars: 30
Watchers: 4
Forks: 9
Open Issues: 4
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        SpatialIndexing.jl

==============

[![Build Status](https://github.com/alyst/SpatialIndexing.jl/workflows/CI/badge.svg)](https://github.com/alyst/SpatialIndexing.jl/actions?query=worflow%3ACI+branch%3Amaster)

[![codecov](https://codecov.io/gh/alyst/SpatialIndexing.jl/branch/master/graph/badge.svg)](https://codecov.io/gh/alyst/SpatialIndexing.jl)

**Documentation**: [![][docs-stable-img]][docs-stable-url] [![][docs-latest-img]][docs-latest-url]

`SpatialIndexing` package provides the tools for efficient in-memory indexing of

spatial data in [Julia](https://julialang.org/).

# Installation

```julia

using Pkg; Pkg.add("SpatialIndexing")

```

from Julia REPL.

# Features

## R-tree

[R-tree](https://en.wikipedia.org/wiki/R-tree) organizes data into

hierarchical structure and ensures that:

  * minimal bounding rectangles (MBRs) of the nodes (rectangles that

    encompass all data elements in the subtree) stay compact,

  * MBRs of the nodes from the same R-tree level have minimal overlap

    with each other.

The key benefit of R-tree is its ability to rebalance itself

and maintain efficient structure while handling dynamic data (massive insertions

and deletions).

`SpatialIndexing` provides `RTree` type that supports:

  * different R-tree variants (classic [R-tree](https://en.wikipedia.org/wiki/R-tree),

[R*-tree](https://en.wikipedia.org/wiki/R*_tree), linear and quadratic node splits)

  * `insert!(tree, item)`, `delete!(tree, item)` for element-wise insertion and deletion

  * bulk-loading of data using Overlap-minimizing Top-down (OMT) approach (`load!(tree, data)`)

  * `subtract!(tree, reg)` for removing data within specified region `reg`

  * `findfirst(tree, reg, [id])`, `contained_in(tree, reg)` and `intersects_with(tree, reg)` spatial queries

## Simple Spatial Index

`SimpleSpatialIndex` stores all data elements in a vector. So, while insertion

of new data takes constant time, the time of spatial searches grows linearly

with the number of elements. This spatial index is intended as a reference

implementation for benchmarking and not recommended for production usage.

**TODO**

# Usage

**TODO**

`examples` folder contains `spiral.jl` and `pareto.jl` examples of using R-tree

for storing spatial data.

![R*-tree of 10000 random points (sequential insertions)](examples/spiral_rtree_seq.png)

![R*-tree of 3D Pareto Front (1233 of 100000 points; bulk-load)](examples/pareto3d_rtree_bulk.jpg)

# See also

Other Julia packages for spatial data:

  * [LibSpatialIndex.jl](https://github.com/yeesian/LibSpatialIndex.jl)

([libspatialindex](https://github.com/libspatialindex/libspatialindex) wrapper)

  * [NearestNeighbors.jl](https://github.com/KristofferC/NearestNeighbors.jl)

  * [RegionTrees.jl](https://github.com/rdeits/RegionTrees.jl)

  * [LSH.jl](https://github.com/Keno/LSH.jl)

# References

* A.Guttman, _“R-Trees: A Dynamic Index Structure for Spatial Searching”_

  Proc. 1984 ACM-SIGMOD Conference on Management of Data (1985), pp.47-57.

* N. Beckmann, H.P. Kriegel, R. Schneider, B. Seeger,

  _"The R*-tree: an efficient and robust access method for points and rectangles"_

  Proc. 1990 ACM SIGMOD international conference on Management of data (1990), p.322

* T. Lee and S. Lee, _"OMT: Overlap Minimizing Top-down Bulk Loading Algorithm for R-tree"_,

  CAiSE Short Paper Proceedings (2003) [paper](http://ceur-ws.org/Vol-74/files/FORUM_18.pdf)

[docs-latest-img]: https://img.shields.io/badge/docs-latest-blue.svg

[docs-latest-url]: http://alyst.github.io/SpatialIndexing.jl/dev/

[docs-stable-img]: https://img.shields.io/badge/docs-stable-blue.svg

[docs-stable-url]: http://alyst.github.io/SpatialIndexing.jl/stable/