goko

Crates.iogoko
lib.rsgoko
version0.5.5
sourcesrc
created_at2020-07-15 19:04:15.879492
updated_at2021-05-04 04:53:54.320009
descriptionA lock-free, eventually consistent, concurrent covertree.
homepagehttps://github.com/elastic/goko
repositoryhttps://github.com/elastic/goko.git
max_upload_size
id265541
size366,109
Sven Cattell (comath)

documentation

https://docs.rs/goko

README

Goko

Plugins

These are going to be the core of the library. Attaching math gadgets to each node of the covertree is the most interesting thing you can do with them and is the goal of this library. The objective is to have zero-cost plugins on the fastest covertree implementation possible. It should be impossible to write a faster implementation of your covertree based algorithm. This is the third near total rewrite of the library. The previous 2 implementations had foundational bottlenecks and details that hindered this goal. We feel that this latest architecture has the strongest foundation for future work.

Plugins are currently partially implemented. Expect them in the coming weeks!

Read-Write heads

goko stores the covertree as an array of layers, each with an arena style allocation of all nodes on that layer in a evmap. This is a pair of hashmaps where all the readers point at one constant map (so it can be safely, locklessly queried), while the writer edits the other map. When the writer is done it swaps the pointer. The readers then can see the updates, while the writer writes the same changes (and more) to the other hashmap. Plugins cannot control the update order, however the tree will be updated from leaf to root so you can use recursive logic.

Singleton Children

Children of a node that would only cover are stored in a singleton list. This saves a significant amount of memory (Trees built on Ember are 2-3x smaller) and you can chose not to query these nodes to speed up KNN & other queries. Considerations should be made when writing algorithms for this implementation for these unique children.

Installation

This depends on protoc which can be installed by installing protobuf-compiler on ubuntu. A normal dev machine should have the rest installed, but fresh machines may need to install the following, along with Rust:

sudo apt install -y build-essential libssl-dev libblas-dev liblapacke-dev pkg-config libprotobuf-dev libprotoc-dev protobuf-compiler

It also requires nightly due to packed-simd's reliance on experimental APIs. Currently the latest version that is confirmed to work is

rustup install nightly-2020-09-14
rustup override set nightly-2020-09-14
Commit count: 178

cargo fmt