{ "_id": "6a1d69a71d7bb097a0a4ee58", "Package": "bigANNOY", "Type": "Package", "Title": "Approximate k-Nearest Neighbour Search for 'bigmemory' Matrices\nwith Annoy", "Version": "0.3.0", "Date": "2026-03-27", "Authors@R": "person(\"Frederic\", \"Bertrand\", role = c(\"aut\", \"cre\"),\nemail = \"frederic.bertrand@lecnam.net\")", "Author": "Frederic Bertrand [aut, cre]", "Maintainer": "Frederic Bertrand ", "Description": "Approximate Euclidean k-nearest neighbour search routines\nthat operate on 'bigmemory::big.matrix' data through Annoy\nindexes created with 'RcppAnnoy'. The package builds persistent\non-disk indexes plus sidecar metadata from streamed\n'big.matrix' rows, supports euclidean, angular, Manhattan, and\ndot-product Annoy metrics, and can either return in-memory\nresults or stream neighbour indices and distances into\ndestination 'bigmemory' matrices. Explicit index lifecycle\nhelpers, stronger metadata validation, descriptor-aware\nfile-backed workflows, and benchmark helpers are also included.", "License": "GPL (>= 2)", "VignetteBuilder": "litedown", "Encoding": "UTF-8", "NeedsCompilation": "yes", "URL": "https://fbertran.github.io/bigANNOY/,\nhttps://github.com/fbertran/bigANNOY", "BugReports": "https://github.com/fbertran/bigANNOY/issues", "Roxygen": "list(markdown = TRUE)", "RoxygenNote": "7.3.3", "Config/testthat/edition": "3", "Repository": "https://fbertran.r-universe.dev", "Date/Publication": "2026-03-27 01:10:12 UTC", "RemoteUrl": "https://github.com/fbertran/bigannoy", "RemoteRef": "HEAD", "RemoteSha": "9597b605929621a1e9f84802523ff5aa0be3dac2", "Packaged": { "Date": "2026-06-01 11:07:34 UTC", "User": "root" }, "MD5sum": "463d6d33afa800622198883d6369821f", "_user": "fbertran", "_type": "src", "_file": "bigANNOY_0.3.0.tar.gz", "_fileid": "65dc0f2b30da37588e8ce23d2ce583792fd6d19b37338811b2b800c1d58bd30f", "_filesize": 206316, "_sha256": "65dc0f2b30da37588e8ce23d2ce583792fd6d19b37338811b2b800c1d58bd30f", "_created": "2026-06-01T11:07:34.000Z", "_published": "2026-06-01T11:14:47.871Z", "_distro": "noble", "_jobs": [ { "job": 78839301215, "time": 138, "config": "linux-devel-x86_64", "r": "4.7.0", "check": "OK", "artifact": "7329914750" }, { "job": 78839301239, "time": 128, "config": "linux-release-arm64", "r": "4.6.0", "check": "OK", "artifact": "7329911653" }, { "job": 78839301208, "time": 132, "config": "linux-release-x86_64", "r": "4.6.0", "check": "OK", "artifact": "7329913187" }, { "job": 78839301257, "time": 129, "config": "macos-oldrel-arm64", "r": "4.5.3", "check": "OK", "artifact": "7329990623" }, { "job": 78839301185, "time": 206, "config": "macos-oldrel-x86_64", "r": "4.5.3", "check": "OK", "artifact": "7329957011" }, { "job": 78839301193, "time": 92, "config": "macos-release-arm64", "r": "4.6.0", "check": "OK", "artifact": "7329965055" }, { "job": 78839301211, "time": 233, "config": "macos-release-x86_64", "r": "4.6.0", "check": "OK", "artifact": "7329967847" }, { "job": 78838713860, "time": 225, "config": "source", "r": "4.6.0", "check": "OK", "artifact": "7329872251" }, { "job": 78839301281, "time": 121, "config": "wasm-release", "r": "4.6.0", "check": "OK", "artifact": "7329909506" }, { "job": 78839301312, "time": 144, "config": "windows-devel", "r": "4.7.0", "check": "OK", "artifact": "7329916573" }, { "job": 78839301285, "time": 139, "config": "windows-oldrel", "r": "4.5.3", "check": "OK", "artifact": "7329915366" }, { "job": 78839301199, "time": 127, "config": "windows-release", "r": "4.6.0", "check": "OK", "artifact": "7329911423" } ], "_buildurl": "https://github.com/r-universe/fbertran/actions/runs/26750995835", "_status": "success", "_host": "GitHub-Actions", "_upstream": "https://github.com/fbertran/bigannoy", "_commit": { "id": "9597b605929621a1e9f84802523ff5aa0be3dac2", "author": "Frederic Bertrand ", "committer": "Frederic Bertrand ", "message": "Update website\n", "time": 1774573812 }, "_maintainer": { "name": "Frederic Bertrand", "email": "frederic.bertrand@lecnam.net", "login": "fbertran", "twitter": "@BertrandFrdric2", "description": "Full professor in statistical modelling and data science at the CNAM Paris, France", "uuid": 6714333 }, "_registered": true, "_dependencies": [ { "package": "R", "version": ">= 3.5.0", "role": "Depends" }, { "package": "BH", "role": "LinkingTo" }, { "package": "bigmemory", "role": "LinkingTo" }, { "package": "Rcpp", "role": "LinkingTo" }, { "package": "RcppAnnoy", "role": "LinkingTo" }, { "package": "methods", "role": "Imports" }, { "package": "Rcpp", "role": "Imports" }, { "package": "RcppAnnoy", "role": "Imports" }, { "package": "bigmemory", "role": "Suggests" }, { "package": "knitr", "role": "Suggests" }, { "package": "litedown", "role": "Suggests" }, { "package": "testthat", "version": ">= 3.0.0", "role": "Suggests" } ], "_owner": "fbertran", "_selfowned": true, "_usedby": 0, "_updates": [ { "week": "2026-13", "n": 9 } ], "_tags": [], "_stars": 1, "_contributors": [ { "user": "fbertran", "count": 9, "uuid": 6714333 } ], "_userbio": { "uuid": 6714333, "type": "user", "name": "Frederic Bertrand", "description": "Full professor in statistical modelling and data science at the CNAM Paris, France" }, "_downloads": { "count": 472, "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/bigANNOY" }, "_devurl": "https://github.com/fbertran/bigannoy", "_pkgdown": "https://fbertran.github.io/bigANNOY/", "_searchresults": 27, "_topics": [ "cpp" ], "_rbuild": "4.6.0", "_assets": [ "extra/bigANNOY.html", "extra/citation.cff", "extra/citation.html", "extra/citation.json", "extra/citation.txt", "extra/contents.json", "extra/NEWS.html", "extra/NEWS.txt", "extra/readme.html", "extra/readme.md", "manual.pdf" ], "_homeurl": "https://github.com/fbertran/bigannoy", "_realowner": "fbertran", "_cranurl": true, "_releases": [ { "version": "0.3.0", "date": "2026-04-01" } ], "_exports": [ "annoy_build_bigmatrix", "annoy_close_index", "annoy_is_loaded", "annoy_load_bigmatrix", "annoy_open_index", "annoy_search_bigmatrix", "annoy_validate_index", "benchmark_annoy_bigmatrix", "benchmark_annoy_recall_suite", "benchmark_annoy_volume_suite", "benchmark_annoy_vs_rcppannoy" ], "_help": [ { "page": "annoy_build_bigmatrix", "title": "Build an Annoy index from a 'bigmemory::big.matrix'", "topics": [ "annoy_build_bigmatrix" ] }, { "page": "annoy_close_index", "title": "Close any loaded Annoy handle cached inside a 'bigannoy_index'", "topics": [ "annoy_close_index" ] }, { "page": "annoy_is_loaded", "title": "Check whether an index currently has a loaded in-memory handle", "topics": [ "annoy_is_loaded" ] }, { "page": "annoy_load_bigmatrix", "title": "Load an existing Annoy index for bigmatrix workflows", "topics": [ "annoy_load_bigmatrix" ] }, { "page": "annoy_open_index", "title": "Open an existing Annoy index and its sidecar metadata", "topics": [ "annoy_open_index" ] }, { "page": "annoy_search_bigmatrix", "title": "Search an Annoy index built from a 'bigmemory::big.matrix'", "topics": [ "annoy_search_bigmatrix" ] }, { "page": "annoy_validate_index", "title": "Validate a persisted Annoy index and its sidecar metadata", "topics": [ "annoy_validate_index" ] }, { "page": "benchmark_annoy_bigmatrix", "title": "Benchmark a single bigANNOY build/search configuration", "topics": [ "benchmark_annoy_bigmatrix" ] }, { "page": "benchmark_annoy_recall_suite", "title": "Benchmark a recall suite across multiple Annoy configurations", "topics": [ "benchmark_annoy_recall_suite" ] }, { "page": "benchmark_annoy_volume_suite", "title": "Benchmark scaling across data volumes for bigANNOY and direct RcppAnnoy", "topics": [ "benchmark_annoy_volume_suite" ] }, { "page": "benchmark_annoy_vs_rcppannoy", "title": "Benchmark bigANNOY against direct RcppAnnoy", "topics": [ "benchmark_annoy_vs_rcppannoy" ] }, { "page": "print.bigannoy_index", "title": "Print a 'bigannoy_index'", "topics": [ "print.bigannoy_index" ] } ], "_readme": "https://github.com/fbertran/bigannoy/raw/HEAD/README.md", "_rundeps": [ "BH", "bigmemory", "bigmemory.sri", "Rcpp", "RcppAnnoy", "uuid" ], "_sysdeps": [ { "shlib": "libstdc++", "package": "libstdc++6", "source": "gcc", "version": "14.2.0-4ubuntu2~24.04.1", "name": "c++", "homepage": "http://gcc.gnu.org/", "description": "GNU Standard C++ Library v3" } ], "_vignettes": [ { "source": "benchmarking-recall-and-latency.Rmd", "filename": "benchmarking-recall-and-latency.html", "title": "Benchmarking Recall and Latency", "engine": "litedown::vignette", "headings": [ "What the Benchmark Helpers Do", "Load the Package", "Create a Benchmark Workspace", "A Single Synthetic Benchmark Run", "Validation Is Part of the Benchmark Workflow", "External-Query Versus Self-Search Benchmarks", "Benchmark a Recall Suite Across Parameter Grids", "Optional Exact Recall Against bigKNN", "Benchmark User-Supplied Data", "Compare bigANNOY with Direct RcppAnnoy", "Benchmark Scaling by Data Volume", "Interpreting the Main Summary Columns", "Installed Benchmark Runner", "Recommended Workflow", "Recap" ], "created": "2026-03-26 23:01:28", "modified": "2026-03-27 00:56:46", "commits": 3 }, { "source": "bigannoy-vs-bigknn.Rmd", "filename": "bigannoy-vs-bigknn.html", "title": "bigANNOY Versus bigKNN", "engine": "litedown::vignette", "headings": [ "The Core Difference", "When To Use Which Package", "Shared Result Shape", "Load the Packages You Need", "A Small Comparison Dataset", "Approximate Search with bigANNOY", "Exact Search with bigKNN When Available", "What Does \"Aligned Result Shape\" Buy You?", "Why bigANNOY Still Matters When bigKNN Exists", "Benchmark Integration", "A Practical Decision Framework", "Important Boundaries", "Recap" ], "created": "2026-03-26 23:01:28", "modified": "2026-03-27 00:21:38", "commits": 2 }, { "source": "file-backed-bigmemory-workflows.Rmd", "filename": "file-backed-bigmemory-workflows.html", "title": "File-Backed bigmemory Workflows", "engine": "litedown::vignette", "headings": [ "Load the Packages", "Create a Small File-Backed Workspace", "Build a File-Backed Reference Matrix", "Build an Annoy Index from a Descriptor Path", "Accepted File-Oriented Input Forms", "Query with a File-Backed big.matrix", "Query with a Descriptor Object and a Descriptor Path", "Stream Results into File-Backed Destination Matrices", "Reattach the Output Files Later", "Separated-Column Query Matrices", "Persisted Reference, Persisted Index, Persisted Outputs", "Practical Tips", "Recap" ], "created": "2026-03-26 23:01:28", "modified": "2026-03-27 00:21:38", "commits": 2 }, { "source": "getting-started-bigannoy.Rmd", "filename": "getting-started-bigannoy.html", "title": "Getting Started with bigANNOY", "engine": "litedown::vignette", "headings": [ "Load the Packages", "Create a Small Reference Matrix", "Build the First Annoy Index", "Run a Self-Search", "Search with an External Query Matrix", "Tune the Main Search Controls", "Stream Results into big.matrix Outputs", "Reopen and Validate a Persisted Index", "What Inputs Are Accepted?", "Recap" ], "created": "2026-03-26 23:01:28", "modified": "2026-03-27 00:21:38", "commits": 2 }, { "source": "metrics-and-tuning.Rmd", "filename": "metrics-and-tuning.html", "title": "Metrics and Tuning", "engine": "litedown::vignette", "headings": [ "Load the Packages", "A Small Dataset for Metric Comparisons", "Supported Metrics", "Compare Metrics on the Same Queries", "Build-Time Controls", "n_trees", "seed", "build_threads", "block_size", "load_mode", "Query-Time Controls", "k", "search_k", "prefault", "Use the Benchmark Helpers to Tune n_trees and search_k", "Package-Level Defaults", "A Practical Tuning Pattern", "Recap" ], "created": "2026-03-26 23:01:28", "modified": "2026-03-27 00:21:38", "commits": 2 }, { "source": "persistent-indexes-and-lifecycle.Rmd", "filename": "persistent-indexes-and-lifecycle.html", "title": "Persistent Indexes and Lifecycle", "engine": "litedown::vignette", "headings": [ "Why Lifecycle Management Matters", "Load the Packages", "Build an Index in Lazy Mode", "Inspect the Sidecar Metadata", "Lazy Loading Versus Eager Loading", "Validate Without Loading", "Validate and Load Explicitly", "Close a Loaded Handle Explicitly", "Reopen the Same Index in a New Object", "Lifecycle State Lives in the Session Object", "What Happens If Validation Fails?", "Recommended Workflow", "Recap" ], "created": "2026-03-26 23:01:28", "modified": "2026-03-27 00:21:38", "commits": 2 }, { "source": "validation-and-sharing-indexes.Rmd", "filename": "validation-and-sharing-indexes.html", "title": "Validation and Sharing Indexes", "engine": "litedown::vignette", "headings": [ "Load the Packages", "Create a Small Persisted Example", "What the Metadata Records", "Validate Before You Use a Persisted Index", "What Counts as an Error Versus a Warning", "Reopen the Index as a Separate Session Object", "Sharing Checklist", "Simulate Sharing by Copying the Persisted Files", "Non-Strict Validation for Diagnostics", "Strict Validation as a Gate", "A Common Sharing Pitfall: Renaming Only the .ann File", "Recommended Sharing Pattern", "Recap" ], "created": "2026-03-26 23:01:28", "modified": "2026-03-27 00:21:38", "commits": 2 } ], "_score": 4.9754318085092635, "_indexed": true, "_nocasepkg": "bigannoy", "_universes": [ "fbertran" ], "_binaries": [ { "r": "4.7.0", "os": "linux", "version": "0.3.0", "date": "2026-05-02T06:40:51.000Z", "distro": "noble", "arch": "aarch64", "commit": "9597b605929621a1e9f84802523ff5aa0be3dac2", "fileid": "0ae0dae476d2a246169da9046cdadf006652ecf5c2435d93074a643fe1ebdd48", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/fbertran/actions/runs/25245928971" }, { "r": "4.7.0", "os": "linux", "version": "0.3.0", "date": "2026-06-01T11:09:51.000Z", "distro": "noble", "arch": "x86_64", "commit": "9597b605929621a1e9f84802523ff5aa0be3dac2", "fileid": "1bafa82abdc54a06e14f523643bfe39c526b93ba6bef488f7de50eddc263e43b", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/fbertran/actions/runs/26750995835" }, { "r": "4.6.0", "os": "linux", "version": "0.3.0", "date": "2026-06-01T11:09:46.000Z", "distro": "noble", "arch": "aarch64", "commit": "9597b605929621a1e9f84802523ff5aa0be3dac2", "fileid": "e194dbd94f204b721752de040e5441235ac296622467e7b68fcab81f34a251e3", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/fbertran/actions/runs/26750995835" }, { "r": "4.6.0", "os": "linux", "version": "0.3.0", "date": "2026-06-01T11:09:48.000Z", "distro": "noble", "arch": "x86_64", "commit": "9597b605929621a1e9f84802523ff5aa0be3dac2", "fileid": "2aa0f35aeeb897df1e84a8b10ba36770116ef4fccd136ea2916f6a485877e3d3", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/fbertran/actions/runs/26750995835" }, { "r": "4.5.3", "os": "mac", "version": "0.3.0", "date": "2026-06-01T11:14:03.000Z", "arch": "aarch64", "commit": "9597b605929621a1e9f84802523ff5aa0be3dac2", "fileid": "b4c709d5501d4f2bfb94f92cb9943dc443989d4d1ef225d8d60a3e2e7cca13b6", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/fbertran/actions/runs/26750995835" }, { "r": "4.5.3", "os": "mac", "version": "0.3.0", "date": "2026-06-01T11:11:57.000Z", "arch": "x86_64", "commit": "9597b605929621a1e9f84802523ff5aa0be3dac2", "fileid": "7186f8642e3faaa77c4112887c8a5025320c6f72c33db083e17c5eb27c0aa1d8", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/fbertran/actions/runs/26750995835" }, { "r": "4.6.0", "os": "mac", "version": "0.3.0", "date": "2026-06-01T11:12:44.000Z", "arch": "aarch64", "commit": "9597b605929621a1e9f84802523ff5aa0be3dac2", "fileid": "8039864ac6401d6579b0ca81102307fa13c8cc03e394d150dc18c352109af7c7", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/fbertran/actions/runs/26750995835" }, { "r": "4.6.0", "os": "mac", "version": "0.3.0", "date": "2026-06-01T11:12:21.000Z", "arch": "x86_64", "commit": "9597b605929621a1e9f84802523ff5aa0be3dac2", "fileid": "de14bdb0499b7de51431a264ac2d81829cf08c7db0136a8454e3d08020f5333e", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/fbertran/actions/runs/26750995835" }, { "r": "4.6.0", "os": "wasm", "version": "0.3.0", "date": "2026-06-01T11:09:56.000Z", "arch": "emscripten", "commit": "9597b605929621a1e9f84802523ff5aa0be3dac2", "fileid": "498aba5002ec09fe5f82e1001b4e6e45547e87f40afc8bdbac0bcd7b83b619d5", "status": "success", "buildurl": "https://github.com/r-universe/fbertran/actions/runs/26750995835" }, { "r": "4.7.0", "os": "win", "version": "0.3.0", "date": "2026-06-01T11:09:09.000Z", "arch": "x86_64", "commit": "9597b605929621a1e9f84802523ff5aa0be3dac2", "fileid": "5b8bf45a2d3e894af53aaa433faa9999a1075b573460201125b685cbab19e4ce", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/fbertran/actions/runs/26750995835" }, { "r": "4.5.3", "os": "win", "version": "0.3.0", "date": "2026-06-01T11:09:12.000Z", "arch": "x86_64", "commit": "9597b605929621a1e9f84802523ff5aa0be3dac2", "fileid": "98b9e781f4373a7597f756026cb7103b75cdf919489147d195a87f712e9b2359", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/fbertran/actions/runs/26750995835" }, { "r": "4.6.0", "os": "win", "version": "0.3.0", "date": "2026-06-01T11:09:13.000Z", "arch": "x86_64", "commit": "9597b605929621a1e9f84802523ff5aa0be3dac2", "fileid": "a92f612d13018a738eff72d16692210234f4b4e0074413bdeda8125cad137221", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/fbertran/actions/runs/26750995835" } ] }