{ "_id": "6ab2de273d719c1f8408e9ea", "Package": "faissR", "Type": "Package", "Title": "FAISS-Backed Nearest Neighbours, kNN Models, and k-Means", "Version": "0.99.47", "Authors@R": "person(given = \"Stefano\",\nfamily = \"Cacciatore\",\nrole = c(\"aut\", \"cre\"),\nemail = \"tkcaccia@gmail.com\",\ncomment = c(ORCID = \"0000-0001-7052-7156\"))", "Description": "Native nearest-neighbour search, k-nearest neighbour\nprediction, and k-means helpers for large dimensionality\nreduction workflows in high-throughput biological data\nanalysis, including single-cell, flow cytometry, imaging, and\nmass spectrometry applications. Functional native builds\nrequire the FAISS C++ library, including CPU-only indexes, and\ncan optionally use FAISS GPU indexes with NVIDIA cuVS\nintegration or direct RAPIDS cuVS/CUDA indexes on NVIDIA\nmachines. CPU-only systems do not need NVIDIA libraries, but\nNVIDIA CUDA/cuVS libraries are mandatory when a GPU-enabled\nbuild is explicitly requested. Unsupported WebAssembly and\nBioconductor staging platforms may build diagnostic-only stubs\nthat report the unavailable native functionality. Supervised\nkNN models use knn(Xtrain, Ytrain) and predict(), or\nknn(Xtrain, Ytrain, Xtest) for immediate prediction. Class\nprobabilities are returned through predict(type = \"prob\") for\nkNN classification models.", "License": "MIT + file LICENSE", "URL": "https://github.com/tkcaccia/faissR", "BugReports": "https://github.com/tkcaccia/faissR/issues", "biocViews": "Software, Infrastructure, GPU, SingleCell, FlowCytometry,\nMassSpectrometry, ImagingMassSpectrometry, Proteomics,\nClustering, DimensionReduction, Classification,\nFunctionalPrediction", "Encoding": "UTF-8", "SystemRequirements": "C++20, Fortran on Unix, FAISS C++ development\nlibrary (Debian/Ubuntu: libfaiss-dev, libblas-dev,\nliblapack-dev; RPM distributions: faiss-devel, blas-devel,\nlapack-devel where available; macOS: static FAISS and OpenMP\nsupplied through the R-macos recipes/toolchain or a compatible\nlocal prefix; Windows: an Rtools-compatible FAISS CPU build),\ncomplete LP64 BLAS and LAPACK with single-precision routines on\nLinux and Windows. Optional CUDA and cuVS libraries are used\nonly when a GPU-enabled build is explicitly requested.", "VignetteBuilder": "knitr", "RoxygenNote": "8.1.0", "Config/roxygen2/version": "8.1.0", "Config/testthat/edition": "3", "Config/pak/sysreqs": "nvidia-cuda-dev libfaiss-dev", "Repository": "https://biocstaging.r-universe.dev", "Date/Publication": "2026-09-22 15:08:10 UTC", "RemoteUrl": "https://github.com/BiocStaging/faissR", "RemoteRef": "HEAD", "RemoteSha": "82ed27005c5292b15f3c8499ac61047c37240c5b", "NeedsCompilation": "yes", "Packaged": { "Date": "2026-09-22 19:13:23 UTC", "User": "root" }, "Author": "Stefano Cacciatore [aut, cre] (ORCID:\n)", "Maintainer": "Stefano Cacciatore ", "_user": "biocstaging", "_type": "src", "_file": "faissR_0.99.47.tar.gz", "_fileid": "https://r2.ropensci.org/6aba4703082b8a0f04e030444ffb795038367d337740ce8f5ba5e288ba70875d", "_filesize": 2548646, "_sha256": "6aba4703082b8a0f04e030444ffb795038367d337740ce8f5ba5e288ba70875d", "_expires": "2026-12-31T19:59:32.000Z", "_created": "2026-09-22T19:13:23.000Z", "_published": "2026-09-22T19:59:34.964Z", "_bioccheck": { "error": 0, "warning": 0, "note": 0 }, "_host": "GitHub-Actions", "_buildurl": "https://github.com/r-universe/biocstaging/actions/runs/35771436924", "_status": "success", "_upstream": "https://github.com/BiocStaging/faissR", "_commit": { "id": "82ed27005c5292b15f3c8499ac61047c37240c5b", "author": "tkcaccia ", "committer": "tkcaccia ", "message": "Clarify Expat licensing and refresh submission files\n", "time": 1790089690 }, "_maintainer": { "name": "Stefano Cacciatore", "email": "tkcaccia@gmail.com", "login": "tkcaccia", "description": "", "uuid": 15799157, "orcid": "0000-0001-7052-7156" }, "_distro": "resolute", "_jobs": [ { "job": 106897468564, "time": 387, "config": "bioc-checks", "r": "4.6.1", "check": "OK", "artifact": "10714723327" }, { "job": 106897468580, "time": 369, "config": "linux-devel-arm64", "r": "4.7.0", "check": "OK", "artifact": "10714743264" }, { "job": 106897468490, "time": 464, "config": "linux-devel-x86_64", "r": "4.7.0", "check": "OK", "artifact": "10714574099" }, { "job": 106897468632, "time": 405, "config": "linux-release-arm64", "r": "4.6.1", "check": "OK", "artifact": "10715031558" }, { "job": 106897468628, "time": 387, "config": "linux-release-x86_64", "r": "4.6.1", "check": "OK", "artifact": "10714553547" }, { "job": 106897468652, "time": 225, "config": "macos-oldrel-arm64", "r": "4.5.3", "check": "OK", "artifact": "10715171703" }, { "job": 106897468680, "time": 426, "config": "macos-oldrel-x86_64", "r": "4.5.3", "check": "OK", "artifact": "10715595157" }, { "job": 106897468787, "time": 189, "config": "macos-release-arm64", "r": "4.6.1", "check": "OK", "artifact": "10714348856" }, { "job": 106897468823, "time": 557, "config": "macos-release-x86_64", "r": "4.6.1", "check": "OK", "artifact": "10714853163" }, { "job": 106893978718, "time": 564, "config": "source", "r": "4.6.1", "check": "OK", "artifact": "10714702312" }, { "job": 106897471460, "time": 275, "config": "wasm-release", "r": "4.6.0", "check": "OK", "artifact": "10714807260" }, { "job": 106897468774, "time": 356, "config": "windows-devel-arm64", "r": "4.7.0", "check": "OK", "artifact": "10715231042" }, { "job": 106897468698, "time": 1831, "config": "windows-devel-x86_64", "r": "4.7.0", "check": "OK", "artifact": "10715653062" }, { "job": 106897468684, "time": 1849, "config": "windows-oldrel-x86_64", "r": "4.5.3", "check": "OK", "artifact": "10716420841" }, { "job": 106897468908, "time": 342, "config": "windows-release-arm64", "r": "4.6.1", "check": "OK", "artifact": "10714931992" }, { "job": 106897469550, "time": 2661, "config": "windows-release-x86_64", "r": "4.6.1", "check": "OK", "artifact": "10716623443" } ], "_registered": true, "_dependencies": [ { "package": "R", "version": ">= 4.5.0", "role": "Depends" }, { "package": "Rcpp", "version": ">= 1.1.0", "role": "LinkingTo" }, { "package": "Biobase", "role": "Imports" }, { "package": "methods", "role": "Imports" }, { "package": "Rcpp", "version": ">= 1.1.0", "role": "Imports" }, { "package": "BiocNeighbors", "role": "Suggests" }, { "package": "BiocSingular", "role": "Suggests" }, { "package": "BiocStyle", "role": "Suggests" }, { "package": "S4Vectors", "role": "Suggests" }, { "package": "SingleCellExperiment", "role": "Suggests" }, { "package": "SummarizedExperiment", "role": "Suggests" }, { "package": "knitr", "role": "Suggests" }, { "package": "Matrix", "role": "Suggests" }, { "package": "float", "role": "Suggests" }, { "package": "rmarkdown", "role": "Suggests" }, { "package": "scater", "role": "Suggests" }, { "package": "scRNAseq", "role": "Suggests" }, { "package": "scran", "role": "Suggests" }, { "package": "scuttle", "role": "Suggests" }, { "package": "testthat", "role": "Suggests" }, { "package": "withr", "role": "Suggests" } ], "_owner": "biocstaging", "_selfowned": true, "_usedby": 0, "_updates": [ { "week": "2026-25", "n": 223 }, { "week": "2026-26", "n": 383 }, { "week": "2026-27", "n": 8 }, { "week": "2026-28", "n": 31 }, { "week": "2026-29", "n": 4 }, { "week": "2026-31", "n": 23 }, { "week": "2026-32", "n": 3 }, { "week": "2026-33", "n": 3 }, { "week": "2026-35", "n": 12 }, { "week": "2026-36", "n": 6 }, { "week": "2026-37", "n": 9 }, { "week": "2026-38", "n": 2 }, { "week": "2026-39", "n": 3 } ], "_tags": [], "_topics": [ "software", "infrastructure", "gpu", "singlecell", "flowcytometry", "massspectrometry", "imagingmassspectrometry", "proteomics", "clustering", "dimensionreduction", "classification", "functionalprediction", "openblas", "fortran", "cpp", "openmp" ], "_stars": 0, "_contributors": [ { "user": "tkcaccia", "count": 716, "uuid": 15799157 } ], "_userbio": { "uuid": 278472782, "type": "organization", "name": "BiocStaging", "followers": 2 }, "_downloads": { "count": 0, "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/faissR" }, "_devurl": "https://github.com/tkcaccia/faissr", "_searchresults": 0, "_rbuild": "4.6.1", "_assets": [ "extra/citation.cff", "extra/citation.html", "extra/citation.json", "extra/citation.txt", "extra/contents.json", "extra/faissR.html", "extra/manual.pdf", "extra/NEWS.html", "extra/NEWS.txt", "extra/readme.html", "extra/readme.md", "LICENSE" ], "_cranurl": false, "_exports": [ "backend_info", "candidate_knn", "cuda_available", "cuvs_available", "faiss_available", "faiss_gpu_available", "faissR_backend", "fast_kmeans", "gpu_knn_to_host", "knn", "nn", "nn_capabilities", "nn_gpu", "nn_metric_preflight" ], "_help": [ { "page": "backend_info", "title": "Summarize native neighbour-search backend availability", "topics": [ "backend_info" ] }, { "page": "candidate_knn", "title": "Select nearest neighbours from a candidate matrix", "topics": [ "candidate_knn" ] }, { "page": "cuda_available", "title": "Check whether the native CUDA backend is available", "topics": [ "cuda_available" ] }, { "page": "cuvs_available", "title": "Check whether the RAPIDS cuVS backend is available", "topics": [ "cuvs_available" ] }, { "page": "faiss_available", "title": "Check whether the real FAISS C++ backend is available", "topics": [ "faiss_available" ] }, { "page": "faiss_gpu_available", "title": "Check whether FAISS GPU support is available", "topics": [ "faiss_gpu_available" ] }, { "page": "faissR_backend", "title": "Configure the default faissR execution backend", "topics": [ "faissR_backend" ] }, { "page": "faissR-c-api", "title": "Native C-callable nearest-neighbour API", "topics": [ "faissR-c-api" ] }, { "page": "fast_kmeans", "title": "Fast k-means clustering", "topics": [ "fast_kmeans" ] }, { "page": "gpu_knn_to_host", "title": "Copy a GPU-resident KNN result to host matrices", "topics": [ "gpu_knn_to_host" ] }, { "page": "knn", "title": "Fit or apply a k-nearest-neighbour classifier or regressor", "topics": [ "knn" ] }, { "page": "nn", "title": "Nearest neighbors from row-wise matrices", "topics": [ "nn" ] }, { "page": "nn_capabilities", "title": "Nearest-neighbour method capabilities", "topics": [ "nn_capabilities" ] }, { "page": "nn_gpu", "title": "GPU-resident tuned nearest-neighbour search", "topics": [ "nn_gpu" ] }, { "page": "nn_metric_preflight", "title": "Preflight nearest-neighbor metric inputs", "topics": [ "nn_metric_preflight" ] }, { "page": "predict.faissR_knn_model", "title": "Predict from a faissR kNN model", "topics": [ "predict.faissR_knn_model" ] }, { "page": "print.faissR_knn_model", "title": "Print a fitted faissR kNN model", "topics": [ "print.faissR_knn_model" ] }, { "page": "summary.faissR", "title": "Summaries of faissR result objects", "topics": [ "summary.faissR", "summary.faissR_gpu_knn", "summary.faissR_kmeans", "summary.faissR_knn_model", "summary.faissR_nn" ] }, { "page": "zeisel_brain_pca", "title": "Zeisel brain PCA vignette artifact", "topics": [ "zeisel_brain_pca" ] } ], "_readme": "https://github.com/BiocStaging/faissR/raw/HEAD/README.md", "_rundeps": [ "Biobase", "BiocGenerics", "generics", "Rcpp" ], "_sysdeps": [ { "shlib": "liblapack", "package": "libopenblas0-pthread", "source": "openblas", "version": "0.3.32+ds-5", "name": "openblas", "homepage": "https://www.openblas.net/", "description": "Optimized BLAS (linear algebra) library (shared lib, pthread)" }, { "shlib": "libblas", "package": "libopenblas0-pthread", "source": "openblas", "version": "0.3.32+ds-5", "name": "openblas", "homepage": "https://www.openblas.net/", "description": "Optimized BLAS (linear algebra) library (shared lib, pthread)" }, { "shlib": "libgfortran", "package": "libgfortran5", "source": "gcc", "version": "16-20260322-1ubuntu1", "name": "fortran", "homepage": "http://gcc.gnu.org/", "description": "Runtime library for GNU Fortran applications" }, { "shlib": "libstdc++", "package": "libstdc++6", "source": "gcc", "version": "16-20260322-1ubuntu1", "name": "c++", "homepage": "http://gcc.gnu.org/", "description": "GNU Standard C++ Library v3" }, { "shlib": "libgomp", "package": "libgomp1", "source": "gcc", "version": "16-20260322-1ubuntu1", "name": "openmp", "homepage": "http://gcc.gnu.org/", "description": "GCC OpenMP (GOMP) support library" } ], "_vignettes": [ { "source": "faissR.Rmd", "filename": "faissR.html", "title": "faissR: nearest-neighbor search for Bioconductor workflows", "author": "Stefano Cacciatore", "engine": "knitr::rmarkdown", "headings": [ "Introduction", "Example data", "Inspect execution capabilities", "Run a nearest-neighbor search", "Approximate search and observed recall", "Automatic selection", "Metrics and edge cases", "Dense input contract", "Reuse an index for prediction", "Optional CUDA execution", "Session information" ], "created": "2026-07-06 13:11:18", "modified": "2026-09-22 05:10:13", "commits": 24 }, { "source": "installation.Rmd", "filename": "installation.html", "title": "Installing faissR and auditing native capabilities", "author": "Stefano Cacciatore", "engine": "knitr::rmarkdown", "headings": [ "Build contract", "Tested combinations", "Linux CPU-only installation", "Optional Linux performance configuration", "macOS CPU-only installation", "Windows CPU-only installation", "Linux CUDA and cuVS installation", "Audit the installed capability", "Common failures", "Checks and licenses", "Session information" ], "created": "2026-08-30 16:30:58", "modified": "2026-09-22 15:08:10", "commits": 14 } ], "_score": 4.113943352306837, "_indexed": true, "_nocasepkg": "faissr", "_universes": [ "biocstaging", "tkcaccia" ], "_previous": "0.99.46", "_binaries": [ { "r": "4.7.0", "os": "linux", "version": "0.99.47", "date": "2026-09-22T19:19:26.000Z", "distro": "resolute", "arch": "aarch64", "commit": "82ed27005c5292b15f3c8499ac61047c37240c5b", "fileid": "https://r2.ropensci.org/24c7af322ee2dfa8d3a76317ed1c7de0e3f8d5d39c61935548cea69a8fa37999", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/biocstaging/actions/runs/35771436924" }, { "r": "4.7.0", "os": "linux", "version": "0.99.47", "date": "2026-09-22T19:20:33.000Z", "distro": "resolute", "arch": "x86_64", "commit": "82ed27005c5292b15f3c8499ac61047c37240c5b", "fileid": "https://r2.ropensci.org/ebec95153d891b454484a25846cd2777ec324b645cb4b499d3e9c905cb34ce8a", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/biocstaging/actions/runs/35771436924" }, { "r": "4.6.1", "os": "linux", "version": "0.99.47", "date": "2026-09-22T19:19:54.000Z", "distro": "resolute", "arch": "aarch64", "commit": "82ed27005c5292b15f3c8499ac61047c37240c5b", "fileid": "https://r2.ropensci.org/3e78c10ee349c687a2ebb8f60f5963b4a858982888095fdd5510b254250ac6af", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/biocstaging/actions/runs/35771436924" }, { "r": "4.6.1", "os": "linux", "version": "0.99.47", "date": "2026-09-22T19:19:22.000Z", "distro": "resolute", "arch": "x86_64", "commit": "82ed27005c5292b15f3c8499ac61047c37240c5b", "fileid": "https://r2.ropensci.org/4810e7e1b350b1f42c22c4fb4173bd16b73dc52b8f7c4a5c17616534adf43849", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/biocstaging/actions/runs/35771436924" }, { "r": "4.5.3", "os": "mac", "version": "0.99.47", "date": "2026-09-22T19:22:07.000Z", "arch": "aarch64", "commit": "82ed27005c5292b15f3c8499ac61047c37240c5b", "fileid": "https://r2.ropensci.org/4ce53548420d550932113084779f1662c7b98432a1af09e3edff1487fced04d6", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/biocstaging/actions/runs/35771436924" }, { "r": "4.5.3", "os": "mac", "version": "0.99.47", "date": "2026-09-22T19:24:37.000Z", "arch": "x86_64", "commit": "82ed27005c5292b15f3c8499ac61047c37240c5b", "fileid": "https://r2.ropensci.org/3f6a93cca0b140382d9918e918f86f3f46de50b5de79f0994b6b85f29e960a03", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/biocstaging/actions/runs/35771436924" }, { "r": "4.6.1", "os": "mac", "version": "0.99.47", "date": "2026-09-22T19:18:22.000Z", "arch": "aarch64", "commit": "82ed27005c5292b15f3c8499ac61047c37240c5b", "fileid": "https://r2.ropensci.org/52b0357a0a3053c8f8e5092d559b2a0e0e124c648617b80ef11f54f9dcc1da1e", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/biocstaging/actions/runs/35771436924" }, { "r": "4.6.1", "os": "mac", "version": "0.99.47", "date": "2026-09-22T19:22:26.000Z", "arch": "x86_64", "commit": "82ed27005c5292b15f3c8499ac61047c37240c5b", "fileid": "https://r2.ropensci.org/c3b2873675cf7761811eb69c4923f46f0dce80afc1c63056451cb8cd93877289", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/biocstaging/actions/runs/35771436924" }, { "r": "4.6.0", "os": "wasm", "version": "0.99.47", "date": "2026-09-22T19:18:43.000Z", "arch": "emscripten", "commit": "82ed27005c5292b15f3c8499ac61047c37240c5b", "fileid": "https://r2.ropensci.org/ce9de46a070ee37389c0cfdb82a354efb28fc4cc55506d507950ff4f13043cd7", "status": "success", "buildurl": "https://github.com/r-universe/biocstaging/actions/runs/35771436924" }, { "r": "4.7.0", "os": "win", "version": "0.99.47", "date": "2026-09-22T19:18:38.000Z", "arch": "aarch64", "commit": "82ed27005c5292b15f3c8499ac61047c37240c5b", "fileid": "https://r2.ropensci.org/6cf1cbeebd75e5471d0309c842f601cf80d36e0b76eeb8b8635651d7afe2399a", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/biocstaging/actions/runs/35771436924" }, { "r": "4.7.0", "os": "win", "version": "0.99.47", "date": "2026-09-22T19:42:13.000Z", "arch": "x86_64", "commit": "82ed27005c5292b15f3c8499ac61047c37240c5b", "fileid": "https://r2.ropensci.org/cbc5747c52d2d7eb4253371217843ac0ffde8b1478436b81a3c9f05d9771a257", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/biocstaging/actions/runs/35771436924" }, { "r": "4.5.3", "os": "win", "version": "0.99.47", "date": "2026-09-22T19:42:16.000Z", "arch": "x86_64", "commit": "82ed27005c5292b15f3c8499ac61047c37240c5b", "fileid": "https://r2.ropensci.org/7a0fedb5c459ba7956d87ca07273d8c763aa416c47a7c0e4fa6f9ce16b74d8fc", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/biocstaging/actions/runs/35771436924" }, { "r": "4.6.1", "os": "win", "version": "0.99.47", "date": "2026-09-22T19:18:31.000Z", "arch": "aarch64", "commit": "82ed27005c5292b15f3c8499ac61047c37240c5b", "fileid": "https://r2.ropensci.org/738c659da1aa3611f29f056738460effb221cf92e8653e2f4ae2da69be62ca6b", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/biocstaging/actions/runs/35771436924" }, { "r": "4.6.1", "os": "win", "version": "0.99.47", "date": "2026-09-22T19:56:41.000Z", "arch": "x86_64", "commit": "82ed27005c5292b15f3c8499ac61047c37240c5b", "fileid": "https://r2.ropensci.org/dcc1e91d5b1c979482dcbee9c3fd9bf7582ad6ee444bdf816bdeed83567b3017", "status": "success", "check": "OK", "buildurl": "https://github.com/r-universe/biocstaging/actions/runs/35771436924" } ] }