scikitplot.annoy#

scikitplot.annoy#

Public Annoy Python API for scikitplot.

Spotify ANNoy [1] (Approximate Nearest Neighbors Oh Yeah).

This package exposes two layers.

Exports:

1. Low-level C-extension types copied from Spotify’s annoy project: Annoy and AnnoyIndex.

2. A high-level, mixin-composed wrapper Index that:

• forwards the complete low-level API deterministically,

• adds versioned manifest import/export,

• provides explicit index I/O names (save_index / load_index),

• provides safe Python-object persistence helpers (pickling),

• adds optional NumPy export and plotting utilities,

• decides how many threads build an index from one rule (threads_info, SKPLT_ANNOY_THREADS).

Notes

This module intentionally avoids side effects at import time (no implicit NumPy or matplotlib imports).

References

Examples

>>> import random
>>> random.seed(0)

>>> # from annoy import AnnoyIndex
>>> from scikitplot.cexternals._annoy import Annoy, AnnoyIndex
>>> from scikitplot.annoy import Annoy, AnnoyIndex, Index

>>> f = 40  # vector dimensionality
>>> t = Index(f, "angular")  # same constructor as the low-level backend
>>> t.add_item(0, [1] * f)
>>> t.build(10)  # Build 10 trees
>>> t.get_nns_by_item(0, 1)  # Find nearest neighbor

ANNoy (cython based scikitplot/annoy/_annoy)#

ANNoy (Approximate Nearest Neighbors Oh Yeah)

Class inheritance

ANNoy (cpp based scikitplot/cexternals/_annoy)#

ANNoy (Approximate Nearest Neighbors Oh Yeah)

Class inheritance

ANNoy (cpp based Index Mixins)#