From 2586f8059673bb4fbd1ae029dacb8bc757c879a3 Mon Sep 17 00:00:00 2001
From: Ben Frederickson <ben@benfrederickson.com>
Date: Fri, 17 Mar 2023 19:14:37 -0700
Subject: [PATCH 01/25] Remove faiss_mr.hpp (#1351)

Remove faiss_mr.hpp - in favour of https://github.com/rapidsai/cuml/pull/5281

Authors:
  - Ben Frederickson (https://github.com/benfred)

Approvers:
  - Corey J. Nolet (https://github.com/cjnolet)

URL: https://github.com/rapidsai/raft/pull/1351
---
 cpp/include/raft/spatial/knn/faiss_mr.hpp | 640 ----------------------
 cpp/test/CMakeLists.txt                   |   1 -
 cpp/test/neighbors/faiss_mr.cu            |  95 ----
 3 files changed, 736 deletions(-)
 delete mode 100644 cpp/include/raft/spatial/knn/faiss_mr.hpp
 delete mode 100644 cpp/test/neighbors/faiss_mr.cu

diff --git a/cpp/include/raft/spatial/knn/faiss_mr.hpp b/cpp/include/raft/spatial/knn/faiss_mr.hpp
deleted file mode 100644
index 3cae417996..0000000000
--- a/cpp/include/raft/spatial/knn/faiss_mr.hpp
+++ /dev/null
@@ -1,640 +0,0 @@
-/**
- * Copyright (c) Facebook, Inc. and its affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- */
-
-/*
-This code contains unnecessary code duplication. These could be deleted
-once the relevant changes would be made on the FAISS side. Indeed most of
-the logic in the below code is similar to FAISS's standard implementation
-and should thus be inherited instead of duplicated. This FAISS's issue
-once solved should allow the removal of the unnecessary duplicates
-in this file : https://github.com/facebookresearch/faiss/issues/2097
-*/
-
-#pragma once
-
-#include <faiss/gpu/GpuResources.h>
-#include <faiss/gpu/utils/DeviceUtils.h>
-#include <faiss/gpu/utils/StackDeviceMemory.h>
-#include <faiss/gpu/utils/StaticUtils.h>
-#include <faiss/impl/FaissAssert.h>
-#include <functional>
-#include <iostream>
-#include <limits>
-#include <map>
-#include <sstream>
-#include <unordered_map>
-#include <vector>
-
-#include <rmm/mr/device/cuda_memory_resource.hpp>
-#include <rmm/mr/device/managed_memory_resource.hpp>
-#include <rmm/mr/host/pinned_memory_resource.hpp>
-
-namespace raft {
-namespace spatial {
-namespace knn {
-
-using namespace faiss::gpu;
-
-namespace {
-
-// How many streams per device we allocate by default (for multi-streaming)
-constexpr int kNumStreams = 2;
-
-// Use 256 MiB of pinned memory for async CPU <-> GPU copies by default
-constexpr size_t kDefaultPinnedMemoryAllocation = (size_t)256 * 1024 * 1024;
-
-// Default temporary memory allocation for <= 4 GiB memory GPUs
-constexpr size_t k4GiBTempMem = (size_t)512 * 1024 * 1024;
-
-// Default temporary memory allocation for <= 8 GiB memory GPUs
-constexpr size_t k8GiBTempMem = (size_t)1024 * 1024 * 1024;
-
-// Maximum temporary memory allocation for all GPUs
-constexpr size_t kMaxTempMem = (size_t)1536 * 1024 * 1024;
-
-std::string allocsToString(const std::unordered_map<void*, AllocRequest>& map)
-{
-  // Produce a sorted list of all outstanding allocations by type
-  std::unordered_map<AllocType, std::pair<int, size_t>> stats;
-
-  for (auto& entry : map) {
-    auto& a = entry.second;
-
-    auto it = stats.find(a.type);
-    if (it != stats.end()) {
-      stats[a.type].first++;
-      stats[a.type].second += a.size;
-    } else {
-      stats[a.type] = std::make_pair(1, a.size);
-    }
-  }
-
-  std::stringstream ss;
-  for (auto& entry : stats) {
-    ss << "Alloc type " << allocTypeToString(entry.first) << ": " << entry.second.first
-       << " allocations, " << entry.second.second << " bytes\n";
-  }
-
-  return ss.str();
-}
-
-}  // namespace
-
-/// RMM implementation of the GpuResources object that provides for a
-/// temporary memory manager
-class RmmGpuResourcesImpl : public GpuResources {
- public:
-  RmmGpuResourcesImpl()
-    : pinnedMemAlloc_(nullptr),
-      pinnedMemAllocSize_(0),
-      // let the adjustment function determine the memory size for us by passing
-      // in a huge value that will then be adjusted
-      tempMemSize_(getDefaultTempMemForGPU(-1, std::numeric_limits<size_t>::max())),
-      pinnedMemSize_(kDefaultPinnedMemoryAllocation),
-      allocLogging_(false),
-      cmr(new rmm::mr::cuda_memory_resource),
-      mmr(new rmm::mr::managed_memory_resource),
-      pmr(new rmm::mr::pinned_memory_resource){};
-
-  ~RmmGpuResourcesImpl()
-  {
-    // The temporary memory allocator has allocated memory through us, so clean
-    // that up before we finish fully de-initializing ourselves
-    tempMemory_.clear();
-
-    // Make sure all allocations have been freed
-    bool allocError = false;
-
-    for (auto& entry : allocs_) {
-      auto& map = entry.second;
-
-      if (!map.empty()) {
-        std::cerr << "RmmGpuResources destroyed with allocations outstanding:\n"
-                  << "Device " << entry.first << " outstanding allocations:\n";
-        std::cerr << allocsToString(map);
-        allocError = true;
-      }
-    }
-
-    FAISS_ASSERT_MSG(!allocError, "GPU memory allocations not properly cleaned up");
-
-    for (auto& entry : defaultStreams_) {
-      DeviceScope scope(entry.first);
-
-      // We created these streams, so are responsible for destroying them
-      CUDA_VERIFY(cudaStreamDestroy(entry.second));
-    }
-
-    for (auto& entry : alternateStreams_) {
-      DeviceScope scope(entry.first);
-
-      for (auto stream : entry.second) {
-        CUDA_VERIFY(cudaStreamDestroy(stream));
-      }
-    }
-
-    for (auto& entry : asyncCopyStreams_) {
-      DeviceScope scope(entry.first);
-
-      CUDA_VERIFY(cudaStreamDestroy(entry.second));
-    }
-
-    for (auto& entry : blasHandles_) {
-      DeviceScope scope(entry.first);
-
-      auto blasStatus = cublasDestroy(entry.second);
-      FAISS_ASSERT(blasStatus == CUBLAS_STATUS_SUCCESS);
-    }
-
-    if (pinnedMemAlloc_) { pmr->deallocate(pinnedMemAlloc_, pinnedMemAllocSize_); }
-  };
-
-  /// Disable allocation of temporary memory; all temporary memory
-  /// requests will call cudaMalloc / cudaFree at the point of use
-  void noTempMemory() { setTempMemory(0); };
-
-  /// Specify that we wish to use a certain fixed size of memory on
-  /// all devices as temporary memory. This is the upper bound for the GPU
-  /// memory that we will reserve. We will never go above 1.5 GiB on any GPU;
-  /// smaller GPUs (with <= 4 GiB or <= 8 GiB) will use less memory than that.
-  /// To avoid any temporary memory allocation, pass 0.
-  void setTempMemory(size_t size)
-  {
-    if (tempMemSize_ != size) {
-      // adjust based on general limits
-      tempMemSize_ = getDefaultTempMemForGPU(-1, size);
-
-      // We need to re-initialize memory resources for all current devices that
-      // have been initialized.
-      // This should be safe to do, even if we are currently running work, because
-      // the cudaFree call that this implies will force-synchronize all GPUs with
-      // the CPU
-      for (auto& p : tempMemory_) {
-        int device = p.first;
-        // Free the existing memory first
-        p.second.reset();
-
-        // Allocate new
-        p.second = std::unique_ptr<StackDeviceMemory>(
-          new StackDeviceMemory(this,
-                                p.first,
-                                // adjust for this specific device
-                                getDefaultTempMemForGPU(device, tempMemSize_)));
-      }
-    }
-  };
-
-  /// Set amount of pinned memory to allocate, for async GPU <-> CPU
-  /// transfers
-  void setPinnedMemory(size_t size)
-  {
-    // Should not call this after devices have been initialized
-    FAISS_ASSERT(defaultStreams_.size() == 0);
-    FAISS_ASSERT(!pinnedMemAlloc_);
-
-    pinnedMemSize_ = size;
-  };
-
-  /// Called to change the stream for work ordering. We do not own `stream`;
-  /// i.e., it will not be destroyed when the GpuResources object gets cleaned
-  /// up.
-  /// We are guaranteed that all Faiss GPU work is ordered with respect to
-  /// this stream upon exit from an index or other Faiss GPU call.
-  void setDefaultStream(int device, cudaStream_t stream)
-  {
-    if (isInitialized(device)) {
-      // A new series of calls may not be ordered with what was the previous
-      // stream, so if the stream being specified is different, then we need to
-      // ensure ordering between the two (new stream waits on old).
-      auto it                 = userDefaultStreams_.find(device);
-      cudaStream_t prevStream = nullptr;
-
-      if (it != userDefaultStreams_.end()) {
-        prevStream = it->second;
-      } else {
-        FAISS_ASSERT(defaultStreams_.count(device));
-        prevStream = defaultStreams_[device];
-      }
-
-      if (prevStream != stream) { streamWait({stream}, {prevStream}); }
-    }
-
-    userDefaultStreams_[device] = stream;
-  };
-
-  /// Revert the default stream to the original stream managed by this resources
-  /// object, in case someone called `setDefaultStream`.
-  void revertDefaultStream(int device)
-  {
-    if (isInitialized(device)) {
-      auto it = userDefaultStreams_.find(device);
-
-      if (it != userDefaultStreams_.end()) {
-        // There was a user stream set that we need to synchronize against
-        cudaStream_t prevStream = userDefaultStreams_[device];
-
-        FAISS_ASSERT(defaultStreams_.count(device));
-        cudaStream_t newStream = defaultStreams_[device];
-
-        streamWait({newStream}, {prevStream});
-      }
-    }
-
-    userDefaultStreams_.erase(device);
-  };
-
-  /// Returns the stream for the given device on which all Faiss GPU work is
-  /// ordered.
-  /// We are guaranteed that all Faiss GPU work is ordered with respect to
-  /// this stream upon exit from an index or other Faiss GPU call.
-  cudaStream_t getDefaultStream(int device)
-  {
-    initializeForDevice(device);
-
-    auto it = userDefaultStreams_.find(device);
-    if (it != userDefaultStreams_.end()) {
-      // There is a user override stream set
-      return it->second;
-    }
-
-    // Otherwise, our base default stream
-    return defaultStreams_[device];
-  };
-
-  /// Called to change the work ordering streams to the null stream
-  /// for all devices
-  void setDefaultNullStreamAllDevices()
-  {
-    for (int dev = 0; dev < getNumDevices(); ++dev) {
-      setDefaultStream(dev, nullptr);
-    }
-  };
-
-  /// If enabled, will print every GPU memory allocation and deallocation to
-  /// standard output
-  void setLogMemoryAllocations(bool enable) { allocLogging_ = enable; };
-
- public:
-  /// Internal system calls
-
-  /// Initialize resources for this device
-  void initializeForDevice(int device)
-  {
-    if (isInitialized(device)) { return; }
-
-    // If this is the first device that we're initializing, create our
-    // pinned memory allocation
-    if (defaultStreams_.empty() && pinnedMemSize_ > 0) {
-      pinnedMemAlloc_     = pmr->allocate(pinnedMemSize_);
-      pinnedMemAllocSize_ = pinnedMemSize_;
-    }
-
-    FAISS_ASSERT(device < getNumDevices());
-    DeviceScope scope(device);
-
-    // Make sure that device properties for all devices are cached
-    auto& prop = getDeviceProperties(device);
-
-    // Also check to make sure we meet our minimum compute capability (3.0)
-    FAISS_ASSERT_FMT(prop.major >= 3,
-                     "Device id %d with CC %d.%d not supported, "
-                     "need 3.0+ compute capability",
-                     device,
-                     prop.major,
-                     prop.minor);
-
-    // Create streams
-    cudaStream_t defaultStream = 0;
-    CUDA_VERIFY(cudaStreamCreateWithFlags(&defaultStream, cudaStreamNonBlocking));
-
-    defaultStreams_[device] = defaultStream;
-
-    cudaStream_t asyncCopyStream = 0;
-    CUDA_VERIFY(cudaStreamCreateWithFlags(&asyncCopyStream, cudaStreamNonBlocking));
-
-    asyncCopyStreams_[device] = asyncCopyStream;
-
-    std::vector<cudaStream_t> deviceStreams;
-    for (int j = 0; j < kNumStreams; ++j) {
-      cudaStream_t stream = 0;
-      CUDA_VERIFY(cudaStreamCreateWithFlags(&stream, cudaStreamNonBlocking));
-
-      deviceStreams.push_back(stream);
-    }
-
-    alternateStreams_[device] = std::move(deviceStreams);
-
-    // Create cuBLAS handle
-    cublasHandle_t blasHandle = 0;
-    auto blasStatus           = cublasCreate(&blasHandle);
-    FAISS_ASSERT(blasStatus == CUBLAS_STATUS_SUCCESS);
-    blasHandles_[device] = blasHandle;
-
-    // For CUDA 10 on V100, enabling tensor core usage would enable automatic
-    // rounding down of inputs to f16 (though accumulate in f32) which results in
-    // unacceptable loss of precision in general.
-    // For CUDA 11 / A100, only enable tensor core support if it doesn't result in
-    // a loss of precision.
-#if CUDA_VERSION >= 11000
-    cublasSetMathMode(blasHandle, CUBLAS_MATH_DISALLOW_REDUCED_PRECISION_REDUCTION);
-#endif
-
-    FAISS_ASSERT(allocs_.count(device) == 0);
-    allocs_[device] = std::unordered_map<void*, AllocRequest>();
-
-    FAISS_ASSERT(tempMemory_.count(device) == 0);
-    auto mem = std::unique_ptr<StackDeviceMemory>(
-      new StackDeviceMemory(this,
-                            device,
-                            // adjust for this specific device
-                            getDefaultTempMemForGPU(device, tempMemSize_)));
-
-    tempMemory_.emplace(device, std::move(mem));
-  };
-
-  cublasHandle_t getBlasHandle(int device)
-  {
-    initializeForDevice(device);
-    return blasHandles_[device];
-  };
-
-  std::vector<cudaStream_t> getAlternateStreams(int device)
-  {
-    initializeForDevice(device);
-    return alternateStreams_[device];
-  };
-
-  /// Allocate non-temporary GPU memory
-  void* allocMemory(const AllocRequest& req)
-  {
-    initializeForDevice(req.device);
-
-    // We don't allocate a placeholder for zero-sized allocations
-    if (req.size == 0) { return nullptr; }
-
-    // Make sure that the allocation is a multiple of 16 bytes for alignment
-    // purposes
-    auto adjReq = req;
-    adjReq.size = utils::roundUp(adjReq.size, (size_t)16);
-
-    void* p = nullptr;
-
-    if (allocLogging_) { std::cout << "RmmGpuResources: alloc " << adjReq.toString() << "\n"; }
-
-    if (adjReq.space == MemorySpace::Temporary) {
-      // If we don't have enough space in our temporary memory manager, we need
-      // to allocate this request separately
-      auto& tempMem = tempMemory_[adjReq.device];
-
-      if (adjReq.size > tempMem->getSizeAvailable()) {
-        // We need to allocate this ourselves
-        AllocRequest newReq = adjReq;
-        newReq.space        = MemorySpace::Device;
-        newReq.type         = AllocType::TemporaryMemoryOverflow;
-
-        return allocMemory(newReq);
-      }
-
-      // Otherwise, we can handle this locally
-      p = tempMemory_[adjReq.device]->allocMemory(adjReq.stream, adjReq.size);
-
-    } else if (adjReq.space == MemorySpace::Device) {
-      p = cmr->allocate(adjReq.size, adjReq.stream);
-    } else if (adjReq.space == MemorySpace::Unified) {
-      p = mmr->allocate(adjReq.size, adjReq.stream);
-    } else {
-      FAISS_ASSERT_FMT(false, "unknown MemorySpace %d", (int)adjReq.space);
-    }
-
-    allocs_[adjReq.device][p] = adjReq;
-
-    return p;
-  };
-
-  /// Returns a previous allocation
-  void deallocMemory(int device, void* p)
-  {
-    FAISS_ASSERT(isInitialized(device));
-
-    if (!p) { return; }
-
-    auto& a = allocs_[device];
-    auto it = a.find(p);
-    FAISS_ASSERT(it != a.end());
-
-    auto& req = it->second;
-
-    if (allocLogging_) { std::cout << "RmmGpuResources: dealloc " << req.toString() << "\n"; }
-
-    if (req.space == MemorySpace::Temporary) {
-      tempMemory_[device]->deallocMemory(device, req.stream, req.size, p);
-    } else if (req.space == MemorySpace::Device) {
-      cmr->deallocate(p, req.size, req.stream);
-    } else if (req.space == MemorySpace::Unified) {
-      mmr->deallocate(p, req.size, req.stream);
-    } else {
-      FAISS_ASSERT_FMT(false, "unknown MemorySpace %d", (int)req.space);
-    }
-
-    a.erase(it);
-  };
-
-  size_t getTempMemoryAvailable(int device) const
-  {
-    FAISS_ASSERT(isInitialized(device));
-
-    auto it = tempMemory_.find(device);
-    FAISS_ASSERT(it != tempMemory_.end());
-
-    return it->second->getSizeAvailable();
-  };
-
-  /// Export a description of memory used for Python
-  std::map<int, std::map<std::string, std::pair<int, size_t>>> getMemoryInfo() const
-  {
-    using AT = std::map<std::string, std::pair<int, size_t>>;
-
-    std::map<int, AT> out;
-
-    for (auto& entry : allocs_) {
-      AT outDevice;
-
-      for (auto& a : entry.second) {
-        auto& v = outDevice[allocTypeToString(a.second.type)];
-        v.first++;
-        v.second += a.second.size;
-      }
-
-      out[entry.first] = std::move(outDevice);
-    }
-
-    return out;
-  };
-
-  std::pair<void*, size_t> getPinnedMemory()
-  {
-    return std::make_pair(pinnedMemAlloc_, pinnedMemAllocSize_);
-  };
-
-  cudaStream_t getAsyncCopyStream(int device)
-  {
-    initializeForDevice(device);
-    return asyncCopyStreams_[device];
-  };
-
- private:
-  /// Have GPU resources been initialized for this device yet?
-  bool isInitialized(int device) const
-  {
-    // Use default streams as a marker for whether or not a certain
-    // device has been initialized
-    return defaultStreams_.count(device) != 0;
-  };
-
-  /// Adjust the default temporary memory allocation based on the total GPU
-  /// memory size
-  static size_t getDefaultTempMemForGPU(int device, size_t requested)
-  {
-    auto totalMem = device != -1 ? getDeviceProperties(device).totalGlobalMem
-                                 : std::numeric_limits<size_t>::max();
-
-    if (totalMem <= (size_t)4 * 1024 * 1024 * 1024) {
-      // If the GPU has <= 4 GiB of memory, reserve 512 MiB
-
-      if (requested > k4GiBTempMem) { return k4GiBTempMem; }
-    } else if (totalMem <= (size_t)8 * 1024 * 1024 * 1024) {
-      // If the GPU has <= 8 GiB of memory, reserve 1 GiB
-
-      if (requested > k8GiBTempMem) { return k8GiBTempMem; }
-    } else {
-      // Never use more than 1.5 GiB
-      if (requested > kMaxTempMem) { return kMaxTempMem; }
-    }
-
-    // use whatever lower limit the user requested
-    return requested;
-  };
-
- private:
-  /// Set of currently outstanding memory allocations per device
-  /// device -> (alloc request, allocated ptr)
-  std::unordered_map<int, std::unordered_map<void*, AllocRequest>> allocs_;
-
-  /// Temporary memory provider, per each device
-  std::unordered_map<int, std::unique_ptr<StackDeviceMemory>> tempMemory_;
-
-  /// Our default stream that work is ordered on, one per each device
-  std::unordered_map<int, cudaStream_t> defaultStreams_;
-
-  /// This contains particular streams as set by the user for
-  /// ordering, if any
-  std::unordered_map<int, cudaStream_t> userDefaultStreams_;
-
-  /// Other streams we can use, per each device
-  std::unordered_map<int, std::vector<cudaStream_t>> alternateStreams_;
-
-  /// Async copy stream to use for GPU <-> CPU pinned memory copies
-  std::unordered_map<int, cudaStream_t> asyncCopyStreams_;
-
-  /// cuBLAS handle for each device
-  std::unordered_map<int, cublasHandle_t> blasHandles_;
-
-  /// Pinned memory allocation for use with this GPU
-  void* pinnedMemAlloc_;
-  size_t pinnedMemAllocSize_;
-
-  /// Another option is to use a specified amount of memory on all
-  /// devices
-  size_t tempMemSize_;
-
-  /// Amount of pinned memory we should allocate
-  size_t pinnedMemSize_;
-
-  /// Whether or not we log every GPU memory allocation and deallocation
-  bool allocLogging_;
-
-  // cuda_memory_resource
-  std::unique_ptr<rmm::mr::device_memory_resource> cmr;
-
-  // managed_memory_resource
-  std::unique_ptr<rmm::mr::device_memory_resource> mmr;
-
-  // pinned_memory_resource
-  std::unique_ptr<rmm::mr::host_memory_resource> pmr;
-};
-
-/// Default implementation of GpuResources that allocates a cuBLAS
-/// stream and 2 streams for use, as well as temporary memory.
-/// Internally, the Faiss GPU code uses the instance managed by getResources,
-/// but this is the user-facing object that is internally reference counted.
-class RmmGpuResources : public GpuResourcesProvider {
- public:
-  RmmGpuResources() : res_(new RmmGpuResourcesImpl){};
-
-  ~RmmGpuResources(){};
-
-  std::shared_ptr<GpuResources> getResources() { return res_; };
-
-  /// Disable allocation of temporary memory; all temporary memory
-  /// requests will call cudaMalloc / cudaFree at the point of use
-  void noTempMemory() { res_->noTempMemory(); };
-
-  /// Specify that we wish to use a certain fixed size of memory on
-  /// all devices as temporary memory. This is the upper bound for the GPU
-  /// memory that we will reserve. We will never go above 1.5 GiB on any GPU;
-  /// smaller GPUs (with <= 4 GiB or <= 8 GiB) will use less memory than that.
-  /// To avoid any temporary memory allocation, pass 0.
-  void setTempMemory(size_t size) { res_->setTempMemory(size); };
-
-  /// Set amount of pinned memory to allocate, for async GPU <-> CPU
-  /// transfers
-  void setPinnedMemory(size_t size) { res_->setPinnedMemory(size); };
-
-  /// Called to change the stream for work ordering. We do not own `stream`;
-  /// i.e., it will not be destroyed when the GpuResources object gets cleaned
-  /// up.
-  /// We are guaranteed that all Faiss GPU work is ordered with respect to
-  /// this stream upon exit from an index or other Faiss GPU call.
-  void setDefaultStream(int device, cudaStream_t stream)
-  {
-    res_->setDefaultStream(device, stream);
-  };
-
-  /// Revert the default stream to the original stream managed by this resources
-  /// object, in case someone called `setDefaultStream`.
-  void revertDefaultStream(int device) { res_->revertDefaultStream(device); };
-
-  /// Called to change the work ordering streams to the null stream
-  /// for all devices
-  void setDefaultNullStreamAllDevices() { res_->setDefaultNullStreamAllDevices(); };
-
-  /// Export a description of memory used for Python
-  std::map<int, std::map<std::string, std::pair<int, size_t>>> getMemoryInfo() const
-  {
-    return res_->getMemoryInfo();
-  };
-
-  /// Returns the current default stream
-  cudaStream_t getDefaultStream(int device) { return res_->getDefaultStream(device); };
-
-  /// Returns the current amount of temp memory available
-  size_t getTempMemoryAvailable(int device) const { return res_->getTempMemoryAvailable(device); };
-
-  /// Synchronize our default stream with the CPU
-  void syncDefaultStreamCurrentDevice() { res_->syncDefaultStreamCurrentDevice(); };
-
-  /// If enabled, will print every GPU memory allocation and deallocation to
-  /// standard output
-  void setLogMemoryAllocations(bool enable) { res_->setLogMemoryAllocations(enable); };
-
- private:
-  std::shared_ptr<RmmGpuResourcesImpl> res_;
-};
-
-}  // namespace knn
-}  // namespace spatial
-}  // namespace raft
\ No newline at end of file
diff --git a/cpp/test/CMakeLists.txt b/cpp/test/CMakeLists.txt
index acfb470bd8..696a271c65 100644
--- a/cpp/test/CMakeLists.txt
+++ b/cpp/test/CMakeLists.txt
@@ -271,7 +271,6 @@ if(BUILD_TESTS)
     test/neighbors/tiled_knn.cu
     test/neighbors/haversine.cu
     test/neighbors/ball_cover.cu
-    test/neighbors/faiss_mr.cu
     test/neighbors/epsilon_neighborhood.cu
     test/neighbors/refine.cu
     test/neighbors/selection.cu
diff --git a/cpp/test/neighbors/faiss_mr.cu b/cpp/test/neighbors/faiss_mr.cu
deleted file mode 100644
index 89f012db0f..0000000000
--- a/cpp/test/neighbors/faiss_mr.cu
+++ /dev/null
@@ -1,95 +0,0 @@
-/*
- * Copyright (c) 2021-2023, NVIDIA CORPORATION.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-#include "../test_utils.cuh"
-
-#include <faiss/gpu/GpuResources.h>
-#include <raft/distance/distance_types.hpp>
-#include <raft/spatial/knn/faiss_mr.hpp>
-#include <raft/spatial/knn/knn.cuh>
-
-#include <rmm/device_buffer.hpp>
-
-#include <gtest/gtest.h>
-
-#include <cstddef>
-#include <iostream>
-#include <vector>
-
-namespace raft {
-namespace spatial {
-namespace knn {
-
-using namespace faiss::gpu;
-
-struct AllocInputs {
-  size_t size;
-};
-
-template <typename T>
-class FAISS_MR_Test : public ::testing::TestWithParam<AllocInputs> {
- public:
-  FAISS_MR_Test()
-    : params_(::testing::TestWithParam<AllocInputs>::GetParam()), stream(handle.get_stream())
-  {
-  }
-
- protected:
-  size_t getFreeMemory(MemorySpace mem_space)
-  {
-    if (mem_space == MemorySpace::Device) {
-      rmm::mr::cuda_memory_resource cmr;
-      rmm::mr::device_memory_resource* dmr = &cmr;
-      return dmr->get_mem_info(stream).first;
-    } else if (mem_space == MemorySpace::Unified) {
-      rmm::mr::managed_memory_resource mmr;
-      rmm::mr::device_memory_resource* dmr = &mmr;
-      return dmr->get_mem_info(stream).first;
-    }
-    return 0;
-  }
-
-  void testAllocs(MemorySpace mem_space)
-  {
-    raft::spatial::knn::RmmGpuResources faiss_mr;
-    auto faiss_mr_impl = faiss_mr.getResources();
-    size_t free_before = getFreeMemory(mem_space);
-    AllocRequest req(AllocType::Other, 0, mem_space, stream, params_.size);
-    void* ptr               = faiss_mr_impl->allocMemory(req);
-    size_t free_after_alloc = getFreeMemory(mem_space);
-    faiss_mr_impl->deallocMemory(0, ptr);
-    ASSERT_TRUE(free_after_alloc <= free_before - params_.size);
-  }
-
-  raft::device_resources handle;
-  cudaStream_t stream;
-  AllocInputs params_;
-};
-
-const std::vector<AllocInputs> inputs = {{19687}};
-
-typedef FAISS_MR_Test<float> FAISS_MR_TestF;
-TEST_P(FAISS_MR_TestF, TestAllocs)
-{
-  testAllocs(MemorySpace::Device);
-  testAllocs(MemorySpace::Unified);
-}
-
-INSTANTIATE_TEST_CASE_P(FAISS_MR_Test, FAISS_MR_TestF, ::testing::ValuesIn(inputs));
-
-}  // namespace knn
-}  // namespace spatial
-}  // namespace raft

From c4671ed33439c6776bd91a45d6583b84c08d37dd Mon Sep 17 00:00:00 2001
From: "Corey J. Nolet" <cjnolet@users.noreply.github.com>
Date: Sat, 18 Mar 2023 11:17:33 -0400
Subject: [PATCH 02/25] Removing FAISS from build (#1340)

This depends on https://github.com/rapidsai/raft/pull/1202 so those changes are also included here. This should also not be merged until that PR is merged.

Authors:
  - Corey J. Nolet (https://github.com/cjnolet)
  - Ben Frederickson (https://github.com/benfred)

Approvers:
  - Ben Frederickson (https://github.com/benfred)
  - Vyas Ramasubramani (https://github.com/vyasr)
  - Ray Douglass (https://github.com/raydouglass)

URL: https://github.com/rapidsai/raft/pull/1340
---
 README.md                                     | 10 +--
 build.sh                                      | 13 +--
 .../all_cuda-118_arch-x86_64.yaml             |  2 -
 conda/recipes/libraft/conda_build_config.yaml |  3 -
 conda/recipes/libraft/meta.yaml               |  4 -
 cpp/CMakeLists.txt                            | 23 +----
 cpp/cmake/thirdparty/get_faiss.cmake          | 89 -------------------
 dependencies.yaml                             |  2 -
 docs/source/build.md                          | 19 ++--
 9 files changed, 13 insertions(+), 152 deletions(-)
 delete mode 100644 cpp/cmake/thirdparty/get_faiss.cmake

diff --git a/README.md b/README.md
index a178d90008..ff1066492e 100755
--- a/README.md
+++ b/README.md
@@ -263,12 +263,12 @@ find_and_configure_raft(VERSION    ${RAFT_VERSION}.00
 
 Several CMake targets can be made available by adding components in the table below to the `RAFT_COMPONENTS` list above, separated by spaces. The `raft::raft` target will always be available. RAFT headers require, at a minimum, the CUDA toolkit libraries and RMM dependencies.
 
-| Component | Target | Description | Base Dependencies |
-| --- | --- | --- | --- |
+| Component | Target | Description | Base Dependencies                                                |
+| --- | --- | --- |------------------------------------------------------------------|
 | n/a | `raft::raft` | Full RAFT header library | CUDA toolkit library, RMM, Thrust (optional), NVTools (optional) |
-| distance | `raft::distance` | Pre-compiled template specializations for raft::distance | raft::raft, cuCollections (optional)  |
-| nn | `raft::nn` | Pre-compiled template specializations for raft::neighbors | raft::raft, FAISS (optional) |
-| distributed | `raft::distributed` | No specializations | raft::raft, UCX, NCCL |
+| distance | `raft::distance` | Pre-compiled template specializations for raft::distance | raft::raft, cuCollections (optional)                             |
+| nn | `raft::nn` | Pre-compiled template specializations for raft::neighbors | raft::raft                                                       |
+| distributed | `raft::distributed` | No specializations | raft::raft, UCX, NCCL                                            |
 
 ### Source
 
diff --git a/build.sh b/build.sh
index 575f6bdaa1..7215b8199a 100755
--- a/build.sh
+++ b/build.sh
@@ -18,7 +18,7 @@ ARGS=$*
 # script, and that this script resides in the repo dir!
 REPODIR=$(cd $(dirname $0); pwd)
 
-VALIDARGS="clean libraft pylibraft raft-dask docs tests bench clean --uninstall  -v -g -n --compile-libs --compile-nn --compile-dist --allgpuarch --no-nvtx --show_depr_warn -h --buildfaiss --minimal-deps"
+VALIDARGS="clean libraft pylibraft raft-dask docs tests bench clean --uninstall  -v -g -n --compile-libs --compile-nn --compile-dist --allgpuarch --no-nvtx --show_depr_warn -h --minimal-deps"
 HELP="$0 [<target> ...] [<flag> ...] [--cmake-args=\"<args>\"] [--cache-tool=<tool>] [--limit-tests=<targets>] [--limit-bench=<targets>]
  where <target> is:
    clean            - remove all existing build artifacts and configuration (start over)
@@ -45,7 +45,6 @@ HELP="$0 [<target> ...] [<flag> ...] [--cmake-args=\"<args>\"] [--cache-tool=<to
    --limit-tests               - semicolon-separated list of test executables to compile (e.g. NEIGHBORS_TEST;CLUSTER_TEST)
    --limit-bench               - semicolon-separated list of benchmark executables to compute (e.g. NEIGHBORS_BENCH;CLUSTER_BENCH)
    --allgpuarch                - build for all supported GPU architectures
-   --buildfaiss                - build faiss statically into raft
    --no-nvtx                   - disable nvtx (profiling markers), but allow enabling it in downstream projects
    --show_depr_warn            - show cmake deprecation warnings
    --cmake-args=\\\"<args>\\\" - pass arbitrary list of CMake configuration options (escape all quotes in argument)
@@ -69,11 +68,9 @@ BUILD_ALL_GPU_ARCH=0
 BUILD_TESTS=OFF
 BUILD_TYPE=Release
 BUILD_BENCH=OFF
-BUILD_STATIC_FAISS=OFF
 COMPILE_LIBRARIES=OFF
 COMPILE_NN_LIBRARY=OFF
 COMPILE_DIST_LIBRARY=OFF
-ENABLE_NN_DEPENDENCIES=OFF
 INSTALL_TARGET=install
 
 TEST_TARGETS="CLUSTER_TEST;CORE_TEST;DISTANCE_TEST;LABEL_TEST;LINALG_TEST;MATRIX_TEST;RANDOM_TEST;SOLVERS_TEST;SPARSE_TEST;SPARSE_DIST_TEST;SPARSE_NEIGHBORS_TEST;NEIGHBORS_TEST;STATS_TEST;UTILS_TEST"
@@ -278,7 +275,6 @@ if hasArg --compile-libs || (( ${NUMARGS} == 0 )); then
 fi
 
 if hasArg --compile-nn || hasArg --compile-libs || (( ${NUMARGS} == 0 )); then
-    ENABLE_NN_DEPENDENCIES=ON
     COMPILE_NN_LIBRARY=ON
     CMAKE_TARGET="${CMAKE_TARGET};raft_nn_lib"
 fi
@@ -299,7 +295,6 @@ if hasArg tests || (( ${NUMARGS} == 0 )); then
           $CMAKE_TARGET == *"NEIGHBORS_TEST"* || \
           $CMAKE_TARGET == *"STATS_TEST"* ]]; then
       echo "-- Enabling nearest neighbors lib for gtests"
-      ENABLE_NN_DEPENDENCIES=ON
       COMPILE_NN_LIBRARY=ON
     fi
 
@@ -324,7 +319,6 @@ if hasArg bench || (( ${NUMARGS} == 0 )); then
     if [[ $CMAKE_TARGET == *"CLUSTER_BENCH"* || \
           $CMAKE_TARGET == *"NEIGHBORS_BENCH"*  ]]; then
       echo "-- Enabling nearest neighbors lib for benchmarks"
-      ENABLE_NN_DEPENDENCIES=ON
       COMPILE_NN_LIBRARY=ON
     fi
 
@@ -338,9 +332,6 @@ if hasArg bench || (( ${NUMARGS} == 0 )); then
 
 fi
 
-if hasArg --buildfaiss; then
-    BUILD_STATIC_FAISS=ON
-fi
 if hasArg --no-nvtx; then
     NVTX=OFF
 fi
@@ -402,7 +393,6 @@ if (( ${NUMARGS} == 0 )) || hasArg libraft || hasArg docs || hasArg tests || has
           -DCMAKE_CUDA_ARCHITECTURES=${RAFT_CMAKE_CUDA_ARCHITECTURES} \
           -DCMAKE_BUILD_TYPE=${BUILD_TYPE} \
           -DRAFT_COMPILE_LIBRARIES=${COMPILE_LIBRARIES} \
-          -DRAFT_ENABLE_NN_DEPENDENCIES=${ENABLE_NN_DEPENDENCIES} \
           -DRAFT_NVTX=${NVTX} \
           -DDISABLE_DEPRECATION_WARNINGS=${DISABLE_DEPRECATION_WARNINGS} \
           -DBUILD_TESTS=${BUILD_TESTS} \
@@ -410,7 +400,6 @@ if (( ${NUMARGS} == 0 )) || hasArg libraft || hasArg docs || hasArg tests || has
           -DCMAKE_MESSAGE_LOG_LEVEL=${CMAKE_LOG_LEVEL} \
           -DRAFT_COMPILE_NN_LIBRARY=${COMPILE_NN_LIBRARY} \
           -DRAFT_COMPILE_DIST_LIBRARY=${COMPILE_DIST_LIBRARY} \
-          -DRAFT_USE_FAISS_STATIC=${BUILD_STATIC_FAISS} \
           -DRAFT_ENABLE_thrust_DEPENDENCY=${ENABLE_thrust_DEPENDENCY} \
           ${CACHE_ARGS} \
           ${EXTRA_CMAKE_ARGS}
diff --git a/conda/environments/all_cuda-118_arch-x86_64.yaml b/conda/environments/all_cuda-118_arch-x86_64.yaml
index 47af29d9d2..39f1fef4d5 100644
--- a/conda/environments/all_cuda-118_arch-x86_64.yaml
+++ b/conda/environments/all_cuda-118_arch-x86_64.yaml
@@ -22,7 +22,6 @@ dependencies:
 - dask>=2023.1.1
 - distributed>=2023.1.1
 - doxygen>=1.8.20
-- faiss-proc=*=cuda
 - gcc_linux-64=11.*
 - graphviz
 - ipython
@@ -34,7 +33,6 @@ dependencies:
 - libcusolver=11.4.1.48
 - libcusparse-dev=11.7.5.86
 - libcusparse=11.7.5.86
-- libfaiss>=1.7.1=cuda*
 - ninja
 - numpydoc
 - pydata-sphinx-theme
diff --git a/conda/recipes/libraft/conda_build_config.yaml b/conda/recipes/libraft/conda_build_config.yaml
index ca213dc317..e1079f4db8 100644
--- a/conda/recipes/libraft/conda_build_config.yaml
+++ b/conda/recipes/libraft/conda_build_config.yaml
@@ -19,9 +19,6 @@ nccl_version:
 gtest_version:
   - "=1.10.0"
 
-libfaiss_version:
-  - "1.7.2 *_cuda"
-
 # The CTK libraries below are missing from the conda-forge::cudatoolkit
 # package. The "*_host_*" version specifiers correspond to `11.8` packages and the
 # "*_run_*" version specifiers correspond to `11.x` packages.
diff --git a/conda/recipes/libraft/meta.yaml b/conda/recipes/libraft/meta.yaml
index 771c7d55b8..158016ddf0 100644
--- a/conda/recipes/libraft/meta.yaml
+++ b/conda/recipes/libraft/meta.yaml
@@ -130,7 +130,6 @@ outputs:
       host:
         - {{ pin_subpackage('libraft-headers', exact=True) }}
         - cuda-profiler-api {{ cuda_profiler_api_host_version }}
-        - faiss-proc=*=cuda
         - lapack
         - libcublas {{ libcublas_host_version }}
         - libcublas-dev {{ libcublas_host_version }}
@@ -140,10 +139,7 @@ outputs:
         - libcusolver-dev {{ libcusolver_host_version }}
         - libcusparse {{ libcusparse_host_version }}
         - libcusparse-dev {{ libcusparse_host_version }}
-        - libfaiss {{ libfaiss_version }}
       run:
-        - faiss-proc=*=cuda
-        - libfaiss {{ libfaiss_version }}
         - {{ pin_subpackage('libraft-headers', exact=True) }}
     about:
       home: https://rapids.ai/
diff --git a/cpp/CMakeLists.txt b/cpp/CMakeLists.txt
index 2999045a0c..3889c39e6e 100644
--- a/cpp/CMakeLists.txt
+++ b/cpp/CMakeLists.txt
@@ -71,9 +71,6 @@ option(
 option(RAFT_COMPILE_DIST_LIBRARY "Enable building raft distant shared library instantiations"
        ${RAFT_COMPILE_LIBRARIES}
 )
-option(RAFT_ENABLE_NN_DEPENDENCIES "Search for raft::nn dependencies like faiss"
-       ${RAFT_COMPILE_NN_LIBRARY}
-)
 
 option(RAFT_ENABLE_thrust_DEPENDENCY "Enable Thrust dependency" ON)
 
@@ -89,17 +86,6 @@ if(BUILD_TESTS AND NOT RAFT_ENABLE_thrust_DEPENDENCY)
   set(RAFT_ENABLE_thrust_DEPENDENCY ON)
 endif()
 
-option(RAFT_EXCLUDE_FAISS_FROM_ALL "Exclude FAISS targets from RAFT's 'all' target" ON)
-
-include(CMakeDependentOption)
-cmake_dependent_option(
-  RAFT_USE_FAISS_STATIC
-  "Build and statically link the FAISS library for nearest neighbors search on GPU"
-  ON
-  RAFT_COMPILE_LIBRARIES
-  OFF
-)
-
 message(VERBOSE "RAFT: Building optional components: ${raft_FIND_COMPONENTS}")
 message(VERBOSE "RAFT: Build RAFT unit-tests: ${BUILD_TESTS}")
 message(VERBOSE "RAFT: Building raft C++ benchmarks: ${BUILD_BENCH}")
@@ -183,7 +169,6 @@ rapids_cpm_init()
 # thrust before rmm/cuco so we get the right version of thrust/cub
 include(cmake/thirdparty/get_thrust.cmake)
 include(cmake/thirdparty/get_rmm.cmake)
-include(cmake/thirdparty/get_faiss.cmake)
 include(cmake/thirdparty/get_cutlass.cmake)
 
 if(RAFT_ENABLE_cuco_DEPENDENCY)
@@ -502,7 +487,7 @@ if(RAFT_COMPILE_NN_LIBRARY)
 
   target_link_libraries(
     raft_nn_lib
-    PUBLIC faiss::faiss raft::raft
+    PUBLIC raft::raft
     PRIVATE nvidia::cutlass::cutlass
   )
   target_compile_options(
@@ -710,12 +695,6 @@ endif()
 
 if(nn IN_LIST raft_FIND_COMPONENTS)
   enable_language(CUDA)
-
-  if(TARGET faiss AND (NOT TARGET faiss::faiss))
-      add_library(faiss::faiss ALIAS faiss)
-  elseif(TARGET faiss::faiss AND (NOT TARGET faiss))
-      add_library(faiss ALIAS faiss::faiss)
-  endif()
 endif()
 ]=]
 )
diff --git a/cpp/cmake/thirdparty/get_faiss.cmake b/cpp/cmake/thirdparty/get_faiss.cmake
deleted file mode 100644
index e6f06a00a5..0000000000
--- a/cpp/cmake/thirdparty/get_faiss.cmake
+++ /dev/null
@@ -1,89 +0,0 @@
-#=============================================================================
-# Copyright (c) 2021-2022, NVIDIA CORPORATION.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#=============================================================================
-
-function(find_and_configure_faiss)
-    set(oneValueArgs VERSION REPOSITORY PINNED_TAG BUILD_STATIC_LIBS EXCLUDE_FROM_ALL)
-    cmake_parse_arguments(PKG "${options}" "${oneValueArgs}"
-                          "${multiValueArgs}" ${ARGN} )
-
-    if(RAFT_ENABLE_NN_DEPENDENCIES OR RAFT_COMPILE_LIBRARIES)
-      rapids_find_generate_module(faiss
-          HEADER_NAMES  faiss/IndexFlat.h
-          LIBRARY_NAMES faiss
-      )
-
-      set(BUILD_SHARED_LIBS ON)
-      if (PKG_BUILD_STATIC_LIBS)
-        set(BUILD_SHARED_LIBS OFF)
-        set(CPM_DOWNLOAD_faiss ON)
-      endif()
-
-      rapids_cpm_find(faiss ${PKG_VERSION}
-          GLOBAL_TARGETS     faiss::faiss
-          CPM_ARGS
-            GIT_REPOSITORY   ${PKG_REPOSITORY}
-            GIT_TAG          ${PKG_PINNED_TAG}
-            EXCLUDE_FROM_ALL ${PKG_EXCLUDE_FROM_ALL}
-            OPTIONS
-              "FAISS_ENABLE_PYTHON OFF"
-              "CUDAToolkit_ROOT ${CUDAToolkit_LIBRARY_DIR}"
-              "FAISS_ENABLE_GPU ON"
-              "BUILD_TESTING OFF"
-              "CMAKE_MESSAGE_LOG_LEVEL VERBOSE"
-              "FAISS_USE_CUDA_TOOLKIT_STATIC ${CUDA_STATIC_RUNTIME}"
-      )
-
-      if(TARGET faiss AND NOT TARGET faiss::faiss)
-          add_library(faiss::faiss ALIAS faiss)
-      endif()
-
-      if(faiss_ADDED)
-        rapids_export(BUILD faiss
-            EXPORT_SET faiss-targets
-            GLOBAL_TARGETS faiss
-            NAMESPACE faiss::)
-      endif()
-    endif()
-
-    # We generate the faiss-config files when we built faiss locally, so always do `find_dependency`
-    rapids_export_package(BUILD OpenMP raft-nn-lib-exports) # faiss uses openMP but doesn't export a need for it
-    rapids_export_package(BUILD faiss raft-nn-lib-exports GLOBAL_TARGETS faiss::faiss faiss)
-    rapids_export_package(INSTALL faiss raft-nn-lib-exports GLOBAL_TARGETS faiss::faiss faiss)
-
-    # Tell cmake where it can find the generated faiss-config.cmake we wrote.
-    include("${rapids-cmake-dir}/export/find_package_root.cmake")
-    rapids_export_find_package_root(BUILD faiss [=[${CMAKE_CURRENT_LIST_DIR}]=] raft-nn-lib-exports)
-endfunction()
-
-if(NOT RAFT_FAISS_GIT_TAG)
-  # TODO: Remove this once faiss supports FAISS_USE_CUDA_TOOLKIT_STATIC
-  # (https://github.com/facebookresearch/faiss/pull/2446)
-  set(RAFT_FAISS_GIT_TAG fea/statically-link-ctk-v1.7.0)
-  # set(RAFT_FAISS_GIT_TAG bde7c0027191f29c9dadafe4f6e68ca0ee31fb30)
-endif()
-
-if(NOT RAFT_FAISS_GIT_REPOSITORY)
-  # TODO: Remove this once faiss supports FAISS_USE_CUDA_TOOLKIT_STATIC
-  # (https://github.com/facebookresearch/faiss/pull/2446)
-  set(RAFT_FAISS_GIT_REPOSITORY https://github.com/trxcllnt/faiss.git)
-  # set(RAFT_FAISS_GIT_REPOSITORY https://github.com/facebookresearch/faiss.git)
-endif()
-
-find_and_configure_faiss(VERSION    1.7.0
-                         REPOSITORY  ${RAFT_FAISS_GIT_REPOSITORY}
-                         PINNED_TAG  ${RAFT_FAISS_GIT_TAG}
-                         BUILD_STATIC_LIBS ${RAFT_USE_FAISS_STATIC}
-                         EXCLUDE_FROM_ALL ${RAFT_EXCLUDE_FAISS_FROM_ALL})
diff --git a/dependencies.yaml b/dependencies.yaml
index 93893d07af..9fbf26bcd1 100644
--- a/dependencies.yaml
+++ b/dependencies.yaml
@@ -179,8 +179,6 @@ dependencies:
           - ucx-py=0.31.*
           - ucx-proc=*=gpu
           - rmm=23.04
-          - libfaiss>=1.7.1=cuda*
-          - faiss-proc=*=cuda
           - dask-cuda=23.04
   test_python:
     common:
diff --git a/docs/source/build.md b/docs/source/build.md
index 70b07f4e81..5ba1e75fad 100644
--- a/docs/source/build.md
+++ b/docs/source/build.md
@@ -47,7 +47,6 @@ In addition to the libraries included with cudatoolkit 11.0+, there are some oth
 - [cuCollections](https://github.com/NVIDIA/cuCollections) - Used in `raft::sparse::distance` API.
 - [Libcu++](https://github.com/NVIDIA/libcudacxx) v1.7.0 - Used by cuCollections
 - [CUTLASS](https://github.com/NVIDIA/cutlass)  v2.9.1 - Used in `raft::distance` API.
-- [FAISS](https://github.com/facebookresearch/faiss) v1.7.0 - Used in `raft::neighbors` API.
 - [NCCL](https://github.com/NVIDIA/nccl) - Used in `raft::comms` API and needed to build `raft-dask`.
 - [UCX](https://github.com/openucx/ucx) - Used in `raft::comms` API and needed to build `raft-dask`.
 - [Googletest](https://github.com/google/googletest) - Needed to build tests
@@ -60,14 +59,14 @@ The recommended way to build and install RAFT is to use the `build.sh` script in
 
 ### Header-only C++
 
-`build.sh` uses [rapids-cmake](https://github.com/rapidsai/rapids-cmake), which will automatically download any dependencies which are not already installed. It's important to note that while all the headers will be installed and available, some parts of the RAFT API depend on libraries like `FAISS`, which will need to be explicitly enabled in `build.sh`.
+`build.sh` uses [rapids-cmake](https://github.com/rapidsai/rapids-cmake), which will automatically download any dependencies which are not already installed. It's important to note that while all the headers will be installed and available, some parts of the RAFT API depend on libraries like CUTLASS, which will need to be explicitly enabled in `build.sh`.
 
 The following example will download the needed dependencies and install the RAFT headers into `$INSTALL_PREFIX/include/raft`. 
 ```bash
 ./build.sh libraft
 
 ```
-The `-n` flag can be passed to just have the build download the needed dependencies. Since RAFT is primarily used at build-time, the dependencies will never be installed by the RAFT build, with the exception of building FAISS statically into the shared libraries.
+The `-n` flag can be passed to just have the build download the needed dependencies. Since RAFT is primarily used at build-time, the dependencies will never be installed by the RAFT build.
 ```bash
 ./build.sh libraft -n
 ```
@@ -167,15 +166,13 @@ RAFT's cmake has the following configurable flags available:.
 | RAFT_COMPILE_LIBRARIES | ON, OFF | ON if either BUILD_TESTS or BUILD_BENCH is ON; otherwise OFF | Compiles all `libraft` shared libraries (these are required for Googletests) |
 | RAFT_COMPILE_NN_LIBRARY | ON, OFF | OFF | Compiles the `libraft-nn` shared library |
 | RAFT_COMPILE_DIST_LIBRARY | ON, OFF | OFF | Compiles the `libraft-distance` shared library |
-| RAFT_ENABLE_NN_DEPENDENCIES | ON, OFF | OFF | Searches for dependencies of nearest neighbors API, such as FAISS, and compiles them if not found. Needed for `raft::spatial::knn` |
-| RAFT_USE_FAISS_STATIC | ON, OFF | OFF | Statically link FAISS into `libraft-nn` |
 | DETECT_CONDA_ENV | ON, OFF | ON | Enable detection of conda environment for dependencies |
 | RAFT_NVTX | ON, OFF | OFF | Enable NVTX Markers |
 | CUDA_ENABLE_KERNELINFO | ON, OFF | OFF | Enables `kernelinfo` in nvcc. This is useful for `compute-sanitizer` |
 | CUDA_ENABLE_LINEINFO  | ON, OFF | OFF | Enable the -lineinfo option for nvcc |
 | CUDA_STATIC_RUNTIME | ON, OFF | OFF | Statically link the CUDA runtime |
 
-Currently, shared libraries are provided for the `libraft-nn` and `libraft-distance` components. The `libraft-nn` component depends upon [FAISS](https://github.com/facebookresearch/faiss) and the `RAFT_ENABLE_NN_DEPENDENCIES` option will build it from source if it is not already installed.
+Currently, shared libraries are provided for the `libraft-nn` and `libraft-distance` components.
 
 ### Python
 
@@ -277,7 +274,7 @@ If RAFT has already been installed, such as by using the `build.sh` script, use
 
 ### Using C++ pre-compiled shared libraries
 
-Use `find_package(raft COMPONENTS nn distance)` to enable the shared libraries and transitively pass dependencies through separate targets for each component. In this example, the `raft::distance` and `raft::nn` targets will be available for configuring linking paths in addition to `raft::raft`. These targets will also pass through any transitive dependencies (such as FAISS for the `nn` package).
+Use `find_package(raft COMPONENTS nn distance)` to enable the shared libraries and transitively pass dependencies through separate targets for each component. In this example, the `raft::distance` and `raft::nn` targets will be available for configuring linking paths in addition to `raft::raft`. These targets will also pass through any transitive dependencies (such as CUTLASS for the `distance` package).
 
 The pre-compiled libraries contain template specializations for commonly used types, such as single- and double-precision floating-point. In order to use the symbols in the pre-compiled libraries, the compiler needs to be told not to instantiate templates that are already contained in the shared libraries. By convention, these header files are named `specializations.cuh` and located in the base directory for the packages that contain specializations.
 
@@ -302,8 +299,8 @@ set(RAFT_FORK "rapidsai")
 set(RAFT_PINNED_TAG "branch-${RAFT_VERSION}")
 
 function(find_and_configure_raft)
-  set(oneValueArgs VERSION FORK PINNED_TAG USE_FAISS_STATIC
-          COMPILE_LIBRARIES ENABLE_NN_DEPENDENCIES CLONE_ON_PIN
+  set(oneValueArgs VERSION FORK PINNED_TAG
+          COMPILE_LIBRARIES CLONE_ON_PIN
           USE_NN_LIBRARY USE_DISTANCE_LIBRARY
           ENABLE_thrust_DEPENDENCY)
   cmake_parse_arguments(PKG "${options}" "${oneValueArgs}"
@@ -346,8 +343,6 @@ function(find_and_configure_raft)
           OPTIONS
           "BUILD_TESTS OFF"
           "BUILD_BENCH OFF"
-          "RAFT_ENABLE_NN_DEPENDENCIES ${PKG_ENABLE_NN_DEPENDENCIES}"
-          "RAFT_USE_FAISS_STATIC ${PKG_USE_FAISS_STATIC}"
           "RAFT_COMPILE_LIBRARIES ${PKG_COMPILE_LIBRARIES}"
           "RAFT_ENABLE_thrust_DEPENDENCY ${PKG_ENABLE_thrust_DEPENDENCY}"
   )
@@ -369,8 +364,6 @@ find_and_configure_raft(VERSION    ${RAFT_VERSION}.00
         COMPILE_LIBRARIES        NO
         USE_NN_LIBRARY           NO
         USE_DISTANCE_LIBRARY     NO
-        ENABLE_NN_DEPENDENCIES   NO  # This builds FAISS if not installed
-        USE_FAISS_STATIC         NO
         ENABLE_thrust_DEPENDENCY YES
 )
 ```

From 81fd1e0f87f50f6501cdbd1e9b95baea35a1bb4b Mon Sep 17 00:00:00 2001
From: "Corey J. Nolet" <cjnolet@users.noreply.github.com>
Date: Sun, 19 Mar 2023 22:19:50 -0400
Subject: [PATCH 03/25] Adding small readme image (#1354)

Authors:
  - Corey J. Nolet (https://github.com/cjnolet)

Approvers:
  - Divye Gala (https://github.com/divyegala)
  - Mark Sadang (https://github.com/msadang)

URL: https://github.com/rapidsai/raft/pull/1354
---
 README.md    |   3 +++
 img/raft.png | Bin 0 -> 506874 bytes
 2 files changed, 3 insertions(+)
 create mode 100644 img/raft.png

diff --git a/README.md b/README.md
index ff1066492e..6d9de4c8b7 100755
--- a/README.md
+++ b/README.md
@@ -1,5 +1,8 @@
 # <div align="left"><img src="https://rapids.ai/assets/images/rapids_logo.png" width="90px"/>&nbsp;RAFT: Reusable Accelerated Functions and Tools</div>
 
+
+![Navigating the canyons of accelerated possibilities](img/raft.png)
+
 ## Resources
 
 - [RAFT Reference Documentation](https://docs.rapids.ai/api/raft/stable/): API Documentation.
diff --git a/img/raft.png b/img/raft.png
new file mode 100644
index 0000000000000000000000000000000000000000..45589614f5cb780169b5388d3e8fdfe2a1de6cd1
GIT binary patch
literal 506874
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%0DB=R?$+?0ZNJwCB{v`
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

literal 0
HcmV?d00001


From 97f8ad71f26174c18598ab1a34f4d3043d6df2a0 Mon Sep 17 00:00:00 2001
From: "Corey J. Nolet" <cjnolet@users.noreply.github.com>
Date: Mon, 20 Mar 2023 15:35:00 -0400
Subject: [PATCH 04/25] Consolidate pre-compiled specializations into single
 `libraft` binary (#1333)

Now that we no longer need to rely on the FAISS dependency, this PR:
1. Consolidates  the `libraft-distance` and `libraft-nn` targets into a single `libraft` artifact
2. Introduces a new `raft::compiled` target to link against the new `libraft.so` binary. Removes `raft::distance`and `raft::nn` targets.
3. Consolidates `RAFT_DISTANCE_COMPILED` and `RAFT_NN_COMPILED` pre-processor vars into a single `RAFT_COMPILED` (to match similar pattern implementated by `spdlog`)
4. Consolidates `specializations.cuh` headers
5. Updates all docs, scripts, and build infra

This change has been a long time coming and is intended to be a 23.04 feature. This is further going to require updates to several projects downstream. Here's a checklist to track that progress:
- [x] offline announcement
- [x] cuml https://github.com/rapidsai/cuml/pull/5272
- [x] cugraph https://github.com/rapidsai/cugraph/pull/3348
- [x] cuopt https://github.com/rapidsai/cuopt/pull/1023
- [x] cugraph-ops https://github.com/rapidsai/cugraph-ops/pull/429


This PR depended on https://github.com/rapidsai/raft/pull/1340 (removing FAISS from the build) and on https://github.com/rapidsai/raft/pull/1202 (replacing the FAISS bfknn w/ our own), both of which have been merged.

Closes #824

Authors:
  - Corey J. Nolet (https://github.com/cjnolet)
  - Ben Frederickson (https://github.com/benfred)

Approvers:
  - Sevag H (https://github.com/sevagh)
  - Divye Gala (https://github.com/divyegala)
  - Ben Frederickson (https://github.com/benfred)
  - Vyas Ramasubramani (https://github.com/vyasr)

URL: https://github.com/rapidsai/raft/pull/1333
---
 README.md                                     |  20 +-
 build.sh                                      |  79 +--
 ci/build_docs.sh                              |   3 +-
 ci/test_cpp.sh                                |   2 +-
 ci/test_python.sh                             |   2 +-
 .../{build_libraft_nn.sh => build_libraft.sh} |   2 +-
 .../recipes/libraft/build_libraft_distance.sh |   4 -
 conda/recipes/libraft/meta.yaml               |  47 +-
 conda/recipes/pylibraft/meta.yaml             |   4 +-
 cpp/CMakeLists.txt                            | 528 ++++++++----------
 cpp/bench/CMakeLists.txt                      |  14 +-
 cpp/bench/cluster/kmeans.cu                   |   2 +-
 cpp/bench/cluster/kmeans_balanced.cu          |   2 +-
 cpp/bench/distance/distance_common.cuh        |   2 +-
 cpp/bench/distance/fused_l2_nn.cu             |   2 +-
 cpp/bench/distance/kernels.cu                 |   2 +-
 cpp/bench/distance/masked_nn.cu               |   2 +-
 cpp/bench/matrix/select_k.cu                  |   2 +-
 cpp/bench/neighbors/knn.cuh                   |   7 +-
 cpp/bench/neighbors/refine_float_int64_t.cu   |   5 +-
 cpp/bench/neighbors/refine_uint8_t_int64_t.cu |   9 +-
 cpp/cmake/modules/raft_export.cmake           |   4 +-
 cpp/cmake/thirdparty/get_cutlass.cmake        |  23 +-
 cpp/cmake/thirdparty/get_thrust.cmake         |   6 +-
 .../raft/neighbors/specializations.cuh        |   6 +-
 .../{knn.cuh => brute_force.cuh}              |  25 -
 .../raft/spatial/knn/specializations.cuh      |   7 +-
 .../raft/spatial/knn/specializations/knn.cuh  |  43 ++
 cpp/include/raft/spectral/specializations.cuh |   4 +-
 cpp/include/raft/stats/specializations.cuh    |   4 +-
 .../raft_runtime/neighbors/brute_force.hpp    |  39 ++
 .../raft_internal/matrix/select_k.cuh         |   2 +-
 .../raft_internal/neighbors/naive_knn.cuh     |   2 +-
 .../{distance => }/cluster/cluster_cost.cuh   |   0
 .../cluster/cluster_cost_double.cu            |   0
 .../cluster/cluster_cost_float.cu             |   0
 .../cluster/kmeans_fit_double.cu              |   0
 .../cluster/kmeans_fit_float.cu               |   0
 .../cluster/kmeans_init_plus_plus_double.cu   |   0
 .../cluster/kmeans_init_plus_plus_float.cu    |   0
 .../cluster/update_centroids.cuh              |   0
 .../cluster/update_centroids_double.cu        |   0
 .../cluster/update_centroids_float.cu         |   0
 .../{distance => }/fused_l2_min_arg.cu        |   0
 .../{distance => }/pairwise_distance.cu       |   0
 .../canberra_double_double_double_int.cu      |   0
 .../detail/canberra_float_float_float_int.cu  |   0
 .../correlation_double_double_double_int.cu   |   0
 .../correlation_float_float_float_int.cu      |   0
 .../detail/cosine_double_double_double_int.cu |   0
 .../detail/cosine_float_float_float_int.cu    |   0
 ...ing_unexpanded_double_double_double_int.cu |   0
 ...amming_unexpanded_float_float_float_int.cu |   0
 ...inger_expanded_double_double_double_int.cu |   0
 ...ellinger_expanded_float_float_float_int.cu |   0
 .../inner_product_double_double_double_int.cu |   0
 .../inner_product_float_float_float_int.cu    |   0
 ...jensen_shannon_double_double_double_int.cu |   0
 .../jensen_shannon_float_float_float_int.cu   |   0
 .../detail/kernels/gram_matrix_base_double.cu |   0
 .../detail/kernels/gram_matrix_base_float.cu  |   0
 .../kernels/polynomial_kernel_double_int.cu   |   0
 .../kernels/polynomial_kernel_float_int.cu    |   0
 .../detail/kernels/rbf_kernel_double.cu       |   0
 .../detail/kernels/rbf_kernel_float.cu        |   0
 .../detail/kernels/tanh_kernel_double.cu      |   0
 .../detail/kernels/tanh_kernel_float.cu       |   0
 .../kl_divergence_double_double_double_int.cu |   0
 .../kl_divergence_float_float_float_int.cu    |   0
 .../detail/l1_double_double_double_int.cu     |   0
 .../detail/l1_float_float_float_int.cu        |   0
 .../l2_expanded_double_double_double_int.cu   |   0
 .../l2_expanded_float_float_float_int.cu      |   0
 ..._sqrt_expanded_double_double_double_int.cu |   0
 .../l2_sqrt_expanded_float_float_float_int.cu |   0
 ...qrt_unexpanded_double_double_double_int.cu |   0
 ...2_sqrt_unexpanded_float_float_float_int.cu |   0
 .../l2_unexpanded_double_double_double_int.cu |   0
 .../l2_unexpanded_float_float_float_int.cu    |   0
 .../detail/l_inf_double_double_double_int.cu  |   0
 .../detail/l_inf_float_float_float_int.cu     |   0
 .../lp_unexpanded_double_double_double_int.cu |   0
 .../lp_unexpanded_float_float_float_int.cu    |   0
 .../russel_rao_double_double_double_int.cu    |   0
 .../russel_rao_float_float_float_int.cu       |   0
 .../specializations/fused_l2_nn_double_int.cu |   0
 .../fused_l2_nn_double_int64.cu               |   0
 .../specializations/fused_l2_nn_float_int.cu  |   0
 .../fused_l2_nn_float_int64.cu                |   0
 .../detail/select_k_float_int64_t.cu          |   0
 .../detail/select_k_float_uint32_t.cu         |   0
 .../detail/select_k_half_int64_t.cu           |   0
 .../detail/select_k_half_uint32_t.cu          |   0
 .../brute_force_knn_int64_t_float.cu          |  54 ++
 .../neighbors/ivf_flat_build.cu               |   0
 .../neighbors/ivf_flat_search.cu              |   0
 .../{distance => }/neighbors/ivfpq_build.cu   |   0
 .../neighbors/ivfpq_deserialize.cu            |   0
 .../neighbors/ivfpq_search_float_int64_t.cu   |   0
 .../neighbors/ivfpq_search_int8_t_int64_t.cu  |   0
 .../neighbors/ivfpq_search_uint8_t_int64_t.cu |   0
 .../neighbors/ivfpq_serialize.cu              |   0
 .../neighbors/refine_d_int64_t_float.cu       |   0
 .../neighbors/refine_d_int64_t_int8_t.cu      |   0
 .../neighbors/refine_d_int64_t_uint8_t.cu     |   0
 .../neighbors/refine_h_int64_t_float.cu       |   0
 .../neighbors/refine_h_int64_t_int8_t.cu      |   0
 .../neighbors/refine_h_int64_t_uint8_t.cu     |   0
 .../ball_cover_all_knn_query.cu               |   9 +-
 .../specializations/ball_cover_build_index.cu |   9 +-
 .../specializations/ball_cover_knn_query.cu   |  12 +-
 .../detail/ball_cover_lowdim_pass_one_2d.cu   |   4 +-
 .../detail/ball_cover_lowdim_pass_one_3d.cu   |   4 +-
 .../detail/ball_cover_lowdim_pass_two_2d.cu   |   5 +-
 .../detail/ball_cover_lowdim_pass_two_3d.cu   |   4 +-
 .../brute_force_knn_impl_long_float_int.cu    |  38 ++
 .../brute_force_knn_impl_long_float_uint.cu   |  38 ++
 .../brute_force_knn_impl_uint_float_int.cu    |  38 ++
 .../brute_force_knn_impl_uint_float_uint.cu   |  38 ++
 .../compute_similarity_float_float_fast.cu    |   0
 ...pute_similarity_float_float_no_basediff.cu |   0
 ...pute_similarity_float_float_no_smem_lut.cu |   0
 .../compute_similarity_float_fp8s_fast.cu     |   0
 ...mpute_similarity_float_fp8s_no_basediff.cu |   0
 ...mpute_similarity_float_fp8s_no_smem_lut.cu |   0
 .../compute_similarity_float_fp8u_fast.cu     |   0
 ...mpute_similarity_float_fp8u_no_basediff.cu |   0
 ...mpute_similarity_float_fp8u_no_smem_lut.cu |   0
 .../compute_similarity_float_half_fast.cu     |   0
 ...mpute_similarity_float_half_no_basediff.cu |   0
 ...mpute_similarity_float_half_no_smem_lut.cu |   0
 .../compute_similarity_half_fp8s_fast.cu      |   0
 ...ompute_similarity_half_fp8s_no_basediff.cu |   0
 ...ompute_similarity_half_fp8s_no_smem_lut.cu |   0
 .../compute_similarity_half_fp8u_fast.cu      |   0
 ...ompute_similarity_half_fp8u_no_basediff.cu |   0
 ...ompute_similarity_half_fp8u_no_smem_lut.cu |   0
 .../compute_similarity_half_half_fast.cu      |   0
 ...ompute_similarity_half_half_no_basediff.cu |   0
 ...ompute_similarity_half_half_no_smem_lut.cu |   0
 ...mpute_similarity_float_half_no_smem_lut.cu |   0
 .../fused_l2_knn_int_float_false.cu           |   4 +-
 .../fused_l2_knn_int_float_true.cu            |   4 +-
 .../fused_l2_knn_long_float_false.cu          |   4 +-
 .../fused_l2_knn_long_float_true.cu           |   4 +-
 .../ivfflat_build_float_int64_t.cu            |   0
 .../ivfflat_build_int8_t_int64_t.cu           |   0
 .../ivfflat_build_uint8_t_int64_t.cu          |   0
 .../ivfflat_extend_float_int64_t.cu           |   0
 .../ivfflat_extend_int8_t_int64_t.cu          |   0
 .../ivfflat_extend_uint8_t_int64_t.cu         |   0
 .../ivfflat_search_float_int64_t.cu           |   0
 .../ivfflat_search_int8_t_int64_t.cu          |   0
 .../ivfflat_search_uint8_t_int64_t.cu         |   0
 .../ivfpq_build_float_int64_t.cu              |   0
 .../ivfpq_build_int8_t_int64_t.cu             |   0
 .../ivfpq_build_uint8_t_int64_t.cu            |   0
 .../ivfpq_extend_float_int64_t.cu             |   0
 .../ivfpq_extend_int8_t_int64_t.cu            |   0
 .../ivfpq_extend_uint8_t_int64_t.cu           |   0
 .../ivfpq_search_float_int64_t.cu             |   0
 .../ivfpq_search_int8_t_int64_t.cu            |   0
 .../ivfpq_search_uint8_t_int64_t.cu           |   0
 .../specializations/refine_d_int64_t_float.cu |   0
 .../refine_d_int64_t_int8_t.cu                |   0
 .../refine_d_int64_t_uint8_t.cu               |   0
 .../specializations/refine_h_int64_t_float.cu |   0
 .../refine_h_int64_t_int8_t.cu                |   0
 .../refine_h_int64_t_uint8_t.cu               |   0
 cpp/src/{distance => }/random/common.cuh      |   0
 ...rmat_rectangular_generator_int64_double.cu |   2 +-
 .../rmat_rectangular_generator_int64_float.cu |   2 +-
 .../rmat_rectangular_generator_int_double.cu  |   2 +-
 .../rmat_rectangular_generator_int_float.cu   |   2 +-
 cpp/test/CMakeLists.txt                       |  25 +-
 cpp/test/cluster/cluster_solvers.cu           |   2 +-
 cpp/test/cluster/kmeans.cu                    |   2 +-
 cpp/test/cluster/kmeans_balanced.cu           |   2 +-
 cpp/test/cluster/kmeans_find_k.cu             |   2 +-
 cpp/test/cluster/linkage.cu                   |   4 +-
 cpp/test/distance/distance_base.cuh           |   2 +-
 cpp/test/distance/fused_l2_nn.cu              |   2 +-
 cpp/test/distance/gram.cu                     |   2 +-
 cpp/test/distance/masked_nn.cu                |   2 +-
 cpp/test/matrix/select_k.cu                   |   2 +-
 cpp/test/neighbors/ann_ivf_flat.cuh           |   2 +-
 .../ann_ivf_flat/test_float_int64_t.cu        |   2 +-
 .../ann_ivf_flat/test_int8_t_int64_t.cu       |   2 +-
 .../ann_ivf_flat/test_uint8_t_int64_t.cu      |   2 +-
 cpp/test/neighbors/ann_ivf_pq.cuh             |   2 +-
 cpp/test/neighbors/ball_cover.cu              |   5 +-
 cpp/test/neighbors/epsilon_neighborhood.cu    |   2 +-
 cpp/test/neighbors/fused_l2_knn.cu            |   8 +-
 cpp/test/neighbors/knn.cu                     |   6 +-
 cpp/test/neighbors/refine.cu                  |   2 +-
 cpp/test/neighbors/selection.cu               |   2 +-
 cpp/test/neighbors/tiled_knn.cu               |   3 +-
 cpp/test/sparse/neighbors/knn_graph.cu        |   4 +-
 cpp/test/stats/silhouette_score.cu            |   2 +-
 cpp/test/stats/trustworthiness.cu             |   2 +-
 docs/source/build.md                          |  65 +--
 python/pylibraft/CMakeLists.txt               |  13 +-
 .../pylibraft/cluster/CMakeLists.txt          |   4 +-
 .../pylibraft/distance/CMakeLists.txt         |   4 +-
 .../pylibraft/neighbors/CMakeLists.txt        |   2 +-
 .../neighbors/ivf_flat/CMakeLists.txt         |   2 +-
 .../pylibraft/neighbors/ivf_pq/CMakeLists.txt |   4 +-
 .../pylibraft/pylibraft/random/CMakeLists.txt |   4 +-
 208 files changed, 687 insertions(+), 686 deletions(-)
 rename conda/recipes/libraft/{build_libraft_nn.sh => build_libraft.sh} (54%)
 delete mode 100644 conda/recipes/libraft/build_libraft_distance.sh
 rename cpp/include/raft/neighbors/specializations/{knn.cuh => brute_force.cuh} (61%)
 create mode 100644 cpp/include/raft/spatial/knn/specializations/knn.cuh
 create mode 100644 cpp/include/raft_runtime/neighbors/brute_force.hpp
 rename cpp/src/{distance => }/cluster/cluster_cost.cuh (100%)
 rename cpp/src/{distance => }/cluster/cluster_cost_double.cu (100%)
 rename cpp/src/{distance => }/cluster/cluster_cost_float.cu (100%)
 rename cpp/src/{distance => }/cluster/kmeans_fit_double.cu (100%)
 rename cpp/src/{distance => }/cluster/kmeans_fit_float.cu (100%)
 rename cpp/src/{distance => }/cluster/kmeans_init_plus_plus_double.cu (100%)
 rename cpp/src/{distance => }/cluster/kmeans_init_plus_plus_float.cu (100%)
 rename cpp/src/{distance => }/cluster/update_centroids.cuh (100%)
 rename cpp/src/{distance => }/cluster/update_centroids_double.cu (100%)
 rename cpp/src/{distance => }/cluster/update_centroids_float.cu (100%)
 rename cpp/src/distance/{distance => }/fused_l2_min_arg.cu (100%)
 rename cpp/src/distance/{distance => }/pairwise_distance.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/canberra_double_double_double_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/canberra_float_float_float_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/correlation_double_double_double_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/correlation_float_float_float_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/cosine_double_double_double_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/cosine_float_float_float_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/hamming_unexpanded_double_double_double_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/hamming_unexpanded_float_float_float_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/hellinger_expanded_double_double_double_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/hellinger_expanded_float_float_float_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/inner_product_double_double_double_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/inner_product_float_float_float_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/jensen_shannon_double_double_double_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/jensen_shannon_float_float_float_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/kernels/gram_matrix_base_double.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/kernels/gram_matrix_base_float.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/kernels/polynomial_kernel_double_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/kernels/polynomial_kernel_float_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/kernels/rbf_kernel_double.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/kernels/rbf_kernel_float.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/kernels/tanh_kernel_double.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/kernels/tanh_kernel_float.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/kl_divergence_double_double_double_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/kl_divergence_float_float_float_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/l1_double_double_double_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/l1_float_float_float_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/l2_expanded_double_double_double_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/l2_expanded_float_float_float_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/l2_sqrt_expanded_double_double_double_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/l2_sqrt_expanded_float_float_float_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/l2_sqrt_unexpanded_double_double_double_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/l2_sqrt_unexpanded_float_float_float_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/l2_unexpanded_double_double_double_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/l2_unexpanded_float_float_float_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/l_inf_double_double_double_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/l_inf_float_float_float_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/lp_unexpanded_double_double_double_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/lp_unexpanded_float_float_float_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/russel_rao_double_double_double_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/detail/russel_rao_float_float_float_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/fused_l2_nn_double_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/fused_l2_nn_double_int64.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/fused_l2_nn_float_int.cu (100%)
 rename cpp/src/distance/{distance => }/specializations/fused_l2_nn_float_int64.cu (100%)
 rename cpp/src/{distance => }/matrix/specializations/detail/select_k_float_int64_t.cu (100%)
 rename cpp/src/{distance => }/matrix/specializations/detail/select_k_float_uint32_t.cu (100%)
 rename cpp/src/{distance => }/matrix/specializations/detail/select_k_half_int64_t.cu (100%)
 rename cpp/src/{distance => }/matrix/specializations/detail/select_k_half_uint32_t.cu (100%)
 create mode 100644 cpp/src/neighbors/brute_force_knn_int64_t_float.cu
 rename cpp/src/{distance => }/neighbors/ivf_flat_build.cu (100%)
 rename cpp/src/{distance => }/neighbors/ivf_flat_search.cu (100%)
 rename cpp/src/{distance => }/neighbors/ivfpq_build.cu (100%)
 rename cpp/src/{distance => }/neighbors/ivfpq_deserialize.cu (100%)
 rename cpp/src/{distance => }/neighbors/ivfpq_search_float_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/ivfpq_search_int8_t_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/ivfpq_search_uint8_t_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/ivfpq_serialize.cu (100%)
 rename cpp/src/{distance => }/neighbors/refine_d_int64_t_float.cu (100%)
 rename cpp/src/{distance => }/neighbors/refine_d_int64_t_int8_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/refine_d_int64_t_uint8_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/refine_h_int64_t_float.cu (100%)
 rename cpp/src/{distance => }/neighbors/refine_h_int64_t_int8_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/refine_h_int64_t_uint8_t.cu (100%)
 rename cpp/src/{nn => neighbors}/specializations/ball_cover_all_knn_query.cu (80%)
 rename cpp/src/{nn => neighbors}/specializations/ball_cover_build_index.cu (81%)
 rename cpp/src/{nn => neighbors}/specializations/ball_cover_knn_query.cu (80%)
 rename cpp/src/{nn => neighbors}/specializations/detail/ball_cover_lowdim_pass_one_2d.cu (91%)
 rename cpp/src/{nn => neighbors}/specializations/detail/ball_cover_lowdim_pass_one_3d.cu (91%)
 rename cpp/src/{nn => neighbors}/specializations/detail/ball_cover_lowdim_pass_two_2d.cu (91%)
 rename cpp/src/{nn => neighbors}/specializations/detail/ball_cover_lowdim_pass_two_3d.cu (91%)
 create mode 100644 cpp/src/neighbors/specializations/detail/brute_force_knn_impl_long_float_int.cu
 create mode 100644 cpp/src/neighbors/specializations/detail/brute_force_knn_impl_long_float_uint.cu
 create mode 100644 cpp/src/neighbors/specializations/detail/brute_force_knn_impl_uint_float_int.cu
 create mode 100644 cpp/src/neighbors/specializations/detail/brute_force_knn_impl_uint_float_uint.cu
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_float_float_fast.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_float_float_no_basediff.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_float_float_no_smem_lut.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_float_fp8s_fast.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_float_fp8s_no_basediff.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_float_fp8s_no_smem_lut.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_float_fp8u_fast.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_float_fp8u_no_basediff.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_float_fp8u_no_smem_lut.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_float_half_fast.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_float_half_no_basediff.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_float_half_no_smem_lut.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_half_fp8s_fast.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_half_fp8s_no_basediff.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_half_fp8s_no_smem_lut.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_half_fp8u_fast.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_half_fp8u_no_basediff.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_half_fp8u_no_smem_lut.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_half_half_fast.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_half_half_no_basediff.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/compute_similarity_half_half_no_smem_lut.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/detail/ivfpq_compute_similarity_float_half_no_smem_lut.cu (100%)
 rename cpp/src/{nn => neighbors}/specializations/fused_l2_knn_int_float_false.cu (93%)
 rename cpp/src/{nn => neighbors}/specializations/fused_l2_knn_int_float_true.cu (93%)
 rename cpp/src/{nn => neighbors}/specializations/fused_l2_knn_long_float_false.cu (93%)
 rename cpp/src/{nn => neighbors}/specializations/fused_l2_knn_long_float_true.cu (93%)
 rename cpp/src/{distance => }/neighbors/specializations/ivfflat_build_float_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/ivfflat_build_int8_t_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/ivfflat_build_uint8_t_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/ivfflat_extend_float_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/ivfflat_extend_int8_t_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/ivfflat_extend_uint8_t_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/ivfflat_search_float_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/ivfflat_search_int8_t_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/ivfflat_search_uint8_t_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/ivfpq_build_float_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/ivfpq_build_int8_t_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/ivfpq_build_uint8_t_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/ivfpq_extend_float_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/ivfpq_extend_int8_t_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/ivfpq_extend_uint8_t_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/ivfpq_search_float_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/ivfpq_search_int8_t_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/ivfpq_search_uint8_t_int64_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/refine_d_int64_t_float.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/refine_d_int64_t_int8_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/refine_d_int64_t_uint8_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/refine_h_int64_t_float.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/refine_h_int64_t_int8_t.cu (100%)
 rename cpp/src/{distance => }/neighbors/specializations/refine_h_int64_t_uint8_t.cu (100%)
 rename cpp/src/{distance => }/random/common.cuh (100%)
 rename cpp/src/{distance => }/random/rmat_rectangular_generator_int64_double.cu (93%)
 rename cpp/src/{distance => }/random/rmat_rectangular_generator_int64_float.cu (93%)
 rename cpp/src/{distance => }/random/rmat_rectangular_generator_int_double.cu (93%)
 rename cpp/src/{distance => }/random/rmat_rectangular_generator_int_float.cu (93%)

diff --git a/README.md b/README.md
index 6d9de4c8b7..8519ebcae1 100755
--- a/README.md
+++ b/README.md
@@ -195,8 +195,7 @@ RAFT itself can be installed through conda, [CMake Package Manager (CPM)](https:
 
 The easiest way to install RAFT is through conda and several packages are provided.
 - `libraft-headers` RAFT headers
-- `libraft-nn` (optional) contains shared libraries for the nearest neighbors primitives.
-- `libraft-distance` (optional) contains shared libraries for distance primitives.
+- `libraft` (optional) shared library of pre-compiled template specializations and runtime APIs.
 - `pylibraft` (optional) Python wrappers around RAFT algorithms and primitives.
 - `raft-dask` (optional) enables deployment of multi-node multi-GPU algorithms that use RAFT `raft::comms` in Dask clusters.
 
@@ -205,9 +204,9 @@ Use the following command to install all of the RAFT packages with conda (replac
 mamba install -c rapidsai -c conda-forge -c nvidia raft-dask pylibraft
 ```
 
-You can also install the `libraft-*` conda packages individually using the `mamba` command above.
+You can also install the conda packages individually using the `mamba` command above.
 
-After installing RAFT, `find_package(raft COMPONENTS nn distance)` can be used in your CUDA/C++ cmake build to compile and/or link against needed dependencies in your raft target. `COMPONENTS` are optional and will depend on the packages installed.
+After installing RAFT, `find_package(raft COMPONENTS compiled distributed)` can be used in your CUDA/C++ cmake build to compile and/or link against needed dependencies in your raft target. `COMPONENTS` are optional and will depend on the packages installed.
 
 ### Pip
 
@@ -266,12 +265,11 @@ find_and_configure_raft(VERSION    ${RAFT_VERSION}.00
 
 Several CMake targets can be made available by adding components in the table below to the `RAFT_COMPONENTS` list above, separated by spaces. The `raft::raft` target will always be available. RAFT headers require, at a minimum, the CUDA toolkit libraries and RMM dependencies.
 
-| Component | Target | Description | Base Dependencies                                                |
-| --- | --- | --- |------------------------------------------------------------------|
-| n/a | `raft::raft` | Full RAFT header library | CUDA toolkit library, RMM, Thrust (optional), NVTools (optional) |
-| distance | `raft::distance` | Pre-compiled template specializations for raft::distance | raft::raft, cuCollections (optional)                             |
-| nn | `raft::nn` | Pre-compiled template specializations for raft::neighbors | raft::raft                                                       |
-| distributed | `raft::distributed` | No specializations | raft::raft, UCX, NCCL                                            |
+| Component   | Target              | Description                                               | Base Dependencies                     |
+|-------------|---------------------|-----------------------------------------------------------|---------------------------------------|
+| n/a         | `raft::raft`        | Full RAFT header library                                  | CUDA toolkit, RMM, NVTX, CCCL, CUTLASS |
+| compiled    | `raft::compiled`    | Pre-compiled template specializations and runtime library | raft::raft                            |
+| distributed | `raft::distributed` | Dependencies for `raft::comms` APIs                       | raft::raft, UCX, NCCL                 |
 
 ### Source
 
@@ -282,7 +280,7 @@ mamba env create --name raft_dev_env -f conda/environments/all_cuda-118_arch-x86
 mamba activate raft_dev_env
 ```
 ```
-./build.sh raft-dask pylibraft libraft tests bench --compile-libs
+./build.sh raft-dask pylibraft libraft tests bench --compile-lib
 ```
 
 The [build](docs/source/build.md) instructions contain more details on building RAFT from source and including it in downstream projects. You can also find a more comprehensive version of the above CPM code snippet the [Building RAFT C++ from source](docs/source/build.md#building-raft-c-from-source-in-cmake) section of the build instructions.
diff --git a/build.sh b/build.sh
index 7215b8199a..b5a72f4205 100755
--- a/build.sh
+++ b/build.sh
@@ -18,7 +18,7 @@ ARGS=$*
 # script, and that this script resides in the repo dir!
 REPODIR=$(cd $(dirname $0); pwd)
 
-VALIDARGS="clean libraft pylibraft raft-dask docs tests bench clean --uninstall  -v -g -n --compile-libs --compile-nn --compile-dist --allgpuarch --no-nvtx --show_depr_warn -h --minimal-deps"
+VALIDARGS="clean libraft pylibraft raft-dask docs tests bench clean --uninstall  -v -g -n --compile-lib --allgpuarch --no-nvtx --show_depr_warn -h"
 HELP="$0 [<target> ...] [<flag> ...] [--cmake-args=\"<args>\"] [--cache-tool=<tool>] [--limit-tests=<targets>] [--limit-bench=<targets>]
  where <target> is:
    clean            - remove all existing build artifacts and configuration (start over)
@@ -35,12 +35,7 @@ HELP="$0 [<target> ...] [<flag> ...] [--cmake-args=\"<args>\"] [--cache-tool=<to
    -g                          - build for debug
    -n                          - no install step
    --uninstall                 - uninstall files for specified targets which were built and installed prior
-   --compile-libs              - compile shared libraries for all components
-   --compile-nn                - compile shared library for nn component
-   --compile-dist              - compile shared library for distance and current random components
-                                 (eventually, this will be renamed to something more generic and
-                                  the only option to be supported)
-   --minimal-deps              - disables dependencies like thrust so they can be overridden.
+   --compile-lib               - compile shared libraries for all components
                                  can be useful for a pure header-only install
    --limit-tests               - semicolon-separated list of test executables to compile (e.g. NEIGHBORS_TEST;CLUSTER_TEST)
    --limit-bench               - semicolon-separated list of benchmark executables to compute (e.g. NEIGHBORS_BENCH;CLUSTER_BENCH)
@@ -68,14 +63,11 @@ BUILD_ALL_GPU_ARCH=0
 BUILD_TESTS=OFF
 BUILD_TYPE=Release
 BUILD_BENCH=OFF
-COMPILE_LIBRARIES=OFF
-COMPILE_NN_LIBRARY=OFF
-COMPILE_DIST_LIBRARY=OFF
+COMPILE_LIBRARY=OFF
 INSTALL_TARGET=install
 
 TEST_TARGETS="CLUSTER_TEST;CORE_TEST;DISTANCE_TEST;LABEL_TEST;LINALG_TEST;MATRIX_TEST;RANDOM_TEST;SOLVERS_TEST;SPARSE_TEST;SPARSE_DIST_TEST;SPARSE_NEIGHBORS_TEST;NEIGHBORS_TEST;STATS_TEST;UTILS_TEST"
 BENCH_TARGETS="CLUSTER_BENCH;NEIGHBORS_BENCH;DISTANCE_BENCH;LINALG_BENCH;MATRIX_BENCH;SPARSE_BENCH;RANDOM_BENCH"
-ENABLE_thrust_DEPENDENCY=ON
 
 CACHE_ARGS=""
 NVTX=ON
@@ -254,10 +246,6 @@ if hasArg -n; then
     INSTALL_TARGET=""
 fi
 
-if hasArg --minimal-deps; then
-    ENABLE_thrust_DEPENDENCY=OFF
-fi
-
 if hasArg -v; then
     VERBOSE_FLAG="-v"
     CMAKE_LOG_LEVEL="VERBOSE"
@@ -270,35 +258,16 @@ if hasArg --allgpuarch; then
     BUILD_ALL_GPU_ARCH=1
 fi
 
-if hasArg --compile-libs || (( ${NUMARGS} == 0 )); then
-    COMPILE_LIBRARIES=ON
-fi
-
-if hasArg --compile-nn || hasArg --compile-libs || (( ${NUMARGS} == 0 )); then
-    COMPILE_NN_LIBRARY=ON
-    CMAKE_TARGET="${CMAKE_TARGET};raft_nn_lib"
-fi
-
-if hasArg --compile-dist || hasArg --compile-libs || (( ${NUMARGS} == 0 )); then
-    COMPILE_DIST_LIBRARY=ON
-    CMAKE_TARGET="${CMAKE_TARGET};raft_distance_lib"
+if hasArg --compile-lib || (( ${NUMARGS} == 0 )); then
+    COMPILE_LIBRARY=ON
+    CMAKE_TARGET="${CMAKE_TARGET};raft_lib"
 fi
 
 if hasArg tests || (( ${NUMARGS} == 0 )); then
     BUILD_TESTS=ON
     CMAKE_TARGET="${CMAKE_TARGET};${TEST_TARGETS}"
 
-    # Force compile nn library when needed test targets are specified
-    if [[ $CMAKE_TARGET == *"CLUSTER_TEST"* || \
-          $CMAKE_TARGET == *"SPARSE_DIST_TEST"* || \
-          $CMAKE_TARGET == *"SPARSE_NEIGHBORS_TEST"* || \
-          $CMAKE_TARGET == *"NEIGHBORS_TEST"* || \
-          $CMAKE_TARGET == *"STATS_TEST"* ]]; then
-      echo "-- Enabling nearest neighbors lib for gtests"
-      COMPILE_NN_LIBRARY=ON
-    fi
-
-    # Force compile distance library when needed test targets are specified
+    # Force compile library when needed test targets are specified
     if [[ $CMAKE_TARGET == *"CLUSTER_TEST"* || \
           $CMAKE_TARGET == *"DISTANCE_TEST"* || \
           $CMAKE_TARGET == *"SPARSE_DIST_TEST" || \
@@ -306,8 +275,8 @@ if hasArg tests || (( ${NUMARGS} == 0 )); then
           $CMAKE_TARGET == *"MATRIX_TEST"* || \
           $CMAKE_TARGET == *"NEIGHBORS_TEST" || \
           $CMAKE_TARGET == *"STATS_TEST"* ]]; then
-      echo "-- Enabling distance lib for gtests"
-      COMPILE_DIST_LIBRARY=ON
+      echo "-- Enabling compiled lib for gtests"
+      COMPILE_LIBRARY=ON
     fi
 fi
 
@@ -315,19 +284,12 @@ if hasArg bench || (( ${NUMARGS} == 0 )); then
     BUILD_BENCH=ON
     CMAKE_TARGET="${CMAKE_TARGET};${BENCH_TARGETS}"
 
-    # Force compile nn library when needed benchmark targets are specified
-    if [[ $CMAKE_TARGET == *"CLUSTER_BENCH"* || \
-          $CMAKE_TARGET == *"NEIGHBORS_BENCH"*  ]]; then
-      echo "-- Enabling nearest neighbors lib for benchmarks"
-      COMPILE_NN_LIBRARY=ON
-    fi
-
-    # Force compile distance library when needed benchmark targets are specified
+    # Force compile library when needed benchmark targets are specified
     if [[ $CMAKE_TARGET == *"CLUSTER_BENCH"* || \
           $CMAKE_TARGET == *"MATRIX_BENCH"* || \
           $CMAKE_TARGET == *"NEIGHBORS_BENCH"* ]]; then
-      echo "-- Enabling distance lib for benchmarks"
-      COMPILE_DIST_LIBRARY=ON
+      echo "-- Enabling compiled lib for benchmarks"
+      COMPILE_LIBRARY=ON
     fi
 
 fi
@@ -398,9 +360,7 @@ if (( ${NUMARGS} == 0 )) || hasArg libraft || hasArg docs || hasArg tests || has
           -DBUILD_TESTS=${BUILD_TESTS} \
           -DBUILD_BENCH=${BUILD_BENCH} \
           -DCMAKE_MESSAGE_LOG_LEVEL=${CMAKE_LOG_LEVEL} \
-          -DRAFT_COMPILE_NN_LIBRARY=${COMPILE_NN_LIBRARY} \
-          -DRAFT_COMPILE_DIST_LIBRARY=${COMPILE_DIST_LIBRARY} \
-          -DRAFT_ENABLE_thrust_DEPENDENCY=${ENABLE_thrust_DEPENDENCY} \
+          -DRAFT_COMPILE_LIBRARY=${COMPILE_LIBRARY} \
           ${CACHE_ARGS} \
           ${EXTRA_CMAKE_ARGS}
 
@@ -414,34 +374,35 @@ if (( ${NUMARGS} == 0 )) || hasArg libraft || hasArg docs || hasArg tests || has
   fi
 fi
 
-# Build and (optionally) install the raft-dask Python package
-if (( ${NUMARGS} == 0 )) || hasArg raft-dask; then
+# Build and (optionally) install the pylibraft Python package
+if (( ${NUMARGS} == 0 )) || hasArg pylibraft; then
     # Append `-DFIND_RAFT_CPP=ON` to EXTRA_CMAKE_ARGS unless a user specified the option.
     if [[ "${EXTRA_CMAKE_ARGS}" != *"DFIND_RAFT_CPP"* ]]; then
         EXTRA_CMAKE_ARGS="${EXTRA_CMAKE_ARGS} -DFIND_RAFT_CPP=ON"
     fi
 
-    cd ${REPODIR}/python/raft-dask
+    cd ${REPODIR}/python/pylibraft
     python setup.py build_ext --inplace -- -DCMAKE_PREFIX_PATH="${RAFT_DASK_BUILD_DIR};${INSTALL_PREFIX}" -DCMAKE_LIBRARY_PATH=${LIBRAFT_BUILD_DIR} ${EXTRA_CMAKE_ARGS} -- -j${PARALLEL_LEVEL:-1}
     if [[ ${INSTALL_TARGET} != "" ]]; then
         python setup.py install --single-version-externally-managed --record=record.txt -- -DCMAKE_PREFIX_PATH=${INSTALL_PREFIX} ${EXTRA_CMAKE_ARGS}
     fi
 fi
 
-# Build and (optionally) install the pylibraft Python package
-if (( ${NUMARGS} == 0 )) || hasArg pylibraft; then
+# Build and (optionally) install the raft-dask Python package
+if (( ${NUMARGS} == 0 )) || hasArg raft-dask; then
     # Append `-DFIND_RAFT_CPP=ON` to EXTRA_CMAKE_ARGS unless a user specified the option.
     if [[ "${EXTRA_CMAKE_ARGS}" != *"DFIND_RAFT_CPP"* ]]; then
         EXTRA_CMAKE_ARGS="${EXTRA_CMAKE_ARGS} -DFIND_RAFT_CPP=ON"
     fi
 
-    cd ${REPODIR}/python/pylibraft
+    cd ${REPODIR}/python/raft-dask
     python setup.py build_ext --inplace -- -DCMAKE_PREFIX_PATH="${RAFT_DASK_BUILD_DIR};${INSTALL_PREFIX}" -DCMAKE_LIBRARY_PATH=${LIBRAFT_BUILD_DIR} ${EXTRA_CMAKE_ARGS} -- -j${PARALLEL_LEVEL:-1}
     if [[ ${INSTALL_TARGET} != "" ]]; then
         python setup.py install --single-version-externally-managed --record=record.txt -- -DCMAKE_PREFIX_PATH=${INSTALL_PREFIX} ${EXTRA_CMAKE_ARGS}
     fi
 fi
 
+
 if hasArg docs; then
     set -x
     cd ${DOXYGEN_BUILD_DIR}
diff --git a/ci/build_docs.sh b/ci/build_docs.sh
index 78c4399d28..5db6fa11be 100755
--- a/ci/build_docs.sh
+++ b/ci/build_docs.sh
@@ -24,9 +24,8 @@ VERSION_NUMBER=$(rapids-get-rapids-version-from-git)
 rapids-mamba-retry install \
   --channel "${CPP_CHANNEL}" \
   --channel "${PYTHON_CHANNEL}" \
-  libraft-distance \
+  libraft \
   libraft-headers \
-  libraft-nn \
   pylibraft \
   raft-dask
 
diff --git a/ci/test_cpp.sh b/ci/test_cpp.sh
index 44e446d8f6..e32697a68a 100755
--- a/ci/test_cpp.sh
+++ b/ci/test_cpp.sh
@@ -26,7 +26,7 @@ rapids-print-env
 
 rapids-mamba-retry install \
   --channel "${CPP_CHANNEL}" \
-  libraft-headers libraft-distance libraft-nn libraft-tests
+  libraft-headers libraft libraft-tests
 
 rapids-logger "Check GPU usage"
 nvidia-smi
diff --git a/ci/test_python.sh b/ci/test_python.sh
index 934c9c6951..cb6b7631e4 100755
--- a/ci/test_python.sh
+++ b/ci/test_python.sh
@@ -31,7 +31,7 @@ rapids-print-env
 rapids-mamba-retry install \
   --channel "${CPP_CHANNEL}" \
   --channel "${PYTHON_CHANNEL}" \
-  libraft-distance libraft-headers pylibraft raft-dask
+  libraft libraft-headers pylibraft raft-dask
 
 rapids-logger "Check GPU usage"
 nvidia-smi
diff --git a/conda/recipes/libraft/build_libraft_nn.sh b/conda/recipes/libraft/build_libraft.sh
similarity index 54%
rename from conda/recipes/libraft/build_libraft_nn.sh
rename to conda/recipes/libraft/build_libraft.sh
index 5347bfbc20..237e47eb26 100644
--- a/conda/recipes/libraft/build_libraft_nn.sh
+++ b/conda/recipes/libraft/build_libraft.sh
@@ -1,4 +1,4 @@
 #!/usr/bin/env bash
 # Copyright (c) 2022-2023, NVIDIA CORPORATION.
 
-./build.sh libraft --allgpuarch --compile-nn --no-nvtx
+./build.sh libraft --allgpuarch --compile-lib --no-nvtx
diff --git a/conda/recipes/libraft/build_libraft_distance.sh b/conda/recipes/libraft/build_libraft_distance.sh
deleted file mode 100644
index 27a1ee43c8..0000000000
--- a/conda/recipes/libraft/build_libraft_distance.sh
+++ /dev/null
@@ -1,4 +0,0 @@
-#!/usr/bin/env bash
-# Copyright (c) 2022-2023, NVIDIA CORPORATION.
-
-./build.sh libraft --allgpuarch --compile-dist --no-nvtx
diff --git a/conda/recipes/libraft/meta.yaml b/conda/recipes/libraft/meta.yaml
index 158016ddf0..2a724672ab 100644
--- a/conda/recipes/libraft/meta.yaml
+++ b/conda/recipes/libraft/meta.yaml
@@ -76,9 +76,9 @@ outputs:
       home: https://rapids.ai/
       license: Apache-2.0
       summary: libraft-headers library
-  - name: libraft-distance
+  - name: libraft
     version: {{ version }}
-    script: build_libraft_distance.sh
+    script: build_libraft.sh
     build:
       script_env: *script_env
       number: {{ GIT_DESCRIBE_NUMBER }}
@@ -109,42 +109,7 @@ outputs:
     about:
       home: https://rapids.ai/
       license: Apache-2.0
-      summary: libraft-distance library
-  - name: libraft-nn
-    version: {{ version }}
-    script: build_libraft_nn.sh
-    build:
-      script_env: *script_env
-      number: {{ GIT_DESCRIBE_NUMBER }}
-      string: cuda{{ cuda_major }}_{{ date_string }}_{{ GIT_DESCRIBE_HASH }}_{{ GIT_DESCRIBE_NUMBER }}
-      ignore_run_exports_from:
-        - {{ compiler('cuda') }}
-    requirements:
-      build:
-        - {{ compiler('c') }}
-        - {{ compiler('cuda') }} {{ cuda_version }}
-        - {{ compiler('cxx') }}
-        - cmake {{ cmake_version }}
-        - ninja
-        - sysroot_{{ target_platform }} {{ sysroot_version }}
-      host:
-        - {{ pin_subpackage('libraft-headers', exact=True) }}
-        - cuda-profiler-api {{ cuda_profiler_api_host_version }}
-        - lapack
-        - libcublas {{ libcublas_host_version }}
-        - libcublas-dev {{ libcublas_host_version }}
-        - libcurand {{ libcurand_host_version }}
-        - libcurand-dev {{ libcurand_host_version }}
-        - libcusolver {{ libcusolver_host_version }}
-        - libcusolver-dev {{ libcusolver_host_version }}
-        - libcusparse {{ libcusparse_host_version }}
-        - libcusparse-dev {{ libcusparse_host_version }}
-      run:
-        - {{ pin_subpackage('libraft-headers', exact=True) }}
-    about:
-      home: https://rapids.ai/
-      license: Apache-2.0
-      summary: libraft-nn library
+      summary: libraft library
   - name: libraft-tests
     version: {{ version }}
     script: build_libraft_tests.sh
@@ -163,9 +128,8 @@ outputs:
         - ninja
         - sysroot_{{ target_platform }} {{ sysroot_version }}
       host:
-        - {{ pin_subpackage('libraft-distance', exact=True) }}
+        - {{ pin_subpackage('libraft', exact=True) }}
         - {{ pin_subpackage('libraft-headers', exact=True) }}
-        - {{ pin_subpackage('libraft-nn', exact=True) }}
         - cuda-profiler-api {{ cuda_profiler_api_host_version }}
         - gmock {{ gtest_version }}
         - gtest {{ gtest_version }}
@@ -178,9 +142,8 @@ outputs:
         - libcusparse {{ libcusparse_host_version }}
         - libcusparse-dev {{ libcusparse_host_version }}
       run:
-        - {{ pin_subpackage('libraft-distance', exact=True) }}
+        - {{ pin_subpackage('libraft', exact=True) }}
         - {{ pin_subpackage('libraft-headers', exact=True) }}
-        - {{ pin_subpackage('libraft-nn', exact=True) }}
         - gmock {{ gtest_version }}
         - gtest {{ gtest_version }}
     about:
diff --git a/conda/recipes/pylibraft/meta.yaml b/conda/recipes/pylibraft/meta.yaml
index 4a9b98ac75..a528064348 100644
--- a/conda/recipes/pylibraft/meta.yaml
+++ b/conda/recipes/pylibraft/meta.yaml
@@ -34,7 +34,7 @@ requirements:
     - cuda-python >=11.7.1,<12.0
     - cudatoolkit ={{ cuda_version }}
     - cython >=0.29,<0.30
-    - libraft-distance {{ version }}
+    - libraft {{ version }}
     - libraft-headers {{ version }}
     - python x.x
     - rmm ={{ minor_version }}
@@ -43,7 +43,7 @@ requirements:
   run:
     - {{ pin_compatible('cudatoolkit', max_pin='x', min_pin='x') }}
     - cuda-python >=11.7.1,<12.0
-    - libraft-distance {{ version }}
+    - libraft {{ version }}
     - libraft-headers {{ version }}
     - python x.x
 
diff --git a/cpp/CMakeLists.txt b/cpp/CMakeLists.txt
index 3889c39e6e..bdaacb4a85 100644
--- a/cpp/CMakeLists.txt
+++ b/cpp/CMakeLists.txt
@@ -57,22 +57,13 @@ option(DISABLE_DEPRECATION_WARNINGS "Disable deprecaction warnings " ON)
 option(DISABLE_OPENMP "Disable OpenMP" OFF)
 option(RAFT_NVTX "Enable nvtx markers" OFF)
 
-set(RAFT_COMPILE_LIBRARIES_DEFAULT OFF)
+set(RAFT_COMPILE_LIBRARY_DEFAULT OFF)
 if(BUILD_TESTS OR BUILD_BENCH)
-  set(RAFT_COMPILE_LIBRARIES_DEFAULT ON)
+  set(RAFT_COMPILE_LIBRARY_DEFAULT ON)
 endif()
-option(RAFT_COMPILE_LIBRARIES "Enable building raft shared library instantiations"
-       ${RAFT_COMPILE_LIBRARIES_DEFAULT}
+option(RAFT_COMPILE_LIBRARY "Enable building raft shared library instantiations"
+       ${RAFT_COMPILE_LIBRARY_DEFAULT}
 )
-option(
-  RAFT_COMPILE_NN_LIBRARY "Enable building raft nearest neighbors shared library instantiations"
-  ${RAFT_COMPILE_LIBRARIES}
-)
-option(RAFT_COMPILE_DIST_LIBRARY "Enable building raft distant shared library instantiations"
-       ${RAFT_COMPILE_LIBRARIES}
-)
-
-option(RAFT_ENABLE_thrust_DEPENDENCY "Enable Thrust dependency" ON)
 
 if(BUILD_TESTS OR BUILD_BENCH)
   # Needed because GoogleBenchmark changes the state of FindThreads.cmake, causing subsequent runs
@@ -81,10 +72,9 @@ if(BUILD_TESTS OR BUILD_BENCH)
   set(THREADS_PREFER_PTHREAD_FLAG ON)
 endif()
 
-if(BUILD_TESTS AND NOT RAFT_ENABLE_thrust_DEPENDENCY)
-  message(VERBOSE "RAFT: BUILD_TESTS is enabled, overriding RAFT_ENABLE_thrust_DEPENDENCY")
-  set(RAFT_ENABLE_thrust_DEPENDENCY ON)
-endif()
+include(CMakeDependentOption)
+# cmake_dependent_option( RAFT_USE_FAISS_STATIC "Build and statically link the FAISS library for
+# nearest neighbors search on GPU" ON RAFT_COMPILE_LIBRARY OFF )
 
 message(VERBOSE "RAFT: Building optional components: ${raft_FIND_COMPONENTS}")
 message(VERBOSE "RAFT: Build RAFT unit-tests: ${BUILD_TESTS}")
@@ -154,15 +144,6 @@ include(cmake/modules/ConfigureCUDA.cmake)
 # ##################################################################################################
 # * Requirements -------------------------------------------------------------
 
-if(RAFT_COMPILE_LIBRARIES)
-  set(RAFT_COMPILE_DIST_LIBRARY ON)
-  set(RAFT_COMPILE_NN_LIBRARY ON)
-endif()
-
-if(RAFT_COMPILE_DIST_LIBRARY OR distance IN_LIST raft_FIND_COMPONENTS)
-  set(RAFT_ENABLE_cuco_DEPENDENCY ON)
-endif()
-
 # add third party dependencies using CPM
 rapids_cpm_init()
 
@@ -171,12 +152,8 @@ include(cmake/thirdparty/get_thrust.cmake)
 include(cmake/thirdparty/get_rmm.cmake)
 include(cmake/thirdparty/get_cutlass.cmake)
 
-if(RAFT_ENABLE_cuco_DEPENDENCY)
-  include(${rapids-cmake-dir}/cpm/cuco.cmake)
-  rapids_cpm_cuco(
-    BUILD_EXPORT_SET raft-distance-lib-exports INSTALL_EXPORT_SET raft-distance-lib-exports
-  )
-endif()
+include(${rapids-cmake-dir}/cpm/cuco.cmake)
+rapids_cpm_cuco(BUILD_EXPORT_SET raft-exports INSTALL_EXPORT_SET raft-exports)
 
 if(BUILD_TESTS)
   include(cmake/thirdparty/get_gtest.cmake)
@@ -200,11 +177,13 @@ target_include_directories(
 target_link_libraries(
   raft
   INTERFACE rmm::rmm
+            cuco::cuco
+            nvidia::cutlass::cutlass
             CUDA::cublas${_ctk_static_suffix}
             CUDA::curand${_ctk_static_suffix}
             CUDA::cusolver${_ctk_static_suffix}
             CUDA::cusparse${_ctk_static_suffix}
-            $<$<BOOL:${RAFT_ENABLE_thrust_DEPENDENCY}>:raft::Thrust>
+            raft::Thrust
 )
 
 target_compile_features(raft INTERFACE cxx_std_17 $<BUILD_INTERFACE:cuda_std_17>)
@@ -222,7 +201,7 @@ else()
   target_compile_definitions(raft INTERFACE RAFT_SYSTEM_LITTLE_ENDIAN=1)
 endif()
 
-if(RAFT_COMPILE_DIST_LIBRARY OR RAFT_COMPILE_NN_LIBRARY)
+if(RAFT_COMPILE_LIBRARY)
   file(
     WRITE "${CMAKE_CURRENT_BINARY_DIR}/fatbin.ld"
     [=[
@@ -266,148 +245,203 @@ target_compile_definitions(raft::raft INTERFACE $<$<BOOL:${RAFT_NVTX}>:NVTX_ENAB
 endif()
 
 # ##################################################################################################
-# * raft_distance ------------------------------------------------------------ TODO: Currently, this
+# * raft_compiled ------------------------------------------------------------ TODO: Currently, this
 #   package also contains the 'random' namespace (for rmat logic) We couldn't get this to work
 #   properly due to strange CI failures as noticed in the PR#778. In the long term, we should rename
 #   this package to `raft_compiled` in order to have a single pre-compiled raft package for those
 #   who need it.
-add_library(raft_distance INTERFACE)
+add_library(raft_compiled INTERFACE)
 
-if(TARGET raft_distance AND (NOT TARGET raft::distance))
-  add_library(raft::distance ALIAS raft_distance)
+if(TARGET raft_compiled AND (NOT TARGET raft::compiled))
+  add_library(raft::compiled ALIAS raft_compiled)
 endif()
 
-set_target_properties(raft_distance PROPERTIES EXPORT_NAME distance)
+set_target_properties(raft_compiled PROPERTIES EXPORT_NAME compiled)
 
-if(RAFT_COMPILE_DIST_LIBRARY)
+if(RAFT_COMPILE_LIBRARY)
   add_library(
-    raft_distance_lib
-    src/distance/distance/pairwise_distance.cu
-    src/distance/distance/fused_l2_min_arg.cu
-    src/distance/cluster/update_centroids_float.cu
-    src/distance/cluster/update_centroids_double.cu
-    src/distance/cluster/cluster_cost_float.cu
-    src/distance/cluster/cluster_cost_double.cu
-    src/distance/neighbors/refine_d_int64_t_float.cu
-    src/distance/neighbors/refine_d_int64_t_int8_t.cu
-    src/distance/neighbors/refine_d_int64_t_uint8_t.cu
-    src/distance/neighbors/refine_h_int64_t_float.cu
-    src/distance/neighbors/refine_h_int64_t_int8_t.cu
-    src/distance/neighbors/refine_h_int64_t_uint8_t.cu
-    src/distance/neighbors/specializations/refine_d_int64_t_float.cu
-    src/distance/neighbors/specializations/refine_d_int64_t_int8_t.cu
-    src/distance/neighbors/specializations/refine_d_int64_t_uint8_t.cu
-    src/distance/neighbors/specializations/refine_h_int64_t_float.cu
-    src/distance/neighbors/specializations/refine_h_int64_t_int8_t.cu
-    src/distance/neighbors/specializations/refine_h_int64_t_uint8_t.cu
-    src/distance/cluster/kmeans_fit_float.cu
-    src/distance/cluster/kmeans_fit_double.cu
-    src/distance/cluster/kmeans_init_plus_plus_double.cu
-    src/distance/cluster/kmeans_init_plus_plus_float.cu
-    src/distance/distance/specializations/detail/canberra_double_double_double_int.cu
-    src/distance/distance/specializations/detail/canberra_float_float_float_int.cu
-    src/distance/distance/specializations/detail/correlation_double_double_double_int.cu
-    src/distance/distance/specializations/detail/correlation_float_float_float_int.cu
-    src/distance/distance/specializations/detail/cosine_double_double_double_int.cu
-    src/distance/distance/specializations/detail/cosine_float_float_float_int.cu
-    src/distance/distance/specializations/detail/hamming_unexpanded_double_double_double_int.cu
-    src/distance/distance/specializations/detail/hamming_unexpanded_float_float_float_int.cu
-    src/distance/distance/specializations/detail/hellinger_expanded_float_float_float_int.cu
-    src/distance/distance/specializations/detail/hellinger_expanded_double_double_double_int.cu
-    src/distance/distance/specializations/detail/inner_product_float_float_float_int.cu
-    src/distance/distance/specializations/detail/inner_product_double_double_double_int.cu
-    src/distance/distance/specializations/detail/jensen_shannon_float_float_float_int.cu
-    src/distance/distance/specializations/detail/jensen_shannon_double_double_double_int.cu
-    src/distance/distance/specializations/detail/kernels/gram_matrix_base_double.cu
-    src/distance/distance/specializations/detail/kernels/gram_matrix_base_float.cu
-    src/distance/distance/specializations/detail/kernels/polynomial_kernel_double_int.cu
-    src/distance/distance/specializations/detail/kernels/polynomial_kernel_float_int.cu
+    raft_lib
+    src/distance/pairwise_distance.cu
+    src/distance/fused_l2_min_arg.cu
+    src/cluster/update_centroids_float.cu
+    src/cluster/update_centroids_double.cu
+    src/cluster/cluster_cost_float.cu
+    src/cluster/cluster_cost_double.cu
+    src/neighbors/refine_d_int64_t_float.cu
+    src/neighbors/refine_d_int64_t_int8_t.cu
+    src/neighbors/refine_d_int64_t_uint8_t.cu
+    src/neighbors/refine_h_int64_t_float.cu
+    src/neighbors/refine_h_int64_t_int8_t.cu
+    src/neighbors/refine_h_int64_t_uint8_t.cu
+    src/neighbors/specializations/refine_d_int64_t_float.cu
+    src/neighbors/specializations/refine_d_int64_t_int8_t.cu
+    src/neighbors/specializations/refine_d_int64_t_uint8_t.cu
+    src/neighbors/specializations/refine_h_int64_t_float.cu
+    src/neighbors/specializations/refine_h_int64_t_int8_t.cu
+    src/neighbors/specializations/refine_h_int64_t_uint8_t.cu
+    src/cluster/kmeans_fit_float.cu
+    src/cluster/kmeans_fit_double.cu
+    src/cluster/kmeans_init_plus_plus_double.cu
+    src/cluster/kmeans_init_plus_plus_float.cu
+    src/distance/specializations/detail/canberra_double_double_double_int.cu
+    src/distance/specializations/detail/canberra_float_float_float_int.cu
+    src/distance/specializations/detail/correlation_double_double_double_int.cu
+    src/distance/specializations/detail/correlation_float_float_float_int.cu
+    src/distance/specializations/detail/cosine_double_double_double_int.cu
+    src/distance/specializations/detail/cosine_float_float_float_int.cu
+    src/distance/specializations/detail/hamming_unexpanded_double_double_double_int.cu
+    src/distance/specializations/detail/hamming_unexpanded_float_float_float_int.cu
+    src/distance/specializations/detail/hellinger_expanded_float_float_float_int.cu
+    src/distance/specializations/detail/hellinger_expanded_double_double_double_int.cu
+    src/distance/specializations/detail/inner_product_float_float_float_int.cu
+    src/distance/specializations/detail/inner_product_double_double_double_int.cu
+    src/distance/specializations/detail/jensen_shannon_float_float_float_int.cu
+    src/distance/specializations/detail/jensen_shannon_double_double_double_int.cu
+    src/distance/specializations/detail/kernels/gram_matrix_base_double.cu
+    src/distance/specializations/detail/kernels/gram_matrix_base_float.cu
+    src/distance/specializations/detail/kernels/polynomial_kernel_double_int.cu
+    src/distance/specializations/detail/kernels/polynomial_kernel_float_int.cu
     # These are somehow missing a kernel definition which is causing a compile error.
     # src/distance/specializations/detail/kernels/rbf_kernel_double.cu
     # src/distance/specializations/detail/kernels/rbf_kernel_float.cu
-    src/distance/distance/specializations/detail/kernels/tanh_kernel_double.cu
-    src/distance/distance/specializations/detail/kernels/tanh_kernel_float.cu
-    src/distance/distance/specializations/detail/kl_divergence_float_float_float_int.cu
-    src/distance/distance/specializations/detail/kl_divergence_double_double_double_int.cu
-    src/distance/distance/specializations/detail/l1_float_float_float_int.cu
-    src/distance/distance/specializations/detail/l1_double_double_double_int.cu
-    src/distance/distance/specializations/detail/l2_expanded_float_float_float_int.cu
-    src/distance/distance/specializations/detail/l2_expanded_double_double_double_int.cu
-    src/distance/distance/specializations/detail/l2_sqrt_expanded_float_float_float_int.cu
-    src/distance/distance/specializations/detail/l2_sqrt_expanded_double_double_double_int.cu
-    src/distance/distance/specializations/detail/l2_sqrt_unexpanded_float_float_float_int.cu
-    src/distance/distance/specializations/detail/l2_sqrt_unexpanded_double_double_double_int.cu
-    src/distance/distance/specializations/detail/l2_unexpanded_double_double_double_int.cu
-    src/distance/distance/specializations/detail/l2_unexpanded_float_float_float_int.cu
-    src/distance/distance/specializations/detail/l_inf_double_double_double_int.cu
-    src/distance/distance/specializations/detail/l_inf_float_float_float_int.cu
-    src/distance/distance/specializations/detail/lp_unexpanded_double_double_double_int.cu
-    src/distance/distance/specializations/detail/lp_unexpanded_float_float_float_int.cu
-    src/distance/distance/specializations/detail/russel_rao_double_double_double_int.cu
-    src/distance/distance/specializations/detail/russel_rao_float_float_float_int.cu
-    src/distance/distance/specializations/fused_l2_nn_double_int.cu
-    src/distance/distance/specializations/fused_l2_nn_double_int64.cu
-    src/distance/distance/specializations/fused_l2_nn_float_int.cu
-    src/distance/distance/specializations/fused_l2_nn_float_int64.cu
-    src/distance/matrix/specializations/detail/select_k_float_uint32_t.cu
-    src/distance/matrix/specializations/detail/select_k_float_int64_t.cu
-    src/distance/matrix/specializations/detail/select_k_half_uint32_t.cu
-    src/distance/matrix/specializations/detail/select_k_half_int64_t.cu
-    src/distance/neighbors/ivf_flat_search.cu
-    src/distance/neighbors/ivf_flat_build.cu
-    src/distance/neighbors/specializations/ivfflat_build_float_int64_t.cu
-    src/distance/neighbors/specializations/ivfflat_build_int8_t_int64_t.cu
-    src/distance/neighbors/specializations/ivfflat_build_uint8_t_int64_t.cu
-    src/distance/neighbors/specializations/ivfflat_extend_float_int64_t.cu
-    src/distance/neighbors/specializations/ivfflat_extend_int8_t_int64_t.cu
-    src/distance/neighbors/specializations/ivfflat_extend_uint8_t_int64_t.cu
-    src/distance/neighbors/specializations/ivfflat_search_float_int64_t.cu
-    src/distance/neighbors/specializations/ivfflat_search_int8_t_int64_t.cu
-    src/distance/neighbors/specializations/ivfflat_search_uint8_t_int64_t.cu
-    src/distance/neighbors/ivfpq_build.cu
-    src/distance/neighbors/ivfpq_deserialize.cu
-    src/distance/neighbors/ivfpq_serialize.cu
-    src/distance/neighbors/ivfpq_search_float_int64_t.cu
-    src/distance/neighbors/ivfpq_search_int8_t_int64_t.cu
-    src/distance/neighbors/ivfpq_search_uint8_t_int64_t.cu
-    src/distance/neighbors/specializations/ivfpq_build_float_int64_t.cu
-    src/distance/neighbors/specializations/ivfpq_build_int8_t_int64_t.cu
-    src/distance/neighbors/specializations/ivfpq_build_uint8_t_int64_t.cu
-    src/distance/neighbors/specializations/ivfpq_extend_float_int64_t.cu
-    src/distance/neighbors/specializations/ivfpq_extend_int8_t_int64_t.cu
-    src/distance/neighbors/specializations/ivfpq_extend_uint8_t_int64_t.cu
-    src/distance/neighbors/specializations/ivfpq_search_float_int64_t.cu
-    src/distance/neighbors/specializations/ivfpq_search_int8_t_int64_t.cu
-    src/distance/neighbors/specializations/ivfpq_search_uint8_t_int64_t.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_float_float_fast.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_float_float_no_basediff.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_float_float_no_smem_lut.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_float_fp8s_fast.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_float_fp8s_no_basediff.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_float_fp8s_no_smem_lut.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_float_fp8u_fast.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_float_fp8u_no_basediff.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_float_fp8u_no_smem_lut.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_float_half_fast.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_float_half_no_basediff.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_float_half_no_smem_lut.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_half_fp8s_fast.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_half_fp8s_no_basediff.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_half_fp8s_no_smem_lut.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_half_fp8u_fast.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_half_fp8u_no_basediff.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_half_fp8u_no_smem_lut.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_half_half_fast.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_half_half_no_basediff.cu
-    src/distance/neighbors/specializations/detail/compute_similarity_half_half_no_smem_lut.cu
-    src/distance/random/rmat_rectangular_generator_int_double.cu
-    src/distance/random/rmat_rectangular_generator_int64_double.cu
-    src/distance/random/rmat_rectangular_generator_int_float.cu
-    src/distance/random/rmat_rectangular_generator_int64_float.cu
+    src/distance/specializations/detail/kernels/tanh_kernel_double.cu
+    src/distance/specializations/detail/kernels/tanh_kernel_float.cu
+    src/distance/specializations/detail/kl_divergence_float_float_float_int.cu
+    src/distance/specializations/detail/kl_divergence_double_double_double_int.cu
+    src/distance/specializations/detail/l1_float_float_float_int.cu
+    src/distance/specializations/detail/l1_double_double_double_int.cu
+    src/distance/specializations/detail/l2_expanded_float_float_float_int.cu
+    src/distance/specializations/detail/l2_expanded_double_double_double_int.cu
+    src/distance/specializations/detail/l2_sqrt_expanded_float_float_float_int.cu
+    src/distance/specializations/detail/l2_sqrt_expanded_double_double_double_int.cu
+    src/distance/specializations/detail/l2_sqrt_unexpanded_float_float_float_int.cu
+    src/distance/specializations/detail/l2_sqrt_unexpanded_double_double_double_int.cu
+    src/distance/specializations/detail/l2_unexpanded_double_double_double_int.cu
+    src/distance/specializations/detail/l2_unexpanded_float_float_float_int.cu
+    src/distance/specializations/detail/l_inf_double_double_double_int.cu
+    src/distance/specializations/detail/l_inf_float_float_float_int.cu
+    src/distance/specializations/detail/lp_unexpanded_double_double_double_int.cu
+    src/distance/specializations/detail/lp_unexpanded_float_float_float_int.cu
+    src/distance/specializations/detail/russel_rao_double_double_double_int.cu
+    src/distance/specializations/detail/russel_rao_float_float_float_int.cu
+    src/distance/specializations/fused_l2_nn_double_int.cu
+    src/distance/specializations/fused_l2_nn_double_int64.cu
+    src/distance/specializations/fused_l2_nn_float_int.cu
+    src/distance/specializations/fused_l2_nn_float_int64.cu
+    src/matrix/specializations/detail/select_k_float_uint32_t.cu
+    src/matrix/specializations/detail/select_k_float_int64_t.cu
+    src/matrix/specializations/detail/select_k_half_uint32_t.cu
+    src/matrix/specializations/detail/select_k_half_int64_t.cu
+    src/neighbors/ivfpq_build.cu
+    src/neighbors/ivfpq_deserialize.cu
+    src/neighbors/ivfpq_serialize.cu
+    src/neighbors/ivfpq_search_float_int64_t.cu
+    src/neighbors/ivfpq_search_int8_t_int64_t.cu
+    src/neighbors/ivfpq_search_uint8_t_int64_t.cu
+    src/neighbors/specializations/ivfpq_build_float_int64_t.cu
+    src/neighbors/specializations/ivfpq_build_int8_t_int64_t.cu
+    src/neighbors/specializations/ivfpq_build_uint8_t_int64_t.cu
+    src/neighbors/specializations/ivfpq_extend_float_int64_t.cu
+    src/neighbors/specializations/ivfpq_extend_int8_t_int64_t.cu
+    src/neighbors/specializations/ivfpq_extend_uint8_t_int64_t.cu
+    src/neighbors/specializations/ivfpq_search_float_int64_t.cu
+    src/neighbors/specializations/ivfpq_search_int8_t_int64_t.cu
+    src/neighbors/specializations/ivfpq_search_uint8_t_int64_t.cu
+    src/neighbors/specializations/detail/brute_force_knn_impl_long_float_int.cu
+    src/neighbors/specializations/detail/brute_force_knn_impl_long_float_uint.cu
+    src/neighbors/specializations/detail/brute_force_knn_impl_uint_float_int.cu
+    src/neighbors/specializations/detail/brute_force_knn_impl_uint_float_uint.cu
+    src/neighbors/specializations/detail/compute_similarity_float_float_fast.cu
+    src/neighbors/specializations/detail/compute_similarity_float_float_no_basediff.cu
+    src/neighbors/specializations/detail/compute_similarity_float_float_no_smem_lut.cu
+    src/neighbors/specializations/detail/compute_similarity_float_fp8s_fast.cu
+    src/neighbors/specializations/detail/compute_similarity_float_fp8s_no_basediff.cu
+    src/neighbors/specializations/detail/compute_similarity_float_fp8s_no_smem_lut.cu
+    src/neighbors/specializations/detail/compute_similarity_float_fp8u_fast.cu
+    src/neighbors/specializations/detail/compute_similarity_float_fp8u_no_basediff.cu
+    src/neighbors/specializations/detail/compute_similarity_float_fp8u_no_smem_lut.cu
+    src/neighbors/specializations/detail/compute_similarity_float_half_fast.cu
+    src/neighbors/specializations/detail/compute_similarity_float_half_no_basediff.cu
+    src/neighbors/specializations/detail/compute_similarity_float_half_no_smem_lut.cu
+    src/neighbors/specializations/detail/compute_similarity_half_fp8s_fast.cu
+    src/neighbors/specializations/detail/compute_similarity_half_fp8s_no_basediff.cu
+    src/neighbors/specializations/detail/compute_similarity_half_fp8s_no_smem_lut.cu
+    src/neighbors/specializations/detail/compute_similarity_half_fp8u_fast.cu
+    src/neighbors/specializations/detail/compute_similarity_half_fp8u_no_basediff.cu
+    src/neighbors/specializations/detail/compute_similarity_half_fp8u_no_smem_lut.cu
+    src/neighbors/specializations/detail/compute_similarity_half_half_fast.cu
+    src/neighbors/specializations/detail/compute_similarity_half_half_no_basediff.cu
+    src/neighbors/specializations/detail/compute_similarity_half_half_no_smem_lut.cu
+    src/random/rmat_rectangular_generator_int_double.cu
+    src/random/rmat_rectangular_generator_int64_double.cu
+    src/random/rmat_rectangular_generator_int_float.cu
+    src/random/rmat_rectangular_generator_int64_float.cu
+    src/neighbors/specializations/detail/ball_cover_lowdim_pass_one_2d.cu
+    src/neighbors/specializations/detail/ball_cover_lowdim_pass_two_2d.cu
+    src/neighbors/specializations/detail/ball_cover_lowdim_pass_one_3d.cu
+    src/neighbors/specializations/detail/ball_cover_lowdim_pass_two_3d.cu
+    src/neighbors/specializations/ball_cover_all_knn_query.cu
+    src/neighbors/specializations/ball_cover_build_index.cu
+    src/neighbors/specializations/ball_cover_knn_query.cu
+    src/neighbors/specializations/fused_l2_knn_long_float_true.cu
+    src/neighbors/specializations/fused_l2_knn_long_float_false.cu
+    src/neighbors/specializations/fused_l2_knn_int_float_true.cu
+    src/neighbors/specializations/fused_l2_knn_int_float_false.cu
+    src/neighbors/ivf_flat_search.cu
+    src/neighbors/ivf_flat_build.cu
+    src/neighbors/specializations/ivfflat_build_float_int64_t.cu
+    src/neighbors/specializations/ivfflat_build_int8_t_int64_t.cu
+    src/neighbors/specializations/ivfflat_build_uint8_t_int64_t.cu
+    src/neighbors/specializations/ivfflat_extend_float_int64_t.cu
+    src/neighbors/specializations/ivfflat_extend_int8_t_int64_t.cu
+    src/neighbors/specializations/ivfflat_extend_uint8_t_int64_t.cu
+    src/neighbors/specializations/ivfflat_search_float_int64_t.cu
+    src/neighbors/specializations/ivfflat_search_int8_t_int64_t.cu
+    src/neighbors/specializations/ivfflat_search_uint8_t_int64_t.cu
+    src/neighbors/ivfpq_build.cu
+    src/neighbors/ivfpq_deserialize.cu
+    src/neighbors/ivfpq_serialize.cu
+    src/neighbors/ivfpq_search_float_int64_t.cu
+    src/neighbors/ivfpq_search_int8_t_int64_t.cu
+    src/neighbors/ivfpq_search_uint8_t_int64_t.cu
+    src/neighbors/specializations/ivfpq_build_float_int64_t.cu
+    src/neighbors/specializations/ivfpq_build_int8_t_int64_t.cu
+    src/neighbors/specializations/ivfpq_build_uint8_t_int64_t.cu
+    src/neighbors/specializations/ivfpq_extend_float_int64_t.cu
+    src/neighbors/specializations/ivfpq_extend_int8_t_int64_t.cu
+    src/neighbors/specializations/ivfpq_extend_uint8_t_int64_t.cu
+    src/neighbors/specializations/ivfpq_search_float_int64_t.cu
+    src/neighbors/specializations/ivfpq_search_int8_t_int64_t.cu
+    src/neighbors/specializations/ivfpq_search_uint8_t_int64_t.cu
+    src/neighbors/specializations/detail/compute_similarity_float_float_fast.cu
+    src/neighbors/specializations/detail/compute_similarity_float_float_no_basediff.cu
+    src/neighbors/specializations/detail/compute_similarity_float_float_no_smem_lut.cu
+    src/neighbors/specializations/detail/compute_similarity_float_fp8s_fast.cu
+    src/neighbors/specializations/detail/compute_similarity_float_fp8s_no_basediff.cu
+    src/neighbors/specializations/detail/compute_similarity_float_fp8s_no_smem_lut.cu
+    src/neighbors/specializations/detail/compute_similarity_float_fp8u_fast.cu
+    src/neighbors/specializations/detail/compute_similarity_float_fp8u_no_basediff.cu
+    src/neighbors/specializations/detail/compute_similarity_float_fp8u_no_smem_lut.cu
+    src/neighbors/specializations/detail/compute_similarity_float_half_fast.cu
+    src/neighbors/specializations/detail/compute_similarity_float_half_no_basediff.cu
+    src/neighbors/specializations/detail/compute_similarity_float_half_no_smem_lut.cu
+    src/neighbors/specializations/detail/compute_similarity_half_fp8s_fast.cu
+    src/neighbors/specializations/detail/compute_similarity_half_fp8s_no_basediff.cu
+    src/neighbors/specializations/detail/compute_similarity_half_fp8s_no_smem_lut.cu
+    src/neighbors/specializations/detail/compute_similarity_half_fp8u_fast.cu
+    src/neighbors/specializations/detail/compute_similarity_half_fp8u_no_basediff.cu
+    src/neighbors/specializations/detail/compute_similarity_half_fp8u_no_smem_lut.cu
+    src/neighbors/specializations/detail/compute_similarity_half_half_fast.cu
+    src/neighbors/specializations/detail/compute_similarity_half_half_no_basediff.cu
+    src/neighbors/specializations/detail/compute_similarity_half_half_no_smem_lut.cu
+    src/random/rmat_rectangular_generator_int_double.cu
+    src/random/rmat_rectangular_generator_int64_double.cu
+    src/random/rmat_rectangular_generator_int_float.cu
+    src/random/rmat_rectangular_generator_int64_float.cu
   )
   set_target_properties(
-    raft_distance_lib
-    PROPERTIES OUTPUT_NAME raft_distance
+    raft_lib
+    PROPERTIES OUTPUT_NAME raft
                BUILD_RPATH "\$ORIGIN"
                INSTALL_RPATH "\$ORIGIN"
                CXX_STANDARD 17
@@ -418,95 +452,23 @@ if(RAFT_COMPILE_DIST_LIBRARY)
                INTERFACE_POSITION_INDEPENDENT_CODE ON
   )
 
-  target_link_libraries(
-    raft_distance_lib
-    PUBLIC raft::raft cuco::cuco
-    PRIVATE nvidia::cutlass::cutlass $<TARGET_NAME_IF_EXISTS:OpenMP::OpenMP_CXX>
-  )
+  target_link_libraries(raft_lib PUBLIC raft::raft $<TARGET_NAME_IF_EXISTS:OpenMP::OpenMP_CXX>)
   target_compile_options(
-    raft_distance_lib PRIVATE "$<$<COMPILE_LANGUAGE:CXX>:${RAFT_CXX_FLAGS}>"
-                              "$<$<COMPILE_LANGUAGE:CUDA>:${RAFT_CUDA_FLAGS}>"
-  )
-  target_compile_definitions(raft_distance_lib INTERFACE "RAFT_DISTANCE_COMPILED")
-
-  # ensure CUDA symbols aren't relocated to the middle of the debug build binaries
-  target_link_options(raft_distance_lib PRIVATE "${CMAKE_CURRENT_BINARY_DIR}/fatbin.ld")
-
-endif()
-
-if(TARGET raft_distance_lib AND (NOT TARGET raft::raft_distance_lib))
-  add_library(raft::raft_distance_lib ALIAS raft_distance_lib)
-endif()
-
-target_link_libraries(
-  raft_distance INTERFACE raft::raft $<TARGET_NAME_IF_EXISTS:raft::raft_distance_lib>
-                          nvidia::cutlass::cutlass
-)
-
-# ##################################################################################################
-# * raft_nn ------------------------------------------------------------------
-add_library(raft_nn INTERFACE)
-
-if(TARGET raft_nn AND (NOT TARGET raft::nn))
-  add_library(raft::nn ALIAS raft_nn)
-endif()
-
-set_target_properties(raft_nn PROPERTIES EXPORT_NAME nn)
-
-if(RAFT_COMPILE_NN_LIBRARY)
-  add_library(
-    raft_nn_lib
-    src/nn/specializations/detail/ball_cover_lowdim_pass_one_2d.cu
-    src/nn/specializations/detail/ball_cover_lowdim_pass_two_2d.cu
-    src/nn/specializations/detail/ball_cover_lowdim_pass_one_3d.cu
-    src/nn/specializations/detail/ball_cover_lowdim_pass_two_3d.cu
-    src/nn/specializations/ball_cover_all_knn_query.cu
-    src/nn/specializations/ball_cover_build_index.cu
-    src/nn/specializations/ball_cover_knn_query.cu
-    src/nn/specializations/fused_l2_knn_long_float_true.cu
-    src/nn/specializations/fused_l2_knn_long_float_false.cu
-    src/nn/specializations/fused_l2_knn_int_float_true.cu
-    src/nn/specializations/fused_l2_knn_int_float_false.cu
-    src/nn/specializations/brute_force_knn_long_float_int.cu
-    src/nn/specializations/brute_force_knn_long_float_uint.cu
-    src/nn/specializations/brute_force_knn_uint32_t_float_int.cu
-    src/nn/specializations/brute_force_knn_uint32_t_float_uint.cu
-  )
-  set_target_properties(
-    raft_nn_lib
-    PROPERTIES OUTPUT_NAME raft_nn
-               BUILD_RPATH "\$ORIGIN"
-               INSTALL_RPATH "\$ORIGIN"
-               CXX_STANDARD 17
-               CXX_STANDARD_REQUIRED ON
-               CUDA_STANDARD 17
-               CUDA_STANDARD_REQUIRED ON
-               POSITION_INDEPENDENT_CODE ON
-               INTERFACE_POSITION_INDEPENDENT_CODE ON
+    raft_lib PRIVATE "$<$<COMPILE_LANGUAGE:CXX>:${RAFT_CXX_FLAGS}>"
+                     "$<$<COMPILE_LANGUAGE:CUDA>:${RAFT_CUDA_FLAGS}>"
   )
+  target_compile_definitions(raft_lib INTERFACE "RAFT_COMPILED")
 
-  target_link_libraries(
-    raft_nn_lib
-    PUBLIC raft::raft
-    PRIVATE nvidia::cutlass::cutlass
-  )
-  target_compile_options(
-    raft_nn_lib PRIVATE "$<$<COMPILE_LANGUAGE:CXX>:${RAFT_CXX_FLAGS}>"
-                        "$<$<COMPILE_LANGUAGE:CUDA>:${RAFT_CUDA_FLAGS}>"
-  )
   # ensure CUDA symbols aren't relocated to the middle of the debug build binaries
-  target_link_options(raft_nn_lib PRIVATE "${CMAKE_CURRENT_BINARY_DIR}/fatbin.ld")
+  target_link_options(raft_lib PRIVATE "${CMAKE_CURRENT_BINARY_DIR}/fatbin.ld")
 
-  target_compile_definitions(raft_nn_lib INTERFACE "RAFT_NN_COMPILED")
 endif()
 
-if(TARGET raft_nn_lib AND (NOT TARGET raft::raft_nn_lib))
-  add_library(raft::raft_nn_lib ALIAS raft_nn_lib)
+if(TARGET raft_lib AND (NOT TARGET raft::raft_lib))
+  add_library(raft::raft_lib ALIAS raft_lib)
 endif()
 
-target_link_libraries(
-  raft_nn INTERFACE raft::raft $<TARGET_NAME_IF_EXISTS:raft::raft_nn_lib> nvidia::cutlass::cutlass
-)
+target_link_libraries(raft_compiled INTERFACE raft::raft $<TARGET_NAME_IF_EXISTS:raft::raft_lib>)
 
 # ##################################################################################################
 # * raft_distributed -------------------------------------------------------------------------------
@@ -547,39 +509,23 @@ install(
 )
 
 install(
-  TARGETS raft_distance
+  TARGETS raft_compiled
   DESTINATION ${lib_dir}
   COMPONENT raft
-  EXPORT raft-distance-exports
+  EXPORT raft-compiled-exports
 )
 
-install(
-  TARGETS raft_nn
-  DESTINATION ${lib_dir}
-  COMPONENT raft
-  EXPORT raft-nn-exports
-)
-
-if(TARGET raft_distance_lib)
+if(TARGET raft_lib)
   install(
-    TARGETS raft_distance_lib
+    TARGETS raft_lib
     DESTINATION ${lib_dir}
-    COMPONENT distance
-    EXPORT raft-distance-lib-exports
+    COMPONENT compiled
+    EXPORT raft-compiled-lib-exports
   )
   install(
     DIRECTORY include/raft_runtime
     DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}
-    COMPONENT distance
-  )
-endif()
-
-if(TARGET raft_nn_lib)
-  install(
-    TARGETS raft_nn_lib
-    DESTINATION ${lib_dir}
-    COMPONENT nn
-    EXPORT raft-nn-lib-exports
+    COMPONENT compiled
   )
 endif()
 
@@ -614,15 +560,11 @@ install(
 
 include("${rapids-cmake-dir}/export/write_dependencies.cmake")
 
-set(raft_components distance nn distributed)
-set(raft_install_comp raft raft raft)
-if(TARGET raft_distance_lib)
-  list(APPEND raft_components distance-lib)
-  list(APPEND raft_install_comp distance)
-endif()
-if(TARGET raft_nn_lib)
-  list(APPEND raft_components nn-lib)
-  list(APPEND raft_install_comp nn)
+set(raft_components compiled distributed)
+set(raft_install_comp raft raft)
+if(TARGET raft_lib)
+  list(APPEND raft_components compiled-lib)
+  list(APPEND raft_install_comp compiled)
 endif()
 
 foreach(comp install_comp IN ZIP_LISTS raft_components raft_install_comp)
@@ -658,14 +600,12 @@ RAFT contains fundamental widely-used algorithms and primitives
 for data science and machine learning.
 
 Optional Components:
-  - nn
-  - distance
+  - compiled
   - distributed
 
 Imported Targets:
   - raft::raft
-  - raft::nn brought in by the `nn` optional component
-  - raft::distance brought in by the `distance` optional component
+  - raft::compiled brought in by the `compiled` optional component
   - raft::distributed brought in by the `distributed` optional component
 
 ]=]
@@ -673,27 +613,21 @@ Imported Targets:
 
 set(code_string ${nvtx_export_string})
 
-if(RAFT_ENABLE_thrust_DEPENDENCY)
-  string(
-    APPEND
-    code_string
-    [=[
-  if(NOT TARGET raft::Thrust)
-    thrust_create_target(raft::Thrust FROM_OPTIONS)
-  endif()
-  ]=]
-  )
-endif()
-
 string(
   APPEND
   code_string
   [=[
-if(distance IN_LIST raft_FIND_COMPONENTS)
-  enable_language(CUDA)
+if(NOT TARGET raft::Thrust)
+  thrust_create_target(raft::Thrust FROM_OPTIONS)
 endif()
+]=]
+)
 
-if(nn IN_LIST raft_FIND_COMPONENTS)
+string(
+  APPEND
+  code_string
+  [=[
+if(compiled IN_LIST raft_FIND_COMPONENTS)
   enable_language(CUDA)
 endif()
 ]=]
@@ -702,15 +636,15 @@ endif()
 # Use `rapids_export` for 22.04 as it will have COMPONENT support
 include(cmake/modules/raft_export.cmake)
 raft_export(
-  INSTALL raft COMPONENTS nn distance distributed EXPORT_SET raft-exports GLOBAL_TARGETS raft nn
-  distance distributed NAMESPACE raft:: DOCUMENTATION doc_string FINAL_CODE_BLOCK code_string
+  INSTALL raft COMPONENTS compiled distributed EXPORT_SET raft-exports GLOBAL_TARGETS raft compiled
+  distributed NAMESPACE raft:: DOCUMENTATION doc_string FINAL_CODE_BLOCK code_string
 )
 
 # ##################################################################################################
 # * build export -------------------------------------------------------------
 raft_export(
-  BUILD raft EXPORT_SET raft-exports COMPONENTS nn distance distributed GLOBAL_TARGETS raft
-  distance distributed nn DOCUMENTATION doc_string NAMESPACE raft:: FINAL_CODE_BLOCK code_string
+  BUILD raft EXPORT_SET raft-exports COMPONENTS compiled distributed GLOBAL_TARGETS raft compiled
+  distributed DOCUMENTATION doc_string NAMESPACE raft:: FINAL_CODE_BLOCK code_string
 )
 
 # ##################################################################################################
diff --git a/cpp/bench/CMakeLists.txt b/cpp/bench/CMakeLists.txt
index e2324de654..8049074c09 100644
--- a/cpp/bench/CMakeLists.txt
+++ b/cpp/bench/CMakeLists.txt
@@ -17,7 +17,7 @@
 
 function(ConfigureBench)
 
-  set(options OPTIONAL DIST NN)
+  set(options OPTIONAL LIB)
   set(oneValueArgs NAME)
   set(multiValueArgs PATH TARGETS CONFIGURATIONS)
 
@@ -31,8 +31,7 @@ function(ConfigureBench)
     ${BENCH_NAME}
     PRIVATE raft::raft
             raft_internal
-            $<$<BOOL:${ConfigureBench_DIST}>:raft::distance>
-            $<$<BOOL:${ConfigureBench_NN}>:raft::nn>
+            $<$<BOOL:${ConfigureBench_LIB}>:raft::compiled>
             benchmark::benchmark
             Threads::Threads
             $<TARGET_NAME_IF_EXISTS:OpenMP::OpenMP_CXX>
@@ -70,7 +69,7 @@ endfunction()
 if(BUILD_BENCH)
   ConfigureBench(
     NAME CLUSTER_BENCH PATH bench/cluster/kmeans_balanced.cu bench/cluster/kmeans.cu bench/main.cpp
-    OPTIONAL DIST NN
+    OPTIONAL LIB
   )
 
   ConfigureBench(
@@ -86,7 +85,7 @@ if(BUILD_BENCH)
     bench/distance/kernels.cu
     bench/main.cpp
     OPTIONAL
-    DIST
+    LIB
   )
 
   ConfigureBench(
@@ -106,7 +105,7 @@ if(BUILD_BENCH)
 
   ConfigureBench(
     NAME MATRIX_BENCH PATH bench/matrix/argmin.cu bench/matrix/gather.cu bench/matrix/select_k.cu
-    bench/main.cpp OPTIONAL DIST
+    bench/main.cpp OPTIONAL LIB
   )
 
   ConfigureBench(
@@ -132,7 +131,6 @@ if(BUILD_BENCH)
     bench/neighbors/refine_uint8_t_int64_t.cu
     bench/main.cpp
     OPTIONAL
-    DIST
-    NN
+    LIB
   )
 endif()
diff --git a/cpp/bench/cluster/kmeans.cu b/cpp/bench/cluster/kmeans.cu
index f593ec090d..af7afb8037 100644
--- a/cpp/bench/cluster/kmeans.cu
+++ b/cpp/bench/cluster/kmeans.cu
@@ -18,7 +18,7 @@
 #include <raft/cluster/kmeans.cuh>
 #include <raft/cluster/kmeans_types.hpp>
 
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/cluster/specializations.cuh>
 #endif
 
diff --git a/cpp/bench/cluster/kmeans_balanced.cu b/cpp/bench/cluster/kmeans_balanced.cu
index 8dda155a59..6bda43bdb2 100644
--- a/cpp/bench/cluster/kmeans_balanced.cu
+++ b/cpp/bench/cluster/kmeans_balanced.cu
@@ -18,7 +18,7 @@
 #include <raft/cluster/kmeans_balanced.cuh>
 #include <raft/random/rng.cuh>
 
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/cluster/specializations.cuh>
 #endif
 
diff --git a/cpp/bench/distance/distance_common.cuh b/cpp/bench/distance/distance_common.cuh
index 906271bf5a..9b5d67a46f 100644
--- a/cpp/bench/distance/distance_common.cuh
+++ b/cpp/bench/distance/distance_common.cuh
@@ -17,7 +17,7 @@
 #include <common/benchmark.hpp>
 #include <raft/distance/distance.cuh>
 #include <raft/util/cudart_utils.hpp>
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/distance/specializations.cuh>
 #endif
 #include <rmm/device_uvector.hpp>
diff --git a/cpp/bench/distance/fused_l2_nn.cu b/cpp/bench/distance/fused_l2_nn.cu
index 7531784707..1c45572782 100644
--- a/cpp/bench/distance/fused_l2_nn.cu
+++ b/cpp/bench/distance/fused_l2_nn.cu
@@ -17,7 +17,7 @@
 #include <common/benchmark.hpp>
 #include <raft/distance/fused_l2_nn.cuh>
 #include <raft/util/cudart_utils.hpp>
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/distance/specializations.cuh>
 #endif
 #include <rmm/device_uvector.hpp>
diff --git a/cpp/bench/distance/kernels.cu b/cpp/bench/distance/kernels.cu
index 027f93171e..4407bdcf83 100644
--- a/cpp/bench/distance/kernels.cu
+++ b/cpp/bench/distance/kernels.cu
@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/distance/specializations.cuh>
 #endif
 
diff --git a/cpp/bench/distance/masked_nn.cu b/cpp/bench/distance/masked_nn.cu
index 1fecb455c3..f9f234187d 100644
--- a/cpp/bench/distance/masked_nn.cu
+++ b/cpp/bench/distance/masked_nn.cu
@@ -30,7 +30,7 @@
 #include <raft/random/rng.cuh>
 #include <raft/util/cudart_utils.hpp>
 
-#ifdef RAFT_DISTANCE_COMPILED
+#ifdef RAFT_COMPILED
 #include <raft/distance/specializations.cuh>
 #endif
 
diff --git a/cpp/bench/matrix/select_k.cu b/cpp/bench/matrix/select_k.cu
index 3b6f031c77..d4873e2640 100644
--- a/cpp/bench/matrix/select_k.cu
+++ b/cpp/bench/matrix/select_k.cu
@@ -23,7 +23,7 @@
 #include <raft/sparse/detail/utils.h>
 #include <raft/util/cudart_utils.hpp>
 
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/matrix/specializations.cuh>
 #endif
 
diff --git a/cpp/bench/neighbors/knn.cuh b/cpp/bench/neighbors/knn.cuh
index fe8c2c10d8..6caf355034 100644
--- a/cpp/bench/neighbors/knn.cuh
+++ b/cpp/bench/neighbors/knn.cuh
@@ -24,15 +24,10 @@
 #include <raft/neighbors/ivf_pq.cuh>
 #include <raft/spatial/knn/knn.cuh>
 
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/neighbors/specializations.cuh>
 #endif
 
-#if defined RAFT_NN_COMPILED
-// TODO: Legacy. Remove when FAISS is removed
-#include <raft/spatial/knn/specializations.cuh>
-#endif
-
 #include <rmm/mr/device/managed_memory_resource.hpp>
 #include <rmm/mr/device/per_device_resource.hpp>
 
diff --git a/cpp/bench/neighbors/refine_float_int64_t.cu b/cpp/bench/neighbors/refine_float_int64_t.cu
index 40ab2bc0ca..43be330e9b 100644
--- a/cpp/bench/neighbors/refine_float_int64_t.cu
+++ b/cpp/bench/neighbors/refine_float_int64_t.cu
@@ -17,11 +17,8 @@
 #include "refine.cuh"
 #include <common/benchmark.hpp>
 
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/neighbors/specializations/refine.cuh>
-#endif
-
-#if defined RAFT_NN_COMPILED
 #include <raft/spatial/knn/specializations.cuh>
 #endif
 
diff --git a/cpp/bench/neighbors/refine_uint8_t_int64_t.cu b/cpp/bench/neighbors/refine_uint8_t_int64_t.cu
index 92806f84a7..1d7cb8c8aa 100644
--- a/cpp/bench/neighbors/refine_uint8_t_int64_t.cu
+++ b/cpp/bench/neighbors/refine_uint8_t_int64_t.cu
@@ -17,13 +17,8 @@
 #include "refine.cuh"
 #include <common/benchmark.hpp>
 
-#if defined RAFT_DISTANCE_COMPILED
-#include <raft/distance/specializations.cuh>
-#include <raft/neighbors/specializations/refine.cuh>
-#endif
-
-#if defined RAFT_NN_COMPILED
-#include <raft/spatial/knn/specializations.cuh>
+#if defined RAFT_COMPILED
+#include <raft/neighbors/specializations.cuh>
 #endif
 
 using namespace raft::neighbors;
diff --git a/cpp/cmake/modules/raft_export.cmake b/cpp/cmake/modules/raft_export.cmake
index bcc3578bf8..0a43f9451c 100644
--- a/cpp/cmake/modules/raft_export.cmake
+++ b/cpp/cmake/modules/raft_export.cmake
@@ -1,5 +1,5 @@
 # =============================================================================
-# Copyright (c) 2021-2022, NVIDIA CORPORATION.
+# Copyright (c) 2021-2023, NVIDIA CORPORATION.
 #
 # Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
 # in compliance with the License. You may obtain a copy of the License at
@@ -213,7 +213,7 @@ function(raft_export type project_name)
       DESTINATION "${install_location}"
       COMPONENT raft
     )
-    foreach(comp nn distance)
+    foreach(comp compiled)
       set(scratch_dir "${PROJECT_BINARY_DIR}/rapids-cmake/${project_name}/export/${comp}/")
       file(MAKE_DIRECTORY "${scratch_dir}")
       install(
diff --git a/cpp/cmake/thirdparty/get_cutlass.cmake b/cpp/cmake/thirdparty/get_cutlass.cmake
index 3e02ce064e..cb809de445 100644
--- a/cpp/cmake/thirdparty/get_cutlass.cmake
+++ b/cpp/cmake/thirdparty/get_cutlass.cmake
@@ -1,5 +1,5 @@
 # =============================================================================
-# Copyright (c) 2021-2022, NVIDIA CORPORATION.
+# Copyright (c) 2021-2023, NVIDIA CORPORATION.
 #
 # Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
 # in compliance with the License. You may obtain a copy of the License at
@@ -61,32 +61,19 @@ function(find_and_configure_cutlass)
   # We generate the cutlass-config files when we built cutlass locally, so always do
   # `find_dependency`
   rapids_export_package(
-          BUILD NvidiaCutlass raft-distance-exports GLOBAL_TARGETS nvidia::cutlass::cutlass
+          BUILD NvidiaCutlass raft-exports GLOBAL_TARGETS nvidia::cutlass::cutlass
   )
   rapids_export_package(
-          INSTALL NvidiaCutlass raft-distance-exports GLOBAL_TARGETS nvidia::cutlass::cutlass
-  )
-  rapids_export_package(
-          BUILD NvidiaCutlass raft-nn-exports GLOBAL_TARGETS nvidia::cutlass::cutlass
-  )
-  rapids_export_package(
-          INSTALL NvidiaCutlass raft-nn-exports GLOBAL_TARGETS nvidia::cutlass::cutlass
+          INSTALL NvidiaCutlass raft-exports GLOBAL_TARGETS nvidia::cutlass::cutlass
   )
 
   # Tell cmake where it can find the generated NvidiaCutlass-config.cmake we wrote.
   include("${rapids-cmake-dir}/export/find_package_root.cmake")
   rapids_export_find_package_root(
-          INSTALL NvidiaCutlass [=[${CMAKE_CURRENT_LIST_DIR}/../]=] raft-distance-exports
-  )
-  rapids_export_find_package_root(
-          BUILD NvidiaCutlass [=[${CMAKE_CURRENT_LIST_DIR}]=] raft-distance-exports
-  )
-  include("${rapids-cmake-dir}/export/find_package_root.cmake")
-  rapids_export_find_package_root(
-          INSTALL NvidiaCutlass [=[${CMAKE_CURRENT_LIST_DIR}/../]=] raft-nn-exports
+          INSTALL NvidiaCutlass [=[${CMAKE_CURRENT_LIST_DIR}/../]=] raft-exports
   )
   rapids_export_find_package_root(
-          BUILD NvidiaCutlass [=[${CMAKE_CURRENT_LIST_DIR}]=] raft-nn-exports
+          BUILD NvidiaCutlass [=[${CMAKE_CURRENT_LIST_DIR}]=] raft-exports
   )
 endfunction()
 
diff --git a/cpp/cmake/thirdparty/get_thrust.cmake b/cpp/cmake/thirdparty/get_thrust.cmake
index 12360b9482..6e37aab40d 100644
--- a/cpp/cmake/thirdparty/get_thrust.cmake
+++ b/cpp/cmake/thirdparty/get_thrust.cmake
@@ -1,5 +1,5 @@
 # =============================================================================
-# Copyright (c) 2022, NVIDIA CORPORATION.
+# Copyright (c) 2022-2023, NVIDIA CORPORATION.
 #
 # Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
 # in compliance with the License. You may obtain a copy of the License at
@@ -21,6 +21,4 @@ function(find_and_configure_thrust)
                            INSTALL_EXPORT_SET raft-exports)
 endfunction()
 
-if(RAFT_ENABLE_thrust_DEPENDENCY)
-  find_and_configure_thrust()
-endif()
+find_and_configure_thrust()
diff --git a/cpp/include/raft/neighbors/specializations.cuh b/cpp/include/raft/neighbors/specializations.cuh
index 27105b6eab..9da5649ef8 100644
--- a/cpp/include/raft/neighbors/specializations.cuh
+++ b/cpp/include/raft/neighbors/specializations.cuh
@@ -16,10 +16,14 @@
 
 #pragma once
 
+#include <raft/neighbors/specializations/ball_cover.cuh>
+#include <raft/neighbors/specializations/brute_force.cuh>
+#include <raft/neighbors/specializations/fused_l2_knn.cuh>
+
 #include <raft/neighbors/specializations/ivf_flat.cuh>
 #include <raft/neighbors/specializations/ivf_pq.cuh>
 #include <raft/neighbors/specializations/refine.cuh>
 
 #include <raft/cluster/specializations.cuh>
 #include <raft/distance/specializations.cuh>
-#include <raft/matrix/specializations.cuh>
\ No newline at end of file
+#include <raft/matrix/specializations.cuh>
diff --git a/cpp/include/raft/neighbors/specializations/knn.cuh b/cpp/include/raft/neighbors/specializations/brute_force.cuh
similarity index 61%
rename from cpp/include/raft/neighbors/specializations/knn.cuh
rename to cpp/include/raft/neighbors/specializations/brute_force.cuh
index e0b64415fe..d418d40185 100644
--- a/cpp/include/raft/neighbors/specializations/knn.cuh
+++ b/cpp/include/raft/neighbors/specializations/brute_force.cuh
@@ -17,31 +17,6 @@
 #pragma once
 
 #include <raft/neighbors/brute_force.cuh>
-#include <raft/spatial/knn/knn.cuh>
-
-namespace raft::spatial::knn {
-#define RAFT_INST(IdxT, T, IntT)                                                            \
-  extern template void brute_force_knn<IdxT, T, IntT>(raft::device_resources const& handle, \
-                                                      std::vector<T*>& input,               \
-                                                      std::vector<IntT>& sizes,             \
-                                                      IntT D,                               \
-                                                      T* search_items,                      \
-                                                      IntT n,                               \
-                                                      IdxT* res_I,                          \
-                                                      T* res_D,                             \
-                                                      IntT k,                               \
-                                                      bool rowMajorIndex,                   \
-                                                      bool rowMajorQuery,                   \
-                                                      std::vector<IdxT>* translations,      \
-                                                      distance::DistanceType metric,        \
-                                                      float metric_arg);
-
-RAFT_INST(long, float, int);
-RAFT_INST(long, float, unsigned int);
-RAFT_INST(uint32_t, float, int);
-RAFT_INST(uint32_t, float, unsigned int);
-#undef RAFT_INST
-};  // namespace raft::spatial::knn
 
 // also define the detail api, which is used by raft::neighbors::brute_force
 // (not doing the public api, since has extra template params on index_layout, matrix_index,
diff --git a/cpp/include/raft/spatial/knn/specializations.cuh b/cpp/include/raft/spatial/knn/specializations.cuh
index 34b7b742e9..5f0a39a61b 100644
--- a/cpp/include/raft/spatial/knn/specializations.cuh
+++ b/cpp/include/raft/spatial/knn/specializations.cuh
@@ -14,13 +14,8 @@
  * limitations under the License.
  */
 
-#ifndef __KNN_SPECIALIZATIONS_H
-#define __KNN_SPECIALIZATIONS_H
-
 #pragma once
 
 #include <raft/neighbors/specializations/ball_cover.cuh>
+#include <raft/neighbors/specializations/brute_force.cuh>
 #include <raft/neighbors/specializations/fused_l2_knn.cuh>
-#include <raft/neighbors/specializations/knn.cuh>
-
-#endif
diff --git a/cpp/include/raft/spatial/knn/specializations/knn.cuh b/cpp/include/raft/spatial/knn/specializations/knn.cuh
new file mode 100644
index 0000000000..e045487597
--- /dev/null
+++ b/cpp/include/raft/spatial/knn/specializations/knn.cuh
@@ -0,0 +1,43 @@
+/*
+ * Copyright (c) 2021-2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#pragma once
+
+#include <raft/spatial/knn/knn.cuh>
+
+namespace raft::spatial::knn {
+#define RAFT_INST(IdxT, T, IntT)                                                            \
+  extern template void brute_force_knn<IdxT, T, IntT>(raft::device_resources const& handle, \
+                                                      std::vector<T*>& input,               \
+                                                      std::vector<IntT>& sizes,             \
+                                                      IntT D,                               \
+                                                      T* search_items,                      \
+                                                      IntT n,                               \
+                                                      IdxT* res_I,                          \
+                                                      T* res_D,                             \
+                                                      IntT k,                               \
+                                                      bool rowMajorIndex,                   \
+                                                      bool rowMajorQuery,                   \
+                                                      std::vector<IdxT>* translations,      \
+                                                      distance::DistanceType metric,        \
+                                                      float metric_arg);
+
+RAFT_INST(long, float, int);
+RAFT_INST(long, float, unsigned int);
+RAFT_INST(uint32_t, float, int);
+RAFT_INST(uint32_t, float, unsigned int);
+#undef RAFT_INST
+};  // namespace raft::spatial::knn
diff --git a/cpp/include/raft/spectral/specializations.cuh b/cpp/include/raft/spectral/specializations.cuh
index 2303b426fd..0ce5f0c653 100644
--- a/cpp/include/raft/spectral/specializations.cuh
+++ b/cpp/include/raft/spectral/specializations.cuh
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -19,6 +19,6 @@
 #pragma once
 
 #include <raft/distance/specializations.cuh>
-#include <raft/spatial/knn/specializations.cuh>
+#include <raft/neighbors/specializations.cuh>
 
 #endif
\ No newline at end of file
diff --git a/cpp/include/raft/stats/specializations.cuh b/cpp/include/raft/stats/specializations.cuh
index 660eee783f..e6622469d3 100644
--- a/cpp/include/raft/stats/specializations.cuh
+++ b/cpp/include/raft/stats/specializations.cuh
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -19,6 +19,6 @@
 #pragma once
 
 #include <raft/distance/specializations.cuh>
-#include <raft/spatial/knn/specializations.cuh>
+#include <raft/neighbors/specializations.cuh>
 
 #endif
\ No newline at end of file
diff --git a/cpp/include/raft_runtime/neighbors/brute_force.hpp b/cpp/include/raft_runtime/neighbors/brute_force.hpp
new file mode 100644
index 0000000000..19904f4f78
--- /dev/null
+++ b/cpp/include/raft_runtime/neighbors/brute_force.hpp
@@ -0,0 +1,39 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#pragma once
+
+#include <raft/core/device_mdspan.hpp>
+#include <raft/core/device_resources.hpp>
+
+namespace raft::runtime::neighbors::brute_force {
+
+#define RAFT_INST_BFKNN(IDX_T, DATA_T, MATRIX_IDX_T, INDEX_LAYOUT, SEARCH_LAYOUT)                 \
+  void knn(raft::device_resources const& handle,                                                  \
+           std::vector<raft::device_matrix_view<const DATA_T, MATRIX_IDX_T, INDEX_LAYOUT>> index, \
+           raft::device_matrix_view<const DATA_T, MATRIX_IDX_T, SEARCH_LAYOUT> search,            \
+           raft::device_matrix_view<IDX_T, MATRIX_IDX_T, row_major> indices,                      \
+           raft::device_matrix_view<DATA_T, MATRIX_IDX_T, row_major> distances,                   \
+           int k,                                                                                 \
+           distance::DistanceType metric         = distance::DistanceType::L2Unexpanded,          \
+           std::optional<float> metric_arg       = std::make_optional<float>(2.0f),               \
+           std::optional<IDX_T> global_id_offset = std::nullopt);
+
+RAFT_INST_BFKNN(int64_t, float, uint32_t, raft::row_major, raft::row_major);
+
+#undef RAFT_INST_BFKNN
+
+}  // namespace raft::runtime::neighbors::brute_force
diff --git a/cpp/internal/raft_internal/matrix/select_k.cuh b/cpp/internal/raft_internal/matrix/select_k.cuh
index 59cbff9dfb..ede6382c33 100644
--- a/cpp/internal/raft_internal/matrix/select_k.cuh
+++ b/cpp/internal/raft_internal/matrix/select_k.cuh
@@ -20,7 +20,7 @@
 #include <raft/matrix/detail/select_warpsort.cuh>
 #include <raft/matrix/select_k.cuh>
 
-#ifdef RAFT_DISTANCE_COMPILED
+#ifdef RAFT_COMPILED
 #include <raft/matrix/specializations.cuh>
 #endif
 
diff --git a/cpp/internal/raft_internal/neighbors/naive_knn.cuh b/cpp/internal/raft_internal/neighbors/naive_knn.cuh
index 942c096e58..47d6f068e3 100644
--- a/cpp/internal/raft_internal/neighbors/naive_knn.cuh
+++ b/cpp/internal/raft_internal/neighbors/naive_knn.cuh
@@ -21,7 +21,7 @@
 #include <raft/spatial/knn/detail/ann_utils.cuh>
 #include <raft/util/cuda_utils.cuh>
 
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/matrix/specializations/detail/select_k.cuh>
 #endif
 
diff --git a/cpp/src/distance/cluster/cluster_cost.cuh b/cpp/src/cluster/cluster_cost.cuh
similarity index 100%
rename from cpp/src/distance/cluster/cluster_cost.cuh
rename to cpp/src/cluster/cluster_cost.cuh
diff --git a/cpp/src/distance/cluster/cluster_cost_double.cu b/cpp/src/cluster/cluster_cost_double.cu
similarity index 100%
rename from cpp/src/distance/cluster/cluster_cost_double.cu
rename to cpp/src/cluster/cluster_cost_double.cu
diff --git a/cpp/src/distance/cluster/cluster_cost_float.cu b/cpp/src/cluster/cluster_cost_float.cu
similarity index 100%
rename from cpp/src/distance/cluster/cluster_cost_float.cu
rename to cpp/src/cluster/cluster_cost_float.cu
diff --git a/cpp/src/distance/cluster/kmeans_fit_double.cu b/cpp/src/cluster/kmeans_fit_double.cu
similarity index 100%
rename from cpp/src/distance/cluster/kmeans_fit_double.cu
rename to cpp/src/cluster/kmeans_fit_double.cu
diff --git a/cpp/src/distance/cluster/kmeans_fit_float.cu b/cpp/src/cluster/kmeans_fit_float.cu
similarity index 100%
rename from cpp/src/distance/cluster/kmeans_fit_float.cu
rename to cpp/src/cluster/kmeans_fit_float.cu
diff --git a/cpp/src/distance/cluster/kmeans_init_plus_plus_double.cu b/cpp/src/cluster/kmeans_init_plus_plus_double.cu
similarity index 100%
rename from cpp/src/distance/cluster/kmeans_init_plus_plus_double.cu
rename to cpp/src/cluster/kmeans_init_plus_plus_double.cu
diff --git a/cpp/src/distance/cluster/kmeans_init_plus_plus_float.cu b/cpp/src/cluster/kmeans_init_plus_plus_float.cu
similarity index 100%
rename from cpp/src/distance/cluster/kmeans_init_plus_plus_float.cu
rename to cpp/src/cluster/kmeans_init_plus_plus_float.cu
diff --git a/cpp/src/distance/cluster/update_centroids.cuh b/cpp/src/cluster/update_centroids.cuh
similarity index 100%
rename from cpp/src/distance/cluster/update_centroids.cuh
rename to cpp/src/cluster/update_centroids.cuh
diff --git a/cpp/src/distance/cluster/update_centroids_double.cu b/cpp/src/cluster/update_centroids_double.cu
similarity index 100%
rename from cpp/src/distance/cluster/update_centroids_double.cu
rename to cpp/src/cluster/update_centroids_double.cu
diff --git a/cpp/src/distance/cluster/update_centroids_float.cu b/cpp/src/cluster/update_centroids_float.cu
similarity index 100%
rename from cpp/src/distance/cluster/update_centroids_float.cu
rename to cpp/src/cluster/update_centroids_float.cu
diff --git a/cpp/src/distance/distance/fused_l2_min_arg.cu b/cpp/src/distance/fused_l2_min_arg.cu
similarity index 100%
rename from cpp/src/distance/distance/fused_l2_min_arg.cu
rename to cpp/src/distance/fused_l2_min_arg.cu
diff --git a/cpp/src/distance/distance/pairwise_distance.cu b/cpp/src/distance/pairwise_distance.cu
similarity index 100%
rename from cpp/src/distance/distance/pairwise_distance.cu
rename to cpp/src/distance/pairwise_distance.cu
diff --git a/cpp/src/distance/distance/specializations/detail/canberra_double_double_double_int.cu b/cpp/src/distance/specializations/detail/canberra_double_double_double_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/canberra_double_double_double_int.cu
rename to cpp/src/distance/specializations/detail/canberra_double_double_double_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/canberra_float_float_float_int.cu b/cpp/src/distance/specializations/detail/canberra_float_float_float_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/canberra_float_float_float_int.cu
rename to cpp/src/distance/specializations/detail/canberra_float_float_float_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/correlation_double_double_double_int.cu b/cpp/src/distance/specializations/detail/correlation_double_double_double_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/correlation_double_double_double_int.cu
rename to cpp/src/distance/specializations/detail/correlation_double_double_double_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/correlation_float_float_float_int.cu b/cpp/src/distance/specializations/detail/correlation_float_float_float_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/correlation_float_float_float_int.cu
rename to cpp/src/distance/specializations/detail/correlation_float_float_float_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/cosine_double_double_double_int.cu b/cpp/src/distance/specializations/detail/cosine_double_double_double_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/cosine_double_double_double_int.cu
rename to cpp/src/distance/specializations/detail/cosine_double_double_double_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/cosine_float_float_float_int.cu b/cpp/src/distance/specializations/detail/cosine_float_float_float_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/cosine_float_float_float_int.cu
rename to cpp/src/distance/specializations/detail/cosine_float_float_float_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/hamming_unexpanded_double_double_double_int.cu b/cpp/src/distance/specializations/detail/hamming_unexpanded_double_double_double_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/hamming_unexpanded_double_double_double_int.cu
rename to cpp/src/distance/specializations/detail/hamming_unexpanded_double_double_double_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/hamming_unexpanded_float_float_float_int.cu b/cpp/src/distance/specializations/detail/hamming_unexpanded_float_float_float_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/hamming_unexpanded_float_float_float_int.cu
rename to cpp/src/distance/specializations/detail/hamming_unexpanded_float_float_float_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/hellinger_expanded_double_double_double_int.cu b/cpp/src/distance/specializations/detail/hellinger_expanded_double_double_double_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/hellinger_expanded_double_double_double_int.cu
rename to cpp/src/distance/specializations/detail/hellinger_expanded_double_double_double_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/hellinger_expanded_float_float_float_int.cu b/cpp/src/distance/specializations/detail/hellinger_expanded_float_float_float_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/hellinger_expanded_float_float_float_int.cu
rename to cpp/src/distance/specializations/detail/hellinger_expanded_float_float_float_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/inner_product_double_double_double_int.cu b/cpp/src/distance/specializations/detail/inner_product_double_double_double_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/inner_product_double_double_double_int.cu
rename to cpp/src/distance/specializations/detail/inner_product_double_double_double_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/inner_product_float_float_float_int.cu b/cpp/src/distance/specializations/detail/inner_product_float_float_float_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/inner_product_float_float_float_int.cu
rename to cpp/src/distance/specializations/detail/inner_product_float_float_float_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/jensen_shannon_double_double_double_int.cu b/cpp/src/distance/specializations/detail/jensen_shannon_double_double_double_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/jensen_shannon_double_double_double_int.cu
rename to cpp/src/distance/specializations/detail/jensen_shannon_double_double_double_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/jensen_shannon_float_float_float_int.cu b/cpp/src/distance/specializations/detail/jensen_shannon_float_float_float_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/jensen_shannon_float_float_float_int.cu
rename to cpp/src/distance/specializations/detail/jensen_shannon_float_float_float_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/kernels/gram_matrix_base_double.cu b/cpp/src/distance/specializations/detail/kernels/gram_matrix_base_double.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/kernels/gram_matrix_base_double.cu
rename to cpp/src/distance/specializations/detail/kernels/gram_matrix_base_double.cu
diff --git a/cpp/src/distance/distance/specializations/detail/kernels/gram_matrix_base_float.cu b/cpp/src/distance/specializations/detail/kernels/gram_matrix_base_float.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/kernels/gram_matrix_base_float.cu
rename to cpp/src/distance/specializations/detail/kernels/gram_matrix_base_float.cu
diff --git a/cpp/src/distance/distance/specializations/detail/kernels/polynomial_kernel_double_int.cu b/cpp/src/distance/specializations/detail/kernels/polynomial_kernel_double_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/kernels/polynomial_kernel_double_int.cu
rename to cpp/src/distance/specializations/detail/kernels/polynomial_kernel_double_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/kernels/polynomial_kernel_float_int.cu b/cpp/src/distance/specializations/detail/kernels/polynomial_kernel_float_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/kernels/polynomial_kernel_float_int.cu
rename to cpp/src/distance/specializations/detail/kernels/polynomial_kernel_float_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/kernels/rbf_kernel_double.cu b/cpp/src/distance/specializations/detail/kernels/rbf_kernel_double.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/kernels/rbf_kernel_double.cu
rename to cpp/src/distance/specializations/detail/kernels/rbf_kernel_double.cu
diff --git a/cpp/src/distance/distance/specializations/detail/kernels/rbf_kernel_float.cu b/cpp/src/distance/specializations/detail/kernels/rbf_kernel_float.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/kernels/rbf_kernel_float.cu
rename to cpp/src/distance/specializations/detail/kernels/rbf_kernel_float.cu
diff --git a/cpp/src/distance/distance/specializations/detail/kernels/tanh_kernel_double.cu b/cpp/src/distance/specializations/detail/kernels/tanh_kernel_double.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/kernels/tanh_kernel_double.cu
rename to cpp/src/distance/specializations/detail/kernels/tanh_kernel_double.cu
diff --git a/cpp/src/distance/distance/specializations/detail/kernels/tanh_kernel_float.cu b/cpp/src/distance/specializations/detail/kernels/tanh_kernel_float.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/kernels/tanh_kernel_float.cu
rename to cpp/src/distance/specializations/detail/kernels/tanh_kernel_float.cu
diff --git a/cpp/src/distance/distance/specializations/detail/kl_divergence_double_double_double_int.cu b/cpp/src/distance/specializations/detail/kl_divergence_double_double_double_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/kl_divergence_double_double_double_int.cu
rename to cpp/src/distance/specializations/detail/kl_divergence_double_double_double_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/kl_divergence_float_float_float_int.cu b/cpp/src/distance/specializations/detail/kl_divergence_float_float_float_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/kl_divergence_float_float_float_int.cu
rename to cpp/src/distance/specializations/detail/kl_divergence_float_float_float_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/l1_double_double_double_int.cu b/cpp/src/distance/specializations/detail/l1_double_double_double_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/l1_double_double_double_int.cu
rename to cpp/src/distance/specializations/detail/l1_double_double_double_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/l1_float_float_float_int.cu b/cpp/src/distance/specializations/detail/l1_float_float_float_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/l1_float_float_float_int.cu
rename to cpp/src/distance/specializations/detail/l1_float_float_float_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/l2_expanded_double_double_double_int.cu b/cpp/src/distance/specializations/detail/l2_expanded_double_double_double_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/l2_expanded_double_double_double_int.cu
rename to cpp/src/distance/specializations/detail/l2_expanded_double_double_double_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/l2_expanded_float_float_float_int.cu b/cpp/src/distance/specializations/detail/l2_expanded_float_float_float_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/l2_expanded_float_float_float_int.cu
rename to cpp/src/distance/specializations/detail/l2_expanded_float_float_float_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/l2_sqrt_expanded_double_double_double_int.cu b/cpp/src/distance/specializations/detail/l2_sqrt_expanded_double_double_double_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/l2_sqrt_expanded_double_double_double_int.cu
rename to cpp/src/distance/specializations/detail/l2_sqrt_expanded_double_double_double_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/l2_sqrt_expanded_float_float_float_int.cu b/cpp/src/distance/specializations/detail/l2_sqrt_expanded_float_float_float_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/l2_sqrt_expanded_float_float_float_int.cu
rename to cpp/src/distance/specializations/detail/l2_sqrt_expanded_float_float_float_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/l2_sqrt_unexpanded_double_double_double_int.cu b/cpp/src/distance/specializations/detail/l2_sqrt_unexpanded_double_double_double_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/l2_sqrt_unexpanded_double_double_double_int.cu
rename to cpp/src/distance/specializations/detail/l2_sqrt_unexpanded_double_double_double_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/l2_sqrt_unexpanded_float_float_float_int.cu b/cpp/src/distance/specializations/detail/l2_sqrt_unexpanded_float_float_float_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/l2_sqrt_unexpanded_float_float_float_int.cu
rename to cpp/src/distance/specializations/detail/l2_sqrt_unexpanded_float_float_float_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/l2_unexpanded_double_double_double_int.cu b/cpp/src/distance/specializations/detail/l2_unexpanded_double_double_double_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/l2_unexpanded_double_double_double_int.cu
rename to cpp/src/distance/specializations/detail/l2_unexpanded_double_double_double_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/l2_unexpanded_float_float_float_int.cu b/cpp/src/distance/specializations/detail/l2_unexpanded_float_float_float_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/l2_unexpanded_float_float_float_int.cu
rename to cpp/src/distance/specializations/detail/l2_unexpanded_float_float_float_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/l_inf_double_double_double_int.cu b/cpp/src/distance/specializations/detail/l_inf_double_double_double_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/l_inf_double_double_double_int.cu
rename to cpp/src/distance/specializations/detail/l_inf_double_double_double_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/l_inf_float_float_float_int.cu b/cpp/src/distance/specializations/detail/l_inf_float_float_float_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/l_inf_float_float_float_int.cu
rename to cpp/src/distance/specializations/detail/l_inf_float_float_float_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/lp_unexpanded_double_double_double_int.cu b/cpp/src/distance/specializations/detail/lp_unexpanded_double_double_double_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/lp_unexpanded_double_double_double_int.cu
rename to cpp/src/distance/specializations/detail/lp_unexpanded_double_double_double_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/lp_unexpanded_float_float_float_int.cu b/cpp/src/distance/specializations/detail/lp_unexpanded_float_float_float_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/lp_unexpanded_float_float_float_int.cu
rename to cpp/src/distance/specializations/detail/lp_unexpanded_float_float_float_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/russel_rao_double_double_double_int.cu b/cpp/src/distance/specializations/detail/russel_rao_double_double_double_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/russel_rao_double_double_double_int.cu
rename to cpp/src/distance/specializations/detail/russel_rao_double_double_double_int.cu
diff --git a/cpp/src/distance/distance/specializations/detail/russel_rao_float_float_float_int.cu b/cpp/src/distance/specializations/detail/russel_rao_float_float_float_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/detail/russel_rao_float_float_float_int.cu
rename to cpp/src/distance/specializations/detail/russel_rao_float_float_float_int.cu
diff --git a/cpp/src/distance/distance/specializations/fused_l2_nn_double_int.cu b/cpp/src/distance/specializations/fused_l2_nn_double_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/fused_l2_nn_double_int.cu
rename to cpp/src/distance/specializations/fused_l2_nn_double_int.cu
diff --git a/cpp/src/distance/distance/specializations/fused_l2_nn_double_int64.cu b/cpp/src/distance/specializations/fused_l2_nn_double_int64.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/fused_l2_nn_double_int64.cu
rename to cpp/src/distance/specializations/fused_l2_nn_double_int64.cu
diff --git a/cpp/src/distance/distance/specializations/fused_l2_nn_float_int.cu b/cpp/src/distance/specializations/fused_l2_nn_float_int.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/fused_l2_nn_float_int.cu
rename to cpp/src/distance/specializations/fused_l2_nn_float_int.cu
diff --git a/cpp/src/distance/distance/specializations/fused_l2_nn_float_int64.cu b/cpp/src/distance/specializations/fused_l2_nn_float_int64.cu
similarity index 100%
rename from cpp/src/distance/distance/specializations/fused_l2_nn_float_int64.cu
rename to cpp/src/distance/specializations/fused_l2_nn_float_int64.cu
diff --git a/cpp/src/distance/matrix/specializations/detail/select_k_float_int64_t.cu b/cpp/src/matrix/specializations/detail/select_k_float_int64_t.cu
similarity index 100%
rename from cpp/src/distance/matrix/specializations/detail/select_k_float_int64_t.cu
rename to cpp/src/matrix/specializations/detail/select_k_float_int64_t.cu
diff --git a/cpp/src/distance/matrix/specializations/detail/select_k_float_uint32_t.cu b/cpp/src/matrix/specializations/detail/select_k_float_uint32_t.cu
similarity index 100%
rename from cpp/src/distance/matrix/specializations/detail/select_k_float_uint32_t.cu
rename to cpp/src/matrix/specializations/detail/select_k_float_uint32_t.cu
diff --git a/cpp/src/distance/matrix/specializations/detail/select_k_half_int64_t.cu b/cpp/src/matrix/specializations/detail/select_k_half_int64_t.cu
similarity index 100%
rename from cpp/src/distance/matrix/specializations/detail/select_k_half_int64_t.cu
rename to cpp/src/matrix/specializations/detail/select_k_half_int64_t.cu
diff --git a/cpp/src/distance/matrix/specializations/detail/select_k_half_uint32_t.cu b/cpp/src/matrix/specializations/detail/select_k_half_uint32_t.cu
similarity index 100%
rename from cpp/src/distance/matrix/specializations/detail/select_k_half_uint32_t.cu
rename to cpp/src/matrix/specializations/detail/select_k_half_uint32_t.cu
diff --git a/cpp/src/neighbors/brute_force_knn_int64_t_float.cu b/cpp/src/neighbors/brute_force_knn_int64_t_float.cu
new file mode 100644
index 0000000000..b0411a59ce
--- /dev/null
+++ b/cpp/src/neighbors/brute_force_knn_int64_t_float.cu
@@ -0,0 +1,54 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#pragma once
+
+#include <raft/core/device_mdspan.hpp>
+#include <raft/core/device_resources.hpp>
+#include <raft/neighbors/brute_force.cuh>
+
+#include <raft/neighbors/specializations.cuh>
+
+#include <raft_runtime/neighbors/brute_force.hpp>
+
+namespace raft::runtime::neighbors::brute_force {
+
+#define RAFT_INST_BFKNN(IDX_T, DATA_T, MATRIX_IDX_T, INDEX_LAYOUT, SEARCH_LAYOUT)                 \
+  void knn(raft::device_resources const& handle,                                                  \
+           std::vector<raft::device_matrix_view<const DATA_T, MATRIX_IDX_T, INDEX_LAYOUT>> index, \
+           raft::device_matrix_view<const DATA_T, MATRIX_IDX_T, SEARCH_LAYOUT> search,            \
+           raft::device_matrix_view<IDX_T, MATRIX_IDX_T, row_major> indices,                      \
+           raft::device_matrix_view<DATA_T, MATRIX_IDX_T, row_major> distances,                   \
+           distance::DistanceType metric         = distance::DistanceType::L2Unexpanded,          \
+           std::optional<float> metric_arg       = std::make_optional<float>(2.0f),               \
+           std::optional<IDX_T> global_id_offset = std::nullopt)                                  \
+  {                                                                                               \
+    raft::neighbors::brute_force::knn(handle,                                                     \
+                                      index,                                                      \
+                                      search,                                                     \
+                                      indices,                                                    \
+                                      distances,                                                  \
+                                      static_cast<int>(indices.extent(1)),                        \
+                                      metric,                                                     \
+                                      metric_arg,                                                 \
+                                      global_id_offset);                                          \
+  }
+
+RAFT_INST_BFKNN(int64_t, float, uint32_t, raft::row_major, raft::row_major);
+
+#undef RAFT_INST_BFKNN
+
+}  // namespace raft::runtime::neighbors::brute_force
diff --git a/cpp/src/distance/neighbors/ivf_flat_build.cu b/cpp/src/neighbors/ivf_flat_build.cu
similarity index 100%
rename from cpp/src/distance/neighbors/ivf_flat_build.cu
rename to cpp/src/neighbors/ivf_flat_build.cu
diff --git a/cpp/src/distance/neighbors/ivf_flat_search.cu b/cpp/src/neighbors/ivf_flat_search.cu
similarity index 100%
rename from cpp/src/distance/neighbors/ivf_flat_search.cu
rename to cpp/src/neighbors/ivf_flat_search.cu
diff --git a/cpp/src/distance/neighbors/ivfpq_build.cu b/cpp/src/neighbors/ivfpq_build.cu
similarity index 100%
rename from cpp/src/distance/neighbors/ivfpq_build.cu
rename to cpp/src/neighbors/ivfpq_build.cu
diff --git a/cpp/src/distance/neighbors/ivfpq_deserialize.cu b/cpp/src/neighbors/ivfpq_deserialize.cu
similarity index 100%
rename from cpp/src/distance/neighbors/ivfpq_deserialize.cu
rename to cpp/src/neighbors/ivfpq_deserialize.cu
diff --git a/cpp/src/distance/neighbors/ivfpq_search_float_int64_t.cu b/cpp/src/neighbors/ivfpq_search_float_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/ivfpq_search_float_int64_t.cu
rename to cpp/src/neighbors/ivfpq_search_float_int64_t.cu
diff --git a/cpp/src/distance/neighbors/ivfpq_search_int8_t_int64_t.cu b/cpp/src/neighbors/ivfpq_search_int8_t_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/ivfpq_search_int8_t_int64_t.cu
rename to cpp/src/neighbors/ivfpq_search_int8_t_int64_t.cu
diff --git a/cpp/src/distance/neighbors/ivfpq_search_uint8_t_int64_t.cu b/cpp/src/neighbors/ivfpq_search_uint8_t_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/ivfpq_search_uint8_t_int64_t.cu
rename to cpp/src/neighbors/ivfpq_search_uint8_t_int64_t.cu
diff --git a/cpp/src/distance/neighbors/ivfpq_serialize.cu b/cpp/src/neighbors/ivfpq_serialize.cu
similarity index 100%
rename from cpp/src/distance/neighbors/ivfpq_serialize.cu
rename to cpp/src/neighbors/ivfpq_serialize.cu
diff --git a/cpp/src/distance/neighbors/refine_d_int64_t_float.cu b/cpp/src/neighbors/refine_d_int64_t_float.cu
similarity index 100%
rename from cpp/src/distance/neighbors/refine_d_int64_t_float.cu
rename to cpp/src/neighbors/refine_d_int64_t_float.cu
diff --git a/cpp/src/distance/neighbors/refine_d_int64_t_int8_t.cu b/cpp/src/neighbors/refine_d_int64_t_int8_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/refine_d_int64_t_int8_t.cu
rename to cpp/src/neighbors/refine_d_int64_t_int8_t.cu
diff --git a/cpp/src/distance/neighbors/refine_d_int64_t_uint8_t.cu b/cpp/src/neighbors/refine_d_int64_t_uint8_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/refine_d_int64_t_uint8_t.cu
rename to cpp/src/neighbors/refine_d_int64_t_uint8_t.cu
diff --git a/cpp/src/distance/neighbors/refine_h_int64_t_float.cu b/cpp/src/neighbors/refine_h_int64_t_float.cu
similarity index 100%
rename from cpp/src/distance/neighbors/refine_h_int64_t_float.cu
rename to cpp/src/neighbors/refine_h_int64_t_float.cu
diff --git a/cpp/src/distance/neighbors/refine_h_int64_t_int8_t.cu b/cpp/src/neighbors/refine_h_int64_t_int8_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/refine_h_int64_t_int8_t.cu
rename to cpp/src/neighbors/refine_h_int64_t_int8_t.cu
diff --git a/cpp/src/distance/neighbors/refine_h_int64_t_uint8_t.cu b/cpp/src/neighbors/refine_h_int64_t_uint8_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/refine_h_int64_t_uint8_t.cu
rename to cpp/src/neighbors/refine_h_int64_t_uint8_t.cu
diff --git a/cpp/src/nn/specializations/ball_cover_all_knn_query.cu b/cpp/src/neighbors/specializations/ball_cover_all_knn_query.cu
similarity index 80%
rename from cpp/src/nn/specializations/ball_cover_all_knn_query.cu
rename to cpp/src/neighbors/specializations/ball_cover_all_knn_query.cu
index d9cb836bfc..305dd6796e 100644
--- a/cpp/src/nn/specializations/ball_cover_all_knn_query.cu
+++ b/cpp/src/neighbors/specializations/ball_cover_all_knn_query.cu
@@ -16,14 +16,7 @@
 
 #include <raft/neighbors/ball_cover.cuh>
 #include <raft/neighbors/ball_cover_types.hpp>
-
-// Ignore upstream specializations to avoid unnecessary recompiling
-#ifdef RAFT_DISTANCE_COMPILED
-#include <raft/distance/specializations.cuh>
-#endif
-
-// TODO: Change this to proper specializations after FAISS is removed
-#include <raft/spatial/knn/specializations.cuh>
+#include <raft/neighbors/specializations.cuh>
 
 #include <cstdint>
 
diff --git a/cpp/src/nn/specializations/ball_cover_build_index.cu b/cpp/src/neighbors/specializations/ball_cover_build_index.cu
similarity index 81%
rename from cpp/src/nn/specializations/ball_cover_build_index.cu
rename to cpp/src/neighbors/specializations/ball_cover_build_index.cu
index 76c5a2bd5b..ec7f4bcf52 100644
--- a/cpp/src/nn/specializations/ball_cover_build_index.cu
+++ b/cpp/src/neighbors/specializations/ball_cover_build_index.cu
@@ -16,14 +16,7 @@
 
 #include <raft/neighbors/ball_cover.cuh>
 #include <raft/neighbors/ball_cover_types.hpp>
-
-// Ignore upstream specializations to avoid unnecessary recompiling
-#ifdef RAFT_DISTANCE_COMPILED
-#include <raft/distance/specializations.cuh>
-#endif
-
-// TODO: Change this to proper specializations after FAISS is removed
-#include <raft/spatial/knn/specializations.cuh>
+#include <raft/neighbors/specializations.cuh>
 
 #include <cstdint>
 
diff --git a/cpp/src/nn/specializations/ball_cover_knn_query.cu b/cpp/src/neighbors/specializations/ball_cover_knn_query.cu
similarity index 80%
rename from cpp/src/nn/specializations/ball_cover_knn_query.cu
rename to cpp/src/neighbors/specializations/ball_cover_knn_query.cu
index c01da452b2..634427200e 100644
--- a/cpp/src/nn/specializations/ball_cover_knn_query.cu
+++ b/cpp/src/neighbors/specializations/ball_cover_knn_query.cu
@@ -14,18 +14,10 @@
  * limitations under the License.
  */
 
+#include <cstdint>
 #include <raft/neighbors/ball_cover.cuh>
 #include <raft/neighbors/ball_cover_types.hpp>
-
-// Ignore upstream specializations to avoid unnecessary recompiling
-#ifdef RAFT_DISTANCE_COMPILED
-#include <raft/distance/specializations.cuh>
-#endif
-
-// TODO: Change this to proper specializations after FAISS is removed
-#include <raft/spatial/knn/specializations.cuh>
-
-#include <cstdint>
+#include <raft/neighbors/specializations.cuh>
 
 namespace raft::neighbors::ball_cover {
 template void knn_query<std::int64_t, float, std::uint32_t>(
diff --git a/cpp/src/nn/specializations/detail/ball_cover_lowdim_pass_one_2d.cu b/cpp/src/neighbors/specializations/detail/ball_cover_lowdim_pass_one_2d.cu
similarity index 91%
rename from cpp/src/nn/specializations/detail/ball_cover_lowdim_pass_one_2d.cu
rename to cpp/src/neighbors/specializations/detail/ball_cover_lowdim_pass_one_2d.cu
index 9a71ce4f9a..b69751a62a 100644
--- a/cpp/src/nn/specializations/detail/ball_cover_lowdim_pass_one_2d.cu
+++ b/cpp/src/neighbors/specializations/detail/ball_cover_lowdim_pass_one_2d.cu
@@ -15,11 +15,9 @@
  */
 
 #include <cstdint>
+#include <raft/neighbors/specializations.cuh>
 #include <raft/spatial/knn/detail/ball_cover/registers.cuh>
 
-// TODO: Change this to proper specializations after FAISS is removed
-#include <raft/spatial/knn/specializations.cuh>
-
 namespace raft {
 namespace spatial {
 namespace knn {
diff --git a/cpp/src/nn/specializations/detail/ball_cover_lowdim_pass_one_3d.cu b/cpp/src/neighbors/specializations/detail/ball_cover_lowdim_pass_one_3d.cu
similarity index 91%
rename from cpp/src/nn/specializations/detail/ball_cover_lowdim_pass_one_3d.cu
rename to cpp/src/neighbors/specializations/detail/ball_cover_lowdim_pass_one_3d.cu
index b1b3439e8f..ca44ad3165 100644
--- a/cpp/src/nn/specializations/detail/ball_cover_lowdim_pass_one_3d.cu
+++ b/cpp/src/neighbors/specializations/detail/ball_cover_lowdim_pass_one_3d.cu
@@ -15,11 +15,9 @@
  */
 
 #include <cstdint>
+#include <raft/neighbors/specializations.cuh>
 #include <raft/spatial/knn/detail/ball_cover/registers.cuh>
 
-// TODO: Change this to proper specializations after FAISS is removed
-#include <raft/spatial/knn/specializations.cuh>
-
 namespace raft {
 namespace spatial {
 namespace knn {
diff --git a/cpp/src/nn/specializations/detail/ball_cover_lowdim_pass_two_2d.cu b/cpp/src/neighbors/specializations/detail/ball_cover_lowdim_pass_two_2d.cu
similarity index 91%
rename from cpp/src/nn/specializations/detail/ball_cover_lowdim_pass_two_2d.cu
rename to cpp/src/neighbors/specializations/detail/ball_cover_lowdim_pass_two_2d.cu
index 9f512dcda1..ba44327653 100644
--- a/cpp/src/nn/specializations/detail/ball_cover_lowdim_pass_two_2d.cu
+++ b/cpp/src/neighbors/specializations/detail/ball_cover_lowdim_pass_two_2d.cu
@@ -15,11 +15,8 @@
  */
 
 #include <cstdint>
+#include <raft/neighbors/specializations.cuh>
 #include <raft/spatial/knn/detail/ball_cover/registers.cuh>
-
-// TODO: Change this to proper specializations after FAISS is removed
-#include <raft/spatial/knn/specializations.cuh>
-
 namespace raft {
 namespace spatial {
 namespace knn {
diff --git a/cpp/src/nn/specializations/detail/ball_cover_lowdim_pass_two_3d.cu b/cpp/src/neighbors/specializations/detail/ball_cover_lowdim_pass_two_3d.cu
similarity index 91%
rename from cpp/src/nn/specializations/detail/ball_cover_lowdim_pass_two_3d.cu
rename to cpp/src/neighbors/specializations/detail/ball_cover_lowdim_pass_two_3d.cu
index 0eeb448d1e..59132c1f99 100644
--- a/cpp/src/nn/specializations/detail/ball_cover_lowdim_pass_two_3d.cu
+++ b/cpp/src/neighbors/specializations/detail/ball_cover_lowdim_pass_two_3d.cu
@@ -15,11 +15,9 @@
  */
 
 #include <cstdint>
+#include <raft/neighbors/specializations.cuh>
 #include <raft/spatial/knn/detail/ball_cover/registers.cuh>
 
-// TODO: Change this to proper specializations after FAISS is removed
-#include <raft/spatial/knn/specializations.cuh>
-
 namespace raft {
 namespace spatial {
 namespace knn {
diff --git a/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_long_float_int.cu b/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_long_float_int.cu
new file mode 100644
index 0000000000..07810aa576
--- /dev/null
+++ b/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_long_float_int.cu
@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include <raft/neighbors/brute_force.cuh>
+#include <raft/neighbors/specializations.cuh>
+
+namespace raft::neighbors::detail {
+#define RAFT_INST(IdxT, T, IntT)                                                          \
+  template void brute_force_knn_impl<IntT, IdxT, T>(raft::device_resources const& handle, \
+                                                    std::vector<T*>& input,               \
+                                                    std::vector<IntT>& sizes,             \
+                                                    IntT D,                               \
+                                                    T* search_items,                      \
+                                                    IntT n,                               \
+                                                    IdxT* res_I,                          \
+                                                    T* res_D,                             \
+                                                    IntT k,                               \
+                                                    bool rowMajorIndex,                   \
+                                                    bool rowMajorQuery,                   \
+                                                    std::vector<IdxT>* translations,      \
+                                                    raft::distance::DistanceType metric,  \
+                                                    float metricArg);
+RAFT_INST(long, float, int);
+#undef RAFT_INST
+}  // namespace raft::neighbors::detail
diff --git a/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_long_float_uint.cu b/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_long_float_uint.cu
new file mode 100644
index 0000000000..0cb873b40a
--- /dev/null
+++ b/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_long_float_uint.cu
@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include <raft/neighbors/brute_force.cuh>
+#include <raft/neighbors/specializations.cuh>
+
+namespace raft::neighbors::detail {
+#define RAFT_INST(IdxT, T, IntT)                                                          \
+  template void brute_force_knn_impl<IntT, IdxT, T>(raft::device_resources const& handle, \
+                                                    std::vector<T*>& input,               \
+                                                    std::vector<IntT>& sizes,             \
+                                                    IntT D,                               \
+                                                    T* search_items,                      \
+                                                    IntT n,                               \
+                                                    IdxT* res_I,                          \
+                                                    T* res_D,                             \
+                                                    IntT k,                               \
+                                                    bool rowMajorIndex,                   \
+                                                    bool rowMajorQuery,                   \
+                                                    std::vector<IdxT>* translations,      \
+                                                    raft::distance::DistanceType metric,  \
+                                                    float metricArg);
+RAFT_INST(long, float, unsigned int);
+#undef RAFT_INST
+}  // namespace raft::neighbors::detail
diff --git a/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_uint_float_int.cu b/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_uint_float_int.cu
new file mode 100644
index 0000000000..f8a69b896f
--- /dev/null
+++ b/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_uint_float_int.cu
@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include <raft/neighbors/brute_force.cuh>
+#include <raft/neighbors/specializations.cuh>
+
+namespace raft::neighbors::detail {
+#define RAFT_INST(IdxT, T, IntT)                                                          \
+  template void brute_force_knn_impl<IntT, IdxT, T>(raft::device_resources const& handle, \
+                                                    std::vector<T*>& input,               \
+                                                    std::vector<IntT>& sizes,             \
+                                                    IntT D,                               \
+                                                    T* search_items,                      \
+                                                    IntT n,                               \
+                                                    IdxT* res_I,                          \
+                                                    T* res_D,                             \
+                                                    IntT k,                               \
+                                                    bool rowMajorIndex,                   \
+                                                    bool rowMajorQuery,                   \
+                                                    std::vector<IdxT>* translations,      \
+                                                    raft::distance::DistanceType metric,  \
+                                                    float metricArg);
+RAFT_INST(uint32_t, float, int);
+#undef RAFT_INST
+}  // namespace raft::neighbors::detail
diff --git a/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_uint_float_uint.cu b/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_uint_float_uint.cu
new file mode 100644
index 0000000000..3c23d1f3e0
--- /dev/null
+++ b/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_uint_float_uint.cu
@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include <raft/neighbors/brute_force.cuh>
+#include <raft/neighbors/specializations.cuh>
+
+namespace raft::neighbors::detail {
+#define RAFT_INST(IdxT, T, IntT)                                                          \
+  template void brute_force_knn_impl<IntT, IdxT, T>(raft::device_resources const& handle, \
+                                                    std::vector<T*>& input,               \
+                                                    std::vector<IntT>& sizes,             \
+                                                    IntT D,                               \
+                                                    T* search_items,                      \
+                                                    IntT n,                               \
+                                                    IdxT* res_I,                          \
+                                                    T* res_D,                             \
+                                                    IntT k,                               \
+                                                    bool rowMajorIndex,                   \
+                                                    bool rowMajorQuery,                   \
+                                                    std::vector<IdxT>* translations,      \
+                                                    raft::distance::DistanceType metric,  \
+                                                    float metricArg);
+RAFT_INST(uint32_t, float, unsigned int);
+#undef RAFT_INST
+}  // namespace raft::neighbors::detail
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_float_fast.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_float_float_fast.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_float_fast.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_float_float_fast.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_float_no_basediff.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_float_float_no_basediff.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_float_no_basediff.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_float_float_no_basediff.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_float_no_smem_lut.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_float_float_no_smem_lut.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_float_no_smem_lut.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_float_float_no_smem_lut.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_fp8s_fast.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_float_fp8s_fast.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_fp8s_fast.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_float_fp8s_fast.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_fp8s_no_basediff.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_float_fp8s_no_basediff.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_fp8s_no_basediff.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_float_fp8s_no_basediff.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_fp8s_no_smem_lut.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_float_fp8s_no_smem_lut.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_fp8s_no_smem_lut.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_float_fp8s_no_smem_lut.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_fp8u_fast.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_float_fp8u_fast.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_fp8u_fast.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_float_fp8u_fast.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_fp8u_no_basediff.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_float_fp8u_no_basediff.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_fp8u_no_basediff.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_float_fp8u_no_basediff.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_fp8u_no_smem_lut.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_float_fp8u_no_smem_lut.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_fp8u_no_smem_lut.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_float_fp8u_no_smem_lut.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_half_fast.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_float_half_fast.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_half_fast.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_float_half_fast.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_half_no_basediff.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_float_half_no_basediff.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_half_no_basediff.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_float_half_no_basediff.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_half_no_smem_lut.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_float_half_no_smem_lut.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_float_half_no_smem_lut.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_float_half_no_smem_lut.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_half_fp8s_fast.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_half_fp8s_fast.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_half_fp8s_fast.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_half_fp8s_fast.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_half_fp8s_no_basediff.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_half_fp8s_no_basediff.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_half_fp8s_no_basediff.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_half_fp8s_no_basediff.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_half_fp8s_no_smem_lut.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_half_fp8s_no_smem_lut.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_half_fp8s_no_smem_lut.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_half_fp8s_no_smem_lut.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_half_fp8u_fast.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_half_fp8u_fast.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_half_fp8u_fast.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_half_fp8u_fast.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_half_fp8u_no_basediff.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_half_fp8u_no_basediff.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_half_fp8u_no_basediff.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_half_fp8u_no_basediff.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_half_fp8u_no_smem_lut.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_half_fp8u_no_smem_lut.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_half_fp8u_no_smem_lut.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_half_fp8u_no_smem_lut.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_half_half_fast.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_half_half_fast.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_half_half_fast.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_half_half_fast.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_half_half_no_basediff.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_half_half_no_basediff.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_half_half_no_basediff.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_half_half_no_basediff.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/compute_similarity_half_half_no_smem_lut.cu b/cpp/src/neighbors/specializations/detail/compute_similarity_half_half_no_smem_lut.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/compute_similarity_half_half_no_smem_lut.cu
rename to cpp/src/neighbors/specializations/detail/compute_similarity_half_half_no_smem_lut.cu
diff --git a/cpp/src/distance/neighbors/specializations/detail/ivfpq_compute_similarity_float_half_no_smem_lut.cu b/cpp/src/neighbors/specializations/detail/ivfpq_compute_similarity_float_half_no_smem_lut.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/detail/ivfpq_compute_similarity_float_half_no_smem_lut.cu
rename to cpp/src/neighbors/specializations/detail/ivfpq_compute_similarity_float_half_no_smem_lut.cu
diff --git a/cpp/src/nn/specializations/fused_l2_knn_int_float_false.cu b/cpp/src/neighbors/specializations/fused_l2_knn_int_float_false.cu
similarity index 93%
rename from cpp/src/nn/specializations/fused_l2_knn_int_float_false.cu
rename to cpp/src/neighbors/specializations/fused_l2_knn_int_float_false.cu
index 41cf409416..72fdac9526 100644
--- a/cpp/src/nn/specializations/fused_l2_knn_int_float_false.cu
+++ b/cpp/src/neighbors/specializations/fused_l2_knn_int_float_false.cu
@@ -15,11 +15,9 @@
  */
 
 #include <cstdint>
+#include <raft/neighbors/specializations.cuh>
 #include <raft/spatial/knn/detail/fused_l2_knn.cuh>
 
-// TODO: Change this to proper specializations after FAISS is removed
-#include <raft/spatial/knn/specializations.cuh>
-
 namespace raft {
 namespace spatial {
 namespace knn {
diff --git a/cpp/src/nn/specializations/fused_l2_knn_int_float_true.cu b/cpp/src/neighbors/specializations/fused_l2_knn_int_float_true.cu
similarity index 93%
rename from cpp/src/nn/specializations/fused_l2_knn_int_float_true.cu
rename to cpp/src/neighbors/specializations/fused_l2_knn_int_float_true.cu
index 7d183d7220..c7616462fe 100644
--- a/cpp/src/nn/specializations/fused_l2_knn_int_float_true.cu
+++ b/cpp/src/neighbors/specializations/fused_l2_knn_int_float_true.cu
@@ -15,11 +15,9 @@
  */
 
 #include <cstdint>
+#include <raft/neighbors/specializations.cuh>
 #include <raft/spatial/knn/detail/fused_l2_knn.cuh>
 
-// TODO: Change this to proper specializations after FAISS is removed
-#include <raft/spatial/knn/specializations.cuh>
-
 namespace raft {
 namespace spatial {
 namespace knn {
diff --git a/cpp/src/nn/specializations/fused_l2_knn_long_float_false.cu b/cpp/src/neighbors/specializations/fused_l2_knn_long_float_false.cu
similarity index 93%
rename from cpp/src/nn/specializations/fused_l2_knn_long_float_false.cu
rename to cpp/src/neighbors/specializations/fused_l2_knn_long_float_false.cu
index fa273986dc..16bf058238 100644
--- a/cpp/src/nn/specializations/fused_l2_knn_long_float_false.cu
+++ b/cpp/src/neighbors/specializations/fused_l2_knn_long_float_false.cu
@@ -15,11 +15,9 @@
  */
 
 #include <cstdint>
+#include <raft/neighbors/specializations.cuh>
 #include <raft/spatial/knn/detail/fused_l2_knn.cuh>
 
-// TODO: Change this to proper specializations after FAISS is removed
-#include <raft/spatial/knn/specializations.cuh>
-
 namespace raft {
 namespace spatial {
 namespace knn {
diff --git a/cpp/src/nn/specializations/fused_l2_knn_long_float_true.cu b/cpp/src/neighbors/specializations/fused_l2_knn_long_float_true.cu
similarity index 93%
rename from cpp/src/nn/specializations/fused_l2_knn_long_float_true.cu
rename to cpp/src/neighbors/specializations/fused_l2_knn_long_float_true.cu
index 5313a87786..06cf55eae3 100644
--- a/cpp/src/nn/specializations/fused_l2_knn_long_float_true.cu
+++ b/cpp/src/neighbors/specializations/fused_l2_knn_long_float_true.cu
@@ -15,11 +15,9 @@
  */
 
 #include <cstdint>
+#include <raft/neighbors/specializations.cuh>
 #include <raft/spatial/knn/detail/fused_l2_knn.cuh>
 
-// TODO: Change this to proper specializations after FAISS is removed
-#include <raft/spatial/knn/specializations.cuh>
-
 namespace raft {
 namespace spatial {
 namespace knn {
diff --git a/cpp/src/distance/neighbors/specializations/ivfflat_build_float_int64_t.cu b/cpp/src/neighbors/specializations/ivfflat_build_float_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/ivfflat_build_float_int64_t.cu
rename to cpp/src/neighbors/specializations/ivfflat_build_float_int64_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/ivfflat_build_int8_t_int64_t.cu b/cpp/src/neighbors/specializations/ivfflat_build_int8_t_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/ivfflat_build_int8_t_int64_t.cu
rename to cpp/src/neighbors/specializations/ivfflat_build_int8_t_int64_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/ivfflat_build_uint8_t_int64_t.cu b/cpp/src/neighbors/specializations/ivfflat_build_uint8_t_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/ivfflat_build_uint8_t_int64_t.cu
rename to cpp/src/neighbors/specializations/ivfflat_build_uint8_t_int64_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/ivfflat_extend_float_int64_t.cu b/cpp/src/neighbors/specializations/ivfflat_extend_float_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/ivfflat_extend_float_int64_t.cu
rename to cpp/src/neighbors/specializations/ivfflat_extend_float_int64_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/ivfflat_extend_int8_t_int64_t.cu b/cpp/src/neighbors/specializations/ivfflat_extend_int8_t_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/ivfflat_extend_int8_t_int64_t.cu
rename to cpp/src/neighbors/specializations/ivfflat_extend_int8_t_int64_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/ivfflat_extend_uint8_t_int64_t.cu b/cpp/src/neighbors/specializations/ivfflat_extend_uint8_t_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/ivfflat_extend_uint8_t_int64_t.cu
rename to cpp/src/neighbors/specializations/ivfflat_extend_uint8_t_int64_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/ivfflat_search_float_int64_t.cu b/cpp/src/neighbors/specializations/ivfflat_search_float_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/ivfflat_search_float_int64_t.cu
rename to cpp/src/neighbors/specializations/ivfflat_search_float_int64_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/ivfflat_search_int8_t_int64_t.cu b/cpp/src/neighbors/specializations/ivfflat_search_int8_t_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/ivfflat_search_int8_t_int64_t.cu
rename to cpp/src/neighbors/specializations/ivfflat_search_int8_t_int64_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/ivfflat_search_uint8_t_int64_t.cu b/cpp/src/neighbors/specializations/ivfflat_search_uint8_t_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/ivfflat_search_uint8_t_int64_t.cu
rename to cpp/src/neighbors/specializations/ivfflat_search_uint8_t_int64_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/ivfpq_build_float_int64_t.cu b/cpp/src/neighbors/specializations/ivfpq_build_float_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/ivfpq_build_float_int64_t.cu
rename to cpp/src/neighbors/specializations/ivfpq_build_float_int64_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/ivfpq_build_int8_t_int64_t.cu b/cpp/src/neighbors/specializations/ivfpq_build_int8_t_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/ivfpq_build_int8_t_int64_t.cu
rename to cpp/src/neighbors/specializations/ivfpq_build_int8_t_int64_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/ivfpq_build_uint8_t_int64_t.cu b/cpp/src/neighbors/specializations/ivfpq_build_uint8_t_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/ivfpq_build_uint8_t_int64_t.cu
rename to cpp/src/neighbors/specializations/ivfpq_build_uint8_t_int64_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/ivfpq_extend_float_int64_t.cu b/cpp/src/neighbors/specializations/ivfpq_extend_float_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/ivfpq_extend_float_int64_t.cu
rename to cpp/src/neighbors/specializations/ivfpq_extend_float_int64_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/ivfpq_extend_int8_t_int64_t.cu b/cpp/src/neighbors/specializations/ivfpq_extend_int8_t_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/ivfpq_extend_int8_t_int64_t.cu
rename to cpp/src/neighbors/specializations/ivfpq_extend_int8_t_int64_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/ivfpq_extend_uint8_t_int64_t.cu b/cpp/src/neighbors/specializations/ivfpq_extend_uint8_t_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/ivfpq_extend_uint8_t_int64_t.cu
rename to cpp/src/neighbors/specializations/ivfpq_extend_uint8_t_int64_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/ivfpq_search_float_int64_t.cu b/cpp/src/neighbors/specializations/ivfpq_search_float_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/ivfpq_search_float_int64_t.cu
rename to cpp/src/neighbors/specializations/ivfpq_search_float_int64_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/ivfpq_search_int8_t_int64_t.cu b/cpp/src/neighbors/specializations/ivfpq_search_int8_t_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/ivfpq_search_int8_t_int64_t.cu
rename to cpp/src/neighbors/specializations/ivfpq_search_int8_t_int64_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/ivfpq_search_uint8_t_int64_t.cu b/cpp/src/neighbors/specializations/ivfpq_search_uint8_t_int64_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/ivfpq_search_uint8_t_int64_t.cu
rename to cpp/src/neighbors/specializations/ivfpq_search_uint8_t_int64_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/refine_d_int64_t_float.cu b/cpp/src/neighbors/specializations/refine_d_int64_t_float.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/refine_d_int64_t_float.cu
rename to cpp/src/neighbors/specializations/refine_d_int64_t_float.cu
diff --git a/cpp/src/distance/neighbors/specializations/refine_d_int64_t_int8_t.cu b/cpp/src/neighbors/specializations/refine_d_int64_t_int8_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/refine_d_int64_t_int8_t.cu
rename to cpp/src/neighbors/specializations/refine_d_int64_t_int8_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/refine_d_int64_t_uint8_t.cu b/cpp/src/neighbors/specializations/refine_d_int64_t_uint8_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/refine_d_int64_t_uint8_t.cu
rename to cpp/src/neighbors/specializations/refine_d_int64_t_uint8_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/refine_h_int64_t_float.cu b/cpp/src/neighbors/specializations/refine_h_int64_t_float.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/refine_h_int64_t_float.cu
rename to cpp/src/neighbors/specializations/refine_h_int64_t_float.cu
diff --git a/cpp/src/distance/neighbors/specializations/refine_h_int64_t_int8_t.cu b/cpp/src/neighbors/specializations/refine_h_int64_t_int8_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/refine_h_int64_t_int8_t.cu
rename to cpp/src/neighbors/specializations/refine_h_int64_t_int8_t.cu
diff --git a/cpp/src/distance/neighbors/specializations/refine_h_int64_t_uint8_t.cu b/cpp/src/neighbors/specializations/refine_h_int64_t_uint8_t.cu
similarity index 100%
rename from cpp/src/distance/neighbors/specializations/refine_h_int64_t_uint8_t.cu
rename to cpp/src/neighbors/specializations/refine_h_int64_t_uint8_t.cu
diff --git a/cpp/src/distance/random/common.cuh b/cpp/src/random/common.cuh
similarity index 100%
rename from cpp/src/distance/random/common.cuh
rename to cpp/src/random/common.cuh
diff --git a/cpp/src/distance/random/rmat_rectangular_generator_int64_double.cu b/cpp/src/random/rmat_rectangular_generator_int64_double.cu
similarity index 93%
rename from cpp/src/distance/random/rmat_rectangular_generator_int64_double.cu
rename to cpp/src/random/rmat_rectangular_generator_int64_double.cu
index 1b8fb8bd6d..657aa0533c 100644
--- a/cpp/src/distance/random/rmat_rectangular_generator_int64_double.cu
+++ b/cpp/src/random/rmat_rectangular_generator_int64_double.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/src/distance/random/rmat_rectangular_generator_int64_float.cu b/cpp/src/random/rmat_rectangular_generator_int64_float.cu
similarity index 93%
rename from cpp/src/distance/random/rmat_rectangular_generator_int64_float.cu
rename to cpp/src/random/rmat_rectangular_generator_int64_float.cu
index 249e8c2ffb..9cd748da89 100644
--- a/cpp/src/distance/random/rmat_rectangular_generator_int64_float.cu
+++ b/cpp/src/random/rmat_rectangular_generator_int64_float.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/src/distance/random/rmat_rectangular_generator_int_double.cu b/cpp/src/random/rmat_rectangular_generator_int_double.cu
similarity index 93%
rename from cpp/src/distance/random/rmat_rectangular_generator_int_double.cu
rename to cpp/src/random/rmat_rectangular_generator_int_double.cu
index 3333b87983..1f10dbc03c 100644
--- a/cpp/src/distance/random/rmat_rectangular_generator_int_double.cu
+++ b/cpp/src/random/rmat_rectangular_generator_int_double.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/src/distance/random/rmat_rectangular_generator_int_float.cu b/cpp/src/random/rmat_rectangular_generator_int_float.cu
similarity index 93%
rename from cpp/src/distance/random/rmat_rectangular_generator_int_float.cu
rename to cpp/src/random/rmat_rectangular_generator_int_float.cu
index db8d024c04..fecc134326 100644
--- a/cpp/src/distance/random/rmat_rectangular_generator_int_float.cu
+++ b/cpp/src/random/rmat_rectangular_generator_int_float.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/test/CMakeLists.txt b/cpp/test/CMakeLists.txt
index 696a271c65..a778b0d195 100644
--- a/cpp/test/CMakeLists.txt
+++ b/cpp/test/CMakeLists.txt
@@ -17,7 +17,7 @@
 
 function(ConfigureTest)
 
-  set(options OPTIONAL DIST NN)
+  set(options OPTIONAL LIB)
   set(oneValueArgs NAME)
   set(multiValueArgs PATH TARGETS CONFIGURATIONS)
 
@@ -33,8 +33,7 @@ function(ConfigureTest)
     ${TEST_NAME}
     PRIVATE raft::raft
             raft_internal
-            $<$<BOOL:${ConfigureTest_DIST}>:raft::distance>
-            $<$<BOOL:${ConfigureTest_NN}>:raft::nn>
+            $<$<BOOL:${ConfigureTest_LIB}>:raft::compiled>
             GTest::gtest
             GTest::gtest_main
             Threads::Threads
@@ -87,8 +86,7 @@ if(BUILD_TESTS)
     test/cluster/linkage.cu
     test/cluster/kmeans_find_k.cu
     OPTIONAL
-    DIST
-    NN
+    LIB
   )
 
   ConfigureTest(
@@ -140,7 +138,7 @@ if(BUILD_TESTS)
     test/distance/fused_l2_nn.cu
     test/distance/gram.cu
     OPTIONAL
-    DIST
+    LIB
   )
 
   ConfigureTest(NAME LABEL_TEST PATH test/label/label.cu test/label/merge_labels.cu)
@@ -201,7 +199,7 @@ if(BUILD_TESTS)
     test/matrix/triangular.cu
     test/sparse/spectral_matrix.cu
     OPTIONAL
-    DIST
+    LIB
   )
 
   ConfigureTest(
@@ -221,7 +219,7 @@ if(BUILD_TESTS)
 
   ConfigureTest(
     NAME SOLVERS_TEST PATH test/cluster/cluster_solvers_deprecated.cu test/linalg/eigen_solvers.cu
-    test/lap/lap.cu test/sparse/mst.cu OPTIONAL DIST
+    test/lap/lap.cu test/sparse/mst.cu OPTIONAL LIB
   )
 
   ConfigureTest(
@@ -245,13 +243,12 @@ if(BUILD_TESTS)
   )
 
   ConfigureTest(
-    NAME SPARSE_DIST_TEST PATH test/sparse/dist_coo_spmv.cu test/sparse/distance.cu OPTIONAL DIST
-    NN
+    NAME SPARSE_DIST_TEST PATH test/sparse/dist_coo_spmv.cu test/sparse/distance.cu OPTIONAL LIB
   )
 
   ConfigureTest(
     NAME SPARSE_NEIGHBORS_TEST PATH test/sparse/neighbors/connect_components.cu
-    test/sparse/neighbors/brute_force.cu test/sparse/neighbors/knn_graph.cu OPTIONAL DIST NN
+    test/sparse/neighbors/brute_force.cu test/sparse/neighbors/knn_graph.cu OPTIONAL LIB
   )
 
   ConfigureTest(
@@ -275,8 +272,7 @@ if(BUILD_TESTS)
     test/neighbors/refine.cu
     test/neighbors/selection.cu
     OPTIONAL
-    DIST
-    NN
+    LIB
   )
 
   ConfigureTest(
@@ -309,8 +305,7 @@ if(BUILD_TESTS)
     test/stats/weighted_mean.cu
     test/stats/v_measure.cu
     OPTIONAL
-    DIST
-    NN
+    LIB
   )
 
   ConfigureTest(
diff --git a/cpp/test/cluster/cluster_solvers.cu b/cpp/test/cluster/cluster_solvers.cu
index 5121cdf139..f26c598a2b 100644
--- a/cpp/test/cluster/cluster_solvers.cu
+++ b/cpp/test/cluster/cluster_solvers.cu
@@ -19,7 +19,7 @@
 #include <memory>
 #include <raft/core/device_resources.hpp>
 
-#if defined RAFT_DISTANCE_COMPILED && defined RAFT_NN_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/spectral/specializations.cuh>
 #endif
 
diff --git a/cpp/test/cluster/kmeans.cu b/cpp/test/cluster/kmeans.cu
index 3e2153dcde..cfec84256b 100644
--- a/cpp/test/cluster/kmeans.cu
+++ b/cpp/test/cluster/kmeans.cu
@@ -29,7 +29,7 @@
 #include <rmm/device_uvector.hpp>
 #include <thrust/fill.h>
 
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/cluster/specializations.cuh>
 #endif
 
diff --git a/cpp/test/cluster/kmeans_balanced.cu b/cpp/test/cluster/kmeans_balanced.cu
index ae06572061..220eba4186 100644
--- a/cpp/test/cluster/kmeans_balanced.cu
+++ b/cpp/test/cluster/kmeans_balanced.cu
@@ -30,7 +30,7 @@
 #include <rmm/device_uvector.hpp>
 #include <thrust/fill.h>
 
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/cluster/specializations.cuh>
 #endif
 
diff --git a/cpp/test/cluster/kmeans_find_k.cu b/cpp/test/cluster/kmeans_find_k.cu
index e80cbaa93b..a865651f56 100644
--- a/cpp/test/cluster/kmeans_find_k.cu
+++ b/cpp/test/cluster/kmeans_find_k.cu
@@ -25,7 +25,7 @@
 #include <raft/random/make_blobs.cuh>
 #include <raft/util/cuda_utils.cuh>
 
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/cluster/specializations.cuh>
 #endif
 
diff --git a/cpp/test/cluster/linkage.cu b/cpp/test/cluster/linkage.cu
index 20f2952e7d..4946d52f26 100644
--- a/cpp/test/cluster/linkage.cu
+++ b/cpp/test/cluster/linkage.cu
@@ -20,8 +20,8 @@
 #include <raft/linalg/transpose.cuh>
 #include <raft/sparse/coo.hpp>
 
-#if defined RAFT_NN_COMPILED
-#include <raft/spatial/knn/specializations.cuh>
+#if defined RAFT_COMPILED
+#include <raft/neighbors/specializations.cuh>
 #endif
 
 #include <raft/core/device_mdspan.hpp>
diff --git a/cpp/test/distance/distance_base.cuh b/cpp/test/distance/distance_base.cuh
index 5fcaf07539..0e084f2ad8 100644
--- a/cpp/test/distance/distance_base.cuh
+++ b/cpp/test/distance/distance_base.cuh
@@ -22,7 +22,7 @@
 #include <raft/distance/distance.cuh>
 #include <raft/util/cuda_utils.cuh>
 #include <raft/util/cudart_utils.hpp>
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/distance/specializations.cuh>
 #endif
 #include <raft/random/rng.cuh>
diff --git a/cpp/test/distance/fused_l2_nn.cu b/cpp/test/distance/fused_l2_nn.cu
index af67214193..4a74d7f16a 100644
--- a/cpp/test/distance/fused_l2_nn.cu
+++ b/cpp/test/distance/fused_l2_nn.cu
@@ -24,7 +24,7 @@
 #include <raft/util/cuda_utils.cuh>
 #include <raft/util/cudart_utils.hpp>
 
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/distance/specializations.cuh>
 #endif
 
diff --git a/cpp/test/distance/gram.cu b/cpp/test/distance/gram.cu
index a2f0e2385c..f99d02dc7f 100644
--- a/cpp/test/distance/gram.cu
+++ b/cpp/test/distance/gram.cu
@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/distance/specializations.cuh>
 #endif
 
diff --git a/cpp/test/distance/masked_nn.cu b/cpp/test/distance/masked_nn.cu
index 6f7d8bf44a..d01911206b 100644
--- a/cpp/test/distance/masked_nn.cu
+++ b/cpp/test/distance/masked_nn.cu
@@ -28,7 +28,7 @@
 #include <raft/util/cudart_utils.hpp>
 #include <raft/util/itertools.hpp>
 
-#ifdef RAFT_DISTANCE_COMPILED
+#ifdef RAFT_COMPILED
 #include <raft/distance/specializations.cuh>
 #endif
 
diff --git a/cpp/test/matrix/select_k.cu b/cpp/test/matrix/select_k.cu
index a9fc4c8f40..392464eb27 100644
--- a/cpp/test/matrix/select_k.cu
+++ b/cpp/test/matrix/select_k.cu
@@ -18,7 +18,7 @@
 
 #include <raft_internal/matrix/select_k.cuh>
 
-#ifdef RAFT_DISTANCE_COMPILED
+#ifdef RAFT_COMPILED
 #include <raft/matrix/specializations.cuh>
 #endif
 
diff --git a/cpp/test/neighbors/ann_ivf_flat.cuh b/cpp/test/neighbors/ann_ivf_flat.cuh
index 486ff61724..fe6f9163a0 100644
--- a/cpp/test/neighbors/ann_ivf_flat.cuh
+++ b/cpp/test/neighbors/ann_ivf_flat.cuh
@@ -36,7 +36,7 @@
 
 #include <thrust/sequence.h>
 
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/neighbors/specializations.cuh>
 #endif
 
diff --git a/cpp/test/neighbors/ann_ivf_flat/test_float_int64_t.cu b/cpp/test/neighbors/ann_ivf_flat/test_float_int64_t.cu
index cee0d03c99..e430af89df 100644
--- a/cpp/test/neighbors/ann_ivf_flat/test_float_int64_t.cu
+++ b/cpp/test/neighbors/ann_ivf_flat/test_float_int64_t.cu
@@ -18,7 +18,7 @@
 
 #include "../ann_ivf_flat.cuh"
 
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/neighbors/specializations.cuh>
 #endif
 
diff --git a/cpp/test/neighbors/ann_ivf_flat/test_int8_t_int64_t.cu b/cpp/test/neighbors/ann_ivf_flat/test_int8_t_int64_t.cu
index 95876f9165..e4e7a207fb 100644
--- a/cpp/test/neighbors/ann_ivf_flat/test_int8_t_int64_t.cu
+++ b/cpp/test/neighbors/ann_ivf_flat/test_int8_t_int64_t.cu
@@ -18,7 +18,7 @@
 
 #include "../ann_ivf_flat.cuh"
 
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/neighbors/specializations.cuh>
 #endif
 
diff --git a/cpp/test/neighbors/ann_ivf_flat/test_uint8_t_int64_t.cu b/cpp/test/neighbors/ann_ivf_flat/test_uint8_t_int64_t.cu
index ebee20c2b6..ef7980401a 100644
--- a/cpp/test/neighbors/ann_ivf_flat/test_uint8_t_int64_t.cu
+++ b/cpp/test/neighbors/ann_ivf_flat/test_uint8_t_int64_t.cu
@@ -18,7 +18,7 @@
 
 #include "../ann_ivf_flat.cuh"
 
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/neighbors/specializations.cuh>
 #endif
 
diff --git a/cpp/test/neighbors/ann_ivf_pq.cuh b/cpp/test/neighbors/ann_ivf_pq.cuh
index c368192b03..c331081314 100644
--- a/cpp/test/neighbors/ann_ivf_pq.cuh
+++ b/cpp/test/neighbors/ann_ivf_pq.cuh
@@ -24,7 +24,7 @@
 #include <raft/distance/distance_types.hpp>
 #include <raft/neighbors/ivf_pq.cuh>
 #include <raft/random/rng.cuh>
-#ifdef RAFT_DISTANCE_COMPILED
+#ifdef RAFT_COMPILED
 #include <raft/neighbors/specializations.cuh>
 #else
 #pragma message("NN specializations are not enabled; expect very long building times.")
diff --git a/cpp/test/neighbors/ball_cover.cu b/cpp/test/neighbors/ball_cover.cu
index 6dcae8e34d..9b51d585de 100644
--- a/cpp/test/neighbors/ball_cover.cu
+++ b/cpp/test/neighbors/ball_cover.cu
@@ -22,8 +22,9 @@
 #include <raft/neighbors/brute_force.cuh>
 #include <raft/random/make_blobs.cuh>
 #include <raft/util/cudart_utils.hpp>
-#if defined RAFT_NN_COMPILED
-#include <raft/spatial/knn/specializations.cuh>
+
+#ifdef RAFT_COMPILED
+#include <raft/neighbors/specializations.cuh>
 #endif
 
 #include <rmm/device_uvector.hpp>
diff --git a/cpp/test/neighbors/epsilon_neighborhood.cu b/cpp/test/neighbors/epsilon_neighborhood.cu
index 977e8f3ce8..769cb7ec2d 100644
--- a/cpp/test/neighbors/epsilon_neighborhood.cu
+++ b/cpp/test/neighbors/epsilon_neighborhood.cu
@@ -23,7 +23,7 @@
 #include <raft/util/cudart_utils.hpp>
 #include <rmm/device_uvector.hpp>
 
-#ifdef RAFT_DISTANCE_COMPILED
+#ifdef RAFT_COMPILED
 #include <raft/neighbors/specializations.cuh>
 #endif
 
diff --git a/cpp/test/neighbors/fused_l2_knn.cu b/cpp/test/neighbors/fused_l2_knn.cu
index a5fead8093..ab05b41cc9 100644
--- a/cpp/test/neighbors/fused_l2_knn.cu
+++ b/cpp/test/neighbors/fused_l2_knn.cu
@@ -23,12 +23,8 @@
 #include <raft/random/rng.cuh>
 #include <raft/spatial/knn/knn.cuh>
 
-#if defined RAFT_NN_COMPILED
-#include <raft/spatial/knn/specializations.cuh>
-#endif
-
-#ifdef RAFT_DISTANCE_COMPILED
-#include <raft/distance/specializations.cuh>
+#ifdef RAFT_COMPILED
+#include <raft/neighbors/specializations.cuh>
 #endif
 
 #include <raft/distance/distance.cuh>
diff --git a/cpp/test/neighbors/knn.cu b/cpp/test/neighbors/knn.cu
index 7976725c65..4bb977432c 100644
--- a/cpp/test/neighbors/knn.cu
+++ b/cpp/test/neighbors/knn.cu
@@ -21,14 +21,10 @@
 #include <raft/distance/distance_types.hpp>
 #include <raft/neighbors/brute_force.cuh>
 
-#if defined RAFT_DISTANCE_COMPILED
+#ifdef RAFT_COMPILED
 #include <raft/neighbors/specializations.cuh>
 #endif
 
-#if defined RAFT_NN_COMPILED
-#include <raft/spatial/knn/specializations.cuh>
-#endif
-
 #include <rmm/device_buffer.hpp>
 
 #include <gtest/gtest.h>
diff --git a/cpp/test/neighbors/refine.cu b/cpp/test/neighbors/refine.cu
index 8866c404a9..dd3491673e 100644
--- a/cpp/test/neighbors/refine.cu
+++ b/cpp/test/neighbors/refine.cu
@@ -31,7 +31,7 @@
 
 #include <gtest/gtest.h>
 
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/neighbors/specializations.cuh>
 #endif
 
diff --git a/cpp/test/neighbors/selection.cu b/cpp/test/neighbors/selection.cu
index 25939f65c3..9f13de357c 100644
--- a/cpp/test/neighbors/selection.cu
+++ b/cpp/test/neighbors/selection.cu
@@ -24,7 +24,7 @@
 
 #include <raft/sparse/detail/utils.h>
 #include <raft/spatial/knn/knn.cuh>
-#if defined RAFT_DISTANCE_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/neighbors/specializations.cuh>
 #endif
 
diff --git a/cpp/test/neighbors/tiled_knn.cu b/cpp/test/neighbors/tiled_knn.cu
index 4784f915f3..ccc3a64edd 100644
--- a/cpp/test/neighbors/tiled_knn.cu
+++ b/cpp/test/neighbors/tiled_knn.cu
@@ -25,8 +25,7 @@
 #include <raft/matrix/init.cuh>
 #include <raft/neighbors/brute_force.cuh>
 
-#if defined RAFT_NN_COMPILED
-#include <raft/distance/specializations.cuh>
+#if defined RAFT_COMPILED
 #include <raft/neighbors/specializations.cuh>
 #endif
 
diff --git a/cpp/test/sparse/neighbors/knn_graph.cu b/cpp/test/sparse/neighbors/knn_graph.cu
index 3b025fc082..8873445c37 100644
--- a/cpp/test/sparse/neighbors/knn_graph.cu
+++ b/cpp/test/sparse/neighbors/knn_graph.cu
@@ -22,8 +22,8 @@
 
 #include <raft/sparse/coo.hpp>
 #include <raft/sparse/neighbors/knn_graph.cuh>
-#if defined RAFT_NN_COMPILED
-#include <raft/spatial/knn/specializations.cuh>
+#if defined RAFT_COMPILED
+#include <raft/neighbors/specializations.cuh>
 #endif
 
 #include <iostream>
diff --git a/cpp/test/stats/silhouette_score.cu b/cpp/test/stats/silhouette_score.cu
index 80e60a4884..40b7e59d81 100644
--- a/cpp/test/stats/silhouette_score.cu
+++ b/cpp/test/stats/silhouette_score.cu
@@ -20,7 +20,7 @@
 #include <raft/distance/distance_types.hpp>
 #include <raft/util/cudart_utils.hpp>
 
-#if defined RAFT_DISTANCE_COMPILED && defined RAFT_NN_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/stats/specializations.cuh>
 #endif
 
diff --git a/cpp/test/stats/trustworthiness.cu b/cpp/test/stats/trustworthiness.cu
index a2f72516eb..2fde6b29c1 100644
--- a/cpp/test/stats/trustworthiness.cu
+++ b/cpp/test/stats/trustworthiness.cu
@@ -20,7 +20,7 @@
 #include <raft/distance/distance.cuh>
 #include <raft/util/cudart_utils.hpp>
 
-#if defined RAFT_DISTANCE_COMPILED && defined RAFT_NN_COMPILED
+#if defined RAFT_COMPILED
 #include <raft/stats/specializations.cuh>
 #endif
 
diff --git a/docs/source/build.md b/docs/source/build.md
index 5ba1e75fad..bbb454736a 100644
--- a/docs/source/build.md
+++ b/docs/source/build.md
@@ -4,8 +4,7 @@
 
 The easiest way to install RAFT is through conda and several packages are provided.
 - `libraft-headers` RAFT headers
-- `libraft-nn` (optional) contains shared libraries for the nearest neighbors primitives.
-- `libraft-distance` (optional) contains shared libraries for distance primitives.
+- `libraft` (optional) shared library containing pre-compiled template specializations and runtime API.
 - `pylibraft` (optional) Python wrappers around RAFT algorithms and primitives.
 - `raft-dask` (optional) enables deployment of multi-node multi-GPU algorithms that use RAFT `raft::comms` in Dask clusters.
 
@@ -14,7 +13,7 @@ Use the following command to install all of the RAFT packages with conda (replac
 mamba install -c rapidsai -c conda-forge -c nvidia raft-dask pylibraft
 ```
 
-You can also install the `libraft-*` conda packages individually using the `mamba` command above.
+You can also install the conda packages individually using the `mamba` command above.
 
 After installing RAFT, `find_package(raft COMPONENTS nn distance)` can be used in your CUDA/C++ cmake build to compile and/or link against needed dependencies in your raft target. `COMPONENTS` are optional and will depend on the packages installed.
 
@@ -42,11 +41,10 @@ In addition to the libraries included with cudatoolkit 11.0+, there are some oth
 #### Required
 - [RMM](https://github.com/rapidsai/rmm) corresponding to RAFT version.
 - [Thrust](https://github.com/NVIDIA/thrust) v1.17 / [CUB](https://github.com/NVIDIA/cub)
-
-#### Optional
 - [cuCollections](https://github.com/NVIDIA/cuCollections) - Used in `raft::sparse::distance` API.
-- [Libcu++](https://github.com/NVIDIA/libcudacxx) v1.7.0 - Used by cuCollections
 - [CUTLASS](https://github.com/NVIDIA/cutlass)  v2.9.1 - Used in `raft::distance` API.
+
+#### Optional
 - [NCCL](https://github.com/NVIDIA/nccl) - Used in `raft::comms` API and needed to build `raft-dask`.
 - [UCX](https://github.com/openucx/ucx) - Used in `raft::comms` API and needed to build `raft-dask`.
 - [Googletest](https://github.com/google/googletest) - Needed to build tests
@@ -79,19 +77,14 @@ Once installed, `libraft` headers (and dependencies which were downloaded and in
 
 ### C++ Shared Libraries (optional)
 
-For larger projects which make heavy use of the pairwise distances or nearest neighbors APIs, shared libraries can be built to speed up compile times. These shared libraries can also significantly improve re-compile times both while developing RAFT and developing against the APIs. Build all of the available shared libraries by passing `--compile-libs` flag to `build.sh`:
+A shared library can be built for speeding up compile times. The shared library also contains a runtime API that allows you to invoke RAFT APIs directly from C++ source files (without `nvcc`). The shared library can also significantly improve re-compile times both while developing RAFT and using its APIs to develop applications. Pass the `--compile-lib` flag to `build.sh` to build the library:
 ```bash
-./build.sh libraft --compile-libs
+./build.sh libraft --compile-lib
 ```
 
-Individual shared libraries have their own flags and multiple can be used (though currently only the `nn` and `distance` packages contain shared libraries):
-```bash
-./build.sh libraft --compile-nn --compile-dist
-```
+In above example the shared library is installed by default into `$INSTALL_PREFIX/lib`. To disable this, pass `-n` flag.
 
-In above example the shared libraries are installed by default into `$INSTALL_PREFIX/lib`. To disable this, pass `-n` flag.
-
-Once installed, the shared libraries, headers (and any dependencies downloaded and installed via `rapids-cmake`) can be uninstalled using `build.sh`:
+Once installed, the shared library, headers (and any dependencies downloaded and installed via `rapids-cmake`) can be uninstalled using `build.sh`:
 ```bash
 ./build.sh libraft --uninstall
 ```
@@ -152,7 +145,7 @@ Use `CMAKE_INSTALL_PREFIX` to install RAFT into a specific location. The snippet
 cd cpp
 mkdir build
 cd build
-cmake -D BUILD_TESTS=ON -DRAFT_COMPILE_LIBRARIES=ON -DRAFT_ENABLE_NN_DEPENDENCIES=ON  -DCMAKE_INSTALL_PREFIX=$CONDA_PREFIX ../
+cmake -D BUILD_TESTS=ON -DRAFT_COMPILE_LIBRARY=ON -DCMAKE_INSTALL_PREFIX=$CONDA_PREFIX ../
 make -j<parallel_level> install
 ```
 
@@ -187,9 +180,9 @@ The Python APIs can be built and installed using the `build.sh` script:
 
 ```bash
 # to build pylibraft
-./build.sh libraft pylibraft --compile-libs
+./build.sh libraft pylibraft --compile-lib
 # to build raft-dask
-./build.sh libraft raft-dask --compile-libs
+./build.sh libraft pylibraft raft-dask --compile-lib
 ```
 
 `setup.py` can also be used to build the Python APIs manually:
@@ -225,7 +218,7 @@ The documentation requires that the C++ headers and python packages have been bu
 The following will build the docs along with the C++ and Python packages:
 
 ```
-./build.sh libraft pylibraft raft-dask docs --compile-libs
+./build.sh libraft pylibraft raft-dask docs --compile-lib
 ```
 
 
@@ -274,11 +267,11 @@ If RAFT has already been installed, such as by using the `build.sh` script, use
 
 ### Using C++ pre-compiled shared libraries
 
-Use `find_package(raft COMPONENTS nn distance)` to enable the shared libraries and transitively pass dependencies through separate targets for each component. In this example, the `raft::distance` and `raft::nn` targets will be available for configuring linking paths in addition to `raft::raft`. These targets will also pass through any transitive dependencies (such as CUTLASS for the `distance` package).
+Use `find_package(raft COMPONENTS compiled distributed)` to enable the shared library and transitively pass dependencies through separate targets for each component. In this example, the `raft::compiled` and `raft::distributed` targets will be available for configuring linking paths in addition to `raft::raft`. These targets will also pass through any transitive dependencies (such as NCCL for the `distributed` component).
 
 The pre-compiled libraries contain template specializations for commonly used types, such as single- and double-precision floating-point. In order to use the symbols in the pre-compiled libraries, the compiler needs to be told not to instantiate templates that are already contained in the shared libraries. By convention, these header files are named `specializations.cuh` and located in the base directory for the packages that contain specializations.
 
-The following example tells the compiler to ignore the pre-compiled templates for the `libraft-distance` API so any symbols already compiled into pre-compiled shared library will be used instead:
+The following example tells the compiler to ignore the pre-compiled templates for the `raft::distance` API so any symbols already compiled into the `libraft` shared library will be used instead:
 ```c++
 #include <raft/distance/distance.cuh>
 #include <raft/distance/specializations.cuh>
@@ -299,10 +292,7 @@ set(RAFT_FORK "rapidsai")
 set(RAFT_PINNED_TAG "branch-${RAFT_VERSION}")
 
 function(find_and_configure_raft)
-  set(oneValueArgs VERSION FORK PINNED_TAG
-          COMPILE_LIBRARIES CLONE_ON_PIN
-          USE_NN_LIBRARY USE_DISTANCE_LIBRARY
-          ENABLE_thrust_DEPENDENCY)
+  set(oneValueArgs VERSION FORK PINNED_TAG COMPILE_LIBRARY CLONE_ON_PIN)
   cmake_parse_arguments(PKG "${options}" "${oneValueArgs}"
                             "${multiValueArgs}" ${ARGN} )
 
@@ -315,18 +305,6 @@ function(find_and_configure_raft)
     set(CMAKE_IGNORE_PATH "${CMAKE_INSTALL_PREFIX}/include/raft;${CMAKE_IGNORE_PATH})
   endif()
 
-  #-----------------------------------------------------
-  # Add components
-  #-----------------------------------------------------
-
-  if(PKG_USE_NN_LIBRARY)
-    string(APPEND RAFT_COMPONENTS " nn")
-  endif()
-
-  if(PKG_USE_DISTANCE_LIBRARY)
-    string(APPEND RAFT_COMPONENTS " distance")
-  endif()
-
   #-----------------------------------------------------
   # Invoke CPM find_package()
   #-----------------------------------------------------
@@ -339,12 +317,11 @@ function(find_and_configure_raft)
           GIT_REPOSITORY https://github.com/${PKG_FORK}/raft.git
           GIT_TAG        ${PKG_PINNED_TAG}
           SOURCE_SUBDIR  cpp
-          FIND_PACKAGE_ARGUMENTS "COMPONENTS ${RAFT_COMPONENTS}"
+          FIND_PACKAGE_ARGUMENTS "COMPONENTS compiled distributed"
           OPTIONS
           "BUILD_TESTS OFF"
           "BUILD_BENCH OFF"
-          "RAFT_COMPILE_LIBRARIES ${PKG_COMPILE_LIBRARIES}"
-          "RAFT_ENABLE_thrust_DEPENDENCY ${PKG_ENABLE_thrust_DEPENDENCY}"
+          "RAFT_COMPILE_LIBRARY ${PKG_COMPILE_LIBRARY}"
   )
 
 endfunction()
@@ -360,16 +337,10 @@ find_and_configure_raft(VERSION    ${RAFT_VERSION}.00
         # force local raft clone in build directory
         # even if it's already installed.
         CLONE_ON_PIN     ON
-
-        COMPILE_LIBRARIES        NO
-        USE_NN_LIBRARY           NO
-        USE_DISTANCE_LIBRARY     NO
-        ENABLE_thrust_DEPENDENCY YES
+        COMPILE_LIBRARY          NO
 )
 ```
 
-If using the nearest neighbors APIs without the shared libraries, set `ENABLE_NN_DEPENDENCIES=ON` and keep `USE_NN_LIBRARY=OFF`
-
 ## Uninstall
 
 Once built and installed, RAFT can be safely uninstalled using `build.sh` by specifying any or all of the installed components. Please note that since `pylibraft` depends on `libraft`, uninstalling `pylibraft` will also uninstall `libraft`:
diff --git a/python/pylibraft/CMakeLists.txt b/python/pylibraft/CMakeLists.txt
index b12d0a63ea..a87b798eae 100644
--- a/python/pylibraft/CMakeLists.txt
+++ b/python/pylibraft/CMakeLists.txt
@@ -36,11 +36,11 @@ option(RAFT_BUILD_WHEELS "Whether this build is generating a Python wheel." OFF)
 
 # If the user requested it we attempt to find RAFT.
 if(FIND_RAFT_CPP)
-  find_package(raft ${pylibraft_version} REQUIRED COMPONENTS distance)
-  if(NOT TARGET raft::raft_distance_lib)
+  find_package(raft ${pylibraft_version} REQUIRED COMPONENTS compiled)
+  if(NOT TARGET raft::raft_lib)
     message(
       FATAL_ERROR
-        "Building against a preexisting libraft library requires the distance components of that library to have been built!"
+        "Building against a preexisting libraft library requires the compiled libraft to have been built!"
     )
 
   endif()
@@ -62,8 +62,7 @@ if(NOT raft_FOUND)
 
   set(BUILD_TESTS OFF)
   set(BUILD_BENCH OFF)
-  set(RAFT_COMPILE_LIBRARIES OFF)
-  set(RAFT_COMPILE_DIST_LIBRARY ON)
+  set(RAFT_COMPILE_LIBRARY ON)
 
   set(_exclude_from_all "")
   if(RAFT_BUILD_WHEELS)
@@ -75,11 +74,11 @@ if(NOT raft_FOUND)
 
   add_subdirectory(../../cpp raft-cpp ${_exclude_from_all})
 
-  # When building the C++ libraries from source we must copy libraft_distance.so alongside the
+  # When building the C++ libraries from source we must copy libraft.so alongside the
   # pairwise_distance and random Cython libraries TODO: when we have a single 'compiled' raft
   # library, we shouldn't need this
   set(cython_lib_dir pylibraft)
-  install(TARGETS raft_distance_lib DESTINATION ${cython_lib_dir})
+  install(TARGETS raft_lib DESTINATION ${cython_lib_dir})
 endif()
 
 rapids_cython_init()
diff --git a/python/pylibraft/pylibraft/cluster/CMakeLists.txt b/python/pylibraft/pylibraft/cluster/CMakeLists.txt
index ba77403a5d..7d6e05d918 100644
--- a/python/pylibraft/pylibraft/cluster/CMakeLists.txt
+++ b/python/pylibraft/pylibraft/cluster/CMakeLists.txt
@@ -1,5 +1,5 @@
 # =============================================================================
-# Copyright (c) 2022, NVIDIA CORPORATION.
+# Copyright (c) 2022-2023, NVIDIA CORPORATION.
 #
 # Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
 # in compliance with the License. You may obtain a copy of the License at
@@ -14,7 +14,7 @@
 
 # Set the list of Cython files to build
 set(cython_sources kmeans.pyx)
-set(linked_libraries raft::distance)
+set(linked_libraries raft::compiled)
 
 # Build all of the Cython targets
 rapids_cython_create_modules(
diff --git a/python/pylibraft/pylibraft/distance/CMakeLists.txt b/python/pylibraft/pylibraft/distance/CMakeLists.txt
index cae00007d6..14f0cc441a 100644
--- a/python/pylibraft/pylibraft/distance/CMakeLists.txt
+++ b/python/pylibraft/pylibraft/distance/CMakeLists.txt
@@ -1,5 +1,5 @@
 # =============================================================================
-# Copyright (c) 2022, NVIDIA CORPORATION.
+# Copyright (c) 2022-2023, NVIDIA CORPORATION.
 #
 # Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
 # in compliance with the License. You may obtain a copy of the License at
@@ -14,7 +14,7 @@
 
 # Set the list of Cython files to build
 set(cython_sources pairwise_distance.pyx fused_l2_nn.pyx)
-set(linked_libraries raft::raft raft::distance)
+set(linked_libraries raft::raft raft::compiled)
 
 # Build all of the Cython targets
 rapids_cython_create_modules(
diff --git a/python/pylibraft/pylibraft/neighbors/CMakeLists.txt b/python/pylibraft/pylibraft/neighbors/CMakeLists.txt
index 572ea47f4e..98f0d7f67a 100644
--- a/python/pylibraft/pylibraft/neighbors/CMakeLists.txt
+++ b/python/pylibraft/pylibraft/neighbors/CMakeLists.txt
@@ -14,7 +14,7 @@
 
 # Set the list of Cython files to build
 set(cython_sources common.pyx refine.pyx)
-set(linked_libraries raft::raft raft::distance)
+set(linked_libraries raft::raft raft::compiled)
 
 # Build all of the Cython targets
 rapids_cython_create_modules(
diff --git a/python/pylibraft/pylibraft/neighbors/ivf_flat/CMakeLists.txt b/python/pylibraft/pylibraft/neighbors/ivf_flat/CMakeLists.txt
index f183e17157..8f395faec9 100644
--- a/python/pylibraft/pylibraft/neighbors/ivf_flat/CMakeLists.txt
+++ b/python/pylibraft/pylibraft/neighbors/ivf_flat/CMakeLists.txt
@@ -14,7 +14,7 @@
 
 # Set the list of Cython files to build
 set(cython_sources ivf_flat.pyx)
-set(linked_libraries raft::raft raft::distance)
+set(linked_libraries raft::raft raft::compiled)
 
 # Build all of the Cython targets
 rapids_cython_create_modules(
diff --git a/python/pylibraft/pylibraft/neighbors/ivf_pq/CMakeLists.txt b/python/pylibraft/pylibraft/neighbors/ivf_pq/CMakeLists.txt
index cfce37b560..e3d721a6ea 100644
--- a/python/pylibraft/pylibraft/neighbors/ivf_pq/CMakeLists.txt
+++ b/python/pylibraft/pylibraft/neighbors/ivf_pq/CMakeLists.txt
@@ -1,5 +1,5 @@
 # =============================================================================
-# Copyright (c) 2022, NVIDIA CORPORATION.
+# Copyright (c) 2022-2023, NVIDIA CORPORATION.
 #
 # Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
 # in compliance with the License. You may obtain a copy of the License at
@@ -14,7 +14,7 @@
 
 # Set the list of Cython files to build
 set(cython_sources ivf_pq.pyx)
-set(linked_libraries raft::raft raft::distance)
+set(linked_libraries raft::raft raft::compiled)
 
 # Build all of the Cython targets
 rapids_cython_create_modules(
diff --git a/python/pylibraft/pylibraft/random/CMakeLists.txt b/python/pylibraft/pylibraft/random/CMakeLists.txt
index 49ca8627cc..fcc5ee6311 100644
--- a/python/pylibraft/pylibraft/random/CMakeLists.txt
+++ b/python/pylibraft/pylibraft/random/CMakeLists.txt
@@ -1,5 +1,5 @@
 # =============================================================================
-# Copyright (c) 2022, NVIDIA CORPORATION.
+# Copyright (c) 2022-2023, NVIDIA CORPORATION.
 #
 # Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
 # in compliance with the License. You may obtain a copy of the License at
@@ -17,7 +17,7 @@ set(cython_sources rmat_rectangular_generator.pyx)
 
 # TODO: should finally be replaced with 'compiled' library to be more generic, when that is
 # available
-set(linked_libraries raft::raft raft::distance)
+set(linked_libraries raft::raft raft::compiled)
 
 # Build all of the Cython targets
 rapids_cython_create_modules(

From 56ac43ad93a319a61073dce1b3b937f6f13ade63 Mon Sep 17 00:00:00 2001
From: Allard Hendriksen <ahendriksen@nvidia.com>
Date: Mon, 20 Mar 2023 20:36:06 +0100
Subject: [PATCH 05/25] Fix ivf flat specialization header IdxT from uint64_t
 -> int64_t (#1358)

The ivf_flat specialization header declarations used a wrong index type.

The specializations for ivf flat are defined for int64_t. The raft_runtime interface also uses the int64_t instances. The ivf_flat specialization header, however, declared an interface using uint64_t.

This is fixed with this PR. Should also reduce compile times for `src/distance/neighbors/ivf_flat_search.cu.o`

Authors:
  - Allard Hendriksen (https://github.com/ahendriksen)

Approvers:
  - Corey J. Nolet (https://github.com/cjnolet)
  - Divye Gala (https://github.com/divyegala)

URL: https://github.com/rapidsai/raft/pull/1358
---
 .../neighbors/specializations/ivf_flat.cuh    | 54 +++++++++----------
 1 file changed, 27 insertions(+), 27 deletions(-)

diff --git a/cpp/include/raft/neighbors/specializations/ivf_flat.cuh b/cpp/include/raft/neighbors/specializations/ivf_flat.cuh
index 02e1cbebb0..013c7359e5 100644
--- a/cpp/include/raft/neighbors/specializations/ivf_flat.cuh
+++ b/cpp/include/raft/neighbors/specializations/ivf_flat.cuh
@@ -20,35 +20,35 @@
 
 namespace raft::neighbors::ivf_flat {
 
-#define RAFT_INST(T, IdxT)                                                                   \
-  extern template auto build(raft::device_resources const& handle,                           \
-                             const index_params& params,                                     \
-                             raft::device_matrix_view<const T, uint64_t, row_major> dataset) \
-    ->index<T, IdxT>;                                                                        \
-                                                                                             \
-  extern template auto extend(                                                               \
-    raft::device_resources const& handle,                                                    \
-    raft::device_matrix_view<const T, IdxT, row_major> new_vectors,                          \
-    std::optional<raft::device_vector_view<const IdxT, IdxT>> new_indices,                   \
-    const index<T, IdxT>& orig_index)                                                        \
-    ->index<T, IdxT>;                                                                        \
-                                                                                             \
-  extern template void extend(                                                               \
-    raft::device_resources const& handle,                                                    \
-    raft::device_matrix_view<const T, IdxT, row_major> new_vectors,                          \
-    std::optional<raft::device_vector_view<const IdxT, IdxT>> new_indices,                   \
-    raft::neighbors::ivf_flat::index<T, IdxT>* idx);                                         \
-                                                                                             \
-  extern template void search(raft::device_resources const&,                                 \
-                              raft::neighbors::ivf_flat::search_params const&,               \
-                              const raft::neighbors::ivf_flat::index<T, IdxT>&,              \
-                              raft::device_matrix_view<const T, IdxT, row_major>,            \
-                              raft::device_matrix_view<IdxT, IdxT, row_major>,               \
+#define RAFT_INST(T, IdxT)                                                               \
+  extern template auto build(raft::device_resources const& handle,                       \
+                             const index_params& params,                                 \
+                             raft::device_matrix_view<const T, IdxT, row_major> dataset) \
+    ->index<T, IdxT>;                                                                    \
+                                                                                         \
+  extern template auto extend(                                                           \
+    raft::device_resources const& handle,                                                \
+    raft::device_matrix_view<const T, IdxT, row_major> new_vectors,                      \
+    std::optional<raft::device_vector_view<const IdxT, IdxT>> new_indices,               \
+    const index<T, IdxT>& orig_index)                                                    \
+    ->index<T, IdxT>;                                                                    \
+                                                                                         \
+  extern template void extend(                                                           \
+    raft::device_resources const& handle,                                                \
+    raft::device_matrix_view<const T, IdxT, row_major> new_vectors,                      \
+    std::optional<raft::device_vector_view<const IdxT, IdxT>> new_indices,               \
+    raft::neighbors::ivf_flat::index<T, IdxT>* idx);                                     \
+                                                                                         \
+  extern template void search(raft::device_resources const&,                             \
+                              raft::neighbors::ivf_flat::search_params const&,           \
+                              const raft::neighbors::ivf_flat::index<T, IdxT>&,          \
+                              raft::device_matrix_view<const T, IdxT, row_major>,        \
+                              raft::device_matrix_view<IdxT, IdxT, row_major>,           \
                               raft::device_matrix_view<float, IdxT, row_major>);
 
-RAFT_INST(float, uint64_t);
-RAFT_INST(int8_t, uint64_t);
-RAFT_INST(uint8_t, uint64_t);
+RAFT_INST(float, int64_t);
+RAFT_INST(int8_t, int64_t);
+RAFT_INST(uint8_t, int64_t);
 
 #undef RAFT_INST
 }  // namespace raft::neighbors::ivf_flat

From 05d899b36b76545d2439dbe47e4659d644ced227 Mon Sep 17 00:00:00 2001
From: Vyas Ramasubramani <vyasr@nvidia.com>
Date: Tue, 21 Mar 2023 16:23:16 -0400
Subject: [PATCH 06/25] Stop setting package version attribute in wheels
 (#1359)

This PR removes modification of the `__init__.py::version` attribute that occurs during the wheel build process. See https://github.com/rapidsai/ops/issues/2592 for more information.

Authors:
  - Vyas Ramasubramani (https://github.com/vyasr)

Approvers:
  - Sevag H (https://github.com/sevagh)

URL: https://github.com/rapidsai/raft/pull/1359
---
 ci/release/apply_wheel_modifications.sh | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/ci/release/apply_wheel_modifications.sh b/ci/release/apply_wheel_modifications.sh
index ed3d2a15fd..efc8f0c77c 100755
--- a/ci/release/apply_wheel_modifications.sh
+++ b/ci/release/apply_wheel_modifications.sh
@@ -6,10 +6,6 @@
 VERSION=${1}
 CUDA_SUFFIX=${2}
 
-# __init__.py versions
-sed -i "s/__version__ = .*/__version__ = \"${VERSION}\"/g" python/pylibraft/pylibraft/__init__.py
-sed -i "s/__version__ = .*/__version__ = \"${VERSION}\"/g" python/raft-dask/raft_dask/__init__.py
-
 # pyproject.toml versions
 sed -i "s/^version = .*/version = \"${VERSION}\"/g" python/pylibraft/pyproject.toml
 sed -i "s/^version = .*/version = \"${VERSION}\"/g" python/raft-dask/pyproject.toml

From a7e619cfec8b17a467122e0fd123aedad1bc5e06 Mon Sep 17 00:00:00 2001
From: Peter Andreas Entschev <peter@entschev.com>
Date: Wed, 22 Mar 2023 22:53:40 +0100
Subject: [PATCH 07/25] Remove usage of Dask's `get_worker` (#1365)

In dask/distributed#7580 get_worker was modified to return the worker of a task, thus it cannot be used by client.run, and we must now use dask_worker as the first argument to client.run to obtain the worker.

Authors:
  - Peter Andreas Entschev (https://github.com/pentschev)

Approvers:
  - Corey J. Nolet (https://github.com/cjnolet)
  - AJ Schmidt (https://github.com/ajschmidt8)

URL: https://github.com/rapidsai/raft/pull/1365
---
 ci/wheel_smoke_test_raft_dask.py              |  21 ++-
 python/raft-dask/raft_dask/common/comms.py    | 159 ++++++++++++------
 python/raft-dask/raft_dask/test/test_comms.py |  24 ++-
 3 files changed, 133 insertions(+), 71 deletions(-)

diff --git a/ci/wheel_smoke_test_raft_dask.py b/ci/wheel_smoke_test_raft_dask.py
index 32c13e61ca..5709ac901c 100644
--- a/ci/wheel_smoke_test_raft_dask.py
+++ b/ci/wheel_smoke_test_raft_dask.py
@@ -1,4 +1,19 @@
-from dask.distributed import Client, wait
+# Copyright (c) 2019-2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+from dask.distributed import Client, get_worker, wait
 from dask_cuda import LocalCUDACluster, initialize
 
 from raft_dask.common import (
@@ -23,12 +38,12 @@
 
 
 def func_test_send_recv(sessionId, n_trials):
-    handle = local_handle(sessionId)
+    handle = local_handle(sessionId, dask_worker=get_worker())
     return perform_test_comms_send_recv(handle, n_trials)
 
 
 def func_test_collective(func, sessionId, root):
-    handle = local_handle(sessionId)
+    handle = local_handle(sessionId, dask_worker=get_worker())
     return func(handle, root)
 
 
diff --git a/python/raft-dask/raft_dask/common/comms.py b/python/raft-dask/raft_dask/common/comms.py
index 56e40b98da..ebe9a8dc4f 100644
--- a/python/raft-dask/raft_dask/common/comms.py
+++ b/python/raft-dask/raft_dask/common/comms.py
@@ -19,7 +19,7 @@
 import warnings
 from collections import OrderedDict
 
-from dask.distributed import default_client, get_worker
+from dask.distributed import default_client
 
 from pylibraft.common.handle import Handle
 
@@ -242,7 +242,7 @@ def destroy(self):
         self.ucx_initialized = False
 
 
-def local_handle(sessionId):
+def local_handle(sessionId, dask_worker=None):
     """
     Simple helper function for retrieving the local handle_t instance
     for a comms session on a worker.
@@ -251,16 +251,19 @@ def local_handle(sessionId):
     ----------
     sessionId : str
                 session identifier from an initialized comms instance
+    dask_worker : dask_worker object
+                  (Note: if called by client.run(), this is supplied by Dask
+                   and not the client)
 
     Returns
     -------
     handle : raft.Handle or None
     """
-    state = get_raft_comm_state(sessionId, get_worker())
+    state = get_raft_comm_state(sessionId, dask_worker)
     return state["handle"] if "handle" in state else None
 
 
-def get_raft_comm_state(sessionId, state_object=None):
+def get_raft_comm_state(sessionId, state_object=None, dask_worker=None):
     """
     Retrieves cuML comms state on the scheduler node, for the given sessionId,
     creating a new session if it does not exist. If no session id is given,
@@ -271,13 +274,16 @@ def get_raft_comm_state(sessionId, state_object=None):
     sessionId : SessionId value to retrieve from the dask_scheduler instances
     state_object : Object (either Worker, or Scheduler) on which the raft
                    comm state will retrieved (or created)
+    dask_worker : dask_worker object
+                  (Note: if called by client.run(), this is supplied by Dask
+                   and not the client)
 
     Returns
     -------
     session state : str
                     session state associated with sessionId
     """
-    state_object = state_object if state_object is not None else get_worker()
+    state_object = state_object if state_object is not None else dask_worker
 
     if not hasattr(state_object, "_raft_comm_state"):
         state_object._raft_comm_state = {}
@@ -308,13 +314,19 @@ def set_nccl_root(sessionId, state_object):
     return raft_comm_state["nccl_uid"]
 
 
-def get_ucx():
+def get_ucx(dask_worker=None):
     """
     A simple convenience wrapper to make sure UCP listener and
     endpoints are only ever assigned once per worker.
+
+    Parameters
+    ----------
+    dask_worker : dask_worker object
+                  (Note: if called by client.run(), this is supplied by Dask
+                   and not the client)
     """
     raft_comm_state = get_raft_comm_state(
-        sessionId="ucp", state_object=get_worker()
+        sessionId="ucp", state_object=dask_worker
     )
     if "ucx" not in raft_comm_state:
         raft_comm_state["ucx"] = UCX.get()
@@ -371,7 +383,7 @@ def _func_set_scheduler_as_nccl_root(sessionId, verbose, dask_scheduler):
     return nccl_uid
 
 
-def _func_set_worker_as_nccl_root(sessionId, verbose):
+def _func_set_worker_as_nccl_root(sessionId, verbose, dask_worker=None):
     """
     Creates a persistent nccl uniqueId on the scheduler node.
 
@@ -380,63 +392,74 @@ def _func_set_worker_as_nccl_root(sessionId, verbose):
     ----------
     sessionId : Associated session to attach the unique ID to.
     verbose : Indicates whether or not to emit additional information
+    dask_worker : dask_worker object
+                  (Note: if called by client.run(), this is supplied by Dask
+                   and not the client)
 
     Return
     ------
     uniqueId : byte str
                 NCCL uniqueId, associating this DASK worker as its root node.
     """
-    worker = get_worker()
     if verbose:
-        worker.log_event(
+        dask_worker.log_event(
             topic="info",
             msg=f"Setting worker as NCCL root for session, '{sessionId}'",
         )
 
-    nccl_uid = set_nccl_root(sessionId=sessionId, state_object=worker)
+    nccl_uid = set_nccl_root(sessionId=sessionId, state_object=dask_worker)
 
     if verbose:
-        worker.log_event(
+        dask_worker.log_event(
             topic="info", msg="Done setting scheduler as NCCL root."
         )
 
     return nccl_uid
 
 
-def _func_ucp_listener_port():
-    return get_ucx().listener_port()
+def _func_ucp_listener_port(dask_worker=None):
+    return get_ucx(dask_worker=dask_worker).listener_port()
 
 
 async def _func_init_all(
-    sessionId, uniqueId, comms_p2p, worker_info, verbose, streams_per_handle
+    sessionId,
+    uniqueId,
+    comms_p2p,
+    worker_info,
+    verbose,
+    streams_per_handle,
+    dask_worker=None,
 ):
-    worker = get_worker()
     raft_comm_state = get_raft_comm_state(
-        sessionId=sessionId, state_object=worker
+        sessionId=sessionId, state_object=dask_worker
     )
     raft_comm_state["nccl_uid"] = uniqueId
-    raft_comm_state["wid"] = worker_info[get_worker().address]["rank"]
+    raft_comm_state["wid"] = worker_info[dask_worker.address]["rank"]
     raft_comm_state["nworkers"] = len(worker_info)
 
     if verbose:
-        worker.log_event(topic="info", msg="Initializing NCCL.")
+        dask_worker.log_event(topic="info", msg="Initializing NCCL.")
         start = time.time()
 
-    _func_init_nccl(sessionId, uniqueId)
+    _func_init_nccl(sessionId, uniqueId, dask_worker=dask_worker)
 
     if verbose:
         elapsed = time.time() - start
-        worker.log_event(
+        dask_worker.log_event(
             topic="info", msg=f"NCCL Initialization took: {elapsed} seconds."
         )
 
     if comms_p2p:
         if verbose:
-            worker.log_event(topic="info", msg="Initializing UCX Endpoints")
+            dask_worker.log_event(
+                topic="info", msg="Initializing UCX Endpoints"
+            )
 
         if verbose:
             start = time.time()
-        await _func_ucp_create_endpoints(sessionId, worker_info)
+        await _func_ucp_create_endpoints(
+            sessionId, worker_info, dask_worker=dask_worker
+        )
 
         if verbose:
             elapsed = time.time() - start
@@ -444,18 +467,22 @@ async def _func_init_all(
                 f"Done initializing UCX endpoints."
                 f"Took: {elapsed} seconds.\nBuilding handle."
             )
-            worker.log_event(topic="info", msg=msg)
+            dask_worker.log_event(topic="info", msg=msg)
 
-        _func_build_handle_p2p(sessionId, streams_per_handle, verbose)
+        _func_build_handle_p2p(
+            sessionId, streams_per_handle, verbose, dask_worker=dask_worker
+        )
 
         if verbose:
-            worker.log_event(topic="info", msg="Done building handle.")
+            dask_worker.log_event(topic="info", msg="Done building handle.")
 
     else:
-        _func_build_handle(sessionId, streams_per_handle, verbose)
+        _func_build_handle(
+            sessionId, streams_per_handle, verbose, dask_worker=dask_worker
+        )
 
 
-def _func_init_nccl(sessionId, uniqueId):
+def _func_init_nccl(sessionId, uniqueId, dask_worker=None):
     """
     Initialize ncclComm_t on worker
 
@@ -466,11 +493,13 @@ def _func_init_nccl(sessionId, uniqueId):
     uniqueId : array[byte]
                The NCCL unique Id generated from the
                client.
+    dask_worker : dask_worker object
+                  (Note: if called by client.run(), this is supplied by Dask
+                   and not the client)
     """
 
-    worker = get_worker()
     raft_comm_state = get_raft_comm_state(
-        sessionId=sessionId, state_object=get_worker()
+        sessionId=sessionId, state_object=dask_worker, dask_worker=dask_worker
     )
     wid = raft_comm_state["wid"]
     nWorkers = raft_comm_state["nworkers"]
@@ -480,13 +509,15 @@ def _func_init_nccl(sessionId, uniqueId):
         n.init(nWorkers, uniqueId, wid)
         raft_comm_state["nccl"] = n
     except Exception as e:
-        worker.log_event(
+        dask_worker.log_event(
             topic="error", msg=f"An error occurred initializing NCCL: {e}."
         )
         raise
 
 
-def _func_build_handle_p2p(sessionId, streams_per_handle, verbose):
+def _func_build_handle_p2p(
+    sessionId, streams_per_handle, verbose, dask_worker=None
+):
     """
     Builds a handle_t on the current worker given the initialized comms
 
@@ -495,14 +526,16 @@ def _func_build_handle_p2p(sessionId, streams_per_handle, verbose):
     sessionId : str id to reference state for current comms instance.
     streams_per_handle : int number of internal streams to create
     verbose : bool print verbose logging output
+    dask_worker : dask_worker object
+                  (Note: if called by client.run(), this is supplied by Dask
+                   and not the client)
     """
-    worker = get_worker()
     if verbose:
-        worker.log_event(topic="info", msg="Building p2p handle.")
+        dask_worker.log_event(topic="info", msg="Building p2p handle.")
 
-    ucp_worker = get_ucx().get_worker()
+    ucp_worker = get_ucx(dask_worker).get_worker()
     raft_comm_state = get_raft_comm_state(
-        sessionId=sessionId, state_object=worker
+        sessionId=sessionId, state_object=dask_worker
     )
 
     handle = Handle(n_streams=streams_per_handle)
@@ -512,21 +545,23 @@ def _func_build_handle_p2p(sessionId, streams_per_handle, verbose):
     workerId = raft_comm_state["wid"]
 
     if verbose:
-        worker.log_event(topic="info", msg="Injecting comms on handle.")
+        dask_worker.log_event(topic="info", msg="Injecting comms on handle.")
 
     inject_comms_on_handle(
         handle, nccl_comm, ucp_worker, eps, nWorkers, workerId, verbose
     )
 
     if verbose:
-        worker.log_event(
+        dask_worker.log_event(
             topic="info", msg="Finished injecting comms on handle."
         )
 
     raft_comm_state["handle"] = handle
 
 
-def _func_build_handle(sessionId, streams_per_handle, verbose):
+def _func_build_handle(
+    sessionId, streams_per_handle, verbose, dask_worker=None
+):
     """
     Builds a handle_t on the current worker given the initialized comms
 
@@ -535,17 +570,19 @@ def _func_build_handle(sessionId, streams_per_handle, verbose):
     sessionId : str id to reference state for current comms instance.
     streams_per_handle : int number of internal streams to create
     verbose : bool print verbose logging output
+    dask_worker : dask_worker object
+                  (Note: if called by client.run(), this is supplied by Dask
+                   and not the client)
     """
-    worker = get_worker()
     if verbose:
-        worker.log_event(
+        dask_worker.log_event(
             topic="info", msg="Finished injecting comms on handle."
         )
 
     handle = Handle(n_streams=streams_per_handle)
 
     raft_comm_state = get_raft_comm_state(
-        sessionId=sessionId, state_object=worker
+        sessionId=sessionId, state_object=dask_worker
     )
 
     workerId = raft_comm_state["wid"]
@@ -558,16 +595,18 @@ def _func_build_handle(sessionId, streams_per_handle, verbose):
     raft_comm_state["handle"] = handle
 
 
-def _func_store_initial_state(nworkers, sessionId, uniqueId, wid):
+def _func_store_initial_state(
+    nworkers, sessionId, uniqueId, wid, dask_worker=None
+):
     raft_comm_state = get_raft_comm_state(
-        sessionId=sessionId, state_object=get_worker()
+        sessionId=sessionId, state_object=dask_worker
     )
     raft_comm_state["nccl_uid"] = uniqueId
     raft_comm_state["wid"] = wid
     raft_comm_state["nworkers"] = nworkers
 
 
-async def _func_ucp_create_endpoints(sessionId, worker_info):
+async def _func_ucp_create_endpoints(sessionId, worker_info, dask_worker):
     """
     Runs on each worker to create ucp endpoints to all other workers
 
@@ -577,6 +616,9 @@ async def _func_ucp_create_endpoints(sessionId, worker_info):
                 uuid unique id for this instance
     worker_info : dict
                   Maps worker addresses to NCCL ranks & UCX ports
+    dask_worker : dask_worker object
+                  (Note: if called by client.run(), this is supplied by Dask
+                   and not the client)
     """
     eps = [None] * len(worker_info)
     count = 1
@@ -584,40 +626,47 @@ async def _func_ucp_create_endpoints(sessionId, worker_info):
     for k in worker_info:
         ip, port = parse_host_port(k)
 
-        ep = await get_ucx().get_endpoint(ip, worker_info[k]["port"])
+        ep = await get_ucx(dask_worker=dask_worker).get_endpoint(
+            ip, worker_info[k]["port"]
+        )
 
         eps[worker_info[k]["rank"]] = ep
         count += 1
 
     raft_comm_state = get_raft_comm_state(
-        sessionId=sessionId, state_object=get_worker()
+        sessionId=sessionId, state_object=dask_worker
     )
     raft_comm_state["ucp_eps"] = eps
 
 
-async def _func_destroy_all(sessionId, comms_p2p, verbose=False):
-    worker = get_worker()
+async def _func_destroy_all(
+    sessionId, comms_p2p, verbose=False, dask_worker=None
+):
     if verbose:
-        worker.log_event(topic="info", msg="Destroying NCCL session state.")
+        dask_worker.log_event(
+            topic="info", msg="Destroying NCCL session state."
+        )
 
     raft_comm_state = get_raft_comm_state(
-        sessionId=sessionId, state_object=worker
+        sessionId=sessionId, state_object=dask_worker
     )
     if "nccl" in raft_comm_state:
         raft_comm_state["nccl"].destroy()
         del raft_comm_state["nccl"]
         if verbose:
-            worker.log_event(topic="info", msg="NCCL session state destroyed.")
+            dask_worker.log_event(
+                topic="info", msg="NCCL session state destroyed."
+            )
     else:
         if verbose:
-            worker.log_event(
+            dask_worker.log_event(
                 topic="warning",
                 msg=f"Session state for, '{sessionId}', "
                 f"does not contain expected 'nccl' element",
             )
 
     if verbose:
-        worker.log_event(
+        dask_worker.log_event(
             topic="info",
             msg=f"Destroying CUDA handle for sessionId, '{sessionId}.'",
         )
@@ -626,7 +675,7 @@ async def _func_destroy_all(sessionId, comms_p2p, verbose=False):
         del raft_comm_state["handle"]
     else:
         if verbose:
-            worker.log_event(
+            dask_worker.log_event(
                 topic="warning",
                 msg=f"Session state for, '{sessionId}', "
                 f"does not contain expected 'handle' element",
diff --git a/python/raft-dask/raft_dask/test/test_comms.py b/python/raft-dask/raft_dask/test/test_comms.py
index 74ec446e94..3a430f9270 100644
--- a/python/raft-dask/raft_dask/test/test_comms.py
+++ b/python/raft-dask/raft_dask/test/test_comms.py
@@ -1,4 +1,4 @@
-# Copyright (c) 2019-2022, NVIDIA CORPORATION.
+# Copyright (c) 2019-2023, NVIDIA CORPORATION.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -17,7 +17,7 @@
 
 import pytest
 
-from dask.distributed import Client, wait
+from dask.distributed import Client, get_worker, wait
 
 try:
     from raft_dask.common import (
@@ -60,32 +60,32 @@ def test_comms_init_no_p2p(cluster):
 
 
 def func_test_collective(func, sessionId, root):
-    handle = local_handle(sessionId)
+    handle = local_handle(sessionId, dask_worker=get_worker())
     return func(handle, root)
 
 
 def func_test_send_recv(sessionId, n_trials):
-    handle = local_handle(sessionId)
+    handle = local_handle(sessionId, dask_worker=get_worker())
     return perform_test_comms_send_recv(handle, n_trials)
 
 
 def func_test_device_send_or_recv(sessionId, n_trials):
-    handle = local_handle(sessionId)
+    handle = local_handle(sessionId, dask_worker=get_worker())
     return perform_test_comms_device_send_or_recv(handle, n_trials)
 
 
 def func_test_device_sendrecv(sessionId, n_trials):
-    handle = local_handle(sessionId)
+    handle = local_handle(sessionId, dask_worker=get_worker())
     return perform_test_comms_device_sendrecv(handle, n_trials)
 
 
 def func_test_device_multicast_sendrecv(sessionId, n_trials):
-    handle = local_handle(sessionId)
+    handle = local_handle(sessionId, dask_worker=get_worker())
     return perform_test_comms_device_multicast_sendrecv(handle, n_trials)
 
 
 def func_test_comm_split(sessionId, n_trials):
-    handle = local_handle(sessionId)
+    handle = local_handle(sessionId, dask_worker=get_worker())
     return perform_test_comm_split(handle, n_trials)
 
 
@@ -114,11 +114,9 @@ def func_check_uid_on_scheduler(sessionId, uniqueId, dask_scheduler):
     )
 
 
-def func_check_uid_on_worker(sessionId, uniqueId):
-    from dask.distributed import get_worker
-
+def func_check_uid_on_worker(sessionId, uniqueId, dask_worker=None):
     return func_check_uid(
-        sessionId=sessionId, uniqueId=uniqueId, state_object=get_worker()
+        sessionId=sessionId, uniqueId=uniqueId, state_object=dask_worker
     )
 
 
@@ -127,7 +125,7 @@ def test_handles(cluster):
     client = Client(cluster)
 
     def _has_handle(sessionId):
-        return local_handle(sessionId) is not None
+        return local_handle(sessionId, dask_worker=get_worker()) is not None
 
     try:
         cb = Comms(verbose=True)

From 08e7012bc00140f77732fd73b134f388edf119dd Mon Sep 17 00:00:00 2001
From: Allard Hendriksen <ahendriksen@nvidia.com>
Date: Thu, 23 Mar 2023 03:24:56 +0100
Subject: [PATCH 08/25] Reduce compile times of distance specializations
 (#1307)

Following the findings in https://github.com/ahendriksen/raft/tree/investigate-compile-time-reduction-strategies#investigation-of-compile-times, this PR reduces the compile times of the pairwise distance specializations.
This is achieved by:
1. Reducing the number of included files in the translation units where kernels are instantiated, specifically `spdlog` and `rmm` are avoided.
2. Limiting loop unrolling in kernels with expensive operations in the inner loop.

Additional improvements geared towards iterative development:
1. The tests do not have to be recompiled when the internals of a pairwise distance kernel change. Before, a rebuilt was triggered due an include of `raft/distance/distance.cuh`.
2. Addition of a  fine tuning benchmark for the pairwise distance kernels that separates building the kernel from the benchmark code. This dramatically speeds up development. Compiling an empty benchmark takes roughly 18 seconds on my machine. Whereas recompiling a kernel takes ~3.8 seconds. Without this addition, a commit like 35a2ad437 would require substantially more time to make sure that performance is not degraded.

![image](https://user-images.githubusercontent.com/4172822/225383120-5f8a82f9-0b46-4c39-bc1d-7b2a0551e881.png)

```
Parallel build time before: 270 seconds (6 cores, SMT, 12 jobs)
Parallel build time before: 147 seconds (6 cores, SMT, 12 jobs)

Sum of compile times before: 3022.6 seconds
Sum of compile times after:  1816.2 seconds

Comparison of compile times between headers and compiled:
path                                                                         before (s)     after (s)  change (s) change (%)
pairwise_test                                                                    None        0.486       None     None
ance/distance/specializations/detail/lp_unexpanded_double_double_double_int.cu.o  101.1          10.3       -90.8     -89.8%
src/distance/distance/specializations/detail/canberra_float_float_float_int.cu.o   52.9           6.3       -46.6     -88.0%
/distance/distance/specializations/detail/canberra_double_double_double_int.cu.o   48.5           6.4       -42.1     -86.8%
stance/distance/specializations/detail/jensen_shannon_float_float_float_int.cu.o   65.3          10.4       -55.0     -84.1%
istance/distance/specializations/detail/kl_divergence_float_float_float_int.cu.o   70.2          12.6       -57.6     -82.0%
stance/distance/specializations/detail/correlation_double_double_double_int.cu.o   46.7           8.9       -37.8     -80.9%
distance/specializations/detail/hellinger_expanded_double_double_double_int.cu.o   41.6           8.1       -33.5     -80.6%
nce/distance/specializations/detail/jensen_shannon_double_double_double_int.cu.o   74.6          15.1       -59.5     -79.7%
ir/src/distance/distance/specializations/detail/l1_double_double_double_int.cu.o   40.9           8.4       -32.5     -79.4%
ance/distance/specializations/detail/l2_unexpanded_double_double_double_int.cu.o   40.7           8.6       -32.1     -78.8%
distance/specializations/detail/hamming_unexpanded_double_double_double_int.cu.o   40.8           9.0       -31.7     -77.8%
istance/distance/specializations/detail/lp_unexpanded_float_float_float_int.cu.o   45.9          10.2       -35.7     -77.8%
src/distance/distance/specializations/detail/l_inf_double_double_double_int.cu.o   41.2           9.5       -31.8     -77.0%
istance/distance/specializations/detail/russel_rao_double_double_double_int.cu.o   29.5           7.2       -22.3     -75.6%
t.dir/src/distance/distance/specializations/detail/l1_float_float_float_int.cu.o   47.3          13.2       -34.1     -72.2%
ce/distance/specializations/detail/hamming_unexpanded_float_float_float_int.cu.o   47.0          13.3       -33.7     -71.6%
/distance/distance/specializations/detail/correlation_float_float_float_int.cu.o   49.4          14.1       -35.3     -71.5%
ce/distance/specializations/detail/hellinger_expanded_float_float_float_int.cu.o   43.6          12.5       -31.1     -71.4%
c/distance/distance/specializations/detail/russel_rao_float_float_float_int.cu.o   28.5           8.2       -20.3     -71.2%
ance/distance/specializations/detail/kl_divergence_double_double_double_int.cu.o   75.8          21.9       -53.9     -71.1%
istance/distance/specializations/detail/l2_unexpanded_float_float_float_int.cu.o   46.2          13.5       -32.7     -70.7%
ir/src/distance/distance/specializations/detail/l_inf_float_float_float_int.cu.o   43.1          12.7       -30.4     -70.6%
stance/distance/specializations/detail/l2_expanded_double_double_double_int.cu.o   52.3          24.9       -27.3     -52.3%
/distance/distance/specializations/detail/l2_expanded_float_float_float_int.cu.o   75.8          40.3       -35.5     -46.8%
rc/distance/distance/specializations/detail/cosine_double_double_double_int.cu.o   53.5          28.7       -24.8     -46.4%
r/src/distance/distance/specializations/detail/cosine_float_float_float_int.cu.o   83.9          50.1       -33.8     -40.3%
CMakeFiles/pairwise_test.dir/test/distance/fused_l2_nn.cu.o                        85.1          64.1       -21.1     -24.7%
wise_test.dir/src/distance/distance/specializations/fused_l2_nn_float_int64.cu.o   56.2          42.9       -13.3     -23.6%
irwise_test.dir/src/distance/distance/specializations/fused_l2_nn_float_int.cu.o   52.5          40.2       -12.3     -23.5%
CMakeFiles/pairwise_test.dir/test/distance/dist_lp_unexp.cu.o                      56.3          43.3       -13.0     -23.1%
CMakeFiles/pairwise_test.dir/test/distance/dist_russell_rao.cu.o                   55.7          44.0       -11.7     -21.0%
rwise_test.dir/src/distance/distance/specializations/fused_l2_nn_double_int.cu.o   45.3          36.4        -9.0     -19.8%
CMakeFiles/pairwise_test.dir/test/distance/dist_l2_unexp.cu.o                      54.6          44.1       -10.6     -19.3%
CMakeFiles/pairwise_test.dir/test/distance/dist_canberra.cu.o                      51.6          42.1        -9.6     -18.6%
CMakeFiles/pairwise_test.dir/test/distance/dist_l2_exp.cu.o                        53.1          43.4        -9.6     -18.2%
CMakeFiles/pairwise_test.dir/test/distance/dist_l_inf.cu.o                         53.2          43.9        -9.3     -17.5%
CMakeFiles/pairwise_test.dir/test/distance/dist_hellinger.cu.o                     53.1          44.0        -9.0     -17.0%
CMakeFiles/pairwise_test.dir/test/distance/dist_hamming.cu.o                       52.3          43.4        -8.9     -17.0%
CMakeFiles/pairwise_test.dir/test/distance/dist_l2_sqrt_exp.cu.o                   54.0          45.6        -8.4     -15.6%
CMakeFiles/pairwise_test.dir/test/distance/dist_l1.cu.o                            52.6          44.5        -8.1     -15.4%
CMakeFiles/pairwise_test.dir/test/distance/dist_kl_divergence.cu.o                 52.4          44.7        -7.7     -14.8%
ise_test.dir/src/distance/distance/specializations/fused_l2_nn_double_int64.cu.o   43.5          37.2        -6.4     -14.7%
CMakeFiles/pairwise_test.dir/test/distance/dist_cos.cu.o                           52.4          44.8        -7.6     -14.5%
CMakeFiles/pairwise_test.dir/test/distance/dist_jensen_shannon.cu.o                53.2          45.7        -7.6     -14.2%
CMakeFiles/pairwise_test.dir/test/distance/dist_inner_product.cu.o                 51.1          44.8        -6.3     -12.4%
istance/distance/specializations/detail/inner_product_float_float_float_int.cu.o   39.5          35.1        -4.5     -11.3%
CMakeFiles/pairwise_test.dir/test/distance/dist_correlation.cu.o                   51.7          46.8        -4.9     -9.5%
ance/distance/specializations/detail/inner_product_double_double_double_int.cu.o   37.1          33.9        -3.1     -8.5%
src/distance/distance/specializations/detail/kernels/gram_matrix_base_float.cu.o   45.3          41.7        -3.6     -8.0%
rc/distance/distance/specializations/detail/kernels/gram_matrix_base_double.cu.o   42.5          39.6        -2.9     -6.8%
stance/distance/specializations/detail/kernels/polynomial_kernel_double_int.cu.o   40.4          38.5        -1.9     -4.8%
CMakeFiles/pairwise_test.dir/test/distance/dist_adj.cu.o                          123.3         117.8        -5.4     -4.4%
CMakeFiles/pairwise_test.dir/test/distance/gram.cu.o                               55.3          53.4        -1.9     -3.5%
build.ninja                                                                         4.0           4.0        +0.0     +0.1%
istance/distance/specializations/detail/kernels/polynomial_kernel_float_int.cu.o   45.2          45.6        +0.4     +0.8%
.dir/src/distance/distance/specializations/detail/kernels/tanh_kernel_float.cu.o   45.2          46.0        +0.8     +1.7%
dir/src/distance/distance/specializations/detail/kernels/tanh_kernel_double.cu.o   39.0          39.8        +0.8     +2.1%
CMakeFiles/pairwise_test.dir/src/distance/distance/pairwise_distance.cu.o          39.6          50.1       +10.5     +26.6%
```

Authors:
  - Allard Hendriksen (https://github.com/ahendriksen)
  - Corey J. Nolet (https://github.com/cjnolet)

Approvers:
  - Corey J. Nolet (https://github.com/cjnolet)
  - Divye Gala (https://github.com/divyegala)

URL: https://github.com/rapidsai/raft/pull/1307
---
 cpp/CMakeLists.txt                            |   4 -
 cpp/bench/CMakeLists.txt                      |   5 +
 cpp/bench/distance/tune_pairwise/bench.cu     | 151 +++++
 cpp/bench/distance/tune_pairwise/kernel.cu    |  88 +++
 cpp/bench/distance/tune_pairwise/kernel.cuh   |  44 ++
 cpp/include/raft/core/kvp.hpp                 |   2 +-
 cpp/include/raft/distance/detail/distance.cuh | 107 ++--
 .../distance/detail/distance_ops/canberra.cuh |   5 +-
 .../detail/distance_ops/correlation.cuh       |   4 +-
 .../distance/detail/distance_ops/cosine.cuh   |  11 +-
 .../distance/detail/distance_ops/cutlass.cuh  |   6 +-
 .../distance/detail/distance_ops/hamming.cuh  |   4 +-
 .../detail/distance_ops/hellinger.cuh         |   4 +-
 .../detail/distance_ops/jensen_shannon.cuh    |   5 +-
 .../detail/distance_ops/kl_divergence.cuh     |   5 +-
 .../raft/distance/detail/distance_ops/l1.cuh  |   4 +-
 .../distance/detail/distance_ops/l2_exp.cuh   |  11 +-
 .../distance/detail/distance_ops/l2_unexp.cuh |   4 +-
 .../distance/detail/distance_ops/l_inf.cuh    |   4 +-
 .../distance/detail/distance_ops/lp_unexp.cuh |   5 +-
 .../detail/distance_ops/russel_rao.cuh        |   4 +-
 .../distance/detail/distance_ops/template.cuh |  10 +-
 .../raft/distance/detail/fused_l2_nn.cuh      | 133 ++---
 .../detail/pairwise_distance_base.cuh         |  83 ++-
 .../detail/pairwise_distance_cutlass_base.cuh |  29 +-
 .../detail/pairwise_matrix/dispatch.cuh       | 114 ++--
 .../pairwise_matrix/dispatch_layout.cuh       |  21 +-
 .../detail/pairwise_matrix/dispatch_sm60.cuh  |  26 +-
 .../detail/pairwise_matrix/dispatch_sm80.cuh  |  16 +-
 .../detail/pairwise_matrix/kernel_sm60.cuh    |  69 +--
 .../detail/00_write_template.py               | 148 +++++
 .../specializations/detail/canberra.cuh       |  50 +-
 .../specializations/detail/correlation.cuh    |  51 +-
 .../specializations/detail/cosine.cuh         |  51 +-
 .../detail/hamming_unexpanded.cuh             |  51 +-
 .../detail/hellinger_expanded.cuh             |  50 +-
 .../specializations/detail/jensen_shannon.cuh |  50 +-
 .../specializations/detail/kl_divergence.cuh  |  49 +-
 .../distance/specializations/detail/l1.cuh    |  48 +-
 .../specializations/detail/l2_expanded.cuh    |  49 +-
 .../detail/l2_sqrt_expanded.cuh               |  54 --
 .../detail/l2_sqrt_unexpanded.cuh             |  54 --
 .../specializations/detail/l2_unexpanded.cuh  |  49 +-
 .../distance/specializations/detail/l_inf.cuh |  48 +-
 .../specializations/detail/lp_unexpanded.cuh  |  49 +-
 .../specializations/detail/russel_rao.cuh     |  50 +-
 .../distance/specializations/distance.cuh     |   2 -
 .../raft/spatial/knn/detail/fused_l2_knn.cuh  | 524 +++++++++---------
 cpp/include/raft/util/arch.cuh                |  23 +-
 cpp/include/raft/util/cuda_dev_essentials.cuh |  91 +++
 cpp/include/raft/util/cuda_rt_essentials.hpp  |  60 ++
 cpp/include/raft/util/cuda_utils.cuh          | 105 +---
 cpp/include/raft/util/cudart_utils.hpp        |  38 +-
 cpp/include/raft/util/device_loads_stores.cuh |   5 +-
 .../detail/00_write_template.py               | 159 ++++++
 .../canberra_double_double_double_int.cu      |  36 +-
 .../detail/canberra_float_float_float_int.cu  |  35 +-
 .../correlation_double_double_double_int.cu   |  35 +-
 .../correlation_float_float_float_int.cu      |  35 +-
 .../detail/cosine_double_double_double_int.cu |  35 +-
 .../detail/cosine_float_float_float_int.cu    |  35 +-
 ...ing_unexpanded_double_double_double_int.cu |  35 +-
 ...amming_unexpanded_float_float_float_int.cu |  35 +-
 ...inger_expanded_double_double_double_int.cu |  35 +-
 ...ellinger_expanded_float_float_float_int.cu |  34 +-
 ...jensen_shannon_double_double_double_int.cu |  36 +-
 .../jensen_shannon_float_float_float_int.cu   |  36 +-
 .../kl_divergence_double_double_double_int.cu |  35 +-
 .../kl_divergence_float_float_float_int.cu    |  35 +-
 .../detail/l1_double_double_double_int.cu     |  35 +-
 .../detail/l1_float_float_float_int.cu        |  35 +-
 .../l2_expanded_double_double_double_int.cu   |  37 +-
 .../l2_expanded_float_float_float_int.cu      |  36 +-
 ..._sqrt_expanded_double_double_double_int.cu |  38 --
 .../l2_sqrt_expanded_float_float_float_int.cu |  38 --
 ...qrt_unexpanded_double_double_double_int.cu |  38 --
 ...2_sqrt_unexpanded_float_float_float_int.cu |  38 --
 .../l2_unexpanded_double_double_double_int.cu |  35 +-
 .../l2_unexpanded_float_float_float_int.cu    |  35 +-
 .../detail/l_inf_double_double_double_int.cu  |  34 +-
 .../detail/l_inf_float_float_float_int.cu     |  35 +-
 .../lp_unexpanded_double_double_double_int.cu |  35 +-
 .../lp_unexpanded_float_float_float_int.cu    |  35 +-
 .../russel_rao_double_double_double_int.cu    |  36 +-
 .../russel_rao_float_float_float_int.cu       |  35 +-
 cpp/test/distance/distance_base.cuh           |  74 ++-
 cpp/test/distance/fused_l2_nn.cu              |  30 +-
 87 files changed, 2057 insertions(+), 2000 deletions(-)
 create mode 100644 cpp/bench/distance/tune_pairwise/bench.cu
 create mode 100644 cpp/bench/distance/tune_pairwise/kernel.cu
 create mode 100644 cpp/bench/distance/tune_pairwise/kernel.cuh
 create mode 100644 cpp/include/raft/distance/specializations/detail/00_write_template.py
 delete mode 100644 cpp/include/raft/distance/specializations/detail/l2_sqrt_expanded.cuh
 delete mode 100644 cpp/include/raft/distance/specializations/detail/l2_sqrt_unexpanded.cuh
 create mode 100644 cpp/include/raft/util/cuda_dev_essentials.cuh
 create mode 100644 cpp/include/raft/util/cuda_rt_essentials.hpp
 create mode 100644 cpp/src/distance/specializations/detail/00_write_template.py
 delete mode 100644 cpp/src/distance/specializations/detail/l2_sqrt_expanded_double_double_double_int.cu
 delete mode 100644 cpp/src/distance/specializations/detail/l2_sqrt_expanded_float_float_float_int.cu
 delete mode 100644 cpp/src/distance/specializations/detail/l2_sqrt_unexpanded_double_double_double_int.cu
 delete mode 100644 cpp/src/distance/specializations/detail/l2_sqrt_unexpanded_float_float_float_int.cu

diff --git a/cpp/CMakeLists.txt b/cpp/CMakeLists.txt
index bdaacb4a85..034dc059b0 100644
--- a/cpp/CMakeLists.txt
+++ b/cpp/CMakeLists.txt
@@ -312,10 +312,6 @@ if(RAFT_COMPILE_LIBRARY)
     src/distance/specializations/detail/l1_double_double_double_int.cu
     src/distance/specializations/detail/l2_expanded_float_float_float_int.cu
     src/distance/specializations/detail/l2_expanded_double_double_double_int.cu
-    src/distance/specializations/detail/l2_sqrt_expanded_float_float_float_int.cu
-    src/distance/specializations/detail/l2_sqrt_expanded_double_double_double_int.cu
-    src/distance/specializations/detail/l2_sqrt_unexpanded_float_float_float_int.cu
-    src/distance/specializations/detail/l2_sqrt_unexpanded_double_double_double_int.cu
     src/distance/specializations/detail/l2_unexpanded_double_double_double_int.cu
     src/distance/specializations/detail/l2_unexpanded_float_float_float_int.cu
     src/distance/specializations/detail/l_inf_double_double_double_int.cu
diff --git a/cpp/bench/CMakeLists.txt b/cpp/bench/CMakeLists.txt
index 8049074c09..d92ccba8e3 100644
--- a/cpp/bench/CMakeLists.txt
+++ b/cpp/bench/CMakeLists.txt
@@ -72,6 +72,11 @@ if(BUILD_BENCH)
     OPTIONAL LIB
   )
 
+  ConfigureBench(
+    NAME TUNE_DISTANCE PATH bench/distance/tune_pairwise/kernel.cu
+    bench/distance/tune_pairwise/bench.cu bench/main.cpp
+  )
+
   ConfigureBench(
     NAME
     DISTANCE_BENCH
diff --git a/cpp/bench/distance/tune_pairwise/bench.cu b/cpp/bench/distance/tune_pairwise/bench.cu
new file mode 100644
index 0000000000..87159ab1b1
--- /dev/null
+++ b/cpp/bench/distance/tune_pairwise/bench.cu
@@ -0,0 +1,151 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// Tuning benchmarks.
+//
+// Goals:
+//
+// 1. Fast compile times to maintain iteration speed.
+// 2. Create benchmarks that can inform the design of the kernels.
+//
+// Non-goals:
+//
+// 1. Measure every distance operation. Instead measures just one distance
+//    operation at the same time.
+// 2. Be useful for finding performance regressions. This is handled by the
+//    normal benchmarks.
+//
+// So far, both goals are partly achieved.
+//
+// RE (1), COMPILE TIMES: kernel.cu is fast to compile. This file is not.
+// When the internals of a pairwise distance kernel is changed, this file is not
+// recompiled.
+//
+// RE 2, benchmarks with intent: this file contains a benchmark to check the
+// maximal throughput of a kernel. Measuring other things, like performance on
+// skinny or wide matrices is not yet implemented.
+
+#include "kernel.cuh"                                       // launch_kernel
+#include <algorithm>                                        // std::min
+#include <common/benchmark.hpp>                             // RAFT_BENCH_REGISTER
+#include <raft/distance/detail/pairwise_matrix/params.cuh>  // pairwise_matrix_params
+#include <rmm/device_uvector.hpp>                           // rmm::device_uvector
+#include <vector>                                           // std::vector
+
+namespace raft::bench::distance::tune {
+
+// Max throughput benchmark.
+//
+// Goal: Measure the maximum distances/sec that can be computed.
+//
+// To achieve this, we make sure that:
+//
+// - Input data size is a multiple of the block tile size.
+//
+// - Perfect distribution of work between SMs, i.e. the number of block tiles is
+//   a large multiple (num_waves) of the number of blocks (#SMs * occupancy).
+//
+// - Multiple iterations over Kblk are executed (num_k_iters).
+struct throughput_param {
+  int num_waves;
+  int occupancy;
+  int num_k_iters;
+};
+
+const std::vector<throughput_param> throughput_params{
+  // 32 waves, requested occupancy of 4, and 32 k iterations typically achieves
+  // maximum throughput. No need to pick higher values.
+  {32, 4, 32},
+};
+
+struct throughput_bench : public fixture {
+  const throughput_param p;
+
+  throughput_bench(const throughput_param& p_) : p(p_) {}
+
+  void run_benchmark(::benchmark::State& state) override
+  {
+    // Get block size:
+    int block_m, block_n, block_k;
+    get_block_size(block_m, block_n, block_k);
+
+    // Determine number of blocks that will be launched. This informs the size
+    // of the inputs as well as the grid size.
+    const int num_sms       = raft::getMultiProcessorCount();
+    const int max_occupancy = get_max_occupancy();
+    const int occupancy     = std::min(p.occupancy, max_occupancy);
+    const int num_blocks    = occupancy * num_sms;
+    dim3 grid(num_blocks);
+
+    // Create input sizes that are a multiple of the block tile size.
+    size_t m = block_m;
+    size_t n = block_n * p.num_waves * num_blocks;
+    size_t k = block_k * p.num_k_iters;
+
+    // DataT, OutT, IdxT, etc, are defined in tuned_kernel.cuh
+    rmm::device_uvector<DataT> x_vec(m * k, stream);
+    rmm::device_uvector<DataT> y_vec(n * k, stream);
+    rmm::device_uvector<DataT> x_norm_vec(m, stream);
+    rmm::device_uvector<DataT> y_norm_vec(n, stream);
+    rmm::device_uvector<OutT> out_vec(m * n, stream);
+
+    auto x      = x_vec.data();
+    auto y      = y_vec.data();
+    auto x_norm = x_norm_vec.data();
+    auto y_norm = y_norm_vec.data();
+    auto out    = out_vec.data();
+    FinOpT fin_op{};
+
+    // Create kernel parameter struct. Flip x and y if column major.
+    IdxT ldx    = row_major ? k : m;
+    IdxT ldy    = row_major ? k : n;
+    IdxT ld_out = row_major ? n : m;
+
+    // Template parameters of pairwise_matrix_params are defined in kernel.cuh
+    pairwise_matrix_params kparams{
+      IdxT(m), IdxT(n), IdxT(k), ldx, ldy, ld_out, x, y, x_norm, y_norm, out, fin_op, row_major};
+
+    // Run benchmark
+    loop_on_state(state, [&]() { launch_kernel(kparams, grid, stream); });
+
+    // Report metrics. We don't report flop/s because we do not know for each
+    // distance operation how many flops it costs. For L2_unexp and l1, we can
+    // double this number to get the flop/s. For l2 expanded, core_ops/s should
+    // equal flop/s (modulo the sqrt and subtracting from the norm).
+    size_t num_core_ops = m * n * k;
+    size_t read_elts    = n * k + m * k;
+    size_t write_elts   = m * n;
+
+    state.counters["m"]         = benchmark::Counter(m);
+    state.counters["n"]         = benchmark::Counter(n);
+    state.counters["k"]         = benchmark::Counter(k);
+    state.counters["occupancy"] = benchmark::Counter(occupancy);
+    state.counters["# waves"]   = benchmark::Counter(p.num_waves);
+    state.counters["# k iters"] = benchmark::Counter(p.num_k_iters);
+
+    state.counters["core_ops/s"] = benchmark::Counter(num_core_ops,
+                                                      benchmark::Counter::kIsIterationInvariantRate,
+                                                      benchmark::Counter::OneK::kIs1000);
+
+    state.counters["BW"] = benchmark::Counter(write_elts * sizeof(OutT) + read_elts * sizeof(DataT),
+                                              benchmark::Counter::kIsIterationInvariantRate,
+                                              benchmark::Counter::OneK::kIs1000);
+  }
+};
+
+RAFT_BENCH_REGISTER(throughput_bench, "", throughput_params);
+
+}  // namespace raft::bench::distance::tune
diff --git a/cpp/bench/distance/tune_pairwise/kernel.cu b/cpp/bench/distance/tune_pairwise/kernel.cu
new file mode 100644
index 0000000000..3112e1ea9a
--- /dev/null
+++ b/cpp/bench/distance/tune_pairwise/kernel.cu
@@ -0,0 +1,88 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include "kernel.cuh"
+#include <raft/distance/detail/pairwise_matrix/kernel_sm60.cuh>  // pairwise_matrix_sm60_wrapper
+#include <raft/linalg/contractions.cuh>                          // raft::linalg::Policy4x4
+#include <raft/util/arch.cuh>  // raft::util::arch::SM_compute_arch
+
+namespace raft::bench::distance::tune {
+
+// Distance op
+using OpT                  = raft::distance::detail::ops::lp_unexp_distance_op<DataT, AccT, IdxT>;
+constexpr float metric_arg = 2.0;
+OpT distance_op{metric_arg};
+
+// Kernel policy
+constexpr int vec_len = 1;
+using Policy          = typename raft::linalg::Policy4x4<DataT, vec_len>::Policy;
+
+// Architecture
+namespace arch                 = raft::util::arch;
+constexpr auto sm_compat_range = arch::SM_range(arch::SM_min(), arch::SM_future());
+
+void launch_kernel(pairwise_matrix_params params, dim3 grid, cudaStream_t stream)
+{
+  dim3 block(Policy::Nthreads);
+  int smem_size = OpT::shared_mem_size<Policy>();
+
+  // Obtain function pointer to kernel
+  auto kernel = raft::distance::detail::pairwise_matrix_kernel<Policy,
+                                                               row_major,
+                                                               decltype(sm_compat_range),
+                                                               OpT,
+                                                               IdxT,
+                                                               DataT,
+                                                               OutT,
+                                                               FinOpT>;
+
+  kernel<<<grid, block, smem_size, stream>>>(distance_op, params);
+  RAFT_CUDA_TRY(cudaGetLastError());
+}
+
+void get_block_size(int& m, int& n, int& k)
+{
+  m = Policy::Mblk;
+  n = Policy::Nblk;
+  k = Policy::Kblk;
+}
+
+void* get_kernel_ptr()
+{
+  auto kernel = raft::distance::detail::pairwise_matrix_kernel<Policy,
+                                                               row_major,
+                                                               decltype(sm_compat_range),
+                                                               OpT,
+                                                               IdxT,
+                                                               DataT,
+                                                               OutT,
+                                                               FinOpT>;
+  return reinterpret_cast<void*>(kernel);
+}
+
+int get_max_occupancy()
+{
+  void* kernel_ptr = get_kernel_ptr();
+  int max_occupancy;
+  int smem_size = OpT::shared_mem_size<Policy>();
+
+  RAFT_CUDA_TRY(cudaOccupancyMaxActiveBlocksPerMultiprocessor(
+    &max_occupancy, kernel_ptr, Policy::Nthreads, smem_size));
+
+  return max_occupancy;
+}
+
+}  // namespace raft::bench::distance::tune
diff --git a/cpp/bench/distance/tune_pairwise/kernel.cuh b/cpp/bench/distance/tune_pairwise/kernel.cuh
new file mode 100644
index 0000000000..5da54a343c
--- /dev/null
+++ b/cpp/bench/distance/tune_pairwise/kernel.cuh
@@ -0,0 +1,44 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#pragma once
+
+#include <raft/distance/detail/distance_ops/all_ops.cuh>    // lp_unexp_distance_op
+#include <raft/distance/detail/pairwise_matrix/params.cuh>  // pairwise_matrix_params
+
+namespace raft::bench::distance::tune {
+
+// Launch one specific kernel with the following template parameters
+constexpr bool row_major = true;
+using DataT              = float;
+using AccT               = float;
+using OutT               = DataT;
+using IdxT               = int;
+
+using FinOpT = raft::identity_op;
+
+using pairwise_matrix_params =
+  raft::distance::detail::pairwise_matrix_params<IdxT, DataT, OutT, FinOpT>;
+
+// Launches kernel
+void launch_kernel(pairwise_matrix_params, dim3, cudaStream_t);
+
+// Describes the block size that is decided by the policy
+void get_block_size(int& m, int& n, int& k);
+
+int get_max_occupancy();
+
+}  // namespace raft::bench::distance::tune
diff --git a/cpp/include/raft/core/kvp.hpp b/cpp/include/raft/core/kvp.hpp
index 8d3321eb77..192d160d45 100644
--- a/cpp/include/raft/core/kvp.hpp
+++ b/cpp/include/raft/core/kvp.hpp
@@ -20,7 +20,7 @@
 
 #ifdef _RAFT_HAS_CUDA
 #include <cub/cub.cuh>
-#include <raft/util/cuda_utils.cuh>
+#include <raft/util/cuda_utils.cuh>  // raft::shfl_xor
 #endif
 namespace raft {
 /**
diff --git a/cpp/include/raft/distance/detail/distance.cuh b/cpp/include/raft/distance/detail/distance.cuh
index f469250b45..7493c4e558 100644
--- a/cpp/include/raft/distance/detail/distance.cuh
+++ b/cpp/include/raft/distance/detail/distance.cuh
@@ -16,25 +16,18 @@
 
 #pragma once
 
-#include <cuda_runtime_api.h>
-#include <type_traits>
-
-#include <raft/core/resource/cuda_stream.hpp>
-#include <raft/linalg/gemm.cuh>
-#include <raft/linalg/norm.cuh>
-#include <raft/linalg/reduce.cuh>
-#include <raft/linalg/unary_op.cuh>
-
 #include <raft/core/operators.hpp>
-
+#include <raft/core/resource/cuda_stream.hpp>
 #include <raft/distance/detail/distance_ops/all_ops.cuh>
 #include <raft/distance/detail/pairwise_matrix/dispatch.cuh>
-
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm80.cuh>
 #include <raft/distance/distance_types.hpp>
 #include <raft/linalg/gemm.cuh>
-#include <raft/util/arch.cuh>
-#include <raft/util/cuda_utils.cuh>
-#include <rmm/device_uvector.hpp>
+#include <raft/linalg/norm.cuh>
+#include <raft/linalg/reduce.cuh>
+#include <raft/linalg/unary_op.cuh>
+#include <type_traits>
 
 namespace raft {
 namespace distance {
@@ -140,14 +133,14 @@ void distance_impl(raft::resources const& handle,
 
   cudaStream_t stream = raft::resource::get_cuda_stream(handle);
 
-  AccT* norm_col_vec    = workspace;
-  AccT* norm_row_vec    = workspace;
-  AccT* sq_norm_col_vec = workspace;
-  AccT* sq_norm_row_vec = workspace;
+  AccT* x_norm    = workspace;
+  AccT* y_norm    = workspace;
+  AccT* sq_x_norm = workspace;
+  AccT* sq_y_norm = workspace;
   if (x != y) {
-    norm_row_vec += m;
+    y_norm += m;
 
-    raft::linalg::reduce(norm_col_vec,
+    raft::linalg::reduce(x_norm,
                          x,
                          k,
                          m,
@@ -158,7 +151,7 @@ void distance_impl(raft::resources const& handle,
                          false,
                          raft::identity_op(),
                          raft::add_op());
-    raft::linalg::reduce(norm_row_vec,
+    raft::linalg::reduce(y_norm,
                          y,
                          k,
                          n,
@@ -170,12 +163,12 @@ void distance_impl(raft::resources const& handle,
                          raft::identity_op(),
                          raft::add_op());
 
-    sq_norm_col_vec += (m + n);
-    sq_norm_row_vec = sq_norm_col_vec + m;
-    raft::linalg::rowNorm(sq_norm_col_vec, x, k, m, raft::linalg::L2Norm, is_row_major, stream);
-    raft::linalg::rowNorm(sq_norm_row_vec, y, k, n, raft::linalg::L2Norm, is_row_major, stream);
+    sq_x_norm += (m + n);
+    sq_y_norm = sq_x_norm + m;
+    raft::linalg::rowNorm(sq_x_norm, x, k, m, raft::linalg::L2Norm, is_row_major, stream);
+    raft::linalg::rowNorm(sq_y_norm, y, k, n, raft::linalg::L2Norm, is_row_major, stream);
   } else {
-    raft::linalg::reduce(norm_col_vec,
+    raft::linalg::reduce(x_norm,
                          x,
                          k,
                          m,
@@ -186,15 +179,15 @@ void distance_impl(raft::resources const& handle,
                          false,
                          raft::identity_op(),
                          raft::add_op());
-    sq_norm_col_vec += m;
-    sq_norm_row_vec = sq_norm_col_vec;
-    raft::linalg::rowNorm(sq_norm_col_vec, x, k, m, raft::linalg::L2Norm, is_row_major, stream);
+    sq_x_norm += m;
+    sq_y_norm = sq_x_norm;
+    raft::linalg::rowNorm(sq_x_norm, x, k, m, raft::linalg::L2Norm, is_row_major, stream);
   }
 
   using OpT = ops::correlation_distance_op<DataT, AccT, IdxT>;
-  OpT corr_op(is_row_major, sq_norm_col_vec, sq_norm_row_vec, m, n, k);
+  OpT corr_op(is_row_major, sq_x_norm, sq_y_norm, m, n, k);
   pairwise_matrix_dispatch<decltype(corr_op), DataT, AccT, OutT, FinOpT, IdxT>(
-    corr_op, m, n, k, x, y, norm_col_vec, norm_row_vec, out, fin_op, stream, is_row_major);
+    corr_op, m, n, k, x, y, x_norm, y_norm, out, fin_op, stream, is_row_major);
 }
 
 template <typename DataT, typename AccT, typename OutT, typename FinOpT, typename IdxT = int>
@@ -223,22 +216,22 @@ void distance_impl(raft::resources const& handle,
 
   cudaStream_t stream = raft::resource::get_cuda_stream(handle);
 
-  DataT* norm_A = workspace;
-  DataT* norm_B = workspace;
+  DataT* x_norm = workspace;
+  DataT* y_norm = workspace;
   if (x != y) {
-    norm_B += m;
+    y_norm += m;
     raft::linalg::rowNorm(
-      norm_A, x, k, m, raft::linalg::L2Norm, is_row_major, stream, raft::sqrt_op{});
+      x_norm, x, k, m, raft::linalg::L2Norm, is_row_major, stream, raft::sqrt_op{});
     raft::linalg::rowNorm(
-      norm_B, y, k, n, raft::linalg::L2Norm, is_row_major, stream, raft::sqrt_op{});
+      y_norm, y, k, n, raft::linalg::L2Norm, is_row_major, stream, raft::sqrt_op{});
   } else {
     raft::linalg::rowNorm(
-      norm_A, x, k, m, raft::linalg::L2Norm, is_row_major, stream, raft::sqrt_op{});
+      x_norm, x, k, m, raft::linalg::L2Norm, is_row_major, stream, raft::sqrt_op{});
   }
 
   ops::cosine_distance_op<DataT, AccT, IdxT> distance_op{};
   pairwise_matrix_dispatch<decltype(distance_op), DataT, AccT, OutT, FinOpT, IdxT>(
-    distance_op, m, n, k, x, y, norm_A, norm_B, out, fin_op, stream, is_row_major);
+    distance_op, m, n, k, x, y, x_norm, y_norm, out, fin_op, stream, is_row_major);
 }
 
 template <typename DataT, typename AccT, typename OutT, typename FinOpT, typename IdxT = int>
@@ -389,10 +382,6 @@ void distance_impl(raft::resources const& handle,
     return (!x_zero) * raft::exp(input);
   };
 
-  // This op takes some shortcuts when x equals y. So its behavior changes based
-  // on this.
-  ops::kl_divergence_op<DataT, AccT, DataT> kl_divergence{is_row_major, x == y};
-
   if (x != y) {
     raft::linalg::unaryOp<DataT, decltype(unaryOp_lambda), IdxT>(
       (DataT*)y, y, n * k, unaryOp_lambda, stream);
@@ -401,8 +390,12 @@ void distance_impl(raft::resources const& handle,
   const DataT* x_norm = nullptr;
   const DataT* y_norm = nullptr;
 
-  pairwise_matrix_dispatch<decltype(kl_divergence), DataT, AccT, OutT, FinOpT, IdxT>(
-    kl_divergence, m, n, k, x, y, x_norm, y_norm, out, fin_op, stream, is_row_major);
+  // This op takes some shortcuts when x equals y. So its behavior changes based
+  // on this.
+  ops::kl_divergence_op<DataT, AccT, IdxT> distance_op{is_row_major, x == y};
+
+  pairwise_matrix_dispatch<decltype(distance_op), DataT, AccT, OutT, FinOpT, IdxT>(
+    distance_op, m, n, k, x, y, x_norm, y_norm, out, fin_op, stream, is_row_major);
 
   if (x != y) {
     // Now reverse previous log (x) back to x using (e ^ log(x))
@@ -464,22 +457,22 @@ void distance_impl_l2_expanded(  // NOTE: different name
          "workspace size error");
   ASSERT(workspace != nullptr, "workspace is null");
 
-  DataT* norm_A = workspace;
-  DataT* norm_B = workspace;
+  DataT* x_norm = workspace;
+  DataT* y_norm = workspace;
   if (x != y) {
-    norm_B += m;
+    y_norm += m;
     raft::linalg::rowNorm(
-      norm_A, x, k, m, raft::linalg::L2Norm, is_row_major, stream, raft::identity_op{});
+      x_norm, x, k, m, raft::linalg::L2Norm, is_row_major, stream, raft::identity_op{});
     raft::linalg::rowNorm(
-      norm_B, y, k, n, raft::linalg::L2Norm, is_row_major, stream, raft::identity_op{});
+      y_norm, y, k, n, raft::linalg::L2Norm, is_row_major, stream, raft::identity_op{});
   } else {
     raft::linalg::rowNorm(
-      norm_A, x, k, m, raft::linalg::L2Norm, is_row_major, stream, raft::identity_op{});
+      x_norm, x, k, m, raft::linalg::L2Norm, is_row_major, stream, raft::identity_op{});
   }
 
   ops::l2_exp_distance_op<DataT, AccT, IdxT> distance_op{perform_sqrt};
   pairwise_matrix_dispatch<decltype(distance_op), DataT, AccT, OutT, FinOpT, IdxT>(
-    distance_op, m, n, k, x, y, norm_A, norm_B, out, fin_op, stream, is_row_major);
+    distance_op, m, n, k, x, y, x_norm, y_norm, out, fin_op, stream, is_row_major);
 }
 
 template <typename DataT, typename AccT, typename OutT, typename FinOpT, typename IdxT = int>
@@ -543,13 +536,13 @@ void distance_impl(raft::resources const& handle,
   ops::l2_unexp_distance_op<DataT, AccT, IdxT> l2_op(perform_sqrt);
 
   // The unexpanded L2 does not require the norms of a and b to be calculated.
-  const DataT* norm_A = nullptr;
-  const DataT* norm_B = nullptr;
+  const DataT* x_norm = nullptr;
+  const DataT* y_norm = nullptr;
 
   cudaStream_t stream = raft::resource::get_cuda_stream(handle);
 
   pairwise_matrix_dispatch<decltype(l2_op), DataT, AccT, OutT, FinOpT, IdxT>(
-    l2_op, m, n, k, x, y, norm_A, norm_B, out, fin_op, stream, is_row_major);
+    l2_op, m, n, k, x, y, x_norm, y_norm, out, fin_op, stream, is_row_major);
 }
 
 template <typename DataT, typename AccT, typename OutT, typename FinOpT, typename IdxT = int>
@@ -571,13 +564,13 @@ void distance_impl(raft::resources const& handle,
   ops::l2_unexp_distance_op<DataT, AccT, IdxT> l2_op(perform_sqrt);
 
   // The unexpanded L2 does not require the norms of a and b to be calculated.
-  const DataT* norm_A = nullptr;
-  const DataT* norm_B = nullptr;
+  const DataT* x_norm = nullptr;
+  const DataT* y_norm = nullptr;
 
   cudaStream_t stream = raft::resource::get_cuda_stream(handle);
 
   pairwise_matrix_dispatch<decltype(l2_op), DataT, AccT, OutT, FinOpT, IdxT>(
-    l2_op, m, n, k, x, y, norm_A, norm_B, out, fin_op, stream, is_row_major);
+    l2_op, m, n, k, x, y, x_norm, y_norm, out, fin_op, stream, is_row_major);
 }
 
 template <typename DataT, typename AccT, typename OutT, typename FinOpT, typename IdxT = int>
diff --git a/cpp/include/raft/distance/detail/distance_ops/canberra.cuh b/cpp/include/raft/distance/detail/distance_ops/canberra.cuh
index 930294ce31..eaf37b7e9c 100644
--- a/cpp/include/raft/distance/detail/distance_ops/canberra.cuh
+++ b/cpp/include/raft/distance/detail/distance_ops/canberra.cuh
@@ -16,7 +16,8 @@
 
 #pragma once
 
-#include <raft/util/cuda_utils.cuh>
+#include <raft/core/operators.hpp>            // raft::abs
+#include <raft/util/cuda_dev_essentials.cuh>  // DI
 
 namespace raft::distance::detail::ops {
 
@@ -42,7 +43,7 @@ struct canberra_distance_op {
   // Size of shared memory. This is normally decided by the kernel policy, but
   // some ops such as correlation_distance_op use more.
   template <typename Policy>
-  constexpr size_t shared_mem_size()
+  static constexpr size_t shared_mem_size()
   {
     return Policy::SmemSize;
   }
diff --git a/cpp/include/raft/distance/detail/distance_ops/correlation.cuh b/cpp/include/raft/distance/detail/distance_ops/correlation.cuh
index 289b69070a..4fc4bb8297 100644
--- a/cpp/include/raft/distance/detail/distance_ops/correlation.cuh
+++ b/cpp/include/raft/distance/detail/distance_ops/correlation.cuh
@@ -16,7 +16,7 @@
 
 #pragma once
 
-#include <raft/util/cuda_utils.cuh>
+#include <raft/util/cuda_dev_essentials.cuh>  // DI
 
 namespace raft::distance::detail::ops {
 
@@ -61,7 +61,7 @@ struct correlation_distance_op {
   // Size of shared memory. This is normally decided by the kernel policy, but
   // some ops such as correlation_distance_op use more.
   template <typename Policy>
-  constexpr size_t shared_mem_size()
+  static constexpr size_t shared_mem_size()
   {
     return Policy::SmemSize + (2 * (Policy::Mblk + Policy::Nblk) * sizeof(DataT));
   }
diff --git a/cpp/include/raft/distance/detail/distance_ops/cosine.cuh b/cpp/include/raft/distance/detail/distance_ops/cosine.cuh
index 7c37c27b4e..0883136c9f 100644
--- a/cpp/include/raft/distance/detail/distance_ops/cosine.cuh
+++ b/cpp/include/raft/distance/detail/distance_ops/cosine.cuh
@@ -16,7 +16,7 @@
 
 #pragma once
 
-#include <raft/util/cuda_utils.cuh>
+#include <raft/util/cuda_dev_essentials.cuh>  // DI
 
 namespace raft::distance::detail::ops {
 
@@ -26,7 +26,7 @@ struct cosine_cutlass_op {
   __device__ cosine_cutlass_op() noexcept {}
   __device__ AccT operator()(DataT& aNorm, const DataT& bNorm, DataT& accVal) const noexcept
   {
-    return static_cast<AccT>(1.0) - (AccT)(accVal / (aNorm * bNorm));
+    return static_cast<AccT>(1.0) - static_cast<AccT>(accVal / (aNorm * bNorm));
   }
   __device__ AccT operator()(DataT aData) const noexcept { return aData; }
 };
@@ -53,7 +53,7 @@ struct cosine_distance_op {
   // Size of shared memory. This is normally decided by the kernel policy, but
   // some ops such as correlation_distance_op use more.
   template <typename Policy>
-  constexpr size_t shared_mem_size()
+  static constexpr size_t shared_mem_size()
   {
     return Policy::SmemSize + ((Policy::Mblk + Policy::Nblk) * sizeof(DataT));
   }
@@ -76,7 +76,10 @@ struct cosine_distance_op {
     }
   }
 
-  cosine_cutlass_op<DataT, AccT> get_cutlass_op() { return cosine_cutlass_op<DataT, AccT>(); }
+  constexpr cosine_cutlass_op<DataT, AccT> get_cutlass_op() const
+  {
+    return cosine_cutlass_op<DataT, AccT>();
+  }
 };
 
 }  // namespace raft::distance::detail::ops
diff --git a/cpp/include/raft/distance/detail/distance_ops/cutlass.cuh b/cpp/include/raft/distance/detail/distance_ops/cutlass.cuh
index d3eb90467b..7a4fe0ce83 100644
--- a/cpp/include/raft/distance/detail/distance_ops/cutlass.cuh
+++ b/cpp/include/raft/distance/detail/distance_ops/cutlass.cuh
@@ -16,7 +16,8 @@
 
 #pragma once
 
-#include <type_traits>
+#include <type_traits>  // std::false_type
+#include <utility>      // std::declval
 
 namespace raft::distance::detail::ops {
 
@@ -34,7 +35,8 @@ struct has_cutlass_op : std::false_type {
 
 // Specialization recognizes types that do support CUTLASS
 template <typename T>
-struct has_cutlass_op<T, std::void_t<decltype(&T::get_cutlass_op)>> : std::true_type {
+struct has_cutlass_op<T, std::void_t<decltype(std::declval<T>().get_cutlass_op())>>
+  : std::true_type {
 };
 
 }  // namespace raft::distance::detail::ops
diff --git a/cpp/include/raft/distance/detail/distance_ops/hamming.cuh b/cpp/include/raft/distance/detail/distance_ops/hamming.cuh
index 1cfdcfdc73..475b8892e9 100644
--- a/cpp/include/raft/distance/detail/distance_ops/hamming.cuh
+++ b/cpp/include/raft/distance/detail/distance_ops/hamming.cuh
@@ -16,7 +16,7 @@
 
 #pragma once
 
-#include <raft/util/cuda_utils.cuh>
+#include <raft/util/cuda_dev_essentials.cuh>  // DI
 
 namespace raft::distance::detail::ops {
 
@@ -45,7 +45,7 @@ struct hamming_distance_op {
   // Size of shared memory. This is normally decided by the kernel policy, but
   // some ops such as correlation_distance_op use more.
   template <typename Policy>
-  constexpr size_t shared_mem_size()
+  static constexpr size_t shared_mem_size()
   {
     return Policy::SmemSize;
   }
diff --git a/cpp/include/raft/distance/detail/distance_ops/hellinger.cuh b/cpp/include/raft/distance/detail/distance_ops/hellinger.cuh
index c4aecc7a6f..0489b45854 100644
--- a/cpp/include/raft/distance/detail/distance_ops/hellinger.cuh
+++ b/cpp/include/raft/distance/detail/distance_ops/hellinger.cuh
@@ -15,7 +15,7 @@
  */
 
 #pragma once
-#include <raft/util/cuda_utils.cuh>
+#include <raft/util/cuda_dev_essentials.cuh>  // DI
 
 namespace raft::distance::detail::ops {
 
@@ -42,7 +42,7 @@ struct hellinger_distance_op {
   // Size of shared memory. This is normally decided by the kernel policy, but
   // some ops such as correlation_distance_op use more.
   template <typename Policy>
-  constexpr size_t shared_mem_size()
+  static constexpr size_t shared_mem_size()
   {
     return Policy::SmemSize;
   }
diff --git a/cpp/include/raft/distance/detail/distance_ops/jensen_shannon.cuh b/cpp/include/raft/distance/detail/distance_ops/jensen_shannon.cuh
index 41eeb9dd83..e46c63734c 100644
--- a/cpp/include/raft/distance/detail/distance_ops/jensen_shannon.cuh
+++ b/cpp/include/raft/distance/detail/distance_ops/jensen_shannon.cuh
@@ -15,7 +15,8 @@
  */
 
 #pragma once
-#include <raft/util/cuda_utils.cuh>
+#include <raft/core/operators.hpp>            // raft::log
+#include <raft/util/cuda_dev_essentials.cuh>  // DI
 
 namespace raft::distance::detail::ops {
 
@@ -44,7 +45,7 @@ struct jensen_shannon_distance_op {
   // Size of shared memory. This is normally decided by the kernel policy, but
   // some ops such as correlation_distance_op use more.
   template <typename Policy>
-  constexpr size_t shared_mem_size()
+  static constexpr size_t shared_mem_size()
   {
     return Policy::SmemSize;
   }
diff --git a/cpp/include/raft/distance/detail/distance_ops/kl_divergence.cuh b/cpp/include/raft/distance/detail/distance_ops/kl_divergence.cuh
index d046b62c30..d083c5ddcc 100644
--- a/cpp/include/raft/distance/detail/distance_ops/kl_divergence.cuh
+++ b/cpp/include/raft/distance/detail/distance_ops/kl_divergence.cuh
@@ -15,7 +15,8 @@
  */
 
 #pragma once
-#include <raft/util/cuda_utils.cuh>
+#include <raft/core/operators.hpp>            // raft::log
+#include <raft/util/cuda_dev_essentials.cuh>  // DI
 
 namespace raft::distance::detail::ops {
 
@@ -49,7 +50,7 @@ struct kl_divergence_op {
   // Size of shared memory. This is normally decided by the kernel policy, but
   // some ops such as correlation_distance_op use more.
   template <typename Policy>
-  constexpr size_t shared_mem_size()
+  static constexpr size_t shared_mem_size()
   {
     return Policy::SmemSize;
   }
diff --git a/cpp/include/raft/distance/detail/distance_ops/l1.cuh b/cpp/include/raft/distance/detail/distance_ops/l1.cuh
index 8ec4000827..7e86fd3603 100644
--- a/cpp/include/raft/distance/detail/distance_ops/l1.cuh
+++ b/cpp/include/raft/distance/detail/distance_ops/l1.cuh
@@ -15,7 +15,7 @@
  */
 
 #pragma once
-#include <raft/util/cuda_utils.cuh>
+#include <raft/util/cuda_dev_essentials.cuh>  // DI
 
 namespace raft::distance::detail::ops {
 
@@ -41,7 +41,7 @@ struct l1_distance_op {
   // Size of shared memory. This is normally decided by the kernel policy, but
   // some ops such as correlation_distance_op use more.
   template <typename Policy>
-  constexpr size_t shared_mem_size()
+  static constexpr size_t shared_mem_size()
   {
     return Policy::SmemSize;
   }
diff --git a/cpp/include/raft/distance/detail/distance_ops/l2_exp.cuh b/cpp/include/raft/distance/detail/distance_ops/l2_exp.cuh
index 2a7af53813..95577fd311 100644
--- a/cpp/include/raft/distance/detail/distance_ops/l2_exp.cuh
+++ b/cpp/include/raft/distance/detail/distance_ops/l2_exp.cuh
@@ -16,7 +16,7 @@
 
 #pragma once
 
-#include <raft/util/cuda_utils.cuh>
+#include <raft/util/cuda_dev_essentials.cuh>  // DI
 
 namespace raft::distance::detail::ops {
 
@@ -54,7 +54,7 @@ struct l2_exp_distance_op {
   using AccT  = AccType;
   using IdxT  = IdxType;
 
-  bool sqrt;
+  const bool sqrt;
 
   l2_exp_distance_op(bool sqrt_) noexcept : sqrt(sqrt_) {}
 
@@ -67,7 +67,7 @@ struct l2_exp_distance_op {
   // Size of shared memory. This is normally decided by the kernel policy, but
   // some ops such as correlation_distance_op use more.
   template <typename Policy>
-  constexpr size_t shared_mem_size()
+  static constexpr size_t shared_mem_size()
   {
     return Policy::SmemSize + ((Policy::Mblk + Policy::Nblk) * sizeof(DataT));
   }
@@ -102,7 +102,10 @@ struct l2_exp_distance_op {
     }
   }
 
-  l2_exp_cutlass_op<DataT, AccT> get_cutlass_op() { return l2_exp_cutlass_op<DataT, AccT>(sqrt); }
+  constexpr l2_exp_cutlass_op<DataT, AccT> get_cutlass_op() const
+  {
+    return l2_exp_cutlass_op<DataT, AccT>(sqrt);
+  }
 };
 
 }  // namespace raft::distance::detail::ops
diff --git a/cpp/include/raft/distance/detail/distance_ops/l2_unexp.cuh b/cpp/include/raft/distance/detail/distance_ops/l2_unexp.cuh
index f0ea591eaf..62c212ee8f 100644
--- a/cpp/include/raft/distance/detail/distance_ops/l2_unexp.cuh
+++ b/cpp/include/raft/distance/detail/distance_ops/l2_unexp.cuh
@@ -16,7 +16,7 @@
 
 #pragma once
 
-#include <raft/util/cuda_utils.cuh>
+#include <raft/util/cuda_dev_essentials.cuh>  // DI
 
 namespace raft::distance::detail::ops {
 
@@ -46,7 +46,7 @@ struct l2_unexp_distance_op {
   // Size of shared memory. This is normally decided by the kernel policy, but
   // some ops such as correlation_distance_op use more.
   template <typename Policy>
-  constexpr size_t shared_mem_size()
+  static constexpr size_t shared_mem_size()
   {
     return Policy::SmemSize;
   }
diff --git a/cpp/include/raft/distance/detail/distance_ops/l_inf.cuh b/cpp/include/raft/distance/detail/distance_ops/l_inf.cuh
index fb21fb1a21..88853a3083 100644
--- a/cpp/include/raft/distance/detail/distance_ops/l_inf.cuh
+++ b/cpp/include/raft/distance/detail/distance_ops/l_inf.cuh
@@ -16,7 +16,7 @@
 
 #pragma once
 
-#include <raft/util/cuda_utils.cuh>
+#include <raft/util/cuda_dev_essentials.cuh>  // DI
 
 namespace raft::distance::detail::ops {
 
@@ -42,7 +42,7 @@ struct l_inf_distance_op {
   // Size of shared memory. This is normally decided by the kernel policy, but
   // some ops such as correlation_distance_op use more.
   template <typename Policy>
-  constexpr size_t shared_mem_size()
+  static constexpr size_t shared_mem_size()
   {
     return Policy::SmemSize;
   }
diff --git a/cpp/include/raft/distance/detail/distance_ops/lp_unexp.cuh b/cpp/include/raft/distance/detail/distance_ops/lp_unexp.cuh
index 71dfd51a6e..290f4af1b4 100644
--- a/cpp/include/raft/distance/detail/distance_ops/lp_unexp.cuh
+++ b/cpp/include/raft/distance/detail/distance_ops/lp_unexp.cuh
@@ -15,7 +15,8 @@
  */
 
 #pragma once
-#include <raft/util/cuda_utils.cuh>
+#include <raft/core/operators.hpp>            // raft::pow, raft::abs
+#include <raft/util/cuda_dev_essentials.cuh>  // DI
 
 namespace raft::distance::detail::ops {
 
@@ -45,7 +46,7 @@ struct lp_unexp_distance_op {
   // Size of shared memory. This is normally decided by the kernel policy, but
   // some ops such as correlation_distance_op use more.
   template <typename Policy>
-  constexpr size_t shared_mem_size()
+  static constexpr size_t shared_mem_size()
   {
     return Policy::SmemSize;
   }
diff --git a/cpp/include/raft/distance/detail/distance_ops/russel_rao.cuh b/cpp/include/raft/distance/detail/distance_ops/russel_rao.cuh
index ea09e4d1db..63dbf350d1 100644
--- a/cpp/include/raft/distance/detail/distance_ops/russel_rao.cuh
+++ b/cpp/include/raft/distance/detail/distance_ops/russel_rao.cuh
@@ -16,7 +16,7 @@
 
 #pragma once
 
-#include <raft/util/cuda_utils.cuh>
+#include <raft/util/cuda_dev_essentials.cuh>  // DI
 
 namespace raft::distance::detail::ops {
 
@@ -47,7 +47,7 @@ struct russel_rao_distance_op {
   // Size of shared memory. This is normally decided by the kernel policy, but
   // some ops such as correlation_distance_op use more.
   template <typename Policy>
-  constexpr size_t shared_mem_size()
+  static constexpr size_t shared_mem_size()
   {
     return Policy::SmemSize;
   }
diff --git a/cpp/include/raft/distance/detail/distance_ops/template.cuh b/cpp/include/raft/distance/detail/distance_ops/template.cuh
index 6998f3cad4..4320068361 100644
--- a/cpp/include/raft/distance/detail/distance_ops/template.cuh
+++ b/cpp/include/raft/distance/detail/distance_ops/template.cuh
@@ -16,7 +16,7 @@
 
 #pragma once
 
-#include <raft/util/cuda_utils.cuh>
+#include <raft/util/cuda_dev_essentials.cuh>  // DI
 
 namespace raft::distance::detail::ops {
 
@@ -42,8 +42,8 @@ struct template_distance_op {
 
   // Size of shared memory. This is normally decided by the kernel policy, but
   // some ops such as correlation_distance_op use more.
-  template <typename Policy, typename DataT>
-  constexpr size_t shared_mem_size()
+  template <typename Policy>
+  static constexpr size_t shared_mem_size()
   {
     return Policy::SmemSize + TODO;
   }
@@ -59,6 +59,10 @@ struct template_distance_op {
   {
     TODO;
   }
+
+  // If exist, returns a cutlass op that performs the same operation.
+  // See cosine and l2_exp distance ops for an example.
+  constexpr l2_exp_cutlass_op<DataT, AccT> get_cutlass_op() const { TODO; }
 };
 
 }  // namespace raft::distance::detail::ops
diff --git a/cpp/include/raft/distance/detail/fused_l2_nn.cuh b/cpp/include/raft/distance/detail/fused_l2_nn.cuh
index 8fbd7a9c69..be6fed9f10 100644
--- a/cpp/include/raft/distance/detail/fused_l2_nn.cuh
+++ b/cpp/include/raft/distance/detail/fused_l2_nn.cuh
@@ -16,23 +16,20 @@
 
 #pragma once
 
-#include <limits>
-#include <raft/core/kvp.hpp>
-#include <raft/distance/detail/pairwise_distance_base.cuh>
-#include <raft/linalg/contractions.cuh>
-#include <raft/util/cuda_utils.cuh>
-#include <stdint.h>
+#include <cstddef>                                          // size_t
+#include <limits>                                           // std::numeric_limits
+#include <raft/core/kvp.hpp>                                // raft::KeyValuePair
+#include <raft/core/operators.hpp>                          // raft::identity_op
+#include <raft/distance/detail/distance_ops/l2_exp.cuh>     // ops::l2_exp_distance_op
+#include <raft/distance/detail/pairwise_distance_base.cuh>  // PairwiseDistances
+#include <raft/linalg/contractions.cuh>                     // Policy
+#include <raft/util/cuda_utils.cuh>                         // raft::ceildiv, raft::shfl
 
 namespace raft {
 namespace distance {
 
 namespace detail {
 
-#if (ENABLE_MEMCPY_ASYNC == 1)
-#include <cuda_pipeline.h>
-using namespace nvcuda::experimental;
-#endif
-
 template <typename LabelT, typename DataT>
 struct KVPMinReduceImpl {
   typedef raft::KeyValuePair<LabelT, DataT> KVP;
@@ -124,11 +121,10 @@ DI void updateReducedVal(
 template <typename DataT,
           typename OutT,
           typename IdxT,
-          bool Sqrt,
           typename P,
           typename ReduceOpT,
           typename KVPReduceOpT,
-          typename CoreLambda,
+          typename OpT,
           typename FinalLambda>
 __global__ __launch_bounds__(P::Nthreads, 2) void fusedL2NNkernel(OutT* min,
                                                                   const DataT* x,
@@ -142,7 +138,7 @@ __global__ __launch_bounds__(P::Nthreads, 2) void fusedL2NNkernel(OutT* min,
                                                                   int* mutex,
                                                                   ReduceOpT redOp,
                                                                   KVPReduceOpT pairRedOp,
-                                                                  CoreLambda core_op,
+                                                                  OpT distance_op,
                                                                   FinalLambda fin_op)
 {
   extern __shared__ char smem[];
@@ -163,24 +159,6 @@ __global__ __launch_bounds__(P::Nthreads, 2) void fusedL2NNkernel(OutT* min,
                          IdxT gridStrideY) {
     KVPReduceOpT pairRed_op(pairRedOp);
 
-#pragma unroll
-    for (int i = 0; i < P::AccRowsPerTh; ++i) {
-#pragma unroll
-      for (int j = 0; j < P::AccColsPerTh; ++j) {
-        acc[i][j] = regxn[i] + regyn[j] - (DataT)2.0 * acc[i][j];
-      }
-    }
-    if (Sqrt) {
-#pragma unroll
-      for (int i = 0; i < P::AccRowsPerTh; ++i) {
-#pragma unroll
-        for (int j = 0; j < P::AccColsPerTh; ++j) {
-          auto acc_ij = acc[i][j];
-          acc[i][j]   = acc_ij > DataT{0} ? raft::sqrt(acc_ij) : DataT{0};
-        }
-      }
-    }
-
     // intra thread reduce
     const auto acccolid = threadIdx.x % P::AccThCols;
     const auto accrowid = threadIdx.x / P::AccThCols;
@@ -229,18 +207,18 @@ __global__ __launch_bounds__(P::Nthreads, 2) void fusedL2NNkernel(OutT* min,
     };
 
   IdxT lda = k, ldb = k, ldd = n;
-  PairwiseDistances<true,
-                    DataT,
-                    DataT,
-                    DataT,
+  constexpr bool row_major = true;
+  constexpr bool write_out = false;
+  PairwiseDistances<DataT,
+                    DataT,  // OutT (unused in PairwiseDistances)
                     IdxT,
                     P,
-                    CoreLambda,
+                    decltype(distance_op),
                     decltype(epilog_lambda),
                     FinalLambda,
                     decltype(rowEpilog_lambda),
-                    true,
-                    false>
+                    row_major,
+                    write_out>
     obj(x,
         y,
         m,
@@ -251,9 +229,9 @@ __global__ __launch_bounds__(P::Nthreads, 2) void fusedL2NNkernel(OutT* min,
         ldd,
         xn,
         yn,
-        nullptr,
+        nullptr,  // Output pointer
         smem,
-        core_op,
+        distance_op,
         epilog_lambda,
         fin_op,
         rowEpilog_lambda);
@@ -289,9 +267,6 @@ void fusedL2NNImpl(OutT* min,
   constexpr auto maxVal = std::numeric_limits<DataT>::max();
   typedef KeyValuePair<IdxT, DataT> KVPair;
 
-  // Accumulation operation lambda
-  auto core_lambda = [] __device__(DataT & acc, DataT & x, DataT & y) { acc += x * y; };
-
   RAFT_CUDA_TRY(cudaMemsetAsync(workspace, 0, sizeof(int) * m, stream));
   if (initOutBuffer) {
     initKernel<DataT, OutT, IdxT, ReduceOpT>
@@ -300,59 +275,25 @@ void fusedL2NNImpl(OutT* min,
   }
 
   constexpr size_t shmemSize = P::SmemSize + ((P::Mblk + P::Nblk) * sizeof(DataT));
-  if (sqrt) {
-    auto fusedL2NNSqrt = fusedL2NNkernel<DataT,
-                                         OutT,
-                                         IdxT,
-                                         true,
-                                         P,
-                                         ReduceOpT,
-                                         KVPReduceOpT,
-                                         decltype(core_lambda),
-                                         raft::identity_op>;
-    dim3 grid          = launchConfigGenerator<P>(m, n, shmemSize, fusedL2NNSqrt);
-
-    fusedL2NNSqrt<<<grid, blk, shmemSize, stream>>>(min,
-                                                    x,
-                                                    y,
-                                                    xn,
-                                                    yn,
-                                                    m,
-                                                    n,
-                                                    k,
-                                                    maxVal,
-                                                    workspace,
-                                                    redOp,
-                                                    pairRedOp,
-                                                    core_lambda,
-                                                    raft::identity_op{});
-  } else {
-    auto fusedL2NN = fusedL2NNkernel<DataT,
-                                     OutT,
-                                     IdxT,
-                                     false,
-                                     P,
-                                     ReduceOpT,
-                                     KVPReduceOpT,
-                                     decltype(core_lambda),
-                                     raft::identity_op>;
-    dim3 grid      = launchConfigGenerator<P>(m, n, shmemSize, fusedL2NN);
-    fusedL2NN<<<grid, blk, shmemSize, stream>>>(min,
-                                                x,
-                                                y,
-                                                xn,
-                                                yn,
-                                                m,
-                                                n,
-                                                k,
-                                                maxVal,
-                                                workspace,
-                                                redOp,
-                                                pairRedOp,
-                                                core_lambda,
-                                                raft::identity_op{});
-  }
 
+  using AccT = DataT;
+  ops::l2_exp_distance_op<DataT, AccT, IdxT> distance_op{sqrt};
+
+  raft::identity_op fin_op{};
+
+  auto kernel = fusedL2NNkernel<DataT,
+                                OutT,
+                                IdxT,
+                                P,
+                                ReduceOpT,
+                                KVPReduceOpT,
+                                decltype(distance_op),
+                                decltype(fin_op)>;
+
+  dim3 grid = launchConfigGenerator<P>(m, n, shmemSize, kernel);
+
+  kernel<<<grid, blk, shmemSize, stream>>>(
+    min, x, y, xn, yn, m, n, k, maxVal, workspace, redOp, pairRedOp, distance_op, fin_op);
   RAFT_CUDA_TRY(cudaGetLastError());
 }
 
diff --git a/cpp/include/raft/distance/detail/pairwise_distance_base.cuh b/cpp/include/raft/distance/detail/pairwise_distance_base.cuh
index 0293f10c29..c6b09be31e 100644
--- a/cpp/include/raft/distance/detail/pairwise_distance_base.cuh
+++ b/cpp/include/raft/distance/detail/pairwise_distance_base.cuh
@@ -14,14 +14,11 @@
  * limitations under the License.
  */
 #pragma once
-#include <raft/core/operators.hpp>
-#include <raft/linalg/contractions.cuh>
-#include <raft/linalg/norm.cuh>
-#include <raft/util/cuda_utils.cuh>
-#include <raft/util/cudart_utils.hpp>
-#include <raft/util/vectorized.cuh>
+#include <raft/linalg/contractions.cuh>       // raft::linalg::Contractions_NT
+#include <raft/util/cuda_dev_essentials.cuh>  // ceildiv
+#include <raft/util/cuda_rt_essentials.hpp>   // RAFT_CUDA_TRY
 
-#include <cstddef>
+#include <cstddef>  // size_t
 
 namespace raft {
 namespace distance {
@@ -29,16 +26,12 @@ namespace detail {
 
 /**
  * @brief Device class for L1, L2 and cosine distance metrics.
- * @tparam useNorms       whether norms are needed
  * @tparam DataT          input data-type (for A and B matrices)
  * @tparam AccT           accumulation data-type
  * @tparam OutT           output data-type (for C and D matrices)
  * @tparam IdxT           index data-type
  * @tparam Policy         struct which tunes the Contraction kernel
- * @tparam CoreLambda     tells how to accumulate an x and y into
-                          acc. its signature:
-    template <typename AccT, typename DataT> void core_lambda(AccT& acc,
-      const DataT& x, const DataT& y)
+ * @tparam OpT            A distance operation, e.g., cosine_distance_op.
  * @tparam EpilogueLambda applies an elementwise function to compute final
     values. Its signature is:
     template <typename AccT, typename DataT> void epilogue_lambda
@@ -56,19 +49,17 @@ namespace detail {
  * @param[in] yn row norms of input matrix B. Required for expanded L2, cosine
  * @param[output] pD output matrix
  * @param[in] smem shared mem buffer for intermediate storage of A, B, xn & yn.
- * @param core_op the core accumulation operation lambda
+ * @param distance_op the distance operation, e.g. cosine_distance_op
  * @param epilog_op the epilog operation lambda
  * @param fin_op the final gemm epilogue lambda
  * @param rowEpilog_op epilog lambda that executes when a full row has been processed
  */
 
-template <bool useNorms,
-          typename DataT,
-          typename AccT,
+template <typename DataT,
           typename OutT,
           typename IdxT,
           typename Policy,
-          typename CoreLambda,
+          typename OpT,
           typename EpilogueLambda,
           typename FinalLambda,
           typename rowEpilogueLambda,
@@ -76,6 +67,9 @@ template <bool useNorms,
           bool writeOut      = true,
           typename BaseClass = raft::linalg::Contractions_NT<DataT, IdxT, Policy, isRowMajor>>
 struct PairwiseDistances : public BaseClass {
+  // Get accumulation type from distance_op
+  using AccT = typename OpT::AccT;
+
  private:
   typedef Policy P;
   const DataT* xn;
@@ -83,7 +77,7 @@ struct PairwiseDistances : public BaseClass {
   const DataT* const yBase;
   OutT* dOutput;
   char* smem;
-  CoreLambda core_op;
+  OpT distance_op;
   EpilogueLambda epilog_op;
   FinalLambda fin_op;
   rowEpilogueLambda rowEpilog_op;
@@ -109,7 +103,7 @@ struct PairwiseDistances : public BaseClass {
                        const DataT* _yn,
                        OutT* _dOutput,
                        char* _smem,
-                       CoreLambda _core_op,
+                       OpT _distance_op,
                        EpilogueLambda _epilog_op,
                        FinalLambda _fin_op,
                        rowEpilogueLambda _rowEpilog_op)
@@ -119,7 +113,7 @@ struct PairwiseDistances : public BaseClass {
       yBase(_y),
       dOutput(_dOutput),
       smem(_smem),
-      core_op(_core_op),
+      distance_op(_distance_op),
       epilog_op(_epilog_op),
       fin_op(_fin_op),
       rowEpilog_op(_rowEpilog_op),
@@ -159,15 +153,25 @@ struct PairwiseDistances : public BaseClass {
         this->switch_read_buffer();
 
         // Epilog:
-        if (useNorms) {
+        if (distance_op.use_norms) {
           DataT regxn[P::AccRowsPerTh], regyn[P::AccColsPerTh];
           load_norms(tile_idx_m, tile_idx_n, regxn, regyn);
           // Overlap ldg with epilog computation
           ldgNextGridStride(tile_idx_m, tile_idx_n);
+          // Calculate distance_op epilog.
+          // Use .template to disambiguate (See:
+          // https://en.cppreference.com/w/cpp/language/dependent_name)
+          distance_op.template epilog<Policy>(acc, regxn, regyn, tile_idx_n, tile_idx_m);
+          // And any possible additional epilogs
           epilog_op(acc, regxn, regyn, tile_idx_n, tile_idx_m);
         } else {
           // Overlap ldg with epilog computation
           ldgNextGridStride(tile_idx_m, tile_idx_n);
+          // Calculate distance_op epilog.
+          // Use .template to disambiguate (See:
+          // https://en.cppreference.com/w/cpp/language/dependent_name)
+          distance_op.template epilog<Policy>(acc, nullptr, nullptr, tile_idx_n, tile_idx_m);
+          // And any possible additional epilogs
           epilog_op(acc, nullptr, nullptr, tile_idx_n, tile_idx_m);
         }
         if (writeOut) { store_output(tile_idx_m, tile_idx_n); }
@@ -201,24 +205,41 @@ struct PairwiseDistances : public BaseClass {
     }
   }
 
-  DI void accumulate()
+  DI void accumulate_reg_tile(DataT (&reg_x)[P::AccRowsPerTh][P::Veclen],
+                              DataT (&reg_y)[P::AccColsPerTh][P::Veclen])
   {
 #pragma unroll
-    for (int ki = 0; ki < P::Kblk; ki += P::Veclen) {
-      this->ldsXY(ki);
+    for (int v = 0; v < P::Veclen; ++v) {
 #pragma unroll
       for (int i = 0; i < P::AccRowsPerTh; ++i) {
 #pragma unroll
         for (int j = 0; j < P::AccColsPerTh; ++j) {
-#pragma unroll
-          for (int v = 0; v < P::Veclen; ++v) {
-            core_op(acc[i][j], this->regx[i][v], this->regy[j][v]);
-          }
+          distance_op.core(acc[i][j], reg_x[i][v], reg_y[j][v]);
         }
       }
     }
   }
 
+  DI void accumulate()
+  {
+    // We have a separate ldsXY and accumulate_reg_tile outside the loop body,
+    // so that these separated calls can be interspersed with preceding and
+    // following instructions, thereby hiding latency.
+    this->ldsXY(0);
+
+    // If expensive inner loop, do not unroll loop.
+    constexpr int num_iterations = P::Kblk / P::Veclen - 1;
+    constexpr int unroll_count   = decltype(distance_op)::expensive_inner_loop ? 1 : num_iterations;
+#pragma unroll unroll_count
+    for (int ki = P::Veclen; ki < P::Kblk; ki += P::Veclen) {
+      accumulate_reg_tile(this->regx, this->regy);
+      this->ldsXY(ki);
+    }
+
+    // Accumulate last loaded tile.
+    accumulate_reg_tile(this->regx, this->regy);
+  }
+
   DI void load_norms(IdxT tile_idx_m,
                      IdxT tile_idx_n,
                      DataT (&regxn)[P::AccRowsPerTh],
@@ -274,7 +295,11 @@ struct PairwiseDistances : public BaseClass {
 template <typename P, typename IdxT, typename T>
 dim3 launchConfigGenerator(IdxT m, IdxT n, std::size_t sMemSize, T func)
 {
-  const auto numSMs  = raft::getMultiProcessorCount();
+  int devId;
+  RAFT_CUDA_TRY(cudaGetDevice(&devId));
+  int numSMs;
+  RAFT_CUDA_TRY(cudaDeviceGetAttribute(&numSMs, cudaDevAttrMultiProcessorCount, devId));
+
   int numBlocksPerSm = 0;
   dim3 grid;
 
diff --git a/cpp/include/raft/distance/detail/pairwise_distance_cutlass_base.cuh b/cpp/include/raft/distance/detail/pairwise_distance_cutlass_base.cuh
index c5fdd28117..efcd5d9389 100644
--- a/cpp/include/raft/distance/detail/pairwise_distance_cutlass_base.cuh
+++ b/cpp/include/raft/distance/detail/pairwise_distance_cutlass_base.cuh
@@ -64,21 +64,20 @@ template <typename DataT,
           typename FinalLambda,
           typename OpT,
           bool isRowMajor>
-typename std::enable_if<ops::has_cutlass_op<OpT>::value>::type cutlassDistanceKernel(
-  const DataT* x,
-  const DataT* y,
-  const DataT* xn,
-  const DataT* yn,
-  IdxT m,
-  IdxT n,
-  IdxT k,
-  IdxT lda,
-  IdxT ldb,
-  IdxT ldd,
-  OutT* dOutput,
-  FinalLambda fin_op,
-  OpT distance_op,
-  cudaStream_t stream)
+std::enable_if_t<ops::has_cutlass_op<OpT>::value> cutlassDistanceKernel(const DataT* x,
+                                                                        const DataT* y,
+                                                                        const DataT* xn,
+                                                                        const DataT* yn,
+                                                                        IdxT m,
+                                                                        IdxT n,
+                                                                        IdxT k,
+                                                                        IdxT lda,
+                                                                        IdxT ldb,
+                                                                        IdxT ldd,
+                                                                        OutT* dOutput,
+                                                                        FinalLambda fin_op,
+                                                                        OpT distance_op,
+                                                                        cudaStream_t stream)
 {
   static_assert(!(std::is_same<OutT, bool>::value),
                 "OutType bool is not supported use uint8_t instead");
diff --git a/cpp/include/raft/distance/detail/pairwise_matrix/dispatch.cuh b/cpp/include/raft/distance/detail/pairwise_matrix/dispatch.cuh
index 8524ce6fdf..e04b56ee8a 100644
--- a/cpp/include/raft/distance/detail/pairwise_matrix/dispatch.cuh
+++ b/cpp/include/raft/distance/detail/pairwise_matrix/dispatch.cuh
@@ -15,63 +15,74 @@
  */
 #pragma once
 
-#include <raft/distance/detail/distance_ops/cutlass.cuh>
-#include <raft/distance/detail/pairwise_matrix/dispatch_layout.cuh>
-#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
-#include <raft/distance/detail/pairwise_matrix/dispatch_sm80.cuh>
-#include <raft/distance/detail/pairwise_matrix/params.cuh>
-#include <raft/linalg/contractions.cuh>
-#include <raft/util/arch.cuh>
-#include <type_traits>
+/* This file has two responsibilities:
+ *
+ * 1. Dispatch to the correct implementation of a kernel based on the
+ *    architecture of the device on which the kernel will be launched. For
+ *    instance, the cosine distance has a CUTLASS-based implementation that can
+ *    be used on SM80+ and the normal implementation that is used on older
+ *    architectures.
+ *
+ * 2. Provide concise function templates that can be instantiated in
+ *    src/distance/distance/specializations/detail/. Previously,
+ *    raft::distance::detail::distance was instantiated. The function
+ *    necessarily required a large set of include files, which slowed down the
+ *    build. The raft::distance::detail::pairwise_matrix_arch_dispatch functions
+ *    do not require as large an include files set, which speeds up the build.
+ */
+
+#include <raft/distance/detail/distance_ops/cutlass.cuh>           // ops::has_cutlass_op
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>  // dispatch_sm60
+#include <raft/distance/detail/pairwise_matrix/params.cuh>         // pairwise_matrix_params
+#include <raft/util/arch.cuh>                                      // raft::util::arch::SM_*
+
+// NOTE: to minimize compile times, we do not include dispatch_sm80.cuh.
+// Including dispatch_sm80.cuh can slow down compile times (due to CUTLASS).
+// Therefore, it is the including file's responsibility to include the correct
+// dispatch_smXX.cuh headers, as is done in raft/distance/detail/distance.cuh
+// and the specializations in src/distance/distance/specializations/detail/.
 
 namespace raft::distance::detail {
 
+// This forward-declaration ensures that we do not need to include
+// dispatch_sm80.cuh if we are not calling it in practice. This makes compiling
+// all the non-CUTLASS based distance specializations faster. For CUTLASS-based
+// distances, dispatch_sm80.cuh has to be included by the file including this
+// file.
 template <typename OpT,
+          typename IdxT,
           typename DataT,
-          typename AccT,
           typename OutT,
           typename FinOpT,
-          typename IdxT = int>
-void pairwise_matrix_dispatch(OpT distance_op,
-                              IdxT m,
-                              IdxT n,
-                              IdxT k,
-                              const DataT* x,
-                              const DataT* y,
-                              const DataT* x_norm,
-                              const DataT* y_norm,
-                              OutT* out,
-                              FinOpT fin_op,
-                              cudaStream_t stream,
-                              bool is_row_major)
-{
-  // Create kernel parameter struct. Flip x and y if column major.
-  IdxT ldx    = is_row_major ? k : m;
-  IdxT ldy    = is_row_major ? k : n;
-  IdxT ld_out = is_row_major ? n : m;
-
-  pairwise_matrix_params<IdxT, DataT, OutT, FinOpT> params{
-    m, n, k, ldx, ldy, ld_out, x, y, x_norm, y_norm, out, fin_op, is_row_major};
-
-  if (!params.is_row_major) { params.flip_x_and_y(); }
+          typename SM_compat_t>
+void pairwise_matrix_sm80_dispatch(OpT,
+                                   pairwise_matrix_params<IdxT, DataT, OutT, FinOpT>,
+                                   SM_compat_t,
+                                   cudaStream_t);
 
+template <typename OpT, typename IdxT, typename DataT, typename OutT, typename FinOpT>
+void pairwise_matrix_instantiation_point(OpT distance_op,
+                                         pairwise_matrix_params<IdxT, DataT, OutT, FinOpT> params,
+                                         cudaStream_t stream)
+{
   // On CUDA 12:
   // - always execute normal kernel
   //
   // On CUDA 11 and below:
   // - execute CUTLASS-based kernel on SM_80 and above
   // - execute normal kernel below SM_80
+  namespace arch = raft::util::arch;
 
   constexpr bool is_ctk_12              = __CUDACC_VER_MAJOR__ == 12;
   constexpr bool cutlass_op_unavailable = !ops::has_cutlass_op<OpT>();
 
   if constexpr (is_ctk_12 || cutlass_op_unavailable) {
     // Always execute legacy kernels on CUDA 12
-    auto any_range = raft::arch::SM_range(raft::arch::SM_min(), raft::arch::SM_future());
+    auto any_range = arch::SM_range(arch::SM_min(), arch::SM_future());
     pairwise_matrix_sm60_dispatch(distance_op, params, any_range, stream);
   } else {
-    auto cutlass_range = raft::arch::SM_range(raft::arch::SM_80(), raft::arch::SM_future());
-    auto legacy_range  = raft::arch::SM_range(raft::arch::SM_min(), raft::arch::SM_80());
+    auto cutlass_range = arch::SM_range(arch::SM_80(), arch::SM_future());
+    auto legacy_range  = arch::SM_range(arch::SM_min(), arch::SM_80());
 
     // Get pointer to SM60 kernel to determine the runtime architecture of the
     // current system. Other methods to determine the architecture (that do not
@@ -79,7 +90,7 @@ void pairwise_matrix_dispatch(OpT distance_op,
     // https://github.com/NVIDIA/cub/issues/545
     auto sm60_wrapper = pairwise_matrix_sm60_get_wrapper(distance_op, params, legacy_range);
     void* kernel_ptr  = reinterpret_cast<void*>(sm60_wrapper.kernel_ptr);
-    auto runtime_arch = raft::arch::kernel_runtime_arch(kernel_ptr);
+    auto runtime_arch = arch::kernel_runtime_arch(kernel_ptr);
 
     if (cutlass_range.contains(runtime_arch)) {
       // If device is SM_80 or later, use CUTLASS-based kernel.
@@ -92,4 +103,35 @@ void pairwise_matrix_dispatch(OpT distance_op,
   }
 }
 
+template <typename OpT,
+          typename DataT,
+          typename AccT,
+          typename OutT,
+          typename FinOpT,
+          typename IdxT = int>
+void pairwise_matrix_dispatch(OpT distance_op,
+                              IdxT m,
+                              IdxT n,
+                              IdxT k,
+                              const DataT* x,
+                              const DataT* y,
+                              const DataT* x_norm,
+                              const DataT* y_norm,
+                              OutT* out,
+                              FinOpT fin_op,
+                              cudaStream_t stream,
+                              bool is_row_major)
+{
+  // Create kernel parameter struct. Flip x and y if column major.
+  IdxT ldx    = is_row_major ? k : m;
+  IdxT ldy    = is_row_major ? k : n;
+  IdxT ld_out = is_row_major ? n : m;
+
+  pairwise_matrix_params<IdxT, DataT, OutT, FinOpT> params{
+    m, n, k, ldx, ldy, ld_out, x, y, x_norm, y_norm, out, fin_op, is_row_major};
+
+  if (!params.is_row_major) { params.flip_x_and_y(); }
+  pairwise_matrix_instantiation_point(distance_op, params, stream);
+}
+
 };  // namespace raft::distance::detail
diff --git a/cpp/include/raft/distance/detail/pairwise_matrix/dispatch_layout.cuh b/cpp/include/raft/distance/detail/pairwise_matrix/dispatch_layout.cuh
index c1e4c08af4..f2b0e59822 100644
--- a/cpp/include/raft/distance/detail/pairwise_matrix/dispatch_layout.cuh
+++ b/cpp/include/raft/distance/detail/pairwise_matrix/dispatch_layout.cuh
@@ -15,10 +15,11 @@
  */
 #pragma once
 
-#include "kernel_sm60.cuh"
-#include <algorithm>
-#include <type_traits>
-
+#include <algorithm>                                        // std::min
+#include <cstdint>                                          // size_t
+#include <raft/core/error.hpp>                              // RAFT_EXPECTS
+#include <raft/distance/detail/pairwise_matrix/params.cuh>  // pairwise_matrix_params
+#include <type_traits>                                      // std::integral_constant
 namespace raft::distance::detail {
 
 /**
@@ -99,15 +100,15 @@ auto dispatch_layout(bool row_major, int vec_len, F&& f)
 {
   if (row_major) {
     switch (vec_len) {
-      case 4: return f(std::bool_constant<true>(), vec_len_constant<4>());
-      case 2: return f(std::bool_constant<true>(), vec_len_constant<2>());
-      default: return f(std::bool_constant<true>(), vec_len_constant<1>());
+      case 4: return f(std::true_type(), vec_len_constant<4>());
+      case 2: return f(std::true_type(), vec_len_constant<2>());
+      default: return f(std::true_type(), vec_len_constant<1>());
     }
   } else {
     switch (vec_len) {
-      case 4: return f(std::bool_constant<false>(), vec_len_constant<4>());
-      case 2: return f(std::bool_constant<false>(), vec_len_constant<2>());
-      default: return f(std::bool_constant<false>(), vec_len_constant<1>());
+      case 4: return f(std::false_type(), vec_len_constant<4>());
+      case 2: return f(std::false_type(), vec_len_constant<2>());
+      default: return f(std::false_type(), vec_len_constant<1>());
     }
   }
 }
diff --git a/cpp/include/raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh b/cpp/include/raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh
index 6e284007ea..2080fbe9cd 100644
--- a/cpp/include/raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh
+++ b/cpp/include/raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh
@@ -15,10 +15,10 @@
  */
 #pragma once
 
-#include <algorithm>
-#include <raft/distance/detail/pairwise_matrix/dispatch_layout.cuh>
-#include <raft/distance/detail/pairwise_matrix/kernel_sm60.cuh>
-#include <raft/linalg/contractions.cuh>
+#include <algorithm>                                                 // std::min
+#include <raft/distance/detail/pairwise_matrix/dispatch_layout.cuh>  // dispatch_layout
+#include <raft/distance/detail/pairwise_matrix/kernel_sm60.cuh>      // pairwise_matrix_sm60_wrapper
+#include <raft/linalg/contractions.cuh>                              // raft::linalg::Policy4x4
 
 namespace raft::distance::detail {
 
@@ -35,7 +35,11 @@ pairwise_matrix_sm60_wrapper<OpT, IdxT, DataT, OutT, FinOpT> pairwise_matrix_sm6
 {
   int vec_len = determine_vec_len(params);
 
-  return dispatch_layout(params.is_row_major, vec_len, [&](auto row_major, auto vec_len_aligned) {
+  // f takes compile-time constants row_major and vec_len aligned and returns
+  // the corresponding kernel wrapper. The wrapper contains the launch
+  // parameters of the kernel: a pointer to the kernel function, grid size,
+  // block size, and shared memory size.
+  auto f = [&](auto row_major, auto vec_len_aligned) {
     // row_major and vec_len are std::integral_constants of type bool and int
     // respectively.
 
@@ -46,15 +50,19 @@ pairwise_matrix_sm60_wrapper<OpT, IdxT, DataT, OutT, FinOpT> pairwise_matrix_sm6
     // Prevent double, vec_len=4 combination (this is not supported)
     constexpr int vec_len = std::min(vec_len_op, static_cast<int>(16 / sizeof(DataT)));
 
-    typedef typename raft::linalg::Policy4x4<DataT, vec_len>::Policy RowPolicy;
-    typedef typename raft::linalg::Policy4x4<DataT, vec_len>::ColPolicy ColPolicy;
-    typedef typename std::conditional<row_major(), RowPolicy, ColPolicy>::type Policy;
+    using RowPolicy = typename raft::linalg::Policy4x4<DataT, vec_len>::Policy;
+    using ColPolicy = typename raft::linalg::Policy4x4<DataT, vec_len>::ColPolicy;
+    using Policy    = typename std::conditional<row_major(), RowPolicy, ColPolicy>::type;
 
     auto wrapper =
       make_pairwise_matrix_sm60_wrapper<Policy, row_major()>(distance_op, params, sm_compat_range);
 
     return wrapper;
-  });
+  };
+
+  // Dispatch_layout calls f with appropriate compile time constants based on
+  // the runtime values of params.is_row_major and vec_len.
+  return dispatch_layout(params.is_row_major, vec_len, f);
 }
 
 template <typename OpT,
diff --git a/cpp/include/raft/distance/detail/pairwise_matrix/dispatch_sm80.cuh b/cpp/include/raft/distance/detail/pairwise_matrix/dispatch_sm80.cuh
index ec2d522c25..dc30f2f239 100644
--- a/cpp/include/raft/distance/detail/pairwise_matrix/dispatch_sm80.cuh
+++ b/cpp/include/raft/distance/detail/pairwise_matrix/dispatch_sm80.cuh
@@ -15,9 +15,9 @@
  */
 #pragma once
 
-#include <algorithm>  // std::min
-#include <raft/distance/detail/pairwise_distance_cutlass_base.cuh>
-#include <raft/distance/detail/pairwise_matrix/dispatch_layout.cuh>
+#include <algorithm>                                                 // std::min
+#include <raft/distance/detail/pairwise_distance_cutlass_base.cuh>   // cutlassDistanceKernel
+#include <raft/distance/detail/pairwise_matrix/dispatch_layout.cuh>  // dispatch_layout
 
 namespace raft::distance::detail {
 
@@ -34,7 +34,9 @@ void pairwise_matrix_sm80_dispatch(OpT distance_op,
 {
   int vec_len = determine_vec_len(params);
 
-  dispatch_layout(params.is_row_major, vec_len, [&](auto row_major, auto vec_len_aligned) {
+  // f takes compile-time constants row_major and vec_len aligned and runs the
+  // corresponding cutlass launch code.
+  auto f = [&](auto row_major, auto vec_len_aligned) {
     // row_major and vec_len are std::integral_constants of type bool and int
     // respectively.
 
@@ -56,7 +58,11 @@ void pairwise_matrix_sm80_dispatch(OpT distance_op,
                                                                                       params.fin_op,
                                                                                       distance_op,
                                                                                       stream);
-  });
+  };
+
+  // Dispatch_layout calls f with appropriate compile time constants based on
+  // the runtime values of params.is_row_major and vec_len.
+  dispatch_layout(params.is_row_major, vec_len, f);
 }
 
 };  // namespace raft::distance::detail
diff --git a/cpp/include/raft/distance/detail/pairwise_matrix/kernel_sm60.cuh b/cpp/include/raft/distance/detail/pairwise_matrix/kernel_sm60.cuh
index 6e3ab7b26b..2d0a98862e 100644
--- a/cpp/include/raft/distance/detail/pairwise_matrix/kernel_sm60.cuh
+++ b/cpp/include/raft/distance/detail/pairwise_matrix/kernel_sm60.cuh
@@ -15,11 +15,11 @@
  */
 #pragma once
 
-#include <cstddef>
-#include <raft/core/operators.hpp>
-#include <raft/distance/detail/pairwise_distance_base.cuh>
-#include <raft/distance/detail/pairwise_matrix/params.cuh>
-#include <raft/util/arch.cuh>
+#include <cassert>                                          // assert
+#include <raft/core/operators.hpp>                          // raft::void_op
+#include <raft/distance/detail/pairwise_distance_base.cuh>  // PairwiseDistances
+#include <raft/distance/detail/pairwise_matrix/params.cuh>  // pairwise_matrix_params
+#include <raft/util/arch.cuh>                               // raft::util::arch::SM_compute_arch
 
 namespace raft::distance::detail {
 
@@ -36,43 +36,27 @@ __global__ __launch_bounds__(Policy::Nthreads, 2) void pairwise_matrix_kernel(
 {
   // Early exit to minimize the size of the kernel when it is not supposed to be compiled.
   constexpr SM_compat_t sm_compat_range{};
-  if constexpr (!sm_compat_range.contains(raft::arch::SM_compute_arch())) {
+  if constexpr (!sm_compat_range.contains(raft::util::arch::SM_compute_arch())) {
     assert(false);
     return;
   }
 
   extern __shared__ char smem[];
 
-  using AccT = typename OpT::AccT;
-
-  // Wrap operator back into lambdas. This is temporary and should be removed.
-  // See: https://github.com/rapidsai/raft/issues/1323
-  auto core_op = [distance_op] __device__(AccT & acc, DataT & x, DataT & y) {
-    distance_op.core(acc, x, y);
-  };
-  auto epilog_op = [distance_op] __device__(AccT acc[Policy::AccRowsPerTh][Policy::AccColsPerTh],
-                                            DataT * regxn,
-                                            DataT * regyn,
-                                            IdxT gridStrideX,
-                                            IdxT gridStrideY) {
-    // Use .template to disambiguate (See:
-    // https://en.cppreference.com/w/cpp/language/dependent_name)
-    distance_op.template epilog<Policy>(acc, regxn, regyn, gridStrideX, gridStrideY);
-  };
-
+  // The epilog is already provided by distance_op. Do not provide additional
+  // epilogs.
+  auto epilog_op = raft::void_op();
   // No support for row_epilog_op.
   auto row_epilog_op = raft::void_op();
 
   // Always write output
   constexpr bool write_out = true;
   constexpr bool use_norms = distance_op.use_norms;
-  PairwiseDistances<use_norms,
-                    DataT,
-                    AccT,
+  PairwiseDistances<DataT,
                     OutT,
                     IdxT,
                     Policy,
-                    decltype(core_op),
+                    decltype(distance_op),
                     decltype(epilog_op),
                     decltype(params.fin_op),
                     decltype(row_epilog_op),
@@ -90,38 +74,13 @@ __global__ __launch_bounds__(Policy::Nthreads, 2) void pairwise_matrix_kernel(
         params.y_norm,
         params.out,
         smem,
-        core_op,
+        distance_op,
         epilog_op,
         params.fin_op,
         row_epilog_op);
   obj.run();
 }
 
-template <typename Policy,
-          bool row_major,
-          typename SM_compat_t,
-          typename OpT,
-          typename IdxT,
-          typename DataT,
-          typename OutT,
-          typename FinOpT>
-void pairwise_matrix(OpT distance_op,
-                     pairwise_matrix_params<IdxT, DataT, OutT, FinOpT> params,
-                     cudaStream_t stream)
-{
-  dim3 blk(Policy::Nthreads);
-  // Use .template to disambiguate (See:
-  // https://en.cppreference.com/w/cpp/language/dependent_name)
-  size_t smem_size = distance_op.template shared_mem_size<Policy>();
-  // Obtain function pointer to kernel
-  auto kernel =
-    pairwise_matrix_kernel<Policy, row_major, SM_compat_t, OpT, IdxT, DataT, OutT, FinOpT>;
-  dim3 grid = launchConfigGenerator<Policy>(params.m, params.n, smem_size, kernel);
-
-  kernel<<<grid, blk, smem_size, stream>>>(distance_op, params);
-  RAFT_CUDA_TRY(cudaGetLastError());
-}
-
 // The type of a pointer to the pairwise matrix kernel. The following template
 // arguments are type-erased:
 //
@@ -181,9 +140,9 @@ pairwise_matrix_sm60_wrapper<OpT, IdxT, DataT, OutT, FinOpT> make_pairwise_matri
   SM_compat_t sm_compat_range)
 {
   dim3 block(Policy::Nthreads);
-  // Use .template to disambiguate (See:
+  // Use ::template to disambiguate (See:
   // https://en.cppreference.com/w/cpp/language/dependent_name)
-  int smem_size = distance_op.template shared_mem_size<Policy>();
+  int smem_size = OpT::template shared_mem_size<Policy>();
   // Obtain function pointer to kernel
   auto kernel =
     pairwise_matrix_kernel<Policy, row_major, SM_compat_t, OpT, IdxT, DataT, OutT, FinOpT>;
diff --git a/cpp/include/raft/distance/specializations/detail/00_write_template.py b/cpp/include/raft/distance/specializations/detail/00_write_template.py
new file mode 100644
index 0000000000..63ae6580b4
--- /dev/null
+++ b/cpp/include/raft/distance/specializations/detail/00_write_template.py
@@ -0,0 +1,148 @@
+#!/usr/bin/env python3
+
+# This template manages all files in this directory, apart from
+# inner_product.cuh and kernels.cuh.
+
+
+# NOTE: this template is not perfectly formatted. Use pre-commit to get
+# everything in shape again.
+start_template = """/*
+ * Copyright (c) 2021-2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#pragma once
+
+#include <raft/distance/detail/distance.cuh>
+
+namespace raft::distance::detail {
+
+"""
+
+extern_template = """
+extern template void pairwise_matrix_instantiation_point<OpT,
+                                                         IdxT,
+                                                         DataT,
+                                                         OutT,
+                                                         FinopT>(
+  OpT,
+  pairwise_matrix_params<IdxT, DataT, OutT, FinopT>,
+  cudaStream_t);
+"""
+
+end_template = """}  // namespace raft::distance::detail
+"""
+
+data_type_instances = [
+    dict(
+        DataT="float",
+        AccT="float",
+        OutT="float",
+        IdxT="int",
+    ),
+    dict(
+        DataT="double",
+        AccT="double",
+        OutT="double",
+        IdxT="int",
+    ),
+]
+
+
+
+
+op_instances = [
+    dict(
+        path_prefix="canberra",
+        OpT="ops::canberra_distance_op<DataT, AccT, IdxT>",
+    ),
+    dict(
+        path_prefix="correlation",
+        OpT="ops::correlation_distance_op<DataT, AccT, IdxT>",
+    ),
+    dict(
+        path_prefix="cosine",
+        OpT="ops::cosine_distance_op<DataT, AccT, IdxT>",
+        # cosine uses CUTLASS for SM80+
+    ),
+    dict(
+        path_prefix="hamming_unexpanded",
+        OpT="ops::hamming_distance_op<DataT, AccT, IdxT>",
+    ),
+    dict(
+        path_prefix="hellinger_expanded",
+        OpT="ops::hellinger_distance_op<DataT, AccT, IdxT>",
+    ),
+    # inner product is handled by cublas.
+    dict(
+        path_prefix="jensen_shannon",
+        OpT="ops::jensen_shannon_distance_op<DataT, AccT, IdxT>",
+    ),
+    dict(
+        path_prefix="kl_divergence",
+        OpT="ops::kl_divergence_op<DataT, AccT, IdxT>",
+    ),
+    dict(
+        path_prefix="l1",
+        OpT="ops::l1_distance_op<DataT, AccT, IdxT>",
+    ),
+    dict(
+        path_prefix="l2_expanded",
+        OpT="ops::l2_exp_distance_op<DataT, AccT, IdxT>",
+        # L2 expanded uses CUTLASS for SM80+
+    ),
+    dict(
+        path_prefix="l2_unexpanded",
+        OpT="ops::l2_unexp_distance_op<DataT, AccT, IdxT>",
+    ),
+    dict(
+        path_prefix="l_inf",
+        OpT="ops::l_inf_distance_op<DataT, AccT, IdxT>",
+    ),
+    dict(
+        path_prefix="lp_unexpanded",
+        OpT="ops::lp_unexp_distance_op<DataT, AccT, IdxT>",
+    ),
+    dict(
+        path_prefix="russel_rao",
+        OpT="ops::russel_rao_distance_op<DataT, AccT, IdxT>",
+    ),
+]
+
+def fill_in(s, template):
+    for k, v in template.items():
+        s = s.replace(k, v)
+    return s
+
+for op_instance in op_instances:
+    path = fill_in("path_prefix.cuh", op_instance)
+    with open(path, "w") as f:
+        f.write(start_template)
+
+        for data_type_instance in data_type_instances:
+            op_data_instance = {
+                k : fill_in(v, data_type_instance)
+                for k, v in op_instance.items()
+            }
+            instance = {
+                **op_data_instance,
+                **data_type_instance,
+                "FinopT": "raft::identity_op",
+            }
+
+            text = fill_in(extern_template, instance)
+
+            f.write(text)
+
+        f.write(end_template)
diff --git a/cpp/include/raft/distance/specializations/detail/canberra.cuh b/cpp/include/raft/distance/specializations/detail/canberra.cuh
index badce715a5..276c85e5f6 100644
--- a/cpp/include/raft/distance/specializations/detail/canberra.cuh
+++ b/cpp/include/raft/distance/specializations/detail/canberra.cuh
@@ -16,37 +16,25 @@
 
 #pragma once
 
-#include <cstdint>
 #include <raft/distance/detail/distance.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-extern template void distance<raft::distance::DistanceType::Canberra, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-extern template void distance<raft::distance::DistanceType::Canberra, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+extern template void pairwise_matrix_instantiation_point<
+  ops::canberra_distance_op<float, float, int>,
+  int,
+  float,
+  float,
+  raft::identity_op>(ops::canberra_distance_op<float, float, int>,
+                     pairwise_matrix_params<int, float, float, raft::identity_op>,
+                     cudaStream_t);
+
+extern template void pairwise_matrix_instantiation_point<
+  ops::canberra_distance_op<double, double, int>,
+  int,
+  double,
+  double,
+  raft::identity_op>(ops::canberra_distance_op<double, double, int>,
+                     pairwise_matrix_params<int, double, double, raft::identity_op>,
+                     cudaStream_t);
+}  // namespace raft::distance::detail
diff --git a/cpp/include/raft/distance/specializations/detail/correlation.cuh b/cpp/include/raft/distance/specializations/detail/correlation.cuh
index 013a0d43a3..f019f678df 100644
--- a/cpp/include/raft/distance/specializations/detail/correlation.cuh
+++ b/cpp/include/raft/distance/specializations/detail/correlation.cuh
@@ -18,36 +18,23 @@
 
 #include <raft/distance/detail/distance.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-extern template void
-distance<raft::distance::DistanceType::CorrelationExpanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-extern template void
-distance<raft::distance::DistanceType::CorrelationExpanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+extern template void pairwise_matrix_instantiation_point<
+  ops::correlation_distance_op<float, float, int>,
+  int,
+  float,
+  float,
+  raft::identity_op>(ops::correlation_distance_op<float, float, int>,
+                     pairwise_matrix_params<int, float, float, raft::identity_op>,
+                     cudaStream_t);
+
+extern template void pairwise_matrix_instantiation_point<
+  ops::correlation_distance_op<double, double, int>,
+  int,
+  double,
+  double,
+  raft::identity_op>(ops::correlation_distance_op<double, double, int>,
+                     pairwise_matrix_params<int, double, double, raft::identity_op>,
+                     cudaStream_t);
+}  // namespace raft::distance::detail
diff --git a/cpp/include/raft/distance/specializations/detail/cosine.cuh b/cpp/include/raft/distance/specializations/detail/cosine.cuh
index c88bd1b0f6..dcde4ec286 100644
--- a/cpp/include/raft/distance/specializations/detail/cosine.cuh
+++ b/cpp/include/raft/distance/specializations/detail/cosine.cuh
@@ -18,36 +18,23 @@
 
 #include <raft/distance/detail/distance.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-extern template void
-distance<raft::distance::DistanceType::CosineExpanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-extern template void
-distance<raft::distance::DistanceType::CosineExpanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+extern template void pairwise_matrix_instantiation_point<ops::cosine_distance_op<float, float, int>,
+                                                         int,
+                                                         float,
+                                                         float,
+                                                         raft::identity_op>(
+  ops::cosine_distance_op<float, float, int>,
+  pairwise_matrix_params<int, float, float, raft::identity_op>,
+  cudaStream_t);
+
+extern template void pairwise_matrix_instantiation_point<
+  ops::cosine_distance_op<double, double, int>,
+  int,
+  double,
+  double,
+  raft::identity_op>(ops::cosine_distance_op<double, double, int>,
+                     pairwise_matrix_params<int, double, double, raft::identity_op>,
+                     cudaStream_t);
+}  // namespace raft::distance::detail
diff --git a/cpp/include/raft/distance/specializations/detail/hamming_unexpanded.cuh b/cpp/include/raft/distance/specializations/detail/hamming_unexpanded.cuh
index 3c5cad3315..1d6964fbce 100644
--- a/cpp/include/raft/distance/specializations/detail/hamming_unexpanded.cuh
+++ b/cpp/include/raft/distance/specializations/detail/hamming_unexpanded.cuh
@@ -18,36 +18,23 @@
 
 #include <raft/distance/detail/distance.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-extern template void
-distance<raft::distance::DistanceType::HammingUnexpanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-extern template void
-distance<raft::distance::DistanceType::HammingUnexpanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+extern template void pairwise_matrix_instantiation_point<
+  ops::hamming_distance_op<float, float, int>,
+  int,
+  float,
+  float,
+  raft::identity_op>(ops::hamming_distance_op<float, float, int>,
+                     pairwise_matrix_params<int, float, float, raft::identity_op>,
+                     cudaStream_t);
+
+extern template void pairwise_matrix_instantiation_point<
+  ops::hamming_distance_op<double, double, int>,
+  int,
+  double,
+  double,
+  raft::identity_op>(ops::hamming_distance_op<double, double, int>,
+                     pairwise_matrix_params<int, double, double, raft::identity_op>,
+                     cudaStream_t);
+}  // namespace raft::distance::detail
diff --git a/cpp/include/raft/distance/specializations/detail/hellinger_expanded.cuh b/cpp/include/raft/distance/specializations/detail/hellinger_expanded.cuh
index bf214c046f..f96a06f919 100644
--- a/cpp/include/raft/distance/specializations/detail/hellinger_expanded.cuh
+++ b/cpp/include/raft/distance/specializations/detail/hellinger_expanded.cuh
@@ -18,37 +18,23 @@
 
 #include <raft/distance/detail/distance.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-extern template void
-distance<raft::distance::DistanceType::HellingerExpanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-extern template void
-distance<raft::distance::DistanceType::HellingerExpanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+extern template void pairwise_matrix_instantiation_point<
+  ops::hellinger_distance_op<float, float, int>,
+  int,
+  float,
+  float,
+  raft::identity_op>(ops::hellinger_distance_op<float, float, int>,
+                     pairwise_matrix_params<int, float, float, raft::identity_op>,
+                     cudaStream_t);
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+extern template void pairwise_matrix_instantiation_point<
+  ops::hellinger_distance_op<double, double, int>,
+  int,
+  double,
+  double,
+  raft::identity_op>(ops::hellinger_distance_op<double, double, int>,
+                     pairwise_matrix_params<int, double, double, raft::identity_op>,
+                     cudaStream_t);
+}  // namespace raft::distance::detail
diff --git a/cpp/include/raft/distance/specializations/detail/jensen_shannon.cuh b/cpp/include/raft/distance/specializations/detail/jensen_shannon.cuh
index 145834fb70..0b58646582 100644
--- a/cpp/include/raft/distance/specializations/detail/jensen_shannon.cuh
+++ b/cpp/include/raft/distance/specializations/detail/jensen_shannon.cuh
@@ -18,37 +18,23 @@
 
 #include <raft/distance/detail/distance.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-extern template void
-distance<raft::distance::DistanceType::JensenShannon, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-extern template void
-distance<raft::distance::DistanceType::JensenShannon, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+extern template void pairwise_matrix_instantiation_point<
+  ops::jensen_shannon_distance_op<float, float, int>,
+  int,
+  float,
+  float,
+  raft::identity_op>(ops::jensen_shannon_distance_op<float, float, int>,
+                     pairwise_matrix_params<int, float, float, raft::identity_op>,
+                     cudaStream_t);
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+extern template void pairwise_matrix_instantiation_point<
+  ops::jensen_shannon_distance_op<double, double, int>,
+  int,
+  double,
+  double,
+  raft::identity_op>(ops::jensen_shannon_distance_op<double, double, int>,
+                     pairwise_matrix_params<int, double, double, raft::identity_op>,
+                     cudaStream_t);
+}  // namespace raft::distance::detail
diff --git a/cpp/include/raft/distance/specializations/detail/kl_divergence.cuh b/cpp/include/raft/distance/specializations/detail/kl_divergence.cuh
index f0928916cd..5c164e0fd4 100644
--- a/cpp/include/raft/distance/specializations/detail/kl_divergence.cuh
+++ b/cpp/include/raft/distance/specializations/detail/kl_divergence.cuh
@@ -18,36 +18,23 @@
 
 #include <raft/distance/detail/distance.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-extern template void distance<raft::distance::DistanceType::KLDivergence, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-extern template void
-distance<raft::distance::DistanceType::KLDivergence, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+extern template void pairwise_matrix_instantiation_point<ops::kl_divergence_op<float, float, int>,
+                                                         int,
+                                                         float,
+                                                         float,
+                                                         raft::identity_op>(
+  ops::kl_divergence_op<float, float, int>,
+  pairwise_matrix_params<int, float, float, raft::identity_op>,
+  cudaStream_t);
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+extern template void pairwise_matrix_instantiation_point<ops::kl_divergence_op<double, double, int>,
+                                                         int,
+                                                         double,
+                                                         double,
+                                                         raft::identity_op>(
+  ops::kl_divergence_op<double, double, int>,
+  pairwise_matrix_params<int, double, double, raft::identity_op>,
+  cudaStream_t);
+}  // namespace raft::distance::detail
diff --git a/cpp/include/raft/distance/specializations/detail/l1.cuh b/cpp/include/raft/distance/specializations/detail/l1.cuh
index 23261a2571..870627d909 100644
--- a/cpp/include/raft/distance/specializations/detail/l1.cuh
+++ b/cpp/include/raft/distance/specializations/detail/l1.cuh
@@ -18,35 +18,23 @@
 
 #include <raft/distance/detail/distance.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-extern template void distance<raft::distance::DistanceType::L1, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-extern template void distance<raft::distance::DistanceType::L1, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+extern template void pairwise_matrix_instantiation_point<ops::l1_distance_op<float, float, int>,
+                                                         int,
+                                                         float,
+                                                         float,
+                                                         raft::identity_op>(
+  ops::l1_distance_op<float, float, int>,
+  pairwise_matrix_params<int, float, float, raft::identity_op>,
+  cudaStream_t);
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+extern template void pairwise_matrix_instantiation_point<ops::l1_distance_op<double, double, int>,
+                                                         int,
+                                                         double,
+                                                         double,
+                                                         raft::identity_op>(
+  ops::l1_distance_op<double, double, int>,
+  pairwise_matrix_params<int, double, double, raft::identity_op>,
+  cudaStream_t);
+}  // namespace raft::distance::detail
diff --git a/cpp/include/raft/distance/specializations/detail/l2_expanded.cuh b/cpp/include/raft/distance/specializations/detail/l2_expanded.cuh
index f953018b7d..ee3207bcce 100644
--- a/cpp/include/raft/distance/specializations/detail/l2_expanded.cuh
+++ b/cpp/include/raft/distance/specializations/detail/l2_expanded.cuh
@@ -18,36 +18,23 @@
 
 #include <raft/distance/detail/distance.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-extern template void distance<raft::distance::DistanceType::L2Expanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-extern template void
-distance<raft::distance::DistanceType::L2Expanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+extern template void pairwise_matrix_instantiation_point<ops::l2_exp_distance_op<float, float, int>,
+                                                         int,
+                                                         float,
+                                                         float,
+                                                         raft::identity_op>(
+  ops::l2_exp_distance_op<float, float, int>,
+  pairwise_matrix_params<int, float, float, raft::identity_op>,
+  cudaStream_t);
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+extern template void pairwise_matrix_instantiation_point<
+  ops::l2_exp_distance_op<double, double, int>,
+  int,
+  double,
+  double,
+  raft::identity_op>(ops::l2_exp_distance_op<double, double, int>,
+                     pairwise_matrix_params<int, double, double, raft::identity_op>,
+                     cudaStream_t);
+}  // namespace raft::distance::detail
diff --git a/cpp/include/raft/distance/specializations/detail/l2_sqrt_expanded.cuh b/cpp/include/raft/distance/specializations/detail/l2_sqrt_expanded.cuh
deleted file mode 100644
index 9f5f6a3706..0000000000
--- a/cpp/include/raft/distance/specializations/detail/l2_sqrt_expanded.cuh
+++ /dev/null
@@ -1,54 +0,0 @@
-/*
- * Copyright (c) 2021-2023, NVIDIA CORPORATION.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-#pragma once
-
-#include <raft/distance/detail/distance.cuh>
-
-namespace raft {
-namespace distance {
-namespace detail {
-extern template void
-distance<raft::distance::DistanceType::L2SqrtExpanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
-
-extern template void
-distance<raft::distance::DistanceType::L2SqrtExpanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
-
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
diff --git a/cpp/include/raft/distance/specializations/detail/l2_sqrt_unexpanded.cuh b/cpp/include/raft/distance/specializations/detail/l2_sqrt_unexpanded.cuh
deleted file mode 100644
index 94531ddc33..0000000000
--- a/cpp/include/raft/distance/specializations/detail/l2_sqrt_unexpanded.cuh
+++ /dev/null
@@ -1,54 +0,0 @@
-/*
- * Copyright (c) 2021-2023, NVIDIA CORPORATION.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-#pragma once
-
-#include <raft/distance/detail/distance.cuh>
-
-namespace raft {
-namespace distance {
-namespace detail {
-extern template void
-distance<raft::distance::DistanceType::L2SqrtUnexpanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
-
-extern template void
-distance<raft::distance::DistanceType::L2SqrtUnexpanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
-
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
diff --git a/cpp/include/raft/distance/specializations/detail/l2_unexpanded.cuh b/cpp/include/raft/distance/specializations/detail/l2_unexpanded.cuh
index 224b21fce8..1fbf57632b 100644
--- a/cpp/include/raft/distance/specializations/detail/l2_unexpanded.cuh
+++ b/cpp/include/raft/distance/specializations/detail/l2_unexpanded.cuh
@@ -18,36 +18,23 @@
 
 #include <raft/distance/detail/distance.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-extern template void distance<raft::distance::DistanceType::L2Unexpanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-extern template void
-distance<raft::distance::DistanceType::L2Unexpanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+extern template void pairwise_matrix_instantiation_point<
+  ops::l2_unexp_distance_op<float, float, int>,
+  int,
+  float,
+  float,
+  raft::identity_op>(ops::l2_unexp_distance_op<float, float, int>,
+                     pairwise_matrix_params<int, float, float, raft::identity_op>,
+                     cudaStream_t);
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+extern template void pairwise_matrix_instantiation_point<
+  ops::l2_unexp_distance_op<double, double, int>,
+  int,
+  double,
+  double,
+  raft::identity_op>(ops::l2_unexp_distance_op<double, double, int>,
+                     pairwise_matrix_params<int, double, double, raft::identity_op>,
+                     cudaStream_t);
+}  // namespace raft::distance::detail
diff --git a/cpp/include/raft/distance/specializations/detail/l_inf.cuh b/cpp/include/raft/distance/specializations/detail/l_inf.cuh
index 9a46d7b488..388d3bf439 100644
--- a/cpp/include/raft/distance/specializations/detail/l_inf.cuh
+++ b/cpp/include/raft/distance/specializations/detail/l_inf.cuh
@@ -18,35 +18,23 @@
 
 #include <raft/distance/detail/distance.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-extern template void distance<raft::distance::DistanceType::Linf, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-extern template void distance<raft::distance::DistanceType::Linf, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+extern template void pairwise_matrix_instantiation_point<ops::l_inf_distance_op<float, float, int>,
+                                                         int,
+                                                         float,
+                                                         float,
+                                                         raft::identity_op>(
+  ops::l_inf_distance_op<float, float, int>,
+  pairwise_matrix_params<int, float, float, raft::identity_op>,
+  cudaStream_t);
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+extern template void pairwise_matrix_instantiation_point<
+  ops::l_inf_distance_op<double, double, int>,
+  int,
+  double,
+  double,
+  raft::identity_op>(ops::l_inf_distance_op<double, double, int>,
+                     pairwise_matrix_params<int, double, double, raft::identity_op>,
+                     cudaStream_t);
+}  // namespace raft::distance::detail
diff --git a/cpp/include/raft/distance/specializations/detail/lp_unexpanded.cuh b/cpp/include/raft/distance/specializations/detail/lp_unexpanded.cuh
index e05ef02c42..d8e86ce6f2 100644
--- a/cpp/include/raft/distance/specializations/detail/lp_unexpanded.cuh
+++ b/cpp/include/raft/distance/specializations/detail/lp_unexpanded.cuh
@@ -18,36 +18,23 @@
 
 #include <raft/distance/detail/distance.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-extern template void distance<raft::distance::DistanceType::LpUnexpanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-extern template void
-distance<raft::distance::DistanceType::LpUnexpanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+extern template void pairwise_matrix_instantiation_point<
+  ops::lp_unexp_distance_op<float, float, int>,
+  int,
+  float,
+  float,
+  raft::identity_op>(ops::lp_unexp_distance_op<float, float, int>,
+                     pairwise_matrix_params<int, float, float, raft::identity_op>,
+                     cudaStream_t);
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+extern template void pairwise_matrix_instantiation_point<
+  ops::lp_unexp_distance_op<double, double, int>,
+  int,
+  double,
+  double,
+  raft::identity_op>(ops::lp_unexp_distance_op<double, double, int>,
+                     pairwise_matrix_params<int, double, double, raft::identity_op>,
+                     cudaStream_t);
+}  // namespace raft::distance::detail
diff --git a/cpp/include/raft/distance/specializations/detail/russel_rao.cuh b/cpp/include/raft/distance/specializations/detail/russel_rao.cuh
index afc87997c0..4803fb8ab0 100644
--- a/cpp/include/raft/distance/specializations/detail/russel_rao.cuh
+++ b/cpp/include/raft/distance/specializations/detail/russel_rao.cuh
@@ -18,37 +18,23 @@
 
 #include <raft/distance/detail/distance.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-extern template void
-distance<raft::distance::DistanceType::RusselRaoExpanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-extern template void
-distance<raft::distance::DistanceType::RusselRaoExpanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+extern template void pairwise_matrix_instantiation_point<
+  ops::russel_rao_distance_op<float, float, int>,
+  int,
+  float,
+  float,
+  raft::identity_op>(ops::russel_rao_distance_op<float, float, int>,
+                     pairwise_matrix_params<int, float, float, raft::identity_op>,
+                     cudaStream_t);
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+extern template void pairwise_matrix_instantiation_point<
+  ops::russel_rao_distance_op<double, double, int>,
+  int,
+  double,
+  double,
+  raft::identity_op>(ops::russel_rao_distance_op<double, double, int>,
+                     pairwise_matrix_params<int, double, double, raft::identity_op>,
+                     cudaStream_t);
+}  // namespace raft::distance::detail
diff --git a/cpp/include/raft/distance/specializations/distance.cuh b/cpp/include/raft/distance/specializations/distance.cuh
index 8daa398b49..a34f696e9e 100644
--- a/cpp/include/raft/distance/specializations/distance.cuh
+++ b/cpp/include/raft/distance/specializations/distance.cuh
@@ -27,8 +27,6 @@
 #include <raft/distance/specializations/detail/kl_divergence.cuh>
 #include <raft/distance/specializations/detail/l1.cuh>
 #include <raft/distance/specializations/detail/l2_expanded.cuh>
-#include <raft/distance/specializations/detail/l2_sqrt_expanded.cuh>
-#include <raft/distance/specializations/detail/l2_sqrt_unexpanded.cuh>
 #include <raft/distance/specializations/detail/l2_unexpanded.cuh>
 #include <raft/distance/specializations/detail/l_inf.cuh>
 #include <raft/distance/specializations/detail/lp_unexpanded.cuh>
diff --git a/cpp/include/raft/spatial/knn/detail/fused_l2_knn.cuh b/cpp/include/raft/spatial/knn/detail/fused_l2_knn.cuh
index 4e18a210d4..4a571c1447 100644
--- a/cpp/include/raft/spatial/knn/detail/fused_l2_knn.cuh
+++ b/cpp/include/raft/spatial/knn/detail/fused_l2_knn.cuh
@@ -22,6 +22,8 @@
 #include "processing.cuh"
 #include <raft/core/operators.hpp>
 #include <raft/distance/detail/distance.cuh>
+#include <raft/distance/detail/distance_ops/l2_exp.cuh>
+#include <raft/distance/detail/distance_ops/l2_unexp.cuh>
 #include <raft/distance/detail/pairwise_distance_base.cuh>
 #include <raft/util/cuda_utils.cuh>
 
@@ -183,13 +185,11 @@ DI void updateSortedWarpQ(
   }
 }
 
-template <bool useNorms,
-          typename DataT,
-          typename AccT,
+template <typename DataT,
           typename OutT,
           typename IdxT,
           typename Policy,
-          typename CoreLambda,
+          typename OpT,
           typename FinalLambda,
           int NumWarpQ,
           int NumThreadQ,
@@ -205,14 +205,14 @@ __global__ __launch_bounds__(Policy::Nthreads, 2) void fusedL2kNN(const DataT* x
                                                                   const IdxT lda,
                                                                   const IdxT ldb,
                                                                   const IdxT ldd,
-                                                                  CoreLambda core_op,
+                                                                  OpT distance_op,
                                                                   FinalLambda fin_op,
-                                                                  bool sqrt,
                                                                   unsigned int numOfNN,
                                                                   volatile int* mutexes,
                                                                   volatile OutT* out_dists,
                                                                   volatile IdxT* out_inds)
 {
+  using AccT = typename OpT::AccT;
   extern __shared__ char smem[];
 
   typedef cub::KeyValuePair<uint32_t, AccT> Pair;
@@ -222,295 +222,279 @@ __global__ __launch_bounds__(Policy::Nthreads, 2) void fusedL2kNN(const DataT* x
   using namespace raft::neighbors::detail::faiss_select;
   typedef WarpSelect<AccT, uint32_t, Dir, Comparator<AccT>, NumWarpQ, NumThreadQ, 32> myWarpSelect;
 
-  auto rowEpilog_lambda = [m, n, numOfNN, out_dists, out_inds, mutexes] __device__(
-                            IdxT gridStrideY) {
-    if (gridDim.x == 1) { return; }
-
-    Pair* shDumpKV = nullptr;
-    if (useNorms) {
-      shDumpKV = (Pair*)(&smem[Policy::SmemSize + ((Policy::Mblk + Policy::Nblk) * sizeof(DataT))]);
-    } else {
-      shDumpKV = (Pair*)(&smem[Policy::SmemSize]);
-    }
-
-    const int lid     = threadIdx.x % warpSize;
-    const IdxT starty = gridStrideY + (threadIdx.x / Policy::AccThCols);
-
-    //  0 -> consumer done consuming the buffer.
-    // -1 -> consumer started consuming the buffer
-    // -2 -> producer done filling the buffer
-    //  1 -> prod acquired to fill the buffer
-    if (blockIdx.x == 0) {
-      auto cta_processed = 0;
-      myWarpSelect heapArr1(identity, keyMax, numOfNN);
-      myWarpSelect heapArr2(identity, keyMax, numOfNN);
-      myWarpSelect* heapArr[] = {&heapArr1, &heapArr2};
-      __syncwarp();
-
-      loadAllWarpQShmem<Policy, Pair>(heapArr, &shDumpKV[0], m, numOfNN);
-
-      while (cta_processed < gridDim.x - 1) {
-        if (threadIdx.x == 0) {
-          while (atomicCAS((int*)&mutexes[gridStrideY / Policy::Mblk], -2, -1) != -2)
-            ;
-        }
-        __threadfence();
-        __syncthreads();
+  auto rowEpilog_lambda =
+    [m, n, &distance_op, numOfNN, out_dists, out_inds, mutexes] __device__(IdxT gridStrideY) {
+      if (gridDim.x == 1) { return; }
+
+      // Use ::template to disambiguate (See:
+      // https://en.cppreference.com/w/cpp/language/dependent_name)
+      int smem_offset = OpT::template shared_mem_size<Policy>();
+      Pair* shDumpKV  = (Pair*)(&smem[smem_offset]);
+
+      const int lid     = threadIdx.x % warpSize;
+      const IdxT starty = gridStrideY + (threadIdx.x / Policy::AccThCols);
+
+      //  0 -> consumer done consuming the buffer.
+      // -1 -> consumer started consuming the buffer
+      // -2 -> producer done filling the buffer
+      //  1 -> prod acquired to fill the buffer
+      if (blockIdx.x == 0) {
+        auto cta_processed = 0;
+        myWarpSelect heapArr1(identity, keyMax, numOfNN);
+        myWarpSelect heapArr2(identity, keyMax, numOfNN);
+        myWarpSelect* heapArr[] = {&heapArr1, &heapArr2};
+        __syncwarp();
+
+        loadAllWarpQShmem<Policy, Pair>(heapArr, &shDumpKV[0], m, numOfNN);
+
+        while (cta_processed < gridDim.x - 1) {
+          if (threadIdx.x == 0) {
+            while (atomicCAS((int*)&mutexes[gridStrideY / Policy::Mblk], -2, -1) != -2)
+              ;
+          }
+          __threadfence();
+          __syncthreads();
 
 #pragma unroll
-        for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
-          const auto rowId = starty + i * Policy::AccThRows;
-          if (rowId < m) {
+          for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
+            const auto rowId = starty + i * Policy::AccThRows;
+            if (rowId < m) {
 #pragma unroll
-            for (int j = 0; j < myWarpSelect::kNumWarpQRegisters; ++j) {
-              Pair otherKV;
-              otherKV.value  = identity;
-              otherKV.key    = keyMax;
-              const auto idx = j * warpSize + lid;
-              if (idx < numOfNN) {
-                otherKV.value         = out_dists[rowId * numOfNN + idx];
-                otherKV.key           = (uint32_t)out_inds[rowId * numOfNN + idx];
-                const auto shMemRowId = (threadIdx.x / Policy::AccThCols) + i * Policy::AccThRows;
-                shDumpKV[shMemRowId * numOfNN + idx] = otherKV;
+              for (int j = 0; j < myWarpSelect::kNumWarpQRegisters; ++j) {
+                Pair otherKV;
+                otherKV.value  = identity;
+                otherKV.key    = keyMax;
+                const auto idx = j * warpSize + lid;
+                if (idx < numOfNN) {
+                  otherKV.value         = out_dists[rowId * numOfNN + idx];
+                  otherKV.key           = (uint32_t)out_inds[rowId * numOfNN + idx];
+                  const auto shMemRowId = (threadIdx.x / Policy::AccThCols) + i * Policy::AccThRows;
+                  shDumpKV[shMemRowId * numOfNN + idx] = otherKV;
+                }
               }
             }
           }
-        }
-        __threadfence();
-        __syncthreads();
+          __threadfence();
+          __syncthreads();
 
-        if (threadIdx.x == 0) { atomicExch((int*)&mutexes[gridStrideY / Policy::Mblk], 0); }
-        __threadfence();
+          if (threadIdx.x == 0) { atomicExch((int*)&mutexes[gridStrideY / Policy::Mblk], 0); }
+          __threadfence();
 
         // Perform merging of otherKV with topk's across warp.
 #pragma unroll
-        for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
-          const auto rowId = starty + i * Policy::AccThRows;
-          if (rowId < m) {
+          for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
+            const auto rowId = starty + i * Policy::AccThRows;
+            if (rowId < m) {
 #pragma unroll
-            for (int j = 0; j < myWarpSelect::kNumWarpQRegisters; ++j) {
-              Pair otherKV;
-              otherKV.value  = identity;
-              otherKV.key    = keyMax;
-              const auto idx = j * warpSize + lid;
-              if (idx < numOfNN) {
-                const auto shMemRowId = (threadIdx.x / Policy::AccThCols) + i * Policy::AccThRows;
-                otherKV               = shDumpKV[shMemRowId * numOfNN + idx];
+              for (int j = 0; j < myWarpSelect::kNumWarpQRegisters; ++j) {
+                Pair otherKV;
+                otherKV.value  = identity;
+                otherKV.key    = keyMax;
+                const auto idx = j * warpSize + lid;
+                if (idx < numOfNN) {
+                  const auto shMemRowId = (threadIdx.x / Policy::AccThCols) + i * Policy::AccThRows;
+                  otherKV               = shDumpKV[shMemRowId * numOfNN + idx];
+                }
+                heapArr[i]->add(otherKV.value, otherKV.key);
               }
-              heapArr[i]->add(otherKV.value, otherKV.key);
             }
           }
+          cta_processed++;
         }
-        cta_processed++;
-      }
 #pragma unroll
-      for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
-        const auto rowId = starty + i * Policy::AccThRows;
-        if (rowId < m) {
-          bool needSort = (heapArr[i]->numVals > 0);
-          needSort      = __any_sync(0xffffffff, needSort);
-          if (needSort) { heapArr[i]->reduce(); }
+        for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
+          const auto rowId = starty + i * Policy::AccThRows;
+          if (rowId < m) {
+            bool needSort = (heapArr[i]->numVals > 0);
+            needSort      = __any_sync(0xffffffff, needSort);
+            if (needSort) { heapArr[i]->reduce(); }
+          }
         }
-      }
-      storeWarpQGmem<Policy, Pair>(heapArr, out_dists, out_inds, m, numOfNN, starty);
-    } else {
-      if (threadIdx.x == 0) {
-        while (atomicCAS((int*)&mutexes[gridStrideY / Policy::Mblk], 0, 1) != 0)
-          ;
-      }
-      __threadfence();
-      __syncthreads();
+        storeWarpQGmem<Policy, Pair>(heapArr, out_dists, out_inds, m, numOfNN, starty);
+      } else {
+        if (threadIdx.x == 0) {
+          while (atomicCAS((int*)&mutexes[gridStrideY / Policy::Mblk], 0, 1) != 0)
+            ;
+        }
+        __threadfence();
+        __syncthreads();
 
 #pragma unroll
-      for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
-        const auto rowId = starty + i * Policy::AccThRows;
-        if (rowId < m) {
-          for (int idx = lid; idx < numOfNN; idx += warpSize) {
-            const auto shMemRowId = (threadIdx.x / Policy::AccThCols) + i * Policy::AccThRows;
-            Pair KVPair           = shDumpKV[shMemRowId * numOfNN + idx];
-            out_dists[rowId * numOfNN + idx] = KVPair.value;
-            out_inds[rowId * numOfNN + idx]  = (IdxT)KVPair.key;
+        for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
+          const auto rowId = starty + i * Policy::AccThRows;
+          if (rowId < m) {
+            for (int idx = lid; idx < numOfNN; idx += warpSize) {
+              const auto shMemRowId = (threadIdx.x / Policy::AccThCols) + i * Policy::AccThRows;
+              Pair KVPair           = shDumpKV[shMemRowId * numOfNN + idx];
+              out_dists[rowId * numOfNN + idx] = KVPair.value;
+              out_inds[rowId * numOfNN + idx]  = (IdxT)KVPair.key;
+            }
           }
         }
-      }
-      __threadfence();
-      __syncthreads();
-
-      if (threadIdx.x == 0) { atomicExch((int*)&mutexes[gridStrideY / Policy::Mblk], -2); }
-      __threadfence();
-    }
-  };
+        __threadfence();
+        __syncthreads();
 
-  // epilogue operation lambda for final value calculation
-  auto epilog_lambda = [numOfNN, m, n, ldd, out_dists, out_inds, keyMax, identity] __device__(
-                         AccT acc[Policy::AccRowsPerTh][Policy::AccColsPerTh],
-                         DataT * regxn,
-                         DataT * regyn,
-                         IdxT gridStrideX,
-                         IdxT gridStrideY) {
-    if (useNorms) {
-#pragma unroll
-      for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
-#pragma unroll
-        for (int j = 0; j < Policy::AccColsPerTh; ++j) {
-          acc[i][j] = regxn[i] + regyn[j] - (DataT)2.0 * acc[i][j];
-        }
+        if (threadIdx.x == 0) { atomicExch((int*)&mutexes[gridStrideY / Policy::Mblk], -2); }
+        __threadfence();
       }
-    }
+    };
 
-    Pair* shDumpKV = nullptr;
-    if (useNorms) {
-      constexpr size_t shmemSize =
-        Policy::SmemSize + ((Policy::Mblk + Policy::Nblk) * sizeof(DataT));
-      shDumpKV = (Pair*)(&smem[shmemSize]);
-    } else {
-      shDumpKV = (Pair*)(&smem[Policy::SmemSize]);
-    }
+  // epilogue operation lambda for final value calculation
+  auto epilog_lambda =
+    [&distance_op, numOfNN, m, n, ldd, out_dists, out_inds, keyMax, identity] __device__(
+      AccT acc[Policy::AccRowsPerTh][Policy::AccColsPerTh],
+      DataT * regxn,
+      DataT * regyn,
+      IdxT gridStrideX,
+      IdxT gridStrideY) {
+      // Use ::template to disambiguate (See:
+      // https://en.cppreference.com/w/cpp/language/dependent_name)
+      int smem_offset = OpT::template shared_mem_size<Policy>();
+      Pair* shDumpKV  = (Pair*)(&smem[smem_offset]);
+
+      constexpr uint32_t mask = 0xffffffffu;
+      const IdxT starty       = gridStrideY + (threadIdx.x / Policy::AccThCols);
+      const IdxT startx       = gridStrideX + (threadIdx.x % Policy::AccThCols);
+      const int lid           = raft::laneId();
 
-    constexpr uint32_t mask = 0xffffffffu;
-    const IdxT starty       = gridStrideY + (threadIdx.x / Policy::AccThCols);
-    const IdxT startx       = gridStrideX + (threadIdx.x % Policy::AccThCols);
-    const int lid           = raft::laneId();
-
-    myWarpSelect heapArr1(identity, keyMax, numOfNN);
-    myWarpSelect heapArr2(identity, keyMax, numOfNN);
-    myWarpSelect* heapArr[] = {&heapArr1, &heapArr2};
-    if (usePrevTopKs) {
-      if (gridStrideX == blockIdx.x * Policy::Nblk) {
-        loadPrevTopKsGmemWarpQ<Policy, Pair>(heapArr, out_dists, out_inds, m, numOfNN, starty);
+      myWarpSelect heapArr1(identity, keyMax, numOfNN);
+      myWarpSelect heapArr2(identity, keyMax, numOfNN);
+      myWarpSelect* heapArr[] = {&heapArr1, &heapArr2};
+      if (usePrevTopKs) {
+        if (gridStrideX == blockIdx.x * Policy::Nblk) {
+          loadPrevTopKsGmemWarpQ<Policy, Pair>(heapArr, out_dists, out_inds, m, numOfNN, starty);
+        }
       }
-    }
 
-    if (gridStrideX > blockIdx.x * Policy::Nblk) {
+      if (gridStrideX > blockIdx.x * Policy::Nblk) {
 #pragma unroll
-      for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
-        const auto rowId     = (threadIdx.x / Policy::AccThCols) + i * Policy::AccThRows;
-        Pair tempKV          = shDumpKV[(rowId * numOfNN) + numOfNN - 1];
-        heapArr[i]->warpKTop = tempKV.value;
-      }
+        for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
+          const auto rowId     = (threadIdx.x / Policy::AccThCols) + i * Policy::AccThRows;
+          Pair tempKV          = shDumpKV[(rowId * numOfNN) + numOfNN - 1];
+          heapArr[i]->warpKTop = tempKV.value;
+        }
 
-      // total vals can atmost be 256, (32*8)
-      int numValsWarpTopK[Policy::AccRowsPerTh];
-      int anyWarpTopKs = 0;
+        // total vals can atmost be 256, (32*8)
+        int numValsWarpTopK[Policy::AccRowsPerTh];
+        int anyWarpTopKs = 0;
 #pragma unroll
-      for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
-        const auto rowId   = starty + i * Policy::AccThRows;
-        numValsWarpTopK[i] = 0;
-        if (rowId < m) {
+        for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
+          const auto rowId   = starty + i * Policy::AccThRows;
+          numValsWarpTopK[i] = 0;
+          if (rowId < m) {
 #pragma unroll
-          for (int j = 0; j < Policy::AccColsPerTh; ++j) {
-            const auto colId = startx + j * Policy::AccThCols;
-            if (colId < ldd) {
-              if (acc[i][j] < heapArr[i]->warpKTop) { numValsWarpTopK[i]++; }
+            for (int j = 0; j < Policy::AccColsPerTh; ++j) {
+              const auto colId = startx + j * Policy::AccThCols;
+              if (colId < ldd) {
+                if (acc[i][j] < heapArr[i]->warpKTop) { numValsWarpTopK[i]++; }
+              }
             }
+            anyWarpTopKs += numValsWarpTopK[i];
           }
-          anyWarpTopKs += numValsWarpTopK[i];
         }
-      }
-      anyWarpTopKs = __syncthreads_or(anyWarpTopKs > 0);
-      if (anyWarpTopKs) {
-        Pair* allWarpTopKs = (Pair*)(&smem[0]);
-        uint32_t needScanSort[Policy::AccRowsPerTh];
+        anyWarpTopKs = __syncthreads_or(anyWarpTopKs > 0);
+        if (anyWarpTopKs) {
+          Pair* allWarpTopKs = (Pair*)(&smem[0]);
+          uint32_t needScanSort[Policy::AccRowsPerTh];
 
 #pragma unroll
-        for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
-          const auto gmemRowId = starty + i * Policy::AccThRows;
-          needScanSort[i]      = 0;
-          if (gmemRowId < m) {
-            int myVals      = numValsWarpTopK[i];
-            needScanSort[i] = __ballot_sync(mask, myVals > 0);
-            if (needScanSort[i]) {
+          for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
+            const auto gmemRowId = starty + i * Policy::AccThRows;
+            needScanSort[i]      = 0;
+            if (gmemRowId < m) {
+              int myVals      = numValsWarpTopK[i];
+              needScanSort[i] = __ballot_sync(mask, myVals > 0);
+              if (needScanSort[i]) {
 #pragma unroll
-              for (unsigned int k = 1; k <= 16; k *= 2) {
-                const unsigned int n = __shfl_up_sync(mask, numValsWarpTopK[i], k);
-                if (lid >= k) { numValsWarpTopK[i] += n; }
+                for (unsigned int k = 1; k <= 16; k *= 2) {
+                  const unsigned int n = __shfl_up_sync(mask, numValsWarpTopK[i], k);
+                  if (lid >= k) { numValsWarpTopK[i] += n; }
+                }
               }
+              // As each thread will know its total vals to write.
+              // we only store its starting location.
+              numValsWarpTopK[i] -= myVals;
             }
-            // As each thread will know its total vals to write.
-            // we only store its starting location.
-            numValsWarpTopK[i] -= myVals;
-          }
 
-          if (needScanSort[i]) {
-            const auto rowId = (threadIdx.x / Policy::AccThCols) + i * Policy::AccThRows;
-            if (gmemRowId < m) {
-              if (needScanSort[i] & ((uint32_t)1 << lid)) {
+            if (needScanSort[i]) {
+              const auto rowId = (threadIdx.x / Policy::AccThCols) + i * Policy::AccThRows;
+              if (gmemRowId < m) {
+                if (needScanSort[i] & ((uint32_t)1 << lid)) {
 #pragma unroll
-                for (int j = 0; j < Policy::AccColsPerTh; ++j) {
-                  const auto colId = startx + j * Policy::AccThCols;
-                  if (colId < ldd) {
-                    if (acc[i][j] < heapArr[i]->warpKTop) {
-                      Pair otherKV                                     = {colId, acc[i][j]};
-                      allWarpTopKs[rowId * (256) + numValsWarpTopK[i]] = otherKV;
-                      numValsWarpTopK[i]++;
+                  for (int j = 0; j < Policy::AccColsPerTh; ++j) {
+                    const auto colId = startx + j * Policy::AccThCols;
+                    if (colId < ldd) {
+                      if (acc[i][j] < heapArr[i]->warpKTop) {
+                        Pair otherKV                                     = {colId, acc[i][j]};
+                        allWarpTopKs[rowId * (256) + numValsWarpTopK[i]] = otherKV;
+                        numValsWarpTopK[i]++;
+                      }
                     }
                   }
                 }
+                __syncwarp();
+                const int finalNumVals = raft::shfl(numValsWarpTopK[i], 31);
+                loadWarpQShmem<Policy, Pair>(heapArr[i], &shDumpKV[0], rowId, numOfNN);
+                updateSortedWarpQ<Pair, myWarpSelect::kNumWarpQRegisters>(
+                  heapArr[i], &allWarpTopKs[0], rowId, finalNumVals);
               }
-              __syncwarp();
-              const int finalNumVals = raft::shfl(numValsWarpTopK[i], 31);
-              loadWarpQShmem<Policy, Pair>(heapArr[i], &shDumpKV[0], rowId, numOfNN);
-              updateSortedWarpQ<Pair, myWarpSelect::kNumWarpQRegisters>(
-                heapArr[i], &allWarpTopKs[0], rowId, finalNumVals);
             }
           }
-        }
-        __syncthreads();
+          __syncthreads();
 #pragma unroll
-        for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
-          if (needScanSort[i]) {
-            const auto rowId     = (threadIdx.x / Policy::AccThCols) + i * Policy::AccThRows;
-            const auto gmemRowId = starty + i * Policy::AccThRows;
-            if (gmemRowId < m) {
-              storeWarpQShmem<Policy, Pair>(heapArr[i], shDumpKV, rowId, numOfNN);
+          for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
+            if (needScanSort[i]) {
+              const auto rowId     = (threadIdx.x / Policy::AccThCols) + i * Policy::AccThRows;
+              const auto gmemRowId = starty + i * Policy::AccThRows;
+              if (gmemRowId < m) {
+                storeWarpQShmem<Policy, Pair>(heapArr[i], shDumpKV, rowId, numOfNN);
+              }
             }
           }
         }
-      }
-    } else {
+      } else {
 #pragma unroll
-      for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
-        const auto gmemRowId  = starty + i * Policy::AccThRows;
-        const auto shMemRowId = (threadIdx.x / Policy::AccThCols) + i * Policy::AccThRows;
-        if (gmemRowId < m) {
+        for (int i = 0; i < Policy::AccRowsPerTh; ++i) {
+          const auto gmemRowId  = starty + i * Policy::AccThRows;
+          const auto shMemRowId = (threadIdx.x / Policy::AccThCols) + i * Policy::AccThRows;
+          if (gmemRowId < m) {
 #pragma unroll
-          for (int j = 0; j < Policy::AccColsPerTh; ++j) {
-            const auto colId = startx + j * Policy::AccThCols;
-            Pair otherKV     = {keyMax, identity};
-            if (colId < ldd) {
-              otherKV.value = acc[i][j];
-              otherKV.key   = colId;
+            for (int j = 0; j < Policy::AccColsPerTh; ++j) {
+              const auto colId = startx + j * Policy::AccThCols;
+              Pair otherKV     = {keyMax, identity};
+              if (colId < ldd) {
+                otherKV.value = acc[i][j];
+                otherKV.key   = colId;
+              }
+              heapArr[i]->add(otherKV.value, otherKV.key);
             }
-            heapArr[i]->add(otherKV.value, otherKV.key);
-          }
 
-          bool needSort = (heapArr[i]->numVals > 0);
-          needSort      = __any_sync(mask, needSort);
-          if (needSort) { heapArr[i]->reduce(); }
-          storeWarpQShmem<Policy, Pair>(heapArr[i], shDumpKV, shMemRowId, numOfNN);
+            bool needSort = (heapArr[i]->numVals > 0);
+            needSort      = __any_sync(mask, needSort);
+            if (needSort) { heapArr[i]->reduce(); }
+            storeWarpQShmem<Policy, Pair>(heapArr[i], shDumpKV, shMemRowId, numOfNN);
+          }
         }
       }
-    }
 
-    if (((gridStrideX + Policy::Nblk * gridDim.x) >= n) && gridDim.x == 1) {
-      // This is last iteration of grid stride X
-      loadAllWarpQShmem<Policy, Pair>(heapArr, &shDumpKV[0], m, numOfNN);
-      storeWarpQGmem<Policy, Pair>(heapArr, out_dists, out_inds, m, numOfNN, starty);
-    }
-  };
+      if (((gridStrideX + Policy::Nblk * gridDim.x) >= n) && gridDim.x == 1) {
+        // This is last iteration of grid stride X
+        loadAllWarpQShmem<Policy, Pair>(heapArr, &shDumpKV[0], m, numOfNN);
+        storeWarpQGmem<Policy, Pair>(heapArr, out_dists, out_inds, m, numOfNN, starty);
+      }
+    };
 
-  raft::distance::detail::PairwiseDistances<useNorms,
-                                            DataT,
-                                            AccT,
+  constexpr bool write_out = false;
+  raft::distance::detail::PairwiseDistances<DataT,
                                             OutT,
                                             IdxT,
                                             Policy,
-                                            CoreLambda,
+                                            OpT,
                                             decltype(epilog_lambda),
                                             FinalLambda,
                                             decltype(rowEpilog_lambda),
                                             isRowMajor,
-                                            false>
+                                            write_out>
     obj(x,
         y,
         m,
@@ -521,9 +505,9 @@ __global__ __launch_bounds__(Policy::Nthreads, 2) void fusedL2kNN(const DataT* x
         ldd,
         _xn,
         _yn,
-        nullptr,
+        nullptr,  // output ptr, can be null as write_out == false.
         smem,
-        core_op,
+        distance_op,
         epilog_lambda,
         fin_op,
         rowEpilog_lambda);
@@ -562,38 +546,32 @@ void fusedL2UnexpKnnImpl(const DataT* x,
 
   dim3 blk(KPolicy::Nthreads);
   // Accumulation operation lambda
-  auto core_lambda = [] __device__(AccT & acc, DataT & x, DataT & y) {
-    const auto diff = x - y;
-    acc += diff * diff;
-  };
-
   typedef cub::KeyValuePair<uint32_t, AccT> Pair;
 
-  if (isRowMajor) {
-    constexpr auto fusedL2UnexpKnn32RowMajor = fusedL2kNN<false,
-                                                          DataT,
-                                                          AccT,
+  raft::distance::detail::ops::l2_unexp_distance_op<DataT, AccT, IdxT> distance_op{sqrt};
+  raft::identity_op fin_op{};
+
+  if constexpr (isRowMajor) {
+    constexpr auto fusedL2UnexpKnn32RowMajor = fusedL2kNN<DataT,
                                                           OutT,
                                                           IdxT,
                                                           KPolicy,
-                                                          decltype(core_lambda),
-                                                          raft::identity_op,
+                                                          decltype(distance_op),
+                                                          decltype(fin_op),
                                                           32,
                                                           2,
                                                           usePrevTopKs,
-                                                          true>;
-    constexpr auto fusedL2UnexpKnn64RowMajor = fusedL2kNN<false,
-                                                          DataT,
-                                                          AccT,
+                                                          isRowMajor>;
+    constexpr auto fusedL2UnexpKnn64RowMajor = fusedL2kNN<DataT,
                                                           OutT,
                                                           IdxT,
                                                           KPolicy,
-                                                          decltype(core_lambda),
-                                                          raft::identity_op,
+                                                          decltype(distance_op),
+                                                          decltype(fin_op),
                                                           64,
                                                           3,
                                                           usePrevTopKs,
-                                                          true>;
+                                                          isRowMajor>;
 
     auto fusedL2UnexpKnnRowMajor = fusedL2UnexpKnn32RowMajor;
     if (numOfNN <= 32) {
@@ -604,8 +582,10 @@ void fusedL2UnexpKnnImpl(const DataT* x,
       ASSERT(numOfNN <= 64, "fusedL2kNN: num of nearest neighbors must be <= 64");
     }
 
-    const auto sharedMemSize = KPolicy::SmemSize + (KPolicy::Mblk * numOfNN * sizeof(Pair));
-    dim3 grid                = raft::distance::detail::launchConfigGenerator<KPolicy>(
+    const auto sharedMemSize =
+      distance_op.template shared_mem_size<KPolicy>() + KPolicy::Mblk * numOfNN * sizeof(Pair);
+
+    dim3 grid = raft::distance::detail::launchConfigGenerator<KPolicy>(
       m, n, sharedMemSize, fusedL2UnexpKnnRowMajor);
 
     if (grid.x > 1) {
@@ -628,9 +608,8 @@ void fusedL2UnexpKnnImpl(const DataT* x,
                                                                   lda,
                                                                   ldb,
                                                                   ldd,
-                                                                  core_lambda,
-                                                                  raft::identity_op{},
-                                                                  sqrt,
+                                                                  distance_op,
+                                                                  fin_op,
                                                                   (uint32_t)numOfNN,
                                                                   (int*)workspace,
                                                                   out_dists,
@@ -753,36 +732,33 @@ void fusedL2ExpKnnImpl(const DataT* x,
   ASSERT(workspace != nullptr, "workspace is null");
 
   dim3 blk(KPolicy::Nthreads);
-  // Accumulation operation lambda
-  auto core_lambda = [] __device__(AccT & acc, DataT & x, DataT & y) { acc += x * y; };
 
   typedef cub::KeyValuePair<uint32_t, AccT> Pair;
 
-  if (isRowMajor) {
-    constexpr auto fusedL2ExpKnn32RowMajor = fusedL2kNN<true,
-                                                        DataT,
-                                                        AccT,
+  raft::distance::detail::ops::l2_exp_distance_op<DataT, AccT, IdxT> distance_op{sqrt};
+  raft::identity_op fin_op{};
+
+  if constexpr (isRowMajor) {
+    constexpr auto fusedL2ExpKnn32RowMajor = fusedL2kNN<DataT,
                                                         OutT,
                                                         IdxT,
                                                         KPolicy,
-                                                        decltype(core_lambda),
-                                                        raft::identity_op,
+                                                        decltype(distance_op),
+                                                        decltype(fin_op),
                                                         32,
                                                         2,
                                                         usePrevTopKs,
-                                                        true>;
-    constexpr auto fusedL2ExpKnn64RowMajor = fusedL2kNN<true,
-                                                        DataT,
-                                                        AccT,
+                                                        isRowMajor>;
+    constexpr auto fusedL2ExpKnn64RowMajor = fusedL2kNN<DataT,
                                                         OutT,
                                                         IdxT,
                                                         KPolicy,
-                                                        decltype(core_lambda),
-                                                        raft::identity_op,
+                                                        decltype(distance_op),
+                                                        decltype(fin_op),
                                                         64,
                                                         3,
                                                         usePrevTopKs,
-                                                        true>;
+                                                        isRowMajor>;
 
     auto fusedL2ExpKnnRowMajor = fusedL2ExpKnn32RowMajor;
     if (numOfNN <= 32) {
@@ -793,9 +769,8 @@ void fusedL2ExpKnnImpl(const DataT* x,
       ASSERT(numOfNN <= 64, "fusedL2kNN: num of nearest neighbors must be <= 64");
     }
 
-    const auto sharedMemSize = KPolicy::SmemSize +
-                               ((KPolicy::Mblk + KPolicy::Nblk) * sizeof(DataT)) +
-                               (KPolicy::Mblk * numOfNN * sizeof(Pair));
+    const auto sharedMemSize =
+      distance_op.template shared_mem_size<KPolicy>() + (KPolicy::Mblk * numOfNN * sizeof(Pair));
     dim3 grid = raft::distance::detail::launchConfigGenerator<KPolicy>(
       m, n, sharedMemSize, fusedL2ExpKnnRowMajor);
     int32_t* mutexes = nullptr;
@@ -835,9 +810,8 @@ void fusedL2ExpKnnImpl(const DataT* x,
                                                                 lda,
                                                                 ldb,
                                                                 ldd,
-                                                                core_lambda,
-                                                                raft::identity_op{},
-                                                                sqrt,
+                                                                distance_op,
+                                                                fin_op,
                                                                 (uint32_t)numOfNN,
                                                                 mutexes,
                                                                 out_dists,
diff --git a/cpp/include/raft/util/arch.cuh b/cpp/include/raft/util/arch.cuh
index 8c48b87269..dc35b10063 100644
--- a/cpp/include/raft/util/arch.cuh
+++ b/cpp/include/raft/util/arch.cuh
@@ -15,25 +15,27 @@
  */
 #pragma once
 
-namespace raft::arch {
+#include <raft/util/cuda_rt_essentials.hpp>  // RAFT_CUDA_TRY
 
-/* raft::arch provides the following facilities:
+namespace raft::util::arch {
+
+/* raft::util::arch provides the following facilities:
  *
- * - raft::arch::SM_XX : hardcoded compile-time constants for various compute
- *   architectures. The values raft::arch::SM_min and raft::arch::SM_future
+ * - raft::util::arch::SM_XX : hardcoded compile-time constants for various compute
+ *   architectures. The values raft::util::arch::SM_min and raft::util::arch::SM_future
  *   represent architectures that are always smaller and larger (respectively)
  *   than any architecture that can be encountered in practice.
  *
- * - raft::arch::SM_compute_arch : a compile-time value for the *current*
+ * - raft::util::arch::SM_compute_arch : a compile-time value for the *current*
  *   compute architecture that a kernel is compiled with. It can only be used
  *   inside kernels with a template argument.
  *
- * - raft::arch::kernel_runtime_arch : a function that computes at *run-time*
+ * - raft::util::arch::kernel_runtime_arch : a function that computes at *run-time*
  *   which version of a kernel will launch (i.e., it will return the compute
  *   architecture of the version of the kernel that will be launched by the
  *   driver).
  *
- * - raft::arch::SM_range : a compile-time value to represent an open interval
+ * - raft::util::arch::SM_range : a compile-time value to represent an open interval
  *   of compute architectures. This can be used to check if the current
  *   compile-time architecture is in a specified compatibility range.
  */
@@ -46,9 +48,6 @@ struct SM_generic {
  public:
   __host__ __device__ constexpr int value() const { return n; }
 };
-
-// A dummy kernel that is used to determine the runtime architecture.
-__global__ inline void dummy_runtime_kernel() {}
 }  // namespace detail
 
 // A list of architectures that RAPIDS explicitly builds for (SM60, ..., SM90)
@@ -119,7 +118,7 @@ struct SM_runtime {
 inline SM_runtime kernel_runtime_arch(void* kernel)
 {
   cudaFuncAttributes attributes;
-  cudaFuncGetAttributes(&attributes, kernel);
+  RAFT_CUDA_TRY(cudaFuncGetAttributes(&attributes, kernel));
 
   return SM_runtime(10 * attributes.ptxVersion);
 }
@@ -143,4 +142,4 @@ struct SM_range {
   }
 };
 
-}  // namespace raft::arch
+}  // namespace raft::util::arch
diff --git a/cpp/include/raft/util/cuda_dev_essentials.cuh b/cpp/include/raft/util/cuda_dev_essentials.cuh
new file mode 100644
index 0000000000..5080dc33ee
--- /dev/null
+++ b/cpp/include/raft/util/cuda_dev_essentials.cuh
@@ -0,0 +1,91 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#pragma once
+
+// This file provides a few essential functions for use in __device__ code. The
+// scope is necessarily limited to ensure that compilation times are minimized.
+// Please make sure not to include large / expensive files from here.
+
+namespace raft {
+
+/** helper macro for device inlined functions */
+#define DI  inline __device__
+#define HDI inline __host__ __device__
+#define HD  __host__ __device__
+
+/**
+ * @brief Provide a ceiling division operation ie. ceil(a / b)
+ * @tparam IntType supposed to be only integers for now!
+ */
+template <typename IntType>
+constexpr HDI IntType ceildiv(IntType a, IntType b)
+{
+  return (a + b - 1) / b;
+}
+
+/**
+ * @brief Provide an alignment function ie. ceil(a / b) * b
+ * @tparam IntType supposed to be only integers for now!
+ */
+template <typename IntType>
+constexpr HDI IntType alignTo(IntType a, IntType b)
+{
+  return ceildiv(a, b) * b;
+}
+
+/**
+ * @brief Provide an alignment function ie. (a / b) * b
+ * @tparam IntType supposed to be only integers for now!
+ */
+template <typename IntType>
+constexpr HDI IntType alignDown(IntType a, IntType b)
+{
+  return (a / b) * b;
+}
+
+/**
+ * @brief Check if the input is a power of 2
+ * @tparam IntType data type (checked only for integers)
+ */
+template <typename IntType>
+constexpr HDI bool isPo2(IntType num)
+{
+  return (num && !(num & (num - 1)));
+}
+
+/**
+ * @brief Give logarithm of the number to base-2
+ * @tparam IntType data type (checked only for integers)
+ */
+template <typename IntType>
+constexpr HDI IntType log2(IntType num, IntType ret = IntType(0))
+{
+  return num <= IntType(1) ? ret : log2(num >> IntType(1), ++ret);
+}
+
+/** number of threads per warp */
+static const int WarpSize = 32;
+
+/** get the laneId of the current thread */
+DI int laneId()
+{
+  int id;
+  asm("mov.s32 %0, %%laneid;" : "=r"(id));
+  return id;
+}
+
+}  // namespace raft
diff --git a/cpp/include/raft/util/cuda_rt_essentials.hpp b/cpp/include/raft/util/cuda_rt_essentials.hpp
new file mode 100644
index 0000000000..e5f3af4e61
--- /dev/null
+++ b/cpp/include/raft/util/cuda_rt_essentials.hpp
@@ -0,0 +1,60 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#pragma once
+
+// This file provides a few essential functions that wrap the CUDA runtime API.
+// The scope is necessarily limited to ensure that compilation times are
+// minimized. Please make sure not to include large / expensive files from here.
+
+#include <cuda_runtime.h>
+#include <raft/core/error.hpp>
+
+namespace raft {
+
+/**
+ * @brief Exception thrown when a CUDA error is encountered.
+ */
+struct cuda_error : public raft::exception {
+  explicit cuda_error(char const* const message) : raft::exception(message) {}
+  explicit cuda_error(std::string const& message) : raft::exception(message) {}
+};
+
+}  // namespace raft
+
+/**
+ * @brief Error checking macro for CUDA runtime API functions.
+ *
+ * Invokes a CUDA runtime API function call, if the call does not return
+ * cudaSuccess, invokes cudaGetLastError() to clear the error and throws an
+ * exception detailing the CUDA error that occurred
+ *
+ */
+#define RAFT_CUDA_TRY(call)                        \
+  do {                                             \
+    cudaError_t const status = call;               \
+    if (status != cudaSuccess) {                   \
+      cudaGetLastError();                          \
+      std::string msg{};                           \
+      SET_ERROR_MSG(msg,                           \
+                    "CUDA error encountered at: ", \
+                    "call='%s', Reason=%s:%s",     \
+                    #call,                         \
+                    cudaGetErrorName(status),      \
+                    cudaGetErrorString(status));   \
+      throw raft::cuda_error(msg);                 \
+    }                                              \
+  } while (0)
diff --git a/cpp/include/raft/util/cuda_utils.cuh b/cpp/include/raft/util/cuda_utils.cuh
index 5be9dc999a..687a6b4651 100644
--- a/cpp/include/raft/util/cuda_utils.cuh
+++ b/cpp/include/raft/util/cuda_utils.cuh
@@ -23,113 +23,10 @@
 #include <raft/core/cudart_utils.hpp>
 #include <raft/core/math.hpp>
 #include <raft/core/operators.hpp>
-
-#ifndef ENABLE_MEMCPY_ASYNC
-// enable memcpy_async interface by default for newer GPUs
-#if __CUDA_ARCH__ >= 800
-#define ENABLE_MEMCPY_ASYNC 1
-#endif
-#else  // ENABLE_MEMCPY_ASYNC
-// disable memcpy_async for all older GPUs
-#if __CUDA_ARCH__ < 800
-#define ENABLE_MEMCPY_ASYNC 0
-#endif
-#endif  // ENABLE_MEMCPY_ASYNC
+#include <raft/util/cuda_dev_essentials.cuh>
 
 namespace raft {
 
-/** helper macro for device inlined functions */
-#define DI  inline __device__
-#define HDI inline __host__ __device__
-#define HD  __host__ __device__
-
-/**
- * @brief Provide a ceiling division operation ie. ceil(a / b)
- * @tparam IntType supposed to be only integers for now!
- */
-template <typename IntType>
-constexpr HDI IntType ceildiv(IntType a, IntType b)
-{
-  return (a + b - 1) / b;
-}
-
-/**
- * @brief Provide an alignment function ie. ceil(a / b) * b
- * @tparam IntType supposed to be only integers for now!
- */
-template <typename IntType>
-constexpr HDI IntType alignTo(IntType a, IntType b)
-{
-  return ceildiv(a, b) * b;
-}
-
-/**
- * @brief Provide an alignment function ie. (a / b) * b
- * @tparam IntType supposed to be only integers for now!
- */
-template <typename IntType>
-constexpr HDI IntType alignDown(IntType a, IntType b)
-{
-  return (a / b) * b;
-}
-
-/**
- * @brief Check if the input is a power of 2
- * @tparam IntType data type (checked only for integers)
- */
-template <typename IntType>
-constexpr HDI bool isPo2(IntType num)
-{
-  return (num && !(num & (num - 1)));
-}
-
-/**
- * @brief Give logarithm of the number to base-2
- * @tparam IntType data type (checked only for integers)
- */
-template <typename IntType>
-constexpr HDI IntType log2(IntType num, IntType ret = IntType(0))
-{
-  return num <= IntType(1) ? ret : log2(num >> IntType(1), ++ret);
-}
-
-/** Device function to apply the input lambda across threads in the grid */
-template <int ItemsPerThread, typename L>
-DI void forEach(int num, L lambda)
-{
-  int idx              = (blockDim.x * blockIdx.x) + threadIdx.x;
-  const int numThreads = blockDim.x * gridDim.x;
-#pragma unroll
-  for (int itr = 0; itr < ItemsPerThread; ++itr, idx += numThreads) {
-    if (idx < num) lambda(idx, itr);
-  }
-}
-
-/** number of threads per warp */
-static const int WarpSize = 32;
-
-/** get the laneId of the current thread */
-DI int laneId()
-{
-  int id;
-  asm("mov.s32 %0, %%laneid;" : "=r"(id));
-  return id;
-}
-
-/**
- * @brief Swap two values
- * @tparam T the datatype of the values
- * @param a first input
- * @param b second input
- */
-template <typename T>
-HDI void swapVals(T& a, T& b)
-{
-  T tmp = a;
-  a     = b;
-  b     = tmp;
-}
-
 /** Device function to have atomic add support for older archs */
 template <typename Type>
 DI void myAtomicAdd(Type* address, Type val)
diff --git a/cpp/include/raft/util/cudart_utils.hpp b/cpp/include/raft/util/cudart_utils.hpp
index 0feb188ad8..0a7ca23028 100644
--- a/cpp/include/raft/util/cudart_utils.hpp
+++ b/cpp/include/raft/util/cudart_utils.hpp
@@ -25,6 +25,7 @@
 #pragma once
 
 #include <raft/core/error.hpp>
+#include <raft/util/cuda_rt_essentials.hpp>
 #include <rmm/cuda_stream_view.hpp>
 #include <rmm/mr/device/managed_memory_resource.hpp>
 #include <rmm/mr/device/per_device_resource.hpp>
@@ -40,42 +41,7 @@
 #include <iostream>
 #include <memory>
 #include <mutex>
-
-namespace raft {
-
-/**
- * @brief Exception thrown when a CUDA error is encountered.
- */
-struct cuda_error : public raft::exception {
-  explicit cuda_error(char const* const message) : raft::exception(message) {}
-  explicit cuda_error(std::string const& message) : raft::exception(message) {}
-};
-
-}  // namespace raft
-
-/**
- * @brief Error checking macro for CUDA runtime API functions.
- *
- * Invokes a CUDA runtime API function call, if the call does not return
- * cudaSuccess, invokes cudaGetLastError() to clear the error and throws an
- * exception detailing the CUDA error that occurred
- *
- */
-#define RAFT_CUDA_TRY(call)                        \
-  do {                                             \
-    cudaError_t const status = call;               \
-    if (status != cudaSuccess) {                   \
-      cudaGetLastError();                          \
-      std::string msg{};                           \
-      SET_ERROR_MSG(msg,                           \
-                    "CUDA error encountered at: ", \
-                    "call='%s', Reason=%s:%s",     \
-                    #call,                         \
-                    cudaGetErrorName(status),      \
-                    cudaGetErrorString(status));   \
-      throw raft::cuda_error(msg);                 \
-    }                                              \
-  } while (0)
+#include <string>
 
 // FIXME: Remove after consumers rename
 #ifndef CUDA_TRY
diff --git a/cpp/include/raft/util/device_loads_stores.cuh b/cpp/include/raft/util/device_loads_stores.cuh
index 2b87c44d60..c9bda26b81 100644
--- a/cpp/include/raft/util/device_loads_stores.cuh
+++ b/cpp/include/raft/util/device_loads_stores.cuh
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2021-2022, NVIDIA CORPORATION.
+ * Copyright (c) 2021-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -16,7 +16,8 @@
 
 #pragma once
 
-#include <raft/util/cuda_utils.cuh>
+#include <cstdint>                            // uintX_t
+#include <raft/util/cuda_dev_essentials.cuh>  // DI
 
 namespace raft {
 
diff --git a/cpp/src/distance/specializations/detail/00_write_template.py b/cpp/src/distance/specializations/detail/00_write_template.py
new file mode 100644
index 0000000000..3f2f853569
--- /dev/null
+++ b/cpp/src/distance/specializations/detail/00_write_template.py
@@ -0,0 +1,159 @@
+#!/usr/bin/env python3
+
+# NOTE: this template is not perfectly formatted. Use pre-commit to get
+# everything in shape again.
+template = """/*
+ * Copyright (c) 2021-2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include <raft/core/operators.hpp> // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh> // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh> // pairwise_matrix_instantiation_point
+INCLUDE_SM_HEADERS
+
+namespace raft::distance::detail {
+
+template void pairwise_matrix_instantiation_point<OpT,
+                                                  IdxT,
+                                                  DataT,
+                                                  OutT,
+                                                  FinopT>(
+  OpT,
+  pairwise_matrix_params<IdxT, DataT, OutT, FinopT>,
+  cudaStream_t);
+
+}  // namespace raft::distance::detail
+"""
+
+data_type_instances = [
+    dict(
+        DataT="float",
+        AccT="float",
+        OutT="float",
+        IdxT="int",
+    ),
+    dict(
+        DataT="double",
+        AccT="double",
+        OutT="double",
+        IdxT="int",
+    ),
+]
+
+op_instances = [
+    dict(
+        path_prefix="canberra",
+        OpT="ops::canberra_distance_op<DataT, AccT, IdxT>",
+        archs = [60],
+    ),
+    dict(
+        path_prefix="correlation",
+        OpT="ops::correlation_distance_op<DataT, AccT, IdxT>",
+        archs = [60],
+    ),
+    dict(
+        path_prefix="cosine",
+        OpT="ops::cosine_distance_op<DataT, AccT, IdxT>",
+        archs = [60, 80],
+    ),
+    dict(
+        path_prefix="hamming_unexpanded",
+        OpT="ops::hamming_distance_op<DataT, AccT, IdxT>",
+        archs = [60],
+    ),
+    dict(
+        path_prefix="hellinger_expanded",
+        OpT="ops::hellinger_distance_op<DataT, AccT, IdxT>",
+        archs = [60],
+    ),
+    # inner product is handled by cublas.
+    dict(
+        path_prefix="jensen_shannon",
+        OpT="ops::jensen_shannon_distance_op<DataT, AccT, IdxT>",
+        archs = [60],
+    ),
+    dict(
+        path_prefix="kl_divergence",
+        OpT="ops::kl_divergence_op<DataT, AccT, IdxT>",
+        archs = [60],
+    ),
+    dict(
+        path_prefix="l1",
+        OpT="ops::l1_distance_op<DataT, AccT, IdxT>",
+        archs = [60],
+    ),
+    dict(
+        path_prefix="l2_expanded",
+        OpT="ops::l2_exp_distance_op<DataT, AccT, IdxT>",
+        archs = [60, 80],
+    ),
+    dict(
+        path_prefix="l2_unexpanded",
+        OpT="ops::l2_unexp_distance_op<DataT, AccT, IdxT>",
+        archs = [60],
+    ),
+    dict(
+        path_prefix="l_inf",
+        OpT="ops::l_inf_distance_op<DataT, AccT, IdxT>",
+        archs = [60],
+    ),
+    dict(
+        path_prefix="lp_unexpanded",
+        OpT="ops::lp_unexp_distance_op<DataT, AccT, IdxT>",
+        archs = [60],
+    ),
+    dict(
+        path_prefix="russel_rao",
+        OpT="ops::russel_rao_distance_op<DataT, AccT, IdxT>",
+        archs = [60],
+     ),
+]
+
+def fill_in(s, template):
+    for k, v in template.items():
+        s = s.replace(k, v)
+    return s
+
+def fill_include_sm_headers(op_instance):
+    include_headers ="\n".join([
+        f"#include <raft/distance/detail/pairwise_matrix/dispatch_sm{arch}.cuh>"
+        for arch in op_instance["archs"]
+    ])
+
+    return {
+        "path_prefix": op_instance["path_prefix"],
+        "OpT": op_instance["OpT"],
+        "INCLUDE_SM_HEADERS": include_headers
+    }
+
+for op_instance in op_instances:
+    op_instance = fill_include_sm_headers(op_instance)
+
+    for data_type_instance in data_type_instances:
+        op_data_instance = {
+            k : fill_in(v, data_type_instance)
+            for k, v in op_instance.items()
+        }
+        instance = {
+            **op_data_instance,
+            **data_type_instance,
+            "FinopT": "decltype(raft::identity_op())",
+        }
+
+        text = fill_in(template, instance)
+
+        path = fill_in("path_prefix_DataT_AccT_OutT_IdxT.cu", instance)
+        with open(path, "w") as f:
+            f.write(text)
diff --git a/cpp/src/distance/specializations/detail/canberra_double_double_double_int.cu b/cpp/src/distance/specializations/detail/canberra_double_double_double_int.cu
index 4e9e608792..037d218178 100644
--- a/cpp/src/distance/specializations/detail/canberra_double_double_double_int.cu
+++ b/cpp/src/distance/specializations/detail/canberra_double_double_double_int.cu
@@ -14,24 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::Canberra, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+namespace raft::distance::detail {
+
+template void pairwise_matrix_instantiation_point<ops::canberra_distance_op<double, double, int>,
+                                                  int,
+                                                  double,
+                                                  double,
+                                                  decltype(raft::identity_op())>(
+  ops::canberra_distance_op<double, double, int>,
+  pairwise_matrix_params<int, double, double, decltype(raft::identity_op())>,
+  cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/canberra_float_float_float_int.cu b/cpp/src/distance/specializations/detail/canberra_float_float_float_int.cu
index 6dfc385e55..0ed8ea7bb0 100644
--- a/cpp/src/distance/specializations/detail/canberra_float_float_float_int.cu
+++ b/cpp/src/distance/specializations/detail/canberra_float_float_float_int.cu
@@ -14,25 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::Canberra, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+template void pairwise_matrix_instantiation_point<ops::canberra_distance_op<float, float, int>,
+                                                  int,
+                                                  float,
+                                                  float,
+                                                  decltype(raft::identity_op())>(
+  ops::canberra_distance_op<float, float, int>,
+  pairwise_matrix_params<int, float, float, decltype(raft::identity_op())>,
+  cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/correlation_double_double_double_int.cu b/cpp/src/distance/specializations/detail/correlation_double_double_double_int.cu
index 2df77a4b5d..0c11f0621e 100644
--- a/cpp/src/distance/specializations/detail/correlation_double_double_double_int.cu
+++ b/cpp/src/distance/specializations/detail/correlation_double_double_double_int.cu
@@ -14,27 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
+namespace raft::distance::detail {
 
-template void
-distance<raft::distance::DistanceType::CorrelationExpanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+template void pairwise_matrix_instantiation_point<ops::correlation_distance_op<double, double, int>,
+                                                  int,
+                                                  double,
+                                                  double,
+                                                  decltype(raft::identity_op())>(
+  ops::correlation_distance_op<double, double, int>,
+  pairwise_matrix_params<int, double, double, decltype(raft::identity_op())>,
+  cudaStream_t);
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/correlation_float_float_float_int.cu b/cpp/src/distance/specializations/detail/correlation_float_float_float_int.cu
index 76ed00afa6..396e158554 100644
--- a/cpp/src/distance/specializations/detail/correlation_float_float_float_int.cu
+++ b/cpp/src/distance/specializations/detail/correlation_float_float_float_int.cu
@@ -14,25 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::CorrelationExpanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+template void pairwise_matrix_instantiation_point<ops::correlation_distance_op<float, float, int>,
+                                                  int,
+                                                  float,
+                                                  float,
+                                                  decltype(raft::identity_op())>(
+  ops::correlation_distance_op<float, float, int>,
+  pairwise_matrix_params<int, float, float, decltype(raft::identity_op())>,
+  cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/cosine_double_double_double_int.cu b/cpp/src/distance/specializations/detail/cosine_double_double_double_int.cu
index 3e0bcb92ed..e9afb6f563 100644
--- a/cpp/src/distance/specializations/detail/cosine_double_double_double_int.cu
+++ b/cpp/src/distance/specializations/detail/cosine_double_double_double_int.cu
@@ -14,26 +14,21 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm80.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
+namespace raft::distance::detail {
 
-template void distance<raft::distance::DistanceType::CosineExpanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+template void pairwise_matrix_instantiation_point<ops::cosine_distance_op<double, double, int>,
+                                                  int,
+                                                  double,
+                                                  double,
+                                                  decltype(raft::identity_op())>(
+  ops::cosine_distance_op<double, double, int>,
+  pairwise_matrix_params<int, double, double, decltype(raft::identity_op())>,
+  cudaStream_t);
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/cosine_float_float_float_int.cu b/cpp/src/distance/specializations/detail/cosine_float_float_float_int.cu
index 23131ce2c7..1033c491d6 100644
--- a/cpp/src/distance/specializations/detail/cosine_float_float_float_int.cu
+++ b/cpp/src/distance/specializations/detail/cosine_float_float_float_int.cu
@@ -14,26 +14,21 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm80.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
+namespace raft::distance::detail {
 
-template void distance<raft::distance::DistanceType::CosineExpanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+template void pairwise_matrix_instantiation_point<ops::cosine_distance_op<float, float, int>,
+                                                  int,
+                                                  float,
+                                                  float,
+                                                  decltype(raft::identity_op())>(
+  ops::cosine_distance_op<float, float, int>,
+  pairwise_matrix_params<int, float, float, decltype(raft::identity_op())>,
+  cudaStream_t);
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/hamming_unexpanded_double_double_double_int.cu b/cpp/src/distance/specializations/detail/hamming_unexpanded_double_double_double_int.cu
index b618fd024c..195115914d 100644
--- a/cpp/src/distance/specializations/detail/hamming_unexpanded_double_double_double_int.cu
+++ b/cpp/src/distance/specializations/detail/hamming_unexpanded_double_double_double_int.cu
@@ -14,27 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
+namespace raft::distance::detail {
 
-template void
-distance<raft::distance::DistanceType::HammingUnexpanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+template void pairwise_matrix_instantiation_point<ops::hamming_distance_op<double, double, int>,
+                                                  int,
+                                                  double,
+                                                  double,
+                                                  decltype(raft::identity_op())>(
+  ops::hamming_distance_op<double, double, int>,
+  pairwise_matrix_params<int, double, double, decltype(raft::identity_op())>,
+  cudaStream_t);
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/hamming_unexpanded_float_float_float_int.cu b/cpp/src/distance/specializations/detail/hamming_unexpanded_float_float_float_int.cu
index 18e7aad9e9..a74c6c404e 100644
--- a/cpp/src/distance/specializations/detail/hamming_unexpanded_float_float_float_int.cu
+++ b/cpp/src/distance/specializations/detail/hamming_unexpanded_float_float_float_int.cu
@@ -14,25 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::HammingUnexpanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+template void pairwise_matrix_instantiation_point<ops::hamming_distance_op<float, float, int>,
+                                                  int,
+                                                  float,
+                                                  float,
+                                                  decltype(raft::identity_op())>(
+  ops::hamming_distance_op<float, float, int>,
+  pairwise_matrix_params<int, float, float, decltype(raft::identity_op())>,
+  cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/hellinger_expanded_double_double_double_int.cu b/cpp/src/distance/specializations/detail/hellinger_expanded_double_double_double_int.cu
index 08ab20cfe5..bac1dd7bd0 100644
--- a/cpp/src/distance/specializations/detail/hellinger_expanded_double_double_double_int.cu
+++ b/cpp/src/distance/specializations/detail/hellinger_expanded_double_double_double_int.cu
@@ -14,27 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
+namespace raft::distance::detail {
 
-template void
-distance<raft::distance::DistanceType::HellingerExpanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+template void pairwise_matrix_instantiation_point<ops::hellinger_distance_op<double, double, int>,
+                                                  int,
+                                                  double,
+                                                  double,
+                                                  decltype(raft::identity_op())>(
+  ops::hellinger_distance_op<double, double, int>,
+  pairwise_matrix_params<int, double, double, decltype(raft::identity_op())>,
+  cudaStream_t);
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/hellinger_expanded_float_float_float_int.cu b/cpp/src/distance/specializations/detail/hellinger_expanded_float_float_float_int.cu
index 79eed075fb..77c113b1a9 100644
--- a/cpp/src/distance/specializations/detail/hellinger_expanded_float_float_float_int.cu
+++ b/cpp/src/distance/specializations/detail/hellinger_expanded_float_float_float_int.cu
@@ -14,26 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
+namespace raft::distance::detail {
 
-template void distance<raft::distance::DistanceType::HellingerExpanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+template void pairwise_matrix_instantiation_point<ops::hellinger_distance_op<float, float, int>,
+                                                  int,
+                                                  float,
+                                                  float,
+                                                  decltype(raft::identity_op())>(
+  ops::hellinger_distance_op<float, float, int>,
+  pairwise_matrix_params<int, float, float, decltype(raft::identity_op())>,
+  cudaStream_t);
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/jensen_shannon_double_double_double_int.cu b/cpp/src/distance/specializations/detail/jensen_shannon_double_double_double_int.cu
index ed84ee6dc4..188e52c152 100644
--- a/cpp/src/distance/specializations/detail/jensen_shannon_double_double_double_int.cu
+++ b/cpp/src/distance/specializations/detail/jensen_shannon_double_double_double_int.cu
@@ -14,25 +14,21 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::JensenShannon, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+namespace raft::distance::detail {
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+template void
+  pairwise_matrix_instantiation_point<ops::jensen_shannon_distance_op<double, double, int>,
+                                      int,
+                                      double,
+                                      double,
+                                      decltype(raft::identity_op())>(
+    ops::jensen_shannon_distance_op<double, double, int>,
+    pairwise_matrix_params<int, double, double, decltype(raft::identity_op())>,
+    cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/jensen_shannon_float_float_float_int.cu b/cpp/src/distance/specializations/detail/jensen_shannon_float_float_float_int.cu
index a241af767c..b0afbf7bb2 100644
--- a/cpp/src/distance/specializations/detail/jensen_shannon_float_float_float_int.cu
+++ b/cpp/src/distance/specializations/detail/jensen_shannon_float_float_float_int.cu
@@ -14,25 +14,21 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::JensenShannon, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+template void
+  pairwise_matrix_instantiation_point<ops::jensen_shannon_distance_op<float, float, int>,
+                                      int,
+                                      float,
+                                      float,
+                                      decltype(raft::identity_op())>(
+    ops::jensen_shannon_distance_op<float, float, int>,
+    pairwise_matrix_params<int, float, float, decltype(raft::identity_op())>,
+    cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/kl_divergence_double_double_double_int.cu b/cpp/src/distance/specializations/detail/kl_divergence_double_double_double_int.cu
index c4c944d123..f06ae85414 100644
--- a/cpp/src/distance/specializations/detail/kl_divergence_double_double_double_int.cu
+++ b/cpp/src/distance/specializations/detail/kl_divergence_double_double_double_int.cu
@@ -14,25 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::KLDivergence, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+namespace raft::distance::detail {
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+template void pairwise_matrix_instantiation_point<ops::kl_divergence_op<double, double, int>,
+                                                  int,
+                                                  double,
+                                                  double,
+                                                  decltype(raft::identity_op())>(
+  ops::kl_divergence_op<double, double, int>,
+  pairwise_matrix_params<int, double, double, decltype(raft::identity_op())>,
+  cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/kl_divergence_float_float_float_int.cu b/cpp/src/distance/specializations/detail/kl_divergence_float_float_float_int.cu
index aa1db5a837..00d5a5ee5b 100644
--- a/cpp/src/distance/specializations/detail/kl_divergence_float_float_float_int.cu
+++ b/cpp/src/distance/specializations/detail/kl_divergence_float_float_float_int.cu
@@ -14,25 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::KLDivergence, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+template void pairwise_matrix_instantiation_point<ops::kl_divergence_op<float, float, int>,
+                                                  int,
+                                                  float,
+                                                  float,
+                                                  decltype(raft::identity_op())>(
+  ops::kl_divergence_op<float, float, int>,
+  pairwise_matrix_params<int, float, float, decltype(raft::identity_op())>,
+  cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/l1_double_double_double_int.cu b/cpp/src/distance/specializations/detail/l1_double_double_double_int.cu
index 391a1c2aa4..5c235316da 100644
--- a/cpp/src/distance/specializations/detail/l1_double_double_double_int.cu
+++ b/cpp/src/distance/specializations/detail/l1_double_double_double_int.cu
@@ -14,25 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::L1, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+namespace raft::distance::detail {
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+template void pairwise_matrix_instantiation_point<ops::l1_distance_op<double, double, int>,
+                                                  int,
+                                                  double,
+                                                  double,
+                                                  decltype(raft::identity_op())>(
+  ops::l1_distance_op<double, double, int>,
+  pairwise_matrix_params<int, double, double, decltype(raft::identity_op())>,
+  cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/l1_float_float_float_int.cu b/cpp/src/distance/specializations/detail/l1_float_float_float_int.cu
index 7b45e52ca1..fb293ca83d 100644
--- a/cpp/src/distance/specializations/detail/l1_float_float_float_int.cu
+++ b/cpp/src/distance/specializations/detail/l1_float_float_float_int.cu
@@ -14,25 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::L1, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+template void pairwise_matrix_instantiation_point<ops::l1_distance_op<float, float, int>,
+                                                  int,
+                                                  float,
+                                                  float,
+                                                  decltype(raft::identity_op())>(
+  ops::l1_distance_op<float, float, int>,
+  pairwise_matrix_params<int, float, float, decltype(raft::identity_op())>,
+  cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/l2_expanded_double_double_double_int.cu b/cpp/src/distance/specializations/detail/l2_expanded_double_double_double_int.cu
index 8c5f746fa2..2c02f0224f 100644
--- a/cpp/src/distance/specializations/detail/l2_expanded_double_double_double_int.cu
+++ b/cpp/src/distance/specializations/detail/l2_expanded_double_double_double_int.cu
@@ -14,24 +14,21 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm80.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::L2Expanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+namespace raft::distance::detail {
+
+template void pairwise_matrix_instantiation_point<ops::l2_exp_distance_op<double, double, int>,
+                                                  int,
+                                                  double,
+                                                  double,
+                                                  decltype(raft::identity_op())>(
+  ops::l2_exp_distance_op<double, double, int>,
+  pairwise_matrix_params<int, double, double, decltype(raft::identity_op())>,
+  cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/l2_expanded_float_float_float_int.cu b/cpp/src/distance/specializations/detail/l2_expanded_float_float_float_int.cu
index c266125f98..85e25a25ca 100644
--- a/cpp/src/distance/specializations/detail/l2_expanded_float_float_float_int.cu
+++ b/cpp/src/distance/specializations/detail/l2_expanded_float_float_float_int.cu
@@ -14,25 +14,21 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm80.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::L2Expanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+template void pairwise_matrix_instantiation_point<ops::l2_exp_distance_op<float, float, int>,
+                                                  int,
+                                                  float,
+                                                  float,
+                                                  decltype(raft::identity_op())>(
+  ops::l2_exp_distance_op<float, float, int>,
+  pairwise_matrix_params<int, float, float, decltype(raft::identity_op())>,
+  cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/l2_sqrt_expanded_double_double_double_int.cu b/cpp/src/distance/specializations/detail/l2_sqrt_expanded_double_double_double_int.cu
deleted file mode 100644
index 399b120527..0000000000
--- a/cpp/src/distance/specializations/detail/l2_sqrt_expanded_double_double_double_int.cu
+++ /dev/null
@@ -1,38 +0,0 @@
-/*
- * Copyright (c) 2021-2023, NVIDIA CORPORATION.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
-
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::L2SqrtExpanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
-
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
diff --git a/cpp/src/distance/specializations/detail/l2_sqrt_expanded_float_float_float_int.cu b/cpp/src/distance/specializations/detail/l2_sqrt_expanded_float_float_float_int.cu
deleted file mode 100644
index 66de212b8e..0000000000
--- a/cpp/src/distance/specializations/detail/l2_sqrt_expanded_float_float_float_int.cu
+++ /dev/null
@@ -1,38 +0,0 @@
-/*
- * Copyright (c) 2021-2023, NVIDIA CORPORATION.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
-
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::L2SqrtExpanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
-
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
diff --git a/cpp/src/distance/specializations/detail/l2_sqrt_unexpanded_double_double_double_int.cu b/cpp/src/distance/specializations/detail/l2_sqrt_unexpanded_double_double_double_int.cu
deleted file mode 100644
index 562d93b2de..0000000000
--- a/cpp/src/distance/specializations/detail/l2_sqrt_unexpanded_double_double_double_int.cu
+++ /dev/null
@@ -1,38 +0,0 @@
-/*
- * Copyright (c) 2021-2023, NVIDIA CORPORATION.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
-
-namespace raft {
-namespace distance {
-namespace detail {
-
-template void distance<raft::distance::DistanceType::L2SqrtUnexpanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
diff --git a/cpp/src/distance/specializations/detail/l2_sqrt_unexpanded_float_float_float_int.cu b/cpp/src/distance/specializations/detail/l2_sqrt_unexpanded_float_float_float_int.cu
deleted file mode 100644
index 386bbafc5f..0000000000
--- a/cpp/src/distance/specializations/detail/l2_sqrt_unexpanded_float_float_float_int.cu
+++ /dev/null
@@ -1,38 +0,0 @@
-/*
- * Copyright (c) 2021-2023, NVIDIA CORPORATION.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
-
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::L2SqrtUnexpanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
-
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
diff --git a/cpp/src/distance/specializations/detail/l2_unexpanded_double_double_double_int.cu b/cpp/src/distance/specializations/detail/l2_unexpanded_double_double_double_int.cu
index 7733c3af48..5b4d995d14 100644
--- a/cpp/src/distance/specializations/detail/l2_unexpanded_double_double_double_int.cu
+++ b/cpp/src/distance/specializations/detail/l2_unexpanded_double_double_double_int.cu
@@ -14,25 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::L2Unexpanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+namespace raft::distance::detail {
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+template void pairwise_matrix_instantiation_point<ops::l2_unexp_distance_op<double, double, int>,
+                                                  int,
+                                                  double,
+                                                  double,
+                                                  decltype(raft::identity_op())>(
+  ops::l2_unexp_distance_op<double, double, int>,
+  pairwise_matrix_params<int, double, double, decltype(raft::identity_op())>,
+  cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/l2_unexpanded_float_float_float_int.cu b/cpp/src/distance/specializations/detail/l2_unexpanded_float_float_float_int.cu
index 4ea18d31de..a63c3f0bb8 100644
--- a/cpp/src/distance/specializations/detail/l2_unexpanded_float_float_float_int.cu
+++ b/cpp/src/distance/specializations/detail/l2_unexpanded_float_float_float_int.cu
@@ -14,25 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::L2Unexpanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+template void pairwise_matrix_instantiation_point<ops::l2_unexp_distance_op<float, float, int>,
+                                                  int,
+                                                  float,
+                                                  float,
+                                                  decltype(raft::identity_op())>(
+  ops::l2_unexp_distance_op<float, float, int>,
+  pairwise_matrix_params<int, float, float, decltype(raft::identity_op())>,
+  cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/l_inf_double_double_double_int.cu b/cpp/src/distance/specializations/detail/l_inf_double_double_double_int.cu
index 74414f8fd6..831167523f 100644
--- a/cpp/src/distance/specializations/detail/l_inf_double_double_double_int.cu
+++ b/cpp/src/distance/specializations/detail/l_inf_double_double_double_int.cu
@@ -14,26 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
+namespace raft::distance::detail {
 
-template void distance<raft::distance::DistanceType::Linf, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+template void pairwise_matrix_instantiation_point<ops::l_inf_distance_op<double, double, int>,
+                                                  int,
+                                                  double,
+                                                  double,
+                                                  decltype(raft::identity_op())>(
+  ops::l_inf_distance_op<double, double, int>,
+  pairwise_matrix_params<int, double, double, decltype(raft::identity_op())>,
+  cudaStream_t);
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/l_inf_float_float_float_int.cu b/cpp/src/distance/specializations/detail/l_inf_float_float_float_int.cu
index e418fc455f..02e667cbe3 100644
--- a/cpp/src/distance/specializations/detail/l_inf_float_float_float_int.cu
+++ b/cpp/src/distance/specializations/detail/l_inf_float_float_float_int.cu
@@ -14,25 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::Linf, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+template void pairwise_matrix_instantiation_point<ops::l_inf_distance_op<float, float, int>,
+                                                  int,
+                                                  float,
+                                                  float,
+                                                  decltype(raft::identity_op())>(
+  ops::l_inf_distance_op<float, float, int>,
+  pairwise_matrix_params<int, float, float, decltype(raft::identity_op())>,
+  cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/lp_unexpanded_double_double_double_int.cu b/cpp/src/distance/specializations/detail/lp_unexpanded_double_double_double_int.cu
index 402cb51b7e..ebd71065ec 100644
--- a/cpp/src/distance/specializations/detail/lp_unexpanded_double_double_double_int.cu
+++ b/cpp/src/distance/specializations/detail/lp_unexpanded_double_double_double_int.cu
@@ -14,25 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
+namespace raft::distance::detail {
 
-template void distance<raft::distance::DistanceType::LpUnexpanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+template void pairwise_matrix_instantiation_point<ops::lp_unexp_distance_op<double, double, int>,
+                                                  int,
+                                                  double,
+                                                  double,
+                                                  decltype(raft::identity_op())>(
+  ops::lp_unexp_distance_op<double, double, int>,
+  pairwise_matrix_params<int, double, double, decltype(raft::identity_op())>,
+  cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/lp_unexpanded_float_float_float_int.cu b/cpp/src/distance/specializations/detail/lp_unexpanded_float_float_float_int.cu
index 7efe2b3349..b94a81fdce 100644
--- a/cpp/src/distance/specializations/detail/lp_unexpanded_float_float_float_int.cu
+++ b/cpp/src/distance/specializations/detail/lp_unexpanded_float_float_float_int.cu
@@ -14,25 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::LpUnexpanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+template void pairwise_matrix_instantiation_point<ops::lp_unexp_distance_op<float, float, int>,
+                                                  int,
+                                                  float,
+                                                  float,
+                                                  decltype(raft::identity_op())>(
+  ops::lp_unexp_distance_op<float, float, int>,
+  pairwise_matrix_params<int, float, float, decltype(raft::identity_op())>,
+  cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/russel_rao_double_double_double_int.cu b/cpp/src/distance/specializations/detail/russel_rao_double_double_double_int.cu
index b1e6f5e1f4..6f952fcc37 100644
--- a/cpp/src/distance/specializations/detail/russel_rao_double_double_double_int.cu
+++ b/cpp/src/distance/specializations/detail/russel_rao_double_double_double_int.cu
@@ -14,26 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-template void
-distance<raft::distance::DistanceType::RusselRaoExpanded, double, double, double, int>(
-  raft::resources const& handle,
-  const double* x,
-  const double* y,
-  double* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  double metric_arg);
+namespace raft::distance::detail {
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+template void pairwise_matrix_instantiation_point<ops::russel_rao_distance_op<double, double, int>,
+                                                  int,
+                                                  double,
+                                                  double,
+                                                  decltype(raft::identity_op())>(
+  ops::russel_rao_distance_op<double, double, int>,
+  pairwise_matrix_params<int, double, double, decltype(raft::identity_op())>,
+  cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/src/distance/specializations/detail/russel_rao_float_float_float_int.cu b/cpp/src/distance/specializations/detail/russel_rao_float_float_float_int.cu
index 1e12bcd705..3223ce33a7 100644
--- a/cpp/src/distance/specializations/detail/russel_rao_float_float_float_int.cu
+++ b/cpp/src/distance/specializations/detail/russel_rao_float_float_float_int.cu
@@ -14,25 +14,20 @@
  * limitations under the License.
  */
 
-#include <raft/distance/detail/distance.cuh>
-#include <raft/distance/specializations.cuh>
+#include <raft/core/operators.hpp>                            // raft::identity_op
+#include <raft/distance/detail/distance_ops/all_ops.cuh>      // ops::*
+#include <raft/distance/detail/pairwise_matrix/dispatch.cuh>  // pairwise_matrix_instantiation_point
+#include <raft/distance/detail/pairwise_matrix/dispatch_sm60.cuh>
 
-namespace raft {
-namespace distance {
-namespace detail {
-template void distance<raft::distance::DistanceType::RusselRaoExpanded, float, float, float, int>(
-  raft::resources const& handle,
-  const float* x,
-  const float* y,
-  float* dist,
-  int m,
-  int n,
-  int k,
-  void* workspace,
-  std::size_t worksize,
-  bool isRowMajor,
-  float metric_arg);
+namespace raft::distance::detail {
 
-}  // namespace detail
-}  // namespace distance
-}  // namespace raft
+template void pairwise_matrix_instantiation_point<ops::russel_rao_distance_op<float, float, int>,
+                                                  int,
+                                                  float,
+                                                  float,
+                                                  decltype(raft::identity_op())>(
+  ops::russel_rao_distance_op<float, float, int>,
+  pairwise_matrix_params<int, float, float, decltype(raft::identity_op())>,
+  cudaStream_t);
+
+}  // namespace raft::distance::detail
diff --git a/cpp/test/distance/distance_base.cuh b/cpp/test/distance/distance_base.cuh
index 0e084f2ad8..438e212fbd 100644
--- a/cpp/test/distance/distance_base.cuh
+++ b/cpp/test/distance/distance_base.cuh
@@ -16,16 +16,24 @@
 
 #include "../test_utils.cuh"
 #include <gtest/gtest.h>
-#include <raft/common/nvtx.hpp>
-#include <raft/core/mdarray.hpp>
-#include <raft/core/operators.hpp>
-#include <raft/distance/distance.cuh>
-#include <raft/util/cuda_utils.cuh>
-#include <raft/util/cudart_utils.hpp>
+#include <raft/common/nvtx.hpp>  // common::nvtx::range
+
+#include <raft/core/device_mdspan.hpp>       // make_device_matrix_view
+#include <raft/core/device_resources.hpp>    // raft::device_resources
+#include <raft/core/operators.hpp>           // raft::sqrt
+#include <raft/distance/distance_types.hpp>  // raft::distance::DistanceType
+#include <raft/random/rng.cuh>
+#include <rmm/device_uvector.hpp>  // rmm::device_uvector
+
+// When the distance library is precompiled, include only the raft_runtime
+// headers. This way, a small change in one of the kernel internals does not
+// trigger a rebuild of the test files (it of course still triggers a rebuild of
+// the raft specializations)
 #if defined RAFT_COMPILED
-#include <raft/distance/specializations.cuh>
+#include <raft_runtime/distance/pairwise_distance.hpp>
+#else
+#include <raft/distance/distance.cuh>
 #endif
-#include <raft/random/rng.cuh>
 
 namespace raft {
 namespace distance {
@@ -409,6 +417,25 @@ template <typename DataType>
   return os;
 }
 
+// TODO: Remove when mdspan-based raft::runtime::distance::pairwise_distance is
+// implemented.
+//
+// Context:
+// https://github.com/rapidsai/raft/issues/1338
+template <typename layout>
+constexpr bool layout_to_row_major();
+
+template <>
+constexpr bool layout_to_row_major<layout_c_contiguous>()
+{
+  return true;
+}
+template <>
+constexpr bool layout_to_row_major<layout_f_contiguous>()
+{
+  return false;
+}
+
 template <raft::distance::DistanceType distanceType, typename DataType, typename layout>
 void distanceLauncher(raft::device_resources const& handle,
                       DataType* x,
@@ -422,12 +449,23 @@ void distanceLauncher(raft::device_resources const& handle,
                       DataType threshold,
                       DataType metric_arg = 2.0f)
 {
+#if defined RAFT_COMPILED
+  // TODO: Implement and use mdspan-based
+  // raft::runtime::distance::pairwise_distance here.
+  //
+  // Context:
+  // https://github.com/rapidsai/raft/issues/1338
+  bool row_major = layout_to_row_major<layout>();
+  raft::runtime::distance::pairwise_distance(
+    handle, x, y, dist, m, n, k, distanceType, row_major, metric_arg);
+#else
   auto x_v    = make_device_matrix_view<DataType, int, layout>(x, m, k);
   auto y_v    = make_device_matrix_view<DataType, int, layout>(y, n, k);
   auto dist_v = make_device_matrix_view<DataType, int, layout>(dist, m, n);
 
   raft::distance::distance<distanceType, DataType, DataType, DataType, layout>(
     handle, x_v, y_v, dist_v, metric_arg);
+#endif
 }
 
 template <raft::distance::DistanceType distanceType, typename DataType>
@@ -523,9 +561,25 @@ class BigMatrixDistanceTest : public ::testing::Test {
     auto testInfo = testing::UnitTest::GetInstance()->current_test_info();
     common::nvtx::range fun_scope("test::%s/%s", testInfo->test_suite_name(), testInfo->name());
 
+    void pairwise_distance(raft::device_resources const& handle,
+                           float* x,
+                           float* y,
+                           float* dists,
+                           int m,
+                           int n,
+                           int k,
+                           raft::distance::DistanceType metric,
+                           bool isRowMajor,
+                           float metric_arg);
+    constexpr bool row_major   = true;
+    constexpr float metric_arg = 0.0f;
+#if defined RAFT_COMPILED
+    raft::runtime::distance::pairwise_distance(
+      handle, x.data(), x.data(), dist.data(), m, n, k, distanceType, row_major, metric_arg);
+#else
     raft::distance::distance<distanceType, float, float, float>(
-      handle, x.data(), x.data(), dist.data(), m, n, k, true, 0.0f);
-
+      handle, x.data(), x.data(), dist.data(), m, n, k, row_major, metric_arg);
+#endif
     RAFT_CUDA_TRY(cudaStreamSynchronize(handle.get_stream()));
   }
 
diff --git a/cpp/test/distance/fused_l2_nn.cu b/cpp/test/distance/fused_l2_nn.cu
index 4a74d7f16a..383ad39319 100644
--- a/cpp/test/distance/fused_l2_nn.cu
+++ b/cpp/test/distance/fused_l2_nn.cu
@@ -182,22 +182,20 @@ class FusedL2NNTest : public ::testing::TestWithParam<Inputs<DataT>> {
     int m = params.m;
     int n = params.n;
     int k = params.k;
-    MinAndDistanceReduceOp<int, DataT> redOp;
-    fusedL2NN<DataT, raft::KeyValuePair<int, DataT>, int>(
-      out,
-      x.data(),
-      y.data(),
-      xn.data(),
-      yn.data(),
-      m,
-      n,
-      k,
-      (void*)workspace.data(),
-      redOp,
-      raft::distance::KVPMinReduce<int, DataT>(),
-      Sqrt,
-      true,
-      stream);
+
+    const bool init_out_buffer = true;
+    fusedL2NNMinReduce<DataT, raft::KeyValuePair<int, DataT>, int>(out,
+                                                                   x.data(),
+                                                                   y.data(),
+                                                                   xn.data(),
+                                                                   yn.data(),
+                                                                   m,
+                                                                   n,
+                                                                   k,
+                                                                   (void*)workspace.data(),
+                                                                   Sqrt,
+                                                                   init_out_buffer,
+                                                                   stream);
     RAFT_CUDA_TRY(cudaStreamSynchronize(stream));
   }
 };

From 7c73f23ddf5f81ad2cd057c650b7e2e8947c5265 Mon Sep 17 00:00:00 2001
From: Ben Frederickson <ben@benfrederickson.com>
Date: Thu, 23 Mar 2023 03:29:03 -0700
Subject: [PATCH 09/25] Add nccl to dependencies.yaml (#1361)

raft-dask requires nccl to build, add to the dependencies.yaml so that when creating a clean raft conda environment - we can build all of raft out of the box

Authors:
  - Ben Frederickson (https://github.com/benfred)
  - Corey J. Nolet (https://github.com/cjnolet)

Approvers:
  - Corey J. Nolet (https://github.com/cjnolet)
  - AJ Schmidt (https://github.com/ajschmidt8)

URL: https://github.com/rapidsai/raft/pull/1361
---
 conda/environments/all_cuda-118_arch-x86_64.yaml | 1 +
 dependencies.yaml                                | 1 +
 2 files changed, 2 insertions(+)

diff --git a/conda/environments/all_cuda-118_arch-x86_64.yaml b/conda/environments/all_cuda-118_arch-x86_64.yaml
index 39f1fef4d5..7972a8824d 100644
--- a/conda/environments/all_cuda-118_arch-x86_64.yaml
+++ b/conda/environments/all_cuda-118_arch-x86_64.yaml
@@ -33,6 +33,7 @@ dependencies:
 - libcusolver=11.4.1.48
 - libcusparse-dev=11.7.5.86
 - libcusparse=11.7.5.86
+- nccl>=2.9.9
 - ninja
 - numpydoc
 - pydata-sphinx-theme
diff --git a/dependencies.yaml b/dependencies.yaml
index 9fbf26bcd1..c06ce4a20f 100644
--- a/dependencies.yaml
+++ b/dependencies.yaml
@@ -53,6 +53,7 @@ dependencies:
         packages:
           - c-compiler
           - cxx-compiler
+          - nccl>=2.9.9
     specific:
       - output_types: conda
         matrices:

From 419f0c28cd18654064bfd3a6ed2f638e239f46b3 Mon Sep 17 00:00:00 2001
From: Vyas Ramasubramani <vyas.ramasubramani@gmail.com>
Date: Thu, 23 Mar 2023 09:28:16 -0400
Subject: [PATCH 10/25] Generate pyproject dependencies with dfg (#1364)

This PR uses dependencies.yaml to generate the dependency lists in pyproject.toml

Authors:
  - Vyas Ramasubramani (https://github.com/vyasr)
  - Corey J. Nolet (https://github.com/cjnolet)

Approvers:
  - AJ Schmidt (https://github.com/ajschmidt8)
  - Corey J. Nolet (https://github.com/cjnolet)

URL: https://github.com/rapidsai/raft/pull/1364
---
 .pre-commit-config.yaml                       |   2 +-
 .../all_cuda-118_arch-x86_64.yaml             |   9 +-
 conda/recipes/pylibraft/meta.yaml             |   1 +
 dependencies.yaml                             | 107 +++++++++++++++---
 python/pylibraft/pyproject.toml               |  24 ++--
 python/raft-dask/pyproject.toml               |  24 ++--
 6 files changed, 127 insertions(+), 40 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 7606914589..630b8788f8 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -101,7 +101,7 @@ repos:
                 args: ["--toml", "pyproject.toml"]
                 exclude: (?x)^(^CHANGELOG.md$)
       - repo: https://github.com/rapidsai/dependency-file-generator
-        rev: v1.4.0
+        rev: v1.5.1
         hooks:
             - id: rapids-dependency-file-generator
               args: ["--clean"]
diff --git a/conda/environments/all_cuda-118_arch-x86_64.yaml b/conda/environments/all_cuda-118_arch-x86_64.yaml
index 7972a8824d..1afebc98e6 100644
--- a/conda/environments/all_cuda-118_arch-x86_64.yaml
+++ b/conda/environments/all_cuda-118_arch-x86_64.yaml
@@ -18,13 +18,14 @@ dependencies:
 - cupy
 - cxx-compiler
 - cython>=0.29,<0.30
-- dask-cuda=23.04
+- dask-cuda==23.4.*
 - dask>=2023.1.1
 - distributed>=2023.1.1
 - doxygen>=1.8.20
 - gcc_linux-64=11.*
 - graphviz
 - ipython
+- joblib>=0.11
 - libcublas-dev=11.11.3.6
 - libcublas=11.11.3.6
 - libcurand-dev=10.3.0.86
@@ -35,12 +36,14 @@ dependencies:
 - libcusparse=11.7.5.86
 - nccl>=2.9.9
 - ninja
+- numba>=0.49
+- numpy>=1.21
 - numpydoc
 - pydata-sphinx-theme
 - pytest
 - pytest-cov
 - recommonmark
-- rmm=23.04
+- rmm==23.4.*
 - scikit-build>=0.13.1
 - scikit-learn
 - scipy
@@ -48,6 +51,6 @@ dependencies:
 - sphinx-markdown-tables
 - sysroot_linux-64==2.17
 - ucx-proc=*=gpu
-- ucx-py=0.31.*
+- ucx-py==0.31.*
 - ucx>=1.13.0
 name: all_cuda-118_arch-x86_64
diff --git a/conda/recipes/pylibraft/meta.yaml b/conda/recipes/pylibraft/meta.yaml
index a528064348..7730801801 100644
--- a/conda/recipes/pylibraft/meta.yaml
+++ b/conda/recipes/pylibraft/meta.yaml
@@ -36,6 +36,7 @@ requirements:
     - cython >=0.29,<0.30
     - libraft {{ version }}
     - libraft-headers {{ version }}
+    - numpy >=1.21
     - python x.x
     - rmm ={{ minor_version }}
     - scikit-build >=0.13.1
diff --git a/dependencies.yaml b/dependencies.yaml
index c06ce4a20f..dd361a0cdf 100644
--- a/dependencies.yaml
+++ b/dependencies.yaml
@@ -7,11 +7,14 @@ files:
       arch: [x86_64]
     includes:
       - build
+      - build_pylibraft
       - cudatoolkit
       - develop
       - docs
-      - run
-      - test_python
+      - run_raft_dask
+      - run_pylibraft
+      - test_python_common
+      - test_pylibraft
   test_cpp:
     output: none
     includes:
@@ -21,7 +24,8 @@ files:
     includes:
       - cudatoolkit
       - py_version
-      - test_python
+      - test_python_common
+      - test_pylibraft
   checks:
     output: none
     includes:
@@ -33,6 +37,54 @@ files:
       - cudatoolkit
       - docs
       - py_version
+  py_build_pylibraft:
+    output: pyproject
+    pyproject_dir: python/pylibraft
+    extras:
+      table: build-system
+    includes:
+      - build
+      - build_pylibraft
+      - build_wheels
+  py_run_pylibraft:
+    output: pyproject
+    pyproject_dir: python/pylibraft
+    extras:
+      table: project
+    includes:
+      - run_pylibraft
+  py_test_pylibraft:
+    output: pyproject
+    pyproject_dir: python/pylibraft
+    extras:
+      table: project.optional-dependencies
+      key: test
+    includes:
+      - test_python_common
+      - test_pylibraft
+  py_build_raft_dask:
+    output: pyproject
+    pyproject_dir: python/raft-dask
+    extras:
+      table: build-system
+    includes:
+      - build
+      - build_wheels
+  py_run_raft_dask:
+    output: pyproject
+    pyproject_dir: python/raft-dask
+    extras:
+      table: project
+    includes:
+      - run_raft_dask
+  py_test_raft_dask:
+    output: pyproject
+    pyproject_dir: python/raft-dask
+    extras:
+      table: project.optional-dependencies
+      key: test
+    includes:
+      - test_python_common
 channels:
   - rapidsai
   - rapidsai-nightly
@@ -42,10 +94,9 @@ channels:
 dependencies:
   build:
     common:
-      - output_types: [conda, requirements]
+      - output_types: [conda, requirements, pyproject]
         packages:
           - cmake>=3.23.1,!=3.25.0
-          - cuda-python >=11.7.1,<12.0
           - cython>=0.29,<0.30
           - ninja
           - scikit-build>=0.13.1
@@ -67,6 +118,12 @@ dependencies:
             packages:
               - gcc_linux-aarch64=11.*
               - sysroot_linux-aarch64==2.17
+  build_pylibraft:
+    common:
+      - output_types: [conda, requirements, pyproject]
+        packages:
+          - &cuda_python cuda-python >=11.7.1,<12.0
+          - &rmm rmm==23.4.*
   checks:
     common:
       - output_types: [conda, requirements]
@@ -151,6 +208,12 @@ dependencies:
           - recommonmark
           - sphinx-copybutton
           - sphinx-markdown-tables
+  build_wheels:
+    common:
+      - output_types: pyproject
+        packages:
+          - wheel
+          - setuptools
   py_version:
     specific:
       - output_types: conda
@@ -170,23 +233,41 @@ dependencies:
           - matrix:
             packages:
               - python>=3.8,<3.11
-  run:
+  run_pylibraft:
     common:
-      - output_types: [conda]
+      - output_types: [conda, pyproject]
+        packages:
+          - &numpy numpy>=1.21
+          - *cuda_python
+          - *rmm
+  run_raft_dask:
+    common:
+      - output_types: [conda, pyproject]
         packages:
           - dask>=2023.1.1
+          - dask-cuda==23.4.*
           - distributed>=2023.1.1
+          - joblib>=0.11
+          - numba>=0.49
+          - *numpy
+          - ucx-py==0.31.*
+      - output_types: conda
+        packages:
           - ucx>=1.13.0
-          - ucx-py=0.31.*
           - ucx-proc=*=gpu
-          - rmm=23.04
-          - dask-cuda=23.04
-  test_python:
+      - output_types: pyproject
+        packages:
+          - pylibraft==23.4.*
+  test_python_common:
     common:
-      - output_types: [conda, requirements]
+      - output_types: [conda, requirements, pyproject]
         packages:
-          - cupy
           - pytest
           - pytest-cov
+  test_pylibraft:
+    common:
+      - output_types: [conda, requirements, pyproject]
+        packages:
+          - cupy
           - scikit-learn
           - scipy
diff --git a/python/pylibraft/pyproject.toml b/python/pylibraft/pyproject.toml
index 7d92fd0763..fed15bbab0 100644
--- a/python/pylibraft/pyproject.toml
+++ b/python/pylibraft/pyproject.toml
@@ -15,15 +15,15 @@
 [build-system]
 
 requires = [
-    "wheel",
-    "setuptools",
-    "cython>=0.29,<0.30",
-    "cuda-python>=11.7.1,<12.0",
-    "scikit-build>=0.13.1",
     "cmake>=3.23.1,!=3.25.0",
+    "cuda-python >=11.7.1,<12.0",
+    "cython>=0.29,<0.30",
     "ninja",
     "rmm==23.4.*",
-]
+    "scikit-build>=0.13.1",
+    "setuptools",
+    "wheel",
+] # This list was generated by `rapids-dependency-file-generator`. To make changes, edit ../../dependencies.yaml and run `rapids-dependency-file-generator`.
 build-backend = "setuptools.build_meta"
 
 [project]
@@ -37,10 +37,10 @@ authors = [
 license = { text = "Apache 2.0" }
 requires-python = ">=3.8"
 dependencies = [
-    "numpy",
-    "cuda-python>=11.7.1,<12.0",
+    "cuda-python >=11.7.1,<12.0",
+    "numpy>=1.21",
     "rmm==23.4.*",
-]
+] # This list was generated by `rapids-dependency-file-generator`. To make changes, edit ../../dependencies.yaml and run `rapids-dependency-file-generator`.
 classifiers = [
     "Intended Audience :: Developers",
     "Programming Language :: Python",
@@ -50,10 +50,12 @@ classifiers = [
 
 [project.optional-dependencies]
 test = [
+    "cupy",
     "pytest",
-    "scipy",
+    "pytest-cov",
     "scikit-learn",
-]
+    "scipy",
+] # This list was generated by `rapids-dependency-file-generator`. To make changes, edit ../../dependencies.yaml and run `rapids-dependency-file-generator`.
 
 [project.urls]
 Homepage = "https://github.com/rapidsai/raft"
diff --git a/python/raft-dask/pyproject.toml b/python/raft-dask/pyproject.toml
index 2fe6522f57..fe490ea117 100644
--- a/python/raft-dask/pyproject.toml
+++ b/python/raft-dask/pyproject.toml
@@ -15,13 +15,13 @@
 [build-system]
 
 requires = [
-    "wheel",
-    "setuptools",
-    "cython>=0.29,<0.30",
-    "scikit-build>=0.13.1",
     "cmake>=3.23.1,!=3.25.0",
+    "cython>=0.29,<0.30",
     "ninja",
-]
+    "scikit-build>=0.13.1",
+    "setuptools",
+    "wheel",
+] # This list was generated by `rapids-dependency-file-generator`. To make changes, edit ../../dependencies.yaml and run `rapids-dependency-file-generator`.
 
 [project]
 name = "raft-dask"
@@ -34,15 +34,15 @@ authors = [
 license = { text = "Apache 2.0" }
 requires-python = ">=3.8"
 dependencies = [
-    "numpy",
-    "numba>=0.49",
-    "joblib>=0.11",
     "dask-cuda==23.4.*",
     "dask>=2023.1.1",
-    "ucx-py==0.31.*",
     "distributed>=2023.1.1",
+    "joblib>=0.11",
+    "numba>=0.49",
+    "numpy>=1.21",
     "pylibraft==23.4.*",
-]
+    "ucx-py==0.31.*",
+] # This list was generated by `rapids-dependency-file-generator`. To make changes, edit ../../dependencies.yaml and run `rapids-dependency-file-generator`.
 classifiers = [
     "Intended Audience :: Developers",
     "Programming Language :: Python",
@@ -53,8 +53,8 @@ classifiers = [
 [project.optional-dependencies]
 test = [
     "pytest",
-    "dask[distributed,dataframe]",
-]
+    "pytest-cov",
+] # This list was generated by `rapids-dependency-file-generator`. To make changes, edit ../../dependencies.yaml and run `rapids-dependency-file-generator`.
 
 [project.urls]
 Homepage = "https://github.com/rapidsai/raft"

From 31847afbaa55ead3ee99d44fcbe0c41ff8e1f726 Mon Sep 17 00:00:00 2001
From: "Corey J. Nolet" <cjnolet@gmail.com>
Date: Thu, 23 Mar 2023 18:48:01 -0400
Subject: [PATCH 11/25] Python API for brute-force KNN (#1292)

Closes #1289

Authors:
  - Corey J. Nolet (https://github.com/cjnolet)
  - Ben Frederickson (https://github.com/benfred)

Approvers:
  - Ben Frederickson (https://github.com/benfred)

URL: https://github.com/rapidsai/raft/pull/1292
---
 cpp/CMakeLists.txt                            |   1 +
 .../raft_runtime/neighbors/brute_force.hpp    |  19 +-
 .../brute_force_knn_int64_t_float.cu          |  46 ++---
 python/pylibraft/pylibraft/common/mdspan.pyx  |   1 -
 .../pylibraft/neighbors/CMakeLists.txt        |   2 +-
 .../pylibraft/pylibraft/neighbors/__init__.py |   5 +-
 .../pylibraft/neighbors/brute_force.pyx       | 179 ++++++++++++++++++
 .../pylibraft/pylibraft/neighbors/common.pyx  |  12 +-
 .../pylibraft/neighbors/cpp/__init__.pxd      |   0
 .../pylibraft/neighbors/cpp/__init__.py       |  14 ++
 .../pylibraft/neighbors/cpp/brute_force.pxd   |  55 ++++++
 .../pylibraft/test/test_brue_force.py         |  99 ++++++++++
 .../pylibraft/pylibraft/test/test_doctests.py |   3 +-
 13 files changed, 395 insertions(+), 41 deletions(-)
 create mode 100644 python/pylibraft/pylibraft/neighbors/brute_force.pyx
 create mode 100644 python/pylibraft/pylibraft/neighbors/cpp/__init__.pxd
 create mode 100644 python/pylibraft/pylibraft/neighbors/cpp/__init__.py
 create mode 100644 python/pylibraft/pylibraft/neighbors/cpp/brute_force.pxd
 create mode 100644 python/pylibraft/pylibraft/test/test_brue_force.py

diff --git a/cpp/CMakeLists.txt b/cpp/CMakeLists.txt
index 034dc059b0..c1704552ec 100644
--- a/cpp/CMakeLists.txt
+++ b/cpp/CMakeLists.txt
@@ -304,6 +304,7 @@ if(RAFT_COMPILE_LIBRARY)
     # These are somehow missing a kernel definition which is causing a compile error.
     # src/distance/specializations/detail/kernels/rbf_kernel_double.cu
     # src/distance/specializations/detail/kernels/rbf_kernel_float.cu
+    src/neighbors/brute_force_knn_int64_t_float.cu
     src/distance/specializations/detail/kernels/tanh_kernel_double.cu
     src/distance/specializations/detail/kernels/tanh_kernel_float.cu
     src/distance/specializations/detail/kl_divergence_float_float_float_int.cu
diff --git a/cpp/include/raft_runtime/neighbors/brute_force.hpp b/cpp/include/raft_runtime/neighbors/brute_force.hpp
index 19904f4f78..12da6ff101 100644
--- a/cpp/include/raft_runtime/neighbors/brute_force.hpp
+++ b/cpp/include/raft_runtime/neighbors/brute_force.hpp
@@ -21,18 +21,17 @@
 
 namespace raft::runtime::neighbors::brute_force {
 
-#define RAFT_INST_BFKNN(IDX_T, DATA_T, MATRIX_IDX_T, INDEX_LAYOUT, SEARCH_LAYOUT)                 \
-  void knn(raft::device_resources const& handle,                                                  \
-           std::vector<raft::device_matrix_view<const DATA_T, MATRIX_IDX_T, INDEX_LAYOUT>> index, \
-           raft::device_matrix_view<const DATA_T, MATRIX_IDX_T, SEARCH_LAYOUT> search,            \
-           raft::device_matrix_view<IDX_T, MATRIX_IDX_T, row_major> indices,                      \
-           raft::device_matrix_view<DATA_T, MATRIX_IDX_T, row_major> distances,                   \
-           int k,                                                                                 \
-           distance::DistanceType metric         = distance::DistanceType::L2Unexpanded,          \
-           std::optional<float> metric_arg       = std::make_optional<float>(2.0f),               \
+#define RAFT_INST_BFKNN(IDX_T, DATA_T, MATRIX_IDX_T, INDEX_LAYOUT, SEARCH_LAYOUT)        \
+  void knn(raft::device_resources const& handle,                                         \
+           raft::device_matrix_view<const DATA_T, MATRIX_IDX_T, INDEX_LAYOUT> index,     \
+           raft::device_matrix_view<const DATA_T, MATRIX_IDX_T, SEARCH_LAYOUT> search,   \
+           raft::device_matrix_view<IDX_T, MATRIX_IDX_T, row_major> indices,             \
+           raft::device_matrix_view<DATA_T, MATRIX_IDX_T, row_major> distances,          \
+           distance::DistanceType metric         = distance::DistanceType::L2Unexpanded, \
+           std::optional<float> metric_arg       = std::make_optional<float>(2.0f),      \
            std::optional<IDX_T> global_id_offset = std::nullopt);
 
-RAFT_INST_BFKNN(int64_t, float, uint32_t, raft::row_major, raft::row_major);
+RAFT_INST_BFKNN(int64_t, float, int64_t, raft::row_major, raft::row_major);
 
 #undef RAFT_INST_BFKNN
 
diff --git a/cpp/src/neighbors/brute_force_knn_int64_t_float.cu b/cpp/src/neighbors/brute_force_knn_int64_t_float.cu
index b0411a59ce..585084fc97 100644
--- a/cpp/src/neighbors/brute_force_knn_int64_t_float.cu
+++ b/cpp/src/neighbors/brute_force_knn_int64_t_float.cu
@@ -14,8 +14,6 @@
  * limitations under the License.
  */
 
-#pragma once
-
 #include <raft/core/device_mdspan.hpp>
 #include <raft/core/device_resources.hpp>
 #include <raft/neighbors/brute_force.cuh>
@@ -24,30 +22,34 @@
 
 #include <raft_runtime/neighbors/brute_force.hpp>
 
+#include <vector>
+
 namespace raft::runtime::neighbors::brute_force {
 
-#define RAFT_INST_BFKNN(IDX_T, DATA_T, MATRIX_IDX_T, INDEX_LAYOUT, SEARCH_LAYOUT)                 \
-  void knn(raft::device_resources const& handle,                                                  \
-           std::vector<raft::device_matrix_view<const DATA_T, MATRIX_IDX_T, INDEX_LAYOUT>> index, \
-           raft::device_matrix_view<const DATA_T, MATRIX_IDX_T, SEARCH_LAYOUT> search,            \
-           raft::device_matrix_view<IDX_T, MATRIX_IDX_T, row_major> indices,                      \
-           raft::device_matrix_view<DATA_T, MATRIX_IDX_T, row_major> distances,                   \
-           distance::DistanceType metric         = distance::DistanceType::L2Unexpanded,          \
-           std::optional<float> metric_arg       = std::make_optional<float>(2.0f),               \
-           std::optional<IDX_T> global_id_offset = std::nullopt)                                  \
-  {                                                                                               \
-    raft::neighbors::brute_force::knn(handle,                                                     \
-                                      index,                                                      \
-                                      search,                                                     \
-                                      indices,                                                    \
-                                      distances,                                                  \
-                                      static_cast<int>(indices.extent(1)),                        \
-                                      metric,                                                     \
-                                      metric_arg,                                                 \
-                                      global_id_offset);                                          \
+#define RAFT_INST_BFKNN(IDX_T, DATA_T, MATRIX_IDX_T, INDEX_LAYOUT, SEARCH_LAYOUT)        \
+  void knn(raft::device_resources const& handle,                                         \
+           raft::device_matrix_view<const DATA_T, MATRIX_IDX_T, INDEX_LAYOUT> index,     \
+           raft::device_matrix_view<const DATA_T, MATRIX_IDX_T, SEARCH_LAYOUT> search,   \
+           raft::device_matrix_view<IDX_T, MATRIX_IDX_T, row_major> indices,             \
+           raft::device_matrix_view<DATA_T, MATRIX_IDX_T, row_major> distances,          \
+           distance::DistanceType metric,                                                \
+           std::optional<float> metric_arg,                                              \
+           std::optional<IDX_T> global_id_offset)                                        \
+  {                                                                                      \
+    std::vector<raft::device_matrix_view<const DATA_T, MATRIX_IDX_T, INDEX_LAYOUT>> vec; \
+    vec.push_back(index);                                                                \
+    raft::neighbors::brute_force::knn(handle,                                            \
+                                      vec,                                               \
+                                      search,                                            \
+                                      indices,                                           \
+                                      distances,                                         \
+                                      static_cast<int>(distances.extent(1)),             \
+                                      metric,                                            \
+                                      metric_arg,                                        \
+                                      global_id_offset);                                 \
   }
 
-RAFT_INST_BFKNN(int64_t, float, uint32_t, raft::row_major, raft::row_major);
+RAFT_INST_BFKNN(int64_t, float, int64_t, raft::row_major, raft::row_major);
 
 #undef RAFT_INST_BFKNN
 
diff --git a/python/pylibraft/pylibraft/common/mdspan.pyx b/python/pylibraft/pylibraft/common/mdspan.pyx
index c7b42ecab7..f35a94bb9c 100644
--- a/python/pylibraft/pylibraft/common/mdspan.pyx
+++ b/python/pylibraft/pylibraft/common/mdspan.pyx
@@ -159,7 +159,6 @@ cdef device_matrix_view[float, int64_t, row_major] \
     return make_device_matrix_view[float, int64_t, row_major](
         <float*><uintptr_t>cai.data, shape[0], shape[1])
 
-
 cdef device_matrix_view[uint8_t, int64_t, row_major] \
         get_dmv_uint8(cai, check_shape) except *:
     if cai.dtype != np.uint8:
diff --git a/python/pylibraft/pylibraft/neighbors/CMakeLists.txt b/python/pylibraft/pylibraft/neighbors/CMakeLists.txt
index 98f0d7f67a..7b9c1591c1 100644
--- a/python/pylibraft/pylibraft/neighbors/CMakeLists.txt
+++ b/python/pylibraft/pylibraft/neighbors/CMakeLists.txt
@@ -13,7 +13,7 @@
 # =============================================================================
 
 # Set the list of Cython files to build
-set(cython_sources common.pyx refine.pyx)
+set(cython_sources common.pyx refine.pyx brute_force.pyx)
 set(linked_libraries raft::raft raft::compiled)
 
 # Build all of the Cython targets
diff --git a/python/pylibraft/pylibraft/neighbors/__init__.py b/python/pylibraft/pylibraft/neighbors/__init__.py
index f7510ba2db..a50b6f21a7 100644
--- a/python/pylibraft/pylibraft/neighbors/__init__.py
+++ b/python/pylibraft/pylibraft/neighbors/__init__.py
@@ -12,6 +12,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
+
+from pylibraft.neighbors import brute_force
+
 from .refine import refine
 
-__all__ = ["common", "refine"]
+__all__ = ["common", "refine", "brute_force"]
diff --git a/python/pylibraft/pylibraft/neighbors/brute_force.pyx b/python/pylibraft/pylibraft/neighbors/brute_force.pyx
new file mode 100644
index 0000000000..dbd888756d
--- /dev/null
+++ b/python/pylibraft/pylibraft/neighbors/brute_force.pyx
@@ -0,0 +1,179 @@
+#
+# Copyright (c) 2022-2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# cython: profile=False
+# distutils: language = c++
+# cython: embedsignature = True
+# cython: language_level = 3
+
+import numpy as np
+
+from cython.operator cimport dereference as deref
+from libcpp cimport bool, nullptr
+from libcpp.vector cimport vector
+
+from pylibraft.distance.distance_type cimport DistanceType
+
+from pylibraft.common import (
+    DeviceResources,
+    auto_convert_output,
+    cai_wrapper,
+    device_ndarray,
+)
+
+from libc.stdint cimport int64_t, uintptr_t
+
+from pylibraft.common.cpp.optional cimport optional
+from pylibraft.common.handle cimport device_resources
+from pylibraft.common.mdspan cimport get_dmv_float, get_dmv_int64
+
+from pylibraft.common.handle import auto_sync_handle
+from pylibraft.common.input_validation import is_c_contiguous
+from pylibraft.common.interruptible import cuda_interruptible
+
+from pylibraft.distance.distance_type cimport DistanceType
+
+# TODO: Centralize this
+
+from pylibraft.distance.pairwise_distance import DISTANCE_TYPES
+
+from pylibraft.common.cpp.mdspan cimport (
+    device_matrix_view,
+    host_matrix_view,
+    make_device_matrix_view,
+    make_host_matrix_view,
+    row_major,
+)
+from pylibraft.neighbors.cpp.brute_force cimport knn as c_knn
+
+
+def _get_array_params(array_interface, check_dtype=None):
+    dtype = np.dtype(array_interface["typestr"])
+    if check_dtype is None and dtype != check_dtype:
+        raise TypeError("dtype %s not supported" % dtype)
+    shape = array_interface["shape"]
+    if len(shape) != 2:
+        raise ValueError("Expected a 2D array, got %d D" % len(shape))
+    data = array_interface["data"][0]
+    return (shape, dtype, data)
+
+
+@auto_sync_handle
+@auto_convert_output
+def knn(dataset, queries, k=None, indices=None, distances=None,
+        metric="sqeuclidean", metric_arg=2.0,
+        global_id_offset=0, handle=None):
+    """
+    Perform a brute-force nearest neighbors search.
+
+    Parameters
+    ----------
+    dataset : array interface compliant matrix, row-major layout,
+        shape (n_samples, dim). Supported dtype [float]
+    queries : array interface compliant matrix, row-major layout,
+        shape (n_queries, dim) Supported dtype [float]
+    k : int
+        Number of neighbors to search (k <= 2048). Optional if indices or
+        distances arrays are given (in which case their second dimension
+        is k).
+    indices :  Optional array interface compliant matrix shape
+                (n_queries, k), dtype int64_t. If supplied, neighbor
+                indices will be written here in-place. (default None)
+        Supported dtype uint64
+    distances :  Optional array interface compliant matrix shape
+                (n_queries, k), dtype float. If supplied, neighbor
+                indices will be written here in-place. (default None)
+
+    {handle_docstring}
+
+    Returns
+    -------
+    indices: array interface compliant object containing resulting indices
+             shape (n_queries, k)
+
+    distances: array interface compliant object containing resulting distances
+               shape (n_queries, k)
+
+    Examples
+    --------
+
+    >>> import cupy as cp
+
+    >>> from pylibraft.common import DeviceResources
+    >>> from pylibraft.neighbors.brute_force import knn
+
+    >>> n_samples = 50000
+    >>> n_features = 50
+    >>> n_queries = 1000
+
+    >>> dataset = cp.random.random_sample((n_samples, n_features),
+    ...                                   dtype=cp.float32)
+    >>> # Search using the built index
+    >>> queries = cp.random.random_sample((n_queries, n_features),
+    ...                                   dtype=cp.float32)
+    >>> k = 40
+    >>> distances, neighbors = knn(dataset, queries, k)
+    >>> distances = cp.asarray(distances)
+    >>> neighbors = cp.asarray(neighbors)
+    """
+
+    if handle is None:
+        handle = DeviceResources()
+
+    dataset_cai = cai_wrapper(dataset)
+    queries_cai = cai_wrapper(queries)
+
+    if k is None:
+        if indices is not None:
+            k = cai_wrapper(indices).shape[1]
+        elif distances is not None:
+            k = cai_wrapper(distances).shape[1]
+        else:
+            raise ValueError("Argument k must be specified if both indices "
+                             "and distances arg is None")
+
+    n_queries = cai_wrapper(queries).shape[0]
+
+    if indices is None:
+        indices = device_ndarray.empty((n_queries, k), dtype='int64')
+
+    if distances is None:
+        distances = device_ndarray.empty((n_queries, k), dtype='float32')
+
+    cdef DistanceType c_metric = DISTANCE_TYPES[metric]
+
+    distances_cai = cai_wrapper(distances)
+    indices_cai = cai_wrapper(indices)
+
+    cdef optional[float] c_metric_arg = <float>metric_arg
+    cdef optional[int64_t] c_global_offset = <int64_t>global_id_offset
+
+    cdef device_resources* handle_ = \
+        <device_resources*><size_t>handle.getHandle()
+
+    if dataset_cai.dtype == np.float32:
+        with cuda_interruptible():
+            c_knn(deref(handle_),
+                  get_dmv_float(dataset_cai, check_shape=True),
+                  get_dmv_float(queries_cai, check_shape=True),
+                  get_dmv_int64(indices_cai, check_shape=True),
+                  get_dmv_float(distances_cai, check_shape=True),
+                  c_metric,
+                  c_metric_arg,
+                  c_global_offset)
+    else:
+        raise TypeError("dtype %s not supported" % dataset_cai.dtype)
+
+    return (distances, indices)
diff --git a/python/pylibraft/pylibraft/neighbors/common.pyx b/python/pylibraft/pylibraft/neighbors/common.pyx
index a8380b589b..24c1abcf18 100644
--- a/python/pylibraft/pylibraft/neighbors/common.pyx
+++ b/python/pylibraft/pylibraft/neighbors/common.pyx
@@ -22,13 +22,15 @@ import warnings
 
 from pylibraft.distance.distance_type cimport DistanceType
 
+SUPPORTED_DISTANCES = {
+    "sqeuclidean": DistanceType.L2Expanded,
+    "euclidean": DistanceType.L2SqrtExpanded,
+    "inner_product": DistanceType.InnerProduct,
+
+}
+
 
 def _get_metric(metric):
-    SUPPORTED_DISTANCES = {
-        "sqeuclidean": DistanceType.L2Expanded,
-        "euclidean": DistanceType.L2SqrtExpanded,
-        "inner_product": DistanceType.InnerProduct
-    }
     if metric not in SUPPORTED_DISTANCES:
         if metric == "l2_expanded":
             warnings.warn("Using l2_expanded as a metric name is deprecated,"
diff --git a/python/pylibraft/pylibraft/neighbors/cpp/__init__.pxd b/python/pylibraft/pylibraft/neighbors/cpp/__init__.pxd
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/python/pylibraft/pylibraft/neighbors/cpp/__init__.py b/python/pylibraft/pylibraft/neighbors/cpp/__init__.py
new file mode 100644
index 0000000000..a7e7b75096
--- /dev/null
+++ b/python/pylibraft/pylibraft/neighbors/cpp/__init__.py
@@ -0,0 +1,14 @@
+# Copyright (c) 2022-2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
diff --git a/python/pylibraft/pylibraft/neighbors/cpp/brute_force.pxd b/python/pylibraft/pylibraft/neighbors/cpp/brute_force.pxd
new file mode 100644
index 0000000000..de5e0af267
--- /dev/null
+++ b/python/pylibraft/pylibraft/neighbors/cpp/brute_force.pxd
@@ -0,0 +1,55 @@
+#
+# Copyright (c) 2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# cython: profile=False
+# distutils: language = c++
+# cython: embedsignature = True
+# cython: language_level = 3
+
+import numpy as np
+
+import pylibraft.common.handle
+
+from cython.operator cimport dereference as deref
+from libc.stdint cimport int8_t, int64_t, uint8_t, uint64_t, uintptr_t
+from libcpp cimport bool, nullptr
+from libcpp.string cimport string
+from libcpp.vector cimport vector
+
+from rmm._lib.memory_resource cimport device_memory_resource
+
+from pylibraft.common.cpp.mdspan cimport (
+    device_matrix_view,
+    host_matrix_view,
+    make_device_matrix_view,
+    make_host_matrix_view,
+    row_major,
+)
+from pylibraft.common.cpp.optional cimport optional
+from pylibraft.common.handle cimport device_resources
+from pylibraft.distance.distance_type cimport DistanceType
+
+
+cdef extern from "raft_runtime/neighbors/brute_force.hpp" \
+        namespace "raft::runtime::neighbors::brute_force" nogil:
+
+    cdef void knn(const device_resources & handle,
+                  device_matrix_view[float, int64_t, row_major] index,
+                  device_matrix_view[float, int64_t, row_major] search,
+                  device_matrix_view[int64_t, int64_t, row_major] indices,
+                  device_matrix_view[float, int64_t, row_major] distances,
+                  DistanceType metric,
+                  optional[float] metric_arg,
+                  optional[int64_t] global_id_offset) except +
diff --git a/python/pylibraft/pylibraft/test/test_brue_force.py b/python/pylibraft/pylibraft/test/test_brue_force.py
new file mode 100644
index 0000000000..f349be892d
--- /dev/null
+++ b/python/pylibraft/pylibraft/test/test_brue_force.py
@@ -0,0 +1,99 @@
+# Copyright (c) 2022-2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+import numpy as np
+import pytest
+from scipy.spatial.distance import cdist
+
+from pylibraft.common import DeviceResources, Stream, device_ndarray
+from pylibraft.neighbors.brute_force import knn
+
+
+@pytest.mark.parametrize("n_index_rows", [32, 100])
+@pytest.mark.parametrize("n_query_rows", [32, 100])
+@pytest.mark.parametrize("n_cols", [40, 100])
+@pytest.mark.parametrize("k", [1, 5, 32])
+@pytest.mark.parametrize(
+    "metric",
+    [
+        "euclidean",
+        "cityblock",
+        "chebyshev",
+        "canberra",
+        "correlation",
+        "russellrao",
+        "cosine",
+        "sqeuclidean",
+        # "inner_product",
+    ],
+)
+@pytest.mark.parametrize("inplace", [True, False])
+@pytest.mark.parametrize("order", ["F", "C"])
+@pytest.mark.parametrize("dtype", [np.float32])
+def test_knn(
+    n_index_rows, n_query_rows, n_cols, k, inplace, metric, order, dtype
+):
+    index = np.random.random_sample((n_index_rows, n_cols)).astype(dtype)
+    queries = np.random.random_sample((n_query_rows, n_cols)).astype(dtype)
+
+    # RussellRao expects boolean arrays
+    if metric == "russellrao":
+        index[index < 0.5] = 0.0
+        index[index >= 0.5] = 1.0
+        queries[queries < 0.5] = 0.0
+        queries[queries >= 0.5] = 1.0
+
+    indices = np.zeros((n_query_rows, k), dtype="int64")
+    distances = np.zeros((n_query_rows, k), dtype=dtype)
+
+    index_device = device_ndarray(index)
+
+    queries_device = device_ndarray(queries)
+    indices_device = device_ndarray(indices)
+    distances_device = device_ndarray(distances)
+
+    s2 = Stream()
+    handle = DeviceResources(stream=s2)
+    ret_distances, ret_indices = knn(
+        index_device,
+        queries_device,
+        k,
+        indices=indices_device,
+        distances=distances_device,
+        metric=metric,
+        handle=handle,
+    )
+    handle.sync()
+
+    pw_dists = cdist(queries, index, metric=metric)
+
+    distances_device = ret_distances if not inplace else distances_device
+
+    actual_distances = distances_device.copy_to_host()
+
+    actual_distances[actual_distances <= 1e-5] = 0.0
+    argsort = np.argsort(pw_dists, axis=1)
+
+    for i in range(pw_dists.shape[0]):
+        expected_indices = argsort[i]
+        gpu_dists = actual_distances[i]
+
+        if metric == "correlation" or metric == "cosine":
+            gpu_dists = gpu_dists[::-1]
+
+        cpu_ordered = pw_dists[i, expected_indices]
+        np.testing.assert_allclose(
+            cpu_ordered[:k], gpu_dists, atol=1e-4, rtol=1e-4
+        )
diff --git a/python/pylibraft/pylibraft/test/test_doctests.py b/python/pylibraft/pylibraft/test/test_doctests.py
index 3276ca115f..34be6c55f5 100644
--- a/python/pylibraft/pylibraft/test/test_doctests.py
+++ b/python/pylibraft/pylibraft/test/test_doctests.py
@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2022, NVIDIA CORPORATION.
+# Copyright (c) 2022-2023, NVIDIA CORPORATION.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -96,6 +96,7 @@ def _find_doctests_in_obj(obj, finder=None, criteria=None):
 DOC_STRINGS.extend(_find_doctests_in_obj(pylibraft.distance))
 DOC_STRINGS.extend(_find_doctests_in_obj(pylibraft.neighbors))
 DOC_STRINGS.extend(_find_doctests_in_obj(pylibraft.neighbors.ivf_pq))
+DOC_STRINGS.extend(_find_doctests_in_obj(pylibraft.neighbors.brute_force))
 DOC_STRINGS.extend(_find_doctests_in_obj(pylibraft.random))
 
 

From 0df5cee684cb032e81308e355852b437265a6ffd Mon Sep 17 00:00:00 2001
From: Peter Andreas Entschev <peter@entschev.com>
Date: Thu, 23 Mar 2023 23:55:31 +0100
Subject: [PATCH 12/25] Relax UCX pin to allow 1.14 (#1366)

UCX 1.14.0 was recently released and conda-forge package was updated in https://github.com/conda-forge/ucx-split-feedstock/pull/111 with several packaging improvements. Relax the pin to allow installing UCX v1.14.x as well.

Authors:
  - Peter Andreas Entschev (https://github.com/pentschev)
  - AJ Schmidt (https://github.com/ajschmidt8)
  - Corey J. Nolet (https://github.com/cjnolet)

Approvers:
  - AJ Schmidt (https://github.com/ajschmidt8)

URL: https://github.com/rapidsai/raft/pull/1366
---
 conda/recipes/raft-dask/conda_build_config.yaml | 2 +-
 conda/recipes/raft-dask/meta.yaml               | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/conda/recipes/raft-dask/conda_build_config.yaml b/conda/recipes/raft-dask/conda_build_config.yaml
index ef22522116..778b187870 100644
--- a/conda/recipes/raft-dask/conda_build_config.yaml
+++ b/conda/recipes/raft-dask/conda_build_config.yaml
@@ -11,7 +11,7 @@ sysroot_version:
   - "2.17"
 
 ucx_version:
-  - "1.13.0"
+  - ">=1.13.0,<1.15.0"
 
 ucx_py_version:
   - "0.31.*"
diff --git a/conda/recipes/raft-dask/meta.yaml b/conda/recipes/raft-dask/meta.yaml
index b387f0f47c..59a67fe148 100644
--- a/conda/recipes/raft-dask/meta.yaml
+++ b/conda/recipes/raft-dask/meta.yaml
@@ -54,7 +54,7 @@ requirements:
     - pylibraft {{ version }}
     - python x.x
     - rmm ={{ minor_version }}
-    - ucx >={{ ucx_version }}
+    - ucx {{ ucx_version }}
     - ucx-proc=*=gpu
     - ucx-py {{ ucx_py_version }}
 

From 1b18d1fd5e143a547c94dec1fbf793bdb4685400 Mon Sep 17 00:00:00 2001
From: "Corey J. Nolet" <cjnolet@gmail.com>
Date: Thu, 23 Mar 2023 20:28:57 -0400
Subject: [PATCH 13/25] Adding architecture diagram to README.md (#1370)

I noticed some folks on Twitter asking about an architecture diagram for RAFT. I think it's a good idea to provide this in the README.

Authors:
  - Corey J. Nolet (https://github.com/cjnolet)

Approvers:
  - Ben Frederickson (https://github.com/benfred)
  - Divye Gala (https://github.com/divyegala)

URL: https://github.com/rapidsai/raft/pull/1370
---
 README.md    |  10 +++++++---
 img/arch.png | Bin 0 -> 52500 bytes
 2 files changed, 7 insertions(+), 3 deletions(-)
 create mode 100644 img/arch.png

diff --git a/README.md b/README.md
index 8519ebcae1..8c6e817bf9 100755
--- a/README.md
+++ b/README.md
@@ -35,12 +35,16 @@ While not exhaustive, the following general categories help summarize the accele
 | **Tools & Utilities** | common utilities for developing CUDA applications, multi-node multi-gpu infrastructure |
 
 
-All of RAFT's C++ APIs can be accessed header-only and optional pre-compiled shared libraries can 1) speed up compile times and 2) enable the APIs to be used without CUDA-enabled compilers.
+RAFT is a C++ header-only template library with an optional shared library that 
+1) can speed up compile times for common template types, and 
+2) provides host-accessible "runtime" APIs, which don't require a CUDA compiler to use
 
-In addition to the C++ library, RAFT also provides 2 Python libraries:
-- `pylibraft` - lightweight low-level Python wrappers around RAFT's host-accessible "runtime" APIs.
+In addition being a C++ library, RAFT also provides 2 Python libraries:
+- `pylibraft` - lightweight Python wrappers around RAFT's host-accessible "runtime" APIs.
 - `raft-dask` - multi-node multi-GPU communicator infrastructure for building distributed algorithms on the GPU with Dask.
 
+![RAFT is a C++ header-only template library with optional shared library and lightweight Python wrappers](img/arch.png)
+
 ## Getting started
 
 ### RAPIDS Memory Manager (RMM)
diff --git a/img/arch.png b/img/arch.png
new file mode 100644
index 0000000000000000000000000000000000000000..ea9cad9204d16a1ff4587a08e53e8530c5ba0e33
GIT binary patch
literal 52500
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

literal 0
HcmV?d00001


From 8f1fa073257ccf26628098bca5985238ff495a11 Mon Sep 17 00:00:00 2001
From: Yong Wang <yong-wang@users.noreply.github.com>
Date: Sat, 25 Mar 2023 00:21:07 +0800
Subject: [PATCH 14/25] Improve the performance of radix top-k (#1175)

The main changes are:

- Add a one-block version. It uses single thread block for one row of a batch and is used when `len` is relatively small (<= 16384)
- Avoid writing candidates to buffers when the number of candidates is larger than buffer length.
- Add a parameter to control whether to use a fused filter in the last pass or use a standalone filter kernel. The later case is preferable when the leading bits of inputs are almost same.
- Early stopping: when the target bucket contains `k` values, we can stop the computation earlier
- Many implementation details are polished, like the initialization of `counter`, calculation of kernel launch parameters, and the scan step
- Tests and benchmarks are updated to include the new implementations. New benchmarks are added to demonstrate the advantage of adaptive version.

Authors:
  - Yong Wang (https://github.com/yong-wang)
  - Corey J. Nolet (https://github.com/cjnolet)
  - Tamas Bela Feher (https://github.com/tfeher)

Approvers:
  - Tamas Bela Feher (https://github.com/tfeher)

URL: https://github.com/rapidsai/raft/pull/1175
---
 cpp/bench/matrix/select_k.cu                  |  128 +-
 cpp/include/raft/matrix/detail/select_k.cuh   |    2 +-
 .../raft/matrix/detail/select_radix.cuh       | 1149 ++++++++++++-----
 cpp/include/raft/spatial/knn/knn.cuh          |    4 +-
 .../raft_internal/matrix/select_k.cuh         |   43 +-
 cpp/test/matrix/select_k.cu                   |   12 +-
 6 files changed, 975 insertions(+), 363 deletions(-)

diff --git a/cpp/bench/matrix/select_k.cu b/cpp/bench/matrix/select_k.cu
index d4873e2640..870119db52 100644
--- a/cpp/bench/matrix/select_k.cu
+++ b/cpp/bench/matrix/select_k.cu
@@ -35,6 +35,10 @@
 #include <rmm/mr/device/per_device_resource.hpp>
 #include <rmm/mr/device/pool_memory_resource.hpp>
 
+#include <cstdint>
+#include <cstring>
+#include <type_traits>
+
 namespace raft::matrix {
 
 using namespace raft::bench;  // NOLINT
@@ -50,7 +54,23 @@ struct selection : public fixture {
   {
     raft::sparse::iota_fill(in_ids_.data(), IdxT(p.batch_size), IdxT(p.len), stream);
     raft::random::RngState state{42};
-    raft::random::uniform(handle, state, in_dists_.data(), in_dists_.size(), KeyT(-1.0), KeyT(1.0));
+
+    KeyT min_value = -1.0;
+    KeyT max_value = 1.0;
+    if (p.use_same_leading_bits) {
+      if constexpr (std::is_same_v<KeyT, float>) {
+        uint32_t min_bits = 0x3F800000;  // 1.0
+        uint32_t max_bits = 0x3F8000FF;  // 1.00003
+        memcpy(&min_value, &min_bits, sizeof(KeyT));
+        memcpy(&max_value, &max_bits, sizeof(KeyT));
+      } else if constexpr (std::is_same_v<KeyT, double>) {
+        uint64_t min_bits = 0x3FF0000000000000;  // 1.0
+        uint64_t max_bits = 0x3FF0000FFFFFFFFF;  // 1.000015
+        memcpy(&min_value, &min_bits, sizeof(KeyT));
+        memcpy(&max_value, &max_bits, sizeof(KeyT));
+      }
+    }
+    raft::random::uniform(handle, state, in_dists_.data(), in_dists_.size(), min_value, max_value);
   }
 
   void run_benchmark(::benchmark::State& state) override  // NOLINT
@@ -60,6 +80,7 @@ struct selection : public fixture {
     try {
       std::ostringstream label_stream;
       label_stream << params_.batch_size << "#" << params_.len << "#" << params_.k;
+      if (params_.use_same_leading_bits) { label_stream << "#same-leading-bits"; }
       state.SetLabel(label_stream.str());
       loop_on_state(state, [this, &handle]() {
         select::select_k_impl<KeyT, IdxT>(handle,
@@ -85,21 +106,55 @@ struct selection : public fixture {
 };
 
 const std::vector<select::params> kInputs{
-  {20000, 500, 1, true},   {20000, 500, 2, true},    {20000, 500, 4, true},
-  {20000, 500, 8, true},   {20000, 500, 16, true},   {20000, 500, 32, true},
-  {20000, 500, 64, true},  {20000, 500, 128, true},  {20000, 500, 256, true},
-
-  {1000, 10000, 1, true},  {1000, 10000, 2, true},   {1000, 10000, 4, true},
-  {1000, 10000, 8, true},  {1000, 10000, 16, true},  {1000, 10000, 32, true},
-  {1000, 10000, 64, true}, {1000, 10000, 128, true}, {1000, 10000, 256, true},
-
-  {100, 100000, 1, true},  {100, 100000, 2, true},   {100, 100000, 4, true},
-  {100, 100000, 8, true},  {100, 100000, 16, true},  {100, 100000, 32, true},
-  {100, 100000, 64, true}, {100, 100000, 128, true}, {100, 100000, 256, true},
-
-  {10, 1000000, 1, true},  {10, 1000000, 2, true},   {10, 1000000, 4, true},
-  {10, 1000000, 8, true},  {10, 1000000, 16, true},  {10, 1000000, 32, true},
-  {10, 1000000, 64, true}, {10, 1000000, 128, true}, {10, 1000000, 256, true},
+  {20000, 500, 1, true},
+  {20000, 500, 2, true},
+  {20000, 500, 4, true},
+  {20000, 500, 8, true},
+  {20000, 500, 16, true},
+  {20000, 500, 32, true},
+  {20000, 500, 64, true},
+  {20000, 500, 128, true},
+  {20000, 500, 256, true},
+
+  {1000, 10000, 1, true},
+  {1000, 10000, 2, true},
+  {1000, 10000, 4, true},
+  {1000, 10000, 8, true},
+  {1000, 10000, 16, true},
+  {1000, 10000, 32, true},
+  {1000, 10000, 64, true},
+  {1000, 10000, 128, true},
+  {1000, 10000, 256, true},
+
+  {100, 100000, 1, true},
+  {100, 100000, 2, true},
+  {100, 100000, 4, true},
+  {100, 100000, 8, true},
+  {100, 100000, 16, true},
+  {100, 100000, 32, true},
+  {100, 100000, 64, true},
+  {100, 100000, 128, true},
+  {100, 100000, 256, true},
+
+  {10, 1000000, 1, true},
+  {10, 1000000, 2, true},
+  {10, 1000000, 4, true},
+  {10, 1000000, 8, true},
+  {10, 1000000, 16, true},
+  {10, 1000000, 32, true},
+  {10, 1000000, 64, true},
+  {10, 1000000, 128, true},
+  {10, 1000000, 256, true},
+
+  {10, 1000000, 1, true, false, true},
+  {10, 1000000, 2, true, false, true},
+  {10, 1000000, 4, true, false, true},
+  {10, 1000000, 8, true, false, true},
+  {10, 1000000, 16, true, false, true},
+  {10, 1000000, 32, true, false, true},
+  {10, 1000000, 64, true, false, true},
+  {10, 1000000, 128, true, false, true},
+  {10, 1000000, 256, true, false, true},
 };
 
 #define SELECTION_REGISTER(KeyT, IdxT, A)                          \
@@ -109,24 +164,27 @@ const std::vector<select::params> kInputs{
     RAFT_BENCH_REGISTER(SelectK, #KeyT "/" #IdxT "/" #A, kInputs); \
   }
 
-SELECTION_REGISTER(float, uint32_t, kPublicApi);           // NOLINT
-SELECTION_REGISTER(float, uint32_t, kRadix8bits);          // NOLINT
-SELECTION_REGISTER(float, uint32_t, kRadix11bits);         // NOLINT
-SELECTION_REGISTER(float, uint32_t, kWarpAuto);            // NOLINT
-SELECTION_REGISTER(float, uint32_t, kWarpImmediate);       // NOLINT
-SELECTION_REGISTER(float, uint32_t, kWarpFiltered);        // NOLINT
-SELECTION_REGISTER(float, uint32_t, kWarpDistributed);     // NOLINT
-SELECTION_REGISTER(float, uint32_t, kWarpDistributedShm);  // NOLINT
-
-SELECTION_REGISTER(double, uint32_t, kRadix8bits);   // NOLINT
-SELECTION_REGISTER(double, uint32_t, kRadix11bits);  // NOLINT
-SELECTION_REGISTER(double, uint32_t, kWarpAuto);     // NOLINT
-
-SELECTION_REGISTER(double, int64_t, kRadix8bits);          // NOLINT
-SELECTION_REGISTER(double, int64_t, kRadix11bits);         // NOLINT
-SELECTION_REGISTER(double, int64_t, kWarpImmediate);       // NOLINT
-SELECTION_REGISTER(double, int64_t, kWarpFiltered);        // NOLINT
-SELECTION_REGISTER(double, int64_t, kWarpDistributed);     // NOLINT
-SELECTION_REGISTER(double, int64_t, kWarpDistributedShm);  // NOLINT
+SELECTION_REGISTER(float, uint32_t, kPublicApi);             // NOLINT
+SELECTION_REGISTER(float, uint32_t, kRadix8bits);            // NOLINT
+SELECTION_REGISTER(float, uint32_t, kRadix11bits);           // NOLINT
+SELECTION_REGISTER(float, uint32_t, kRadix11bitsExtraPass);  // NOLINT
+SELECTION_REGISTER(float, uint32_t, kWarpAuto);              // NOLINT
+SELECTION_REGISTER(float, uint32_t, kWarpImmediate);         // NOLINT
+SELECTION_REGISTER(float, uint32_t, kWarpFiltered);          // NOLINT
+SELECTION_REGISTER(float, uint32_t, kWarpDistributed);       // NOLINT
+SELECTION_REGISTER(float, uint32_t, kWarpDistributedShm);    // NOLINT
+
+SELECTION_REGISTER(double, uint32_t, kRadix8bits);            // NOLINT
+SELECTION_REGISTER(double, uint32_t, kRadix11bits);           // NOLINT
+SELECTION_REGISTER(double, uint32_t, kRadix11bitsExtraPass);  // NOLINT
+SELECTION_REGISTER(double, uint32_t, kWarpAuto);              // NOLINT
+
+SELECTION_REGISTER(double, int64_t, kRadix8bits);            // NOLINT
+SELECTION_REGISTER(double, int64_t, kRadix11bits);           // NOLINT
+SELECTION_REGISTER(double, int64_t, kRadix11bitsExtraPass);  // NOLINT
+SELECTION_REGISTER(double, int64_t, kWarpImmediate);         // NOLINT
+SELECTION_REGISTER(double, int64_t, kWarpFiltered);          // NOLINT
+SELECTION_REGISTER(double, int64_t, kWarpDistributed);       // NOLINT
+SELECTION_REGISTER(double, int64_t, kWarpDistributedShm);    // NOLINT
 
 }  // namespace raft::matrix
diff --git a/cpp/include/raft/matrix/detail/select_k.cuh b/cpp/include/raft/matrix/detail/select_k.cuh
index ac1ba3dfa3..20c2fb119d 100644
--- a/cpp/include/raft/matrix/detail/select_k.cuh
+++ b/cpp/include/raft/matrix/detail/select_k.cuh
@@ -84,7 +84,7 @@ void select_k(const T* in_val,
       in_val, in_idx, batch_size, len, k, out_val, out_idx, select_min, stream, mr);
   } else {
     select::radix::select_k<T, IdxT, (sizeof(T) >= 4 ? 11 : 8), 512>(
-      in_val, in_idx, batch_size, len, k, out_val, out_idx, select_min, stream, mr);
+      in_val, in_idx, batch_size, len, k, out_val, out_idx, select_min, true, stream, mr);
   }
 }
 
diff --git a/cpp/include/raft/matrix/detail/select_radix.cuh b/cpp/include/raft/matrix/detail/select_radix.cuh
index 643a63d9db..7ac40ac0eb 100644
--- a/cpp/include/raft/matrix/detail/select_radix.cuh
+++ b/cpp/include/raft/matrix/detail/select_radix.cuh
@@ -16,11 +16,11 @@
 
 #pragma once
 
-#include <optional>
-
-#include <raft/core/cudart_utils.hpp>
 #include <raft/core/detail/macros.hpp>
 #include <raft/core/logger.hpp>
+#include <raft/core/operators.hpp>
+#include <raft/linalg/map.cuh>
+#include <raft/util/cudart_utils.hpp>
 #include <raft/util/device_atomics.cuh>
 #include <raft/util/pow2_utils.cuh>
 #include <raft/util/vectorized.cuh>
@@ -35,8 +35,8 @@
 #include <rmm/mr/device/managed_memory_resource.hpp>
 
 namespace raft::matrix::detail::select::radix {
+namespace impl {
 
-constexpr int ITEM_PER_THREAD      = 32;
 constexpr int VECTORIZED_READ_SIZE = 16;
 
 template <int BitsPerPass>
@@ -51,13 +51,6 @@ _RAFT_HOST_DEVICE constexpr int calc_num_passes()
   return ceildiv<int>(sizeof(T) * 8, BitsPerPass);
 }
 
-// Minimum reasonable block size for the given radix size.
-template <int BitsPerPass>
-_RAFT_HOST_DEVICE constexpr int calc_min_block_size()
-{
-  return 1 << std::max<int>(BitsPerPass - 4, Pow2<WarpSize>::Log2 + 1);
-}
-
 /**
  * Bit 0 is the least significant (rightmost);
  * this implementation processes input from the most to the least significant bit.
@@ -82,23 +75,43 @@ _RAFT_DEVICE constexpr unsigned calc_mask(int pass)
 }
 
 /**
- * Use cub to twiddle bits - so that we can correctly compare bits of floating-point values as well
+ * Use CUB to twiddle bits - so that we can correctly compare bits of floating-point values as well
  * as of integers.
  */
 template <typename T>
-_RAFT_DEVICE typename cub::Traits<T>::UnsignedBits twiddle_in(T key, bool greater)
+_RAFT_DEVICE typename cub::Traits<T>::UnsignedBits twiddle_in(T key, bool select_min)
 {
   auto bits = reinterpret_cast<typename cub::Traits<T>::UnsignedBits&>(key);
   bits      = cub::Traits<T>::TwiddleIn(bits);
-  if (greater) { bits = ~bits; }
+  if (!select_min) { bits = ~bits; }
   return bits;
 }
 
+template <typename T>
+_RAFT_DEVICE T twiddle_out(typename cub::Traits<T>::UnsignedBits bits, bool select_min)
+{
+  if (!select_min) { bits = ~bits; }
+  bits = cub::Traits<T>::TwiddleOut(bits);
+  return reinterpret_cast<T&>(bits);
+}
+
 template <typename T, int BitsPerPass>
-_RAFT_DEVICE int calc_bucket(T x, int start_bit, unsigned mask, bool greater)
+_RAFT_DEVICE int calc_bucket(T x, int start_bit, unsigned mask, bool select_min)
+{
+  static_assert(BitsPerPass <= sizeof(int) * 8 - 1,
+                "BitsPerPass is too large that the result type could not be int");
+  return (twiddle_in(x, select_min) >> start_bit) & mask;
+}
+
+template <typename T, typename IdxT>
+_RAFT_HOST_DEVICE IdxT calc_buf_len(IdxT len)
 {
-  static_assert(BitsPerPass <= sizeof(int) * 8 - 1);  // so return type can be int
-  return (twiddle_in(x, greater) >> start_bit) & mask;
+  // When writing is skipped, only read `in`(type T).
+  // When writing is not skipped, read `in_buf`(T) and `in_idx_buf`(IdxT), and write `out_buf`(T)
+  // and `out_idx_buf`(IdxT).
+  // The ratio between these cases determines whether to skip writing and hence the buffer size.
+  constexpr float ratio = 2 + sizeof(IdxT) * 2.0 / sizeof(T);
+  return len / ratio;
 }
 
 /**
@@ -111,17 +124,18 @@ _RAFT_DEVICE int calc_bucket(T x, int start_bit, unsigned mask, bool greater)
  * @tparam IdxT indexing type
  * @tparam Func void (T x, IdxT idx)
  *
+ * @param thread_rank rank of the calling thread among all participating threads
+ * @param num_threads number of the threads that participate in processing
  * @param in the input data
  * @param len the number of elements to read
  * @param f the lambda taking two arguments (T x, IdxT idx)
  */
 template <typename T, typename IdxT, typename Func>
-_RAFT_DEVICE void vectorized_process(const T* in, IdxT len, Func f)
+_RAFT_DEVICE void vectorized_process(
+  size_t thread_rank, size_t num_threads, const T* in, IdxT len, Func f)
 {
-  const IdxT stride = blockDim.x * gridDim.x;
-  const int tid     = blockIdx.x * blockDim.x + threadIdx.x;
   if constexpr (sizeof(T) >= VECTORIZED_READ_SIZE || VECTORIZED_READ_SIZE % sizeof(T) != 0) {
-    for (IdxT i = tid; i < len; i += stride) {
+    for (IdxT i = thread_rank; i < len; i += num_threads) {
       f(in[i], i);
     }
   } else {
@@ -134,8 +148,8 @@ _RAFT_DEVICE void vectorized_process(const T* in, IdxT len, Func f)
     const IdxT skip_cnt_left = std::min<IdxT>((IdxT)(align_bytes::roundUp(in) - in), len);
 
     // The main loop: process all aligned data
-    for (IdxT i = tid * wide_t::Ratio + skip_cnt_left; i + wide_t::Ratio <= len;
-         i += stride * wide_t::Ratio) {
+    for (IdxT i = thread_rank * wide_t::Ratio + skip_cnt_left; i + wide_t::Ratio <= len;
+         i += num_threads * wide_t::Ratio) {
       wide.load(in, i);
 #pragma unroll
       for (int j = 0; j < wide_t::Ratio; ++j) {
@@ -145,30 +159,55 @@ _RAFT_DEVICE void vectorized_process(const T* in, IdxT len, Func f)
 
     static_assert(WarpSize >= wide_t::Ratio);
     // Processes the skipped elements on the left
-    if (tid < skip_cnt_left) { f(in[tid], tid); }
+    if (thread_rank < skip_cnt_left) { f(in[thread_rank], thread_rank); }
     // Processes the skipped elements on the right
     const IdxT skip_cnt_right = align_elems::mod(len - skip_cnt_left);
-    const IdxT remain_i       = len - skip_cnt_right + tid;
+    const IdxT remain_i       = len - skip_cnt_right + thread_rank;
     if (remain_i < len) { f(in[remain_i], remain_i); }
   }
 }
 
 template <typename T, typename IdxT>
-struct Counter {
+struct alignas(128) Counter {
+  // We are processing the values in multiple passes, from most significant to least significant. In
+  // each pass, we keep the length of input (`len`) and the `k` of current pass, and update them at
+  // the end of the pass.
   IdxT k;
   IdxT len;
+
+  //  `previous_len` is the length of input in previous pass. Note that `previous_len` rather
+  //  than `len` is used for the filtering step because filtering is indeed for previous pass (see
+  //  comments before `radix_kernel`).
   IdxT previous_len;
-  int bucket;
 
-  IdxT filter_cnt;
-  unsigned int finished_block_cnt;
-  IdxT out_cnt;
-  IdxT out_back_cnt;
+  // We determine the bits of the k_th value inside the mask processed by the pass. The
+  // already known bits are stored in `kth_value_bits`. It's used to discriminate a element is a
+  // result (written to `out`), a candidate for next pass (written to `out_buf`), or not useful
+  // (discarded). The bits that are not yet processed do not matter for this purpose.
+  typename cub::Traits<T>::UnsignedBits kth_value_bits;
+
+  // Record how many elements have passed filtering. It's used to determine the position in the
+  // `out_buf` where an element should be written.
+  alignas(128) IdxT filter_cnt;
+
+  // For a row inside a batch, we may launch multiple thread blocks. This counter is used to
+  // determine if the current block is the last running block. If so, this block will execute scan()
+  // and choose_bucket().
+  alignas(128) unsigned int finished_block_cnt;
+
+  // Record how many elements have been written to the front of `out`. Elements less (if
+  // select_min==true) than the k-th value are written from front to back.
+  alignas(128) IdxT out_cnt;
+
+  // Record how many elements have been written to the back of `out`. Elements equal to the k-th
+  // value are written from back to front. We need to keep count of them separately because the
+  // number of elements that <= the k-th value might exceed k.
+  alignas(128) IdxT out_back_cnt;
 };
 
 /**
- * Fused filtering of the current phase and building histogram for the next phase
- * (see steps 4-1 in `radix_kernel` description).
+ * Fused filtering of the current pass and building histogram for the next pass
+ * (see steps 4 & 1 in `radix_kernel` description).
  */
 template <typename T, typename IdxT, int BitsPerPass>
 _RAFT_DEVICE void filter_and_histogram(const T* in_buf,
@@ -177,12 +216,12 @@ _RAFT_DEVICE void filter_and_histogram(const T* in_buf,
                                        IdxT* out_idx_buf,
                                        T* out,
                                        IdxT* out_idx,
-                                       IdxT len,
+                                       IdxT previous_len,
                                        Counter<T, IdxT>* counter,
                                        IdxT* histogram,
-                                       bool greater,
+                                       bool select_min,
                                        int pass,
-                                       int k)
+                                       bool early_stop)
 {
   constexpr int num_buckets = calc_num_buckets<BitsPerPass>();
   __shared__ IdxT histogram_smem[num_buckets];
@@ -198,19 +237,20 @@ _RAFT_DEVICE void filter_and_histogram(const T* in_buf,
     // Passed to vectorized_process, this function executes in all blocks in parallel,
     // i.e. the work is split along the input (both, in batches and chunks of a single row).
     // Later, the histograms are merged using atomicAdd.
-    auto f = [greater, start_bit, mask](T value, IdxT) {
-      int bucket = calc_bucket<T, BitsPerPass>(value, start_bit, mask, greater);
-      atomicAdd(histogram_smem + bucket, IdxT(1));
+    auto f = [select_min, start_bit, mask](T value, IdxT) {
+      int bucket = calc_bucket<T, BitsPerPass>(value, start_bit, mask, select_min);
+      atomicAdd(histogram_smem + bucket, static_cast<IdxT>(1));
     };
-    vectorized_process(in_buf, len, f);
+    vectorized_process(static_cast<size_t>(blockIdx.x) * blockDim.x + threadIdx.x,
+                       static_cast<size_t>(blockDim.x) * gridDim.x,
+                       in_buf,
+                       previous_len,
+                       f);
   } else {
-    const IdxT previous_len      = counter->previous_len;
-    const int want_bucket        = counter->bucket;
-    IdxT& filter_cnt             = counter->filter_cnt;
-    IdxT& out_cnt                = counter->out_cnt;
-    const IdxT counter_len       = counter->len;
+    IdxT* p_filter_cnt           = &counter->filter_cnt;
+    IdxT* p_out_cnt              = &counter->out_cnt;
+    const auto kth_value_bits    = counter->kth_value_bits;
     const int previous_start_bit = calc_start_bit<T, BitsPerPass>(pass - 1);
-    const unsigned previous_mask = calc_mask<T, BitsPerPass>(pass - 1);
 
     // See the remark above on the distributed execution of `f` using vectorized_process.
     auto f = [in_idx_buf,
@@ -218,38 +258,50 @@ _RAFT_DEVICE void filter_and_histogram(const T* in_buf,
               out_idx_buf,
               out,
               out_idx,
-              greater,
-              k,
+              select_min,
               start_bit,
               mask,
               previous_start_bit,
-              previous_mask,
-              want_bucket,
-              &filter_cnt,
-              &out_cnt,
-              counter_len](T value, IdxT i) {
-      int prev_bucket =
-        calc_bucket<T, BitsPerPass>(value, previous_start_bit, previous_mask, greater);
-      if (prev_bucket == want_bucket) {
-        IdxT pos     = atomicAdd(&filter_cnt, IdxT(1));
-        out_buf[pos] = value;
-        if (out_idx_buf) { out_idx_buf[pos] = in_idx_buf ? in_idx_buf[i] : i; }
-        int bucket = calc_bucket<T, BitsPerPass>(value, start_bit, mask, greater);
-        atomicAdd(histogram_smem + bucket, IdxT(1));
-
-        if (counter_len == 1) {
-          out[k - 1]     = value;
-          out_idx[k - 1] = in_idx_buf ? in_idx_buf[i] : i;
+              kth_value_bits,
+              p_filter_cnt,
+              p_out_cnt,
+              early_stop](T value, IdxT i) {
+      const auto previous_bits = (twiddle_in(value, select_min) >> previous_start_bit)
+                                 << previous_start_bit;
+      if (previous_bits == kth_value_bits) {
+        if (early_stop) {
+          IdxT pos     = atomicAdd(p_out_cnt, static_cast<IdxT>(1));
+          out[pos]     = value;
+          out_idx[pos] = in_idx_buf ? in_idx_buf[i] : i;
+        } else {
+          if (out_buf) {
+            IdxT pos         = atomicAdd(p_filter_cnt, static_cast<IdxT>(1));
+            out_buf[pos]     = value;
+            out_idx_buf[pos] = in_idx_buf ? in_idx_buf[i] : i;
+          }
+
+          int bucket = calc_bucket<T, BitsPerPass>(value, start_bit, mask, select_min);
+          atomicAdd(histogram_smem + bucket, static_cast<IdxT>(1));
         }
-      } else if (prev_bucket < want_bucket) {
-        IdxT pos     = atomicAdd(&out_cnt, IdxT(1));
+      }
+      // the condition `(out_buf || early_stop)` is a little tricky:
+      // If we skip writing to `out_buf` (when `out_buf` is nullptr), we should skip writing to
+      // `out` too. So we won't write the same value to `out` multiple times in different passes.
+      // And if we keep skipping the writing, values will be written in `last_filter_kernel()` at
+      // last. But when `early_stop` is true, we need to write to `out` since it's the last chance.
+      else if ((out_buf || early_stop) && previous_bits < kth_value_bits) {
+        IdxT pos     = atomicAdd(p_out_cnt, static_cast<IdxT>(1));
         out[pos]     = value;
         out_idx[pos] = in_idx_buf ? in_idx_buf[i] : i;
       }
     };
-
-    vectorized_process(in_buf, previous_len, f);
+    vectorized_process(static_cast<size_t>(blockIdx.x) * blockDim.x + threadIdx.x,
+                       static_cast<size_t>(blockDim.x) * gridDim.x,
+                       in_buf,
+                       previous_len,
+                       f);
   }
+  if (early_stop) { return; }
   __syncthreads();
 
   // merge histograms produced by individual blocks
@@ -259,69 +311,184 @@ _RAFT_DEVICE void filter_and_histogram(const T* in_buf,
 }
 
 /**
- * Replace a part of the histogram with its own prefix sum, starting from the `start` and adding
- * `current` to each entry of the result.
+ * Replace histogram with its own prefix sum
  * (step 2 in `radix_kernel` description)
  */
 template <typename IdxT, int BitsPerPass, int BlockSize>
-_RAFT_DEVICE void scan(volatile IdxT* histogram,
-                       const int start,
-                       const int num_buckets,
-                       const IdxT current)
+_RAFT_DEVICE void scan(volatile IdxT* histogram)
 {
-  typedef cub::BlockScan<IdxT, BlockSize> BlockScan;
-  __shared__ typename BlockScan::TempStorage temp_storage;
+  constexpr int num_buckets = calc_num_buckets<BitsPerPass>();
+  if constexpr (num_buckets >= BlockSize) {
+    static_assert(num_buckets % BlockSize == 0);
+    constexpr int items_per_thread = num_buckets / BlockSize;
+    typedef cub::BlockLoad<IdxT, BlockSize, items_per_thread, cub::BLOCK_LOAD_TRANSPOSE> BlockLoad;
+    typedef cub::BlockStore<IdxT, BlockSize, items_per_thread, cub::BLOCK_STORE_TRANSPOSE>
+      BlockStore;
+    typedef cub::BlockScan<IdxT, BlockSize> BlockScan;
 
-  IdxT thread_data = 0;
-  int index        = start + threadIdx.x;
-  if (index < num_buckets) { thread_data = histogram[index]; }
+    __shared__ union {
+      typename BlockLoad::TempStorage load;
+      typename BlockScan::TempStorage scan;
+      typename BlockStore::TempStorage store;
+    } temp_storage;
+    IdxT thread_data[items_per_thread];
 
-  BlockScan(temp_storage).InclusiveSum(thread_data, thread_data);
-  __syncthreads();
-  if (index < num_buckets) { histogram[index] = thread_data + current; }
-  __syncthreads();  // This sync is necessary, as the content of histogram needs
-                    // to be read after
+    BlockLoad(temp_storage.load).Load(histogram, thread_data);
+    __syncthreads();
+
+    BlockScan(temp_storage.scan).InclusiveSum(thread_data, thread_data);
+    __syncthreads();
+
+    BlockStore(temp_storage.store).Store(histogram, thread_data);
+  } else {
+    typedef cub::BlockScan<IdxT, BlockSize> BlockScan;
+    __shared__ typename BlockScan::TempStorage temp_storage;
+
+    IdxT thread_data = 0;
+    if (threadIdx.x < num_buckets) { thread_data = histogram[threadIdx.x]; }
+
+    BlockScan(temp_storage).InclusiveSum(thread_data, thread_data);
+    __syncthreads();
+
+    if (threadIdx.x < num_buckets) { histogram[threadIdx.x] = thread_data; }
+  }
 }
 
 /**
  * Calculate in which bucket the k-th value will fall
- *  (steps 2-3 in `radix_kernel` description)
+ *  (steps 3 in `radix_kernel` description)
  */
-template <typename T, typename IdxT, int BitsPerPass, int BlockSize>
-_RAFT_DEVICE void choose_bucket(Counter<T, IdxT>* counter, IdxT* histogram, const IdxT k)
+template <typename T, typename IdxT, int BitsPerPass>
+_RAFT_DEVICE void choose_bucket(Counter<T, IdxT>* counter,
+                                const IdxT* histogram,
+                                const IdxT k,
+                                const int pass)
 {
   constexpr int num_buckets = calc_num_buckets<BitsPerPass>();
-  int index                 = threadIdx.x;
-  IdxT last_prefix_sum      = 0;
-  int num_pass              = 1;
-  if constexpr (num_buckets >= BlockSize) {
-    static_assert(num_buckets % BlockSize == 0);
-    num_pass = num_buckets / BlockSize;
+  for (int i = threadIdx.x; i < num_buckets; i += blockDim.x) {
+    IdxT prev = (i == 0) ? 0 : histogram[i - 1];
+    IdxT cur  = histogram[i];
+
+    // one and only one thread will satisfy this condition, so counter is written by only one thread
+    if (prev < k && cur >= k) {
+      counter->k   = k - prev;    // how many values still are there to find
+      counter->len = cur - prev;  // number of values in next pass
+      typename cub::Traits<T>::UnsignedBits bucket = i;
+      int start_bit                                = calc_start_bit<T, BitsPerPass>(pass);
+      counter->kth_value_bits |= bucket << start_bit;
+    }
   }
+}
 
-  for (int i = 0; i < num_pass && (last_prefix_sum < k); i++) {
-    // Turn the i-th chunk of the histogram into its prefix sum.
-    scan<IdxT, BitsPerPass, BlockSize>(histogram, i * BlockSize, num_buckets, last_prefix_sum);
-    if (index < num_buckets) {
-      // Number of values in the previous `index-1` buckets (see the `scan` op above)
-      IdxT prev = (index == 0) ? 0 : histogram[index - 1];
-      // Number of values in `index` buckets
-      IdxT cur = histogram[index];
-
-      // one and only one thread will satisfy this condition, so only write once
-      if (prev < k && cur >= k) {
-        counter->k            = k - prev;  // how many values still are there to find
-        counter->previous_len = counter->len;
-        counter->len          = cur - prev;  // number of values in `index` bucket
-        counter->bucket       = index;
+// For one-block version, last_filter() could be called when pass < num_passes - 1.
+// So `pass` could not be constexpr
+template <typename T, typename IdxT, int BitsPerPass>
+_RAFT_DEVICE void last_filter(const T* in_buf,
+                              const IdxT* in_idx_buf,
+                              T* out,
+                              IdxT* out_idx,
+                              IdxT current_len,
+                              IdxT k,
+                              Counter<T, IdxT>* counter,
+                              const bool select_min,
+                              const int pass)
+{
+  const auto kth_value_bits = counter->kth_value_bits;
+  const int start_bit       = calc_start_bit<T, BitsPerPass>(pass);
+
+  // changed in choose_bucket(); need to reload
+  const IdxT needed_num_of_kth = counter->k;
+  IdxT* p_out_cnt              = &counter->out_cnt;
+  IdxT* p_out_back_cnt         = &counter->out_back_cnt;
+  for (IdxT i = threadIdx.x; i < current_len; i += blockDim.x) {
+    const T value   = in_buf[i];
+    const auto bits = (twiddle_in(value, select_min) >> start_bit) << start_bit;
+    if (bits < kth_value_bits) {
+      IdxT pos = atomicAdd(p_out_cnt, static_cast<IdxT>(1));
+      out[pos] = value;
+      // For one-block version, `in_idx_buf` could be nullptr at pass 0.
+      // For non one-block version, if writing has been skipped, `in_idx_buf` could be nullptr if
+      // `in_buf` is `in`
+      out_idx[pos] = in_idx_buf ? in_idx_buf[i] : i;
+    } else if (bits == kth_value_bits) {
+      IdxT back_pos = atomicAdd(p_out_back_cnt, static_cast<IdxT>(1));
+      if (back_pos < needed_num_of_kth) {
+        IdxT pos     = k - 1 - back_pos;
+        out[pos]     = value;
+        out_idx[pos] = in_idx_buf ? in_idx_buf[i] : i;
       }
     }
-    index += BlockSize;
-    // this will break the loop when the counter is set (cur >= k), because last_prefix_sum >= cur
-    last_prefix_sum = histogram[(i + 1) * BlockSize - 1];
   }
 }
 
+template <typename T, typename IdxT, int BitsPerPass>
+__global__ void last_filter_kernel(const T* in,
+                                   const IdxT* in_idx,
+                                   const T* in_buf,
+                                   const IdxT* in_idx_buf,
+                                   T* out,
+                                   IdxT* out_idx,
+                                   IdxT len,
+                                   IdxT k,
+                                   Counter<T, IdxT>* counters,
+                                   const bool select_min)
+{
+  const size_t batch_id = blockIdx.y;  // size_t to avoid multiplication overflow
+
+  Counter<T, IdxT>* counter = counters + batch_id;
+  IdxT previous_len         = counter->previous_len;
+  if (previous_len == 0) { return; }
+  const IdxT buf_len = calc_buf_len<T>(len);
+  if (previous_len > buf_len || in_buf == in) {
+    in_buf       = in + batch_id * len;
+    in_idx_buf   = in_idx ? (in_idx + batch_id * len) : nullptr;
+    previous_len = len;
+  } else {
+    in_buf += batch_id * buf_len;
+    in_idx_buf += batch_id * buf_len;
+  }
+  out += batch_id * k;
+  out_idx += batch_id * k;
+
+  constexpr int pass      = calc_num_passes<T, BitsPerPass>() - 1;
+  constexpr int start_bit = calc_start_bit<T, BitsPerPass>(pass);
+
+  const auto kth_value_bits    = counter->kth_value_bits;
+  const IdxT needed_num_of_kth = counter->k;
+  IdxT* p_out_cnt              = &counter->out_cnt;
+  IdxT* p_out_back_cnt         = &counter->out_back_cnt;
+
+  auto f = [k,
+            select_min,
+            kth_value_bits,
+            needed_num_of_kth,
+            p_out_cnt,
+            p_out_back_cnt,
+            in_idx_buf,
+            out,
+            out_idx](T value, IdxT i) {
+    const auto bits = (twiddle_in(value, select_min) >> start_bit) << start_bit;
+    if (bits < kth_value_bits) {
+      IdxT pos     = atomicAdd(p_out_cnt, static_cast<IdxT>(1));
+      out[pos]     = value;
+      out_idx[pos] = in_idx_buf ? in_idx_buf[i] : i;
+    } else if (bits == kth_value_bits) {
+      IdxT back_pos = atomicAdd(p_out_back_cnt, static_cast<IdxT>(1));
+      if (back_pos < needed_num_of_kth) {
+        IdxT pos     = k - 1 - back_pos;
+        out[pos]     = value;
+        out_idx[pos] = in_idx_buf ? in_idx_buf[i] : i;
+      }
+    }
+  };
+
+  vectorized_process(static_cast<size_t>(blockIdx.x) * blockDim.x + threadIdx.x,
+                     static_cast<size_t>(blockDim.x) * gridDim.x,
+                     in_buf,
+                     previous_len,
+                     f);
+}
+
 /**
  *
  * It is expected to call this kernel multiple times (passes), in each pass we process a radix,
@@ -350,35 +517,79 @@ _RAFT_DEVICE void choose_bucket(Counter<T, IdxT>* counter, IdxT* histogram, cons
  *
  * In the implementation, the filtering step is delayed to the next pass so the filtering and
  * histogram computation are fused. In this way, inputs are read once rather than twice.
+ *
+ * During the filtering step, we won't write candidates (elements in bucket j) to `out_buf` if the
+ * number of candidates is larger than the length of `out_buf` (this could happen when the leading
+ * bits of input values are almost the same). And then in the next pass, inputs are read from `in`
+ * rather than from `in_buf`. The benefit is that we can save the cost of writing candidates and
+ * their indices.
  */
-template <typename T, typename IdxT, int BitsPerPass, int BlockSize>
-__global__ void __launch_bounds__(BlockSize) radix_kernel(const T* in_buf,
-                                                          const IdxT* in_idx_buf,
-                                                          T* out_buf,
-                                                          IdxT* out_idx_buf,
-                                                          T* out,
-                                                          IdxT* out_idx,
-                                                          Counter<T, IdxT>* counters,
-                                                          IdxT* histograms,
-                                                          const IdxT len,
-                                                          const int k,
-                                                          const bool greater,
-                                                          const int pass)
+template <typename T, typename IdxT, int BitsPerPass, int BlockSize, bool fused_last_filter>
+__global__ void radix_kernel(const T* in,
+                             const IdxT* in_idx,
+                             const T* in_buf,
+                             const IdxT* in_idx_buf,
+                             T* out_buf,
+                             IdxT* out_idx_buf,
+                             T* out,
+                             IdxT* out_idx,
+                             Counter<T, IdxT>* counters,
+                             IdxT* histograms,
+                             const IdxT len,
+                             const IdxT k,
+                             const bool select_min,
+                             const int pass)
 {
-  __shared__ bool isLastBlockDone;
+  const size_t batch_id = blockIdx.y;
+  auto counter          = counters + batch_id;
+  IdxT current_k;
+  IdxT previous_len;
+  IdxT current_len;
+  if (pass == 0) {
+    current_k    = k;
+    previous_len = len;
+    // Need to do this so setting counter->previous_len for the next pass is correct.
+    // This value is meaningless for pass 0, but it's fine because pass 0 won't be the
+    // last pass in this implementation so pass 0 won't hit the "if (pass ==
+    // num_passes - 1)" branch.
+    // Maybe it's better to reload counter->previous_len and use it rather than
+    // current_len in last_filter()
+    current_len = len;
+  } else {
+    current_k    = counter->k;
+    current_len  = counter->len;
+    previous_len = counter->previous_len;
+  }
+  if (current_len == 0) { return; }
 
-  constexpr int num_buckets = calc_num_buckets<BitsPerPass>();
-  constexpr int num_passes  = calc_num_passes<T, BitsPerPass>();
-  const int batch_id        = blockIdx.y;
-  in_buf += batch_id * len;
-  out_buf += batch_id * len;
+  // When k=len, early_stop will be true at pass 0. It means filter_and_histogram() should handle
+  // correctly the case that pass=0 and early_stop=true. However, this special case of k=len is
+  // handled in other way in select_k() so such case is not possible here.
+  const bool early_stop = (current_len == current_k);
+  const IdxT buf_len    = calc_buf_len<T>(len);
+
+  // "previous_len > buf_len" means previous pass skips writing buffer
+  if (pass == 0 || pass == 1 || previous_len > buf_len) {
+    in_buf       = in + batch_id * len;
+    in_idx_buf   = in_idx ? (in_idx + batch_id * len) : nullptr;
+    previous_len = len;
+  } else {
+    in_buf += batch_id * buf_len;
+    in_idx_buf += batch_id * buf_len;
+  }
+  // "current_len > buf_len" means current pass will skip writing buffer
+  if (pass == 0 || current_len > buf_len) {
+    out_buf     = nullptr;
+    out_idx_buf = nullptr;
+  } else {
+    out_buf += batch_id * buf_len;
+    out_idx_buf += batch_id * buf_len;
+  }
   out += batch_id * k;
   out_idx += batch_id * k;
-  if (in_idx_buf) { in_idx_buf += batch_id * len; }
-  if (out_idx_buf) { out_idx_buf += batch_id * len; }
 
-  auto counter   = counters + batch_id;
-  auto histogram = histograms + batch_id * num_buckets;
+  constexpr int num_buckets = calc_num_buckets<BitsPerPass>();
+  auto histogram            = histograms + batch_id * num_buckets;
 
   filter_and_histogram<T, IdxT, BitsPerPass>(in_buf,
                                              in_idx_buf,
@@ -386,126 +597,468 @@ __global__ void __launch_bounds__(BlockSize) radix_kernel(const T* in_buf,
                                              out_idx_buf,
                                              out,
                                              out_idx,
-                                             len,
+                                             previous_len,
                                              counter,
                                              histogram,
-                                             greater,
+                                             select_min,
                                              pass,
-                                             k);
+                                             early_stop);
   __threadfence();
 
+  bool isLastBlock = false;
   if (threadIdx.x == 0) {
     unsigned int finished = atomicInc(&counter->finished_block_cnt, gridDim.x - 1);
-    isLastBlockDone       = (finished == (gridDim.x - 1));
+    isLastBlock           = (finished == (gridDim.x - 1));
   }
 
-  // Synchronize to make sure that each thread reads the correct value of
-  // isLastBlockDone.
-  __syncthreads();
-  if (isLastBlockDone) {
-    if (counter->len == 1 && threadIdx.x == 0) {
-      counter->previous_len = 0;
-      counter->len          = 0;
-    }
-    // init counter, other members of counter is initialized with 0 by
-    // cudaMemset()
-    if (pass == 0 && threadIdx.x == 0) {
-      counter->k            = k;
-      counter->len          = len;
-      counter->out_back_cnt = 0;
+  if (__syncthreads_or(isLastBlock)) {
+    if (early_stop) {
+      if (threadIdx.x == 0) {
+        // `last_filter_kernel()` requires setting previous_len
+        counter->previous_len = 0;
+        counter->len          = 0;
+      }
+      return;
     }
+
+    scan<IdxT, BitsPerPass, BlockSize>(histogram);
     __syncthreads();
+    choose_bucket<T, IdxT, BitsPerPass>(counter, histogram, current_k, pass);
+    __syncthreads();
+
+    constexpr int num_passes = calc_num_passes<T, BitsPerPass>();
+    // reset for next pass
+    if (pass != num_passes - 1) {
+      for (int i = threadIdx.x; i < num_buckets; i += blockDim.x) {
+        histogram[i] = 0;
+      }
+    }
+    if (threadIdx.x == 0) {
+      // `last_filter_kernel()` requires setting previous_len even in the last pass
+      counter->previous_len = current_len;
+      // not necessary for the last pass, but put it here anyway
+      counter->filter_cnt = 0;
+    }
+
+    if constexpr (fused_last_filter) {
+      if (pass == num_passes - 1) {
+        last_filter<T, IdxT, BitsPerPass>(out_buf ? out_buf : in_buf,
+                                          out_idx_buf ? out_idx_buf : in_idx_buf,
+                                          out,
+                                          out_idx,
+                                          out_buf ? current_len : len,
+                                          k,
+                                          counter,
+                                          select_min,
+                                          pass);
+      }
+    }
+  }
+}
+
+template <typename T, typename IdxT, int BlockSize, typename Kernel>
+int calc_chunk_size(int batch_size, IdxT len, int sm_cnt, Kernel kernel)
+{
+  int active_blocks;
+  RAFT_CUDA_TRY(
+    cudaOccupancyMaxActiveBlocksPerMultiprocessor(&active_blocks, kernel, BlockSize, 0));
+
+  constexpr int items_per_thread = 32;
+  constexpr int num_waves        = 10;
+  int chunk_size =
+    std::max<int>(1, num_waves * sm_cnt * active_blocks * BlockSize * items_per_thread / len);
+  return std::min(chunk_size, batch_size);
+}
 
-    IdxT ori_k = counter->k;
+template <typename T, typename IdxT, int BitsPerPass, int BlockSize>
+unsigned calc_grid_dim(int batch_size, IdxT len, int sm_cnt)
+{
+  static_assert(VECTORIZED_READ_SIZE / sizeof(T) >= 1);
+
+  int active_blocks;
+  RAFT_CUDA_TRY(cudaOccupancyMaxActiveBlocksPerMultiprocessor(
+    &active_blocks, radix_kernel<T, IdxT, BitsPerPass, BlockSize, false>, BlockSize, 0));
+  active_blocks *= sm_cnt;
 
-    if (counter->len > 0) {
-      choose_bucket<T, IdxT, BitsPerPass, BlockSize>(counter, histogram, ori_k);
+  IdxT best_num_blocks         = 0;
+  float best_tail_wave_penalty = 1.0f;
+  const IdxT max_num_blocks    = ceildiv<IdxT>(len, VECTORIZED_READ_SIZE / sizeof(T) * BlockSize);
+  for (int num_waves = 1;; ++num_waves) {
+    IdxT num_blocks = std::min(
+      max_num_blocks, static_cast<IdxT>(std::max(num_waves * active_blocks / batch_size, 1)));
+    IdxT items_per_thread  = ceildiv<IdxT>(len, num_blocks * BlockSize);
+    items_per_thread       = alignTo<IdxT>(items_per_thread, VECTORIZED_READ_SIZE / sizeof(T));
+    num_blocks             = ceildiv<IdxT>(len, items_per_thread * BlockSize);
+    float actual_num_waves = static_cast<float>(num_blocks) * batch_size / active_blocks;
+    float tail_wave_penalty =
+      (ceilf(actual_num_waves) - actual_num_waves) / ceilf(actual_num_waves);
+
+    // 0.15 is determined experimentally. It also ensures breaking the loop early,
+    // e.g. when num_waves > 7, tail_wave_penalty will always <0.15
+    if (tail_wave_penalty < 0.15) {
+      best_num_blocks = num_blocks;
+      break;
+    } else if (tail_wave_penalty < best_tail_wave_penalty) {
+      best_num_blocks        = num_blocks;
+      best_tail_wave_penalty = tail_wave_penalty;
     }
 
-    __syncthreads();
-    if (pass == num_passes - 1) {
-      const IdxT previous_len = counter->previous_len;
-      const int want_bucket   = counter->bucket;
-      int start_bit           = calc_start_bit<T, BitsPerPass>(pass);
-      unsigned mask           = calc_mask<T, BitsPerPass>(pass);
-
-      // radix topk
-      IdxT& out_cnt = counter->out_cnt;
-      for (IdxT i = threadIdx.x; i < previous_len; i += blockDim.x) {
-        const T value = out_buf[i];
-        int bucket    = calc_bucket<T, BitsPerPass>(value, start_bit, mask, greater);
-        if (bucket < want_bucket) {
-          IdxT pos     = atomicAdd(&out_cnt, IdxT(1));
-          out[pos]     = value;
-          out_idx[pos] = out_idx_buf[i];
-        } else if (bucket == want_bucket) {
-          IdxT needed_num_of_kth = counter->k;
-          IdxT back_pos          = atomicAdd(&(counter->out_back_cnt), IdxT(1));
-          if (back_pos < needed_num_of_kth) {
-            IdxT pos     = k - 1 - back_pos;
-            out[pos]     = value;
-            out_idx[pos] = out_idx_buf[i];
-          }
-        }
+    if (num_blocks == max_num_blocks) { break; }
+  }
+  return best_num_blocks;
+}
+
+template <typename T, typename IdxT>
+_RAFT_HOST_DEVICE void set_buf_pointers(const T* in,
+                                        const IdxT* in_idx,
+                                        T* buf1,
+                                        IdxT* idx_buf1,
+                                        T* buf2,
+                                        IdxT* idx_buf2,
+                                        int pass,
+                                        const T*& in_buf,
+                                        const IdxT*& in_idx_buf,
+                                        T*& out_buf,
+                                        IdxT*& out_idx_buf)
+{
+  if (pass == 0) {
+    in_buf      = in;
+    in_idx_buf  = nullptr;
+    out_buf     = nullptr;
+    out_idx_buf = nullptr;
+  } else if (pass == 1) {
+    in_buf      = in;
+    in_idx_buf  = in_idx;
+    out_buf     = buf1;
+    out_idx_buf = idx_buf1;
+  } else if (pass % 2 == 0) {
+    in_buf      = buf1;
+    in_idx_buf  = idx_buf1;
+    out_buf     = buf2;
+    out_idx_buf = idx_buf2;
+  } else {
+    in_buf      = buf2;
+    in_idx_buf  = idx_buf2;
+    out_buf     = buf1;
+    out_idx_buf = idx_buf1;
+  }
+}
+
+template <typename T, typename IdxT, int BitsPerPass, int BlockSize>
+void radix_topk(const T* in,
+                const IdxT* in_idx,
+                int batch_size,
+                IdxT len,
+                IdxT k,
+                T* out,
+                IdxT* out_idx,
+                bool select_min,
+                bool fused_last_filter,
+                unsigned grid_dim,
+                int sm_cnt,
+                rmm::cuda_stream_view stream,
+                rmm::mr::device_memory_resource* mr)
+{
+  // TODO: is it possible to relax this restriction?
+  static_assert(calc_num_passes<T, BitsPerPass>() > 1);
+  constexpr int num_buckets = calc_num_buckets<BitsPerPass>();
+
+  auto kernel = radix_kernel<T, IdxT, BitsPerPass, BlockSize, false>;
+  const size_t max_chunk_size =
+    calc_chunk_size<T, IdxT, BlockSize>(batch_size, len, sm_cnt, kernel);
+  if (max_chunk_size != static_cast<size_t>(batch_size)) {
+    grid_dim = calc_grid_dim<T, IdxT, BitsPerPass, BlockSize>(max_chunk_size, len, sm_cnt);
+  }
+  const IdxT buf_len = calc_buf_len<T>(len);
+
+  size_t req_aux = max_chunk_size * (sizeof(Counter<T, IdxT>) + num_buckets * sizeof(IdxT));
+  size_t req_buf = max_chunk_size * buf_len * 2 * (sizeof(T) + sizeof(IdxT));
+  size_t mem_req = req_aux + req_buf + 256 * 6;  // might need extra memory for alignment
+
+  auto pool_guard = raft::get_pool_memory_resource(mr, mem_req);
+  if (pool_guard) {
+    RAFT_LOG_DEBUG("radix::select_k: using pool memory resource with initial size %zu bytes",
+                   pool_guard->pool_size());
+  }
+
+  rmm::device_uvector<Counter<T, IdxT>> counters(max_chunk_size, stream, mr);
+  rmm::device_uvector<IdxT> histograms(max_chunk_size * num_buckets, stream, mr);
+  rmm::device_uvector<T> buf1(max_chunk_size * buf_len, stream, mr);
+  rmm::device_uvector<IdxT> idx_buf1(max_chunk_size * buf_len, stream, mr);
+  rmm::device_uvector<T> buf2(max_chunk_size * buf_len, stream, mr);
+  rmm::device_uvector<IdxT> idx_buf2(max_chunk_size * buf_len, stream, mr);
+
+  for (size_t offset = 0; offset < static_cast<size_t>(batch_size); offset += max_chunk_size) {
+    int chunk_size = std::min(max_chunk_size, batch_size - offset);
+    RAFT_CUDA_TRY(
+      cudaMemsetAsync(counters.data(), 0, counters.size() * sizeof(Counter<T, IdxT>), stream));
+    RAFT_CUDA_TRY(cudaMemsetAsync(histograms.data(), 0, histograms.size() * sizeof(IdxT), stream));
+
+    const T* chunk_in        = in + offset * len;
+    const IdxT* chunk_in_idx = in_idx ? (in_idx + offset * len) : nullptr;
+    T* chunk_out             = out + offset * k;
+    IdxT* chunk_out_idx      = out_idx + offset * k;
+
+    const T* in_buf        = nullptr;
+    const IdxT* in_idx_buf = nullptr;
+    T* out_buf             = nullptr;
+    IdxT* out_idx_buf      = nullptr;
+
+    dim3 blocks(grid_dim, chunk_size);
+    constexpr int num_passes = calc_num_passes<T, BitsPerPass>();
+
+    for (int pass = 0; pass < num_passes; ++pass) {
+      set_buf_pointers(chunk_in,
+                       chunk_in_idx,
+                       buf1.data(),
+                       idx_buf1.data(),
+                       buf2.data(),
+                       idx_buf2.data(),
+                       pass,
+                       in_buf,
+                       in_idx_buf,
+                       out_buf,
+                       out_idx_buf);
+
+      if (fused_last_filter && pass == num_passes - 1) {
+        kernel = radix_kernel<T, IdxT, BitsPerPass, BlockSize, true>;
       }
-      __syncthreads();
-    } else {
-      // reset for next pass
-      for (int i = threadIdx.x; i < num_buckets; i += blockDim.x) {
-        histogram[i] = 0;
+
+      kernel<<<blocks, BlockSize, 0, stream>>>(chunk_in,
+                                               chunk_in_idx,
+                                               in_buf,
+                                               in_idx_buf,
+                                               out_buf,
+                                               out_idx_buf,
+                                               chunk_out,
+                                               chunk_out_idx,
+                                               counters.data(),
+                                               histograms.data(),
+                                               len,
+                                               k,
+                                               select_min,
+                                               pass);
+      RAFT_CUDA_TRY(cudaPeekAtLastError());
+    }
+
+    if (!fused_last_filter) {
+      last_filter_kernel<T, IdxT, BitsPerPass><<<blocks, BlockSize, 0, stream>>>(chunk_in,
+                                                                                 chunk_in_idx,
+                                                                                 out_buf,
+                                                                                 out_idx_buf,
+                                                                                 chunk_out,
+                                                                                 chunk_out_idx,
+                                                                                 len,
+                                                                                 k,
+                                                                                 counters.data(),
+                                                                                 select_min);
+      RAFT_CUDA_TRY(cudaPeekAtLastError());
+    }
+  }
+}
+
+// The following a few functions are for the one-block version, which uses single thread block for
+// each row of a batch.
+template <typename T, typename IdxT, int BitsPerPass>
+_RAFT_DEVICE void filter_and_histogram_for_one_block(const T* in_buf,
+                                                     const IdxT* in_idx_buf,
+                                                     T* out_buf,
+                                                     IdxT* out_idx_buf,
+                                                     T* out,
+                                                     IdxT* out_idx,
+                                                     Counter<T, IdxT>* counter,
+                                                     IdxT* histogram,
+                                                     bool select_min,
+                                                     int pass)
+{
+  constexpr int num_buckets = calc_num_buckets<BitsPerPass>();
+  for (int i = threadIdx.x; i < num_buckets; i += blockDim.x) {
+    histogram[i] = 0;
+  }
+  IdxT* p_filter_cnt = &counter->filter_cnt;
+  if (threadIdx.x == 0) { *p_filter_cnt = 0; }
+  __syncthreads();
+
+  const int start_bit     = calc_start_bit<T, BitsPerPass>(pass);
+  const unsigned mask     = calc_mask<T, BitsPerPass>(pass);
+  const IdxT previous_len = counter->previous_len;
+
+  if (pass == 0) {
+    auto f = [histogram, select_min, start_bit, mask](T value, IdxT) {
+      int bucket = calc_bucket<T, BitsPerPass>(value, start_bit, mask, select_min);
+      atomicAdd(histogram + bucket, static_cast<IdxT>(1));
+    };
+    vectorized_process(threadIdx.x, blockDim.x, in_buf, previous_len, f);
+  } else {
+    // not use vectorized_process here because it increases #registers a lot
+    IdxT* p_out_cnt              = &counter->out_cnt;
+    const auto kth_value_bits    = counter->kth_value_bits;
+    const int previous_start_bit = calc_start_bit<T, BitsPerPass>(pass - 1);
+
+    for (IdxT i = threadIdx.x; i < previous_len; i += blockDim.x) {
+      const T value            = in_buf[i];
+      const auto previous_bits = (twiddle_in(value, select_min) >> previous_start_bit)
+                                 << previous_start_bit;
+      if (previous_bits == kth_value_bits) {
+#if CUDART_VERSION < 12000
+        // Avoiding potential compiler bug in CUDA 11
+        volatile
+#endif
+          IdxT pos       = atomicAdd(p_filter_cnt, static_cast<IdxT>(1));
+        out_buf[pos]     = value;
+        out_idx_buf[pos] = in_idx_buf ? in_idx_buf[i] : i;
+
+        int bucket = calc_bucket<T, BitsPerPass>(value, start_bit, mask, select_min);
+        atomicAdd(histogram + bucket, static_cast<IdxT>(1));
+      } else if (previous_bits < kth_value_bits) {
+        IdxT pos     = atomicAdd(p_out_cnt, static_cast<IdxT>(1));
+        out[pos]     = value;
+        out_idx[pos] = in_idx_buf ? in_idx_buf[i] : i;
       }
-      if (threadIdx.x == 0) { counter->filter_cnt = 0; }
     }
   }
 }
 
-/**
- * Calculate the minimal batch size, such that GPU is still fully occupied.
- */
 template <typename T, typename IdxT, int BitsPerPass, int BlockSize>
-inline dim3 get_optimal_grid_size(size_t req_batch_size, size_t len)
+__global__ void radix_topk_one_block_kernel(const T* in,
+                                            const IdxT* in_idx,
+                                            const IdxT len,
+                                            const IdxT k,
+                                            T* out,
+                                            IdxT* out_idx,
+                                            const bool select_min,
+                                            T* buf1,
+                                            IdxT* idx_buf1,
+                                            T* buf2,
+                                            IdxT* idx_buf2)
 {
-  int dev_id, sm_count, occupancy, max_grid_dim_y;
-  RAFT_CUDA_TRY(cudaGetDevice(&dev_id));
-  RAFT_CUDA_TRY(cudaDeviceGetAttribute(&sm_count, cudaDevAttrMultiProcessorCount, dev_id));
-  RAFT_CUDA_TRY(cudaDeviceGetAttribute(&max_grid_dim_y, cudaDevAttrMaxGridDimY, dev_id));
-  RAFT_CUDA_TRY(cudaOccupancyMaxActiveBlocksPerMultiprocessor(
-    &occupancy, radix_kernel<T, IdxT, BitsPerPass, BlockSize>, BlockSize, 0));
-
-  // number of block we'd use if the batch size is enough to occupy the gpu in any case
-  size_t blocks_per_row = ceildiv<size_t>(len, BlockSize * ITEM_PER_THREAD);
-
-  // fully occupy GPU
-  size_t opt_batch_size = ceildiv<size_t>(sm_count * occupancy, blocks_per_row);
-  // round it up to the closest pow-of-two for better data alignment
-  opt_batch_size = isPo2(opt_batch_size) ? opt_batch_size : (1 << (log2(opt_batch_size) + 1));
-  // Take a max possible pow-of-two grid_dim_y
-  max_grid_dim_y = isPo2(max_grid_dim_y) ? max_grid_dim_y : (1 << log2(max_grid_dim_y));
-  // If the optimal batch size is very small compared to the requested batch size, we know
-  // the extra required memory is not significant and we can increase the batch size for
-  // better occupancy when the grid size is not multiple of the SM count.
-  // Also don't split the batch size when there is not much work overall.
-  const size_t safe_enlarge_factor = 9;
-  const size_t min_grid_size       = 1024;
-  while ((opt_batch_size << safe_enlarge_factor) < req_batch_size ||
-         blocks_per_row * opt_batch_size < min_grid_size) {
-    opt_batch_size <<= 1;
+  constexpr int num_buckets = calc_num_buckets<BitsPerPass>();
+  __shared__ Counter<T, IdxT> counter;
+  __shared__ IdxT histogram[num_buckets];
+
+  if (threadIdx.x == 0) {
+    counter.k              = k;
+    counter.len            = len;
+    counter.previous_len   = len;
+    counter.kth_value_bits = 0;
+    counter.out_cnt        = 0;
+    counter.out_back_cnt   = 0;
   }
+  __syncthreads();
+
+  const size_t batch_id = blockIdx.x;  // size_t to avoid multiplication overflow
+  in += batch_id * len;
+  if (in_idx) { in_idx += batch_id * len; }
+  out += batch_id * k;
+  out_idx += batch_id * k;
+  buf1 += batch_id * len;
+  idx_buf1 += batch_id * len;
+  buf2 += batch_id * len;
+  idx_buf2 += batch_id * len;
+  const T* in_buf        = nullptr;
+  const IdxT* in_idx_buf = nullptr;
+  T* out_buf             = nullptr;
+  IdxT* out_idx_buf      = nullptr;
+
+  constexpr int num_passes = calc_num_passes<T, BitsPerPass>();
+  for (int pass = 0; pass < num_passes; ++pass) {
+    set_buf_pointers(
+      in, in_idx, buf1, idx_buf1, buf2, idx_buf2, pass, in_buf, in_idx_buf, out_buf, out_idx_buf);
+
+    IdxT current_len = counter.len;
+    IdxT current_k   = counter.k;
+
+    filter_and_histogram_for_one_block<T, IdxT, BitsPerPass>(in_buf,
+                                                             in_idx_buf,
+                                                             out_buf,
+                                                             out_idx_buf,
+                                                             out,
+                                                             out_idx,
+                                                             &counter,
+                                                             histogram,
+                                                             select_min,
+                                                             pass);
+    __syncthreads();
+
+    scan<IdxT, BitsPerPass, BlockSize>(histogram);
+    __syncthreads();
+
+    choose_bucket<T, IdxT, BitsPerPass>(&counter, histogram, current_k, pass);
+    if (threadIdx.x == 0) { counter.previous_len = current_len; }
+    __syncthreads();
 
-  // Do not exceed the max grid size.
-  opt_batch_size = std::min<size_t>(opt_batch_size, size_t(max_grid_dim_y));
-  // Don't do more work than needed
-  opt_batch_size = std::min<size_t>(opt_batch_size, req_batch_size);
-  // Let more blocks share one row if the required batch size is too small.
-  while (opt_batch_size * blocks_per_row < size_t(sm_count * occupancy) &&
-         // Ensure we still can read data somewhat efficiently
-         len * sizeof(T) > 2 * VECTORIZED_READ_SIZE * BlockSize * blocks_per_row) {
-    blocks_per_row <<= 1;
+    if (counter.len == counter.k || pass == num_passes - 1) {
+      last_filter<T, IdxT, BitsPerPass>(pass == 0 ? in : out_buf,
+                                        pass == 0 ? in_idx : out_idx_buf,
+                                        out,
+                                        out_idx,
+                                        current_len,
+                                        k,
+                                        &counter,
+                                        select_min,
+                                        pass);
+      break;
+    }
   }
+}
 
-  return dim3(blocks_per_row, opt_batch_size);
+// radix_topk() might use multiple thread blocks for one row of a batch. In contrast, the following
+// one-block version uses single thread block for one row of a batch, so intermediate data, like
+// counters and global histograms, can be kept in shared memory and cheap sync operations can be
+// used. It's used when len is relatively small or when the number of blocks per row calculated by
+// `calc_grid_dim()` is 1.
+template <typename T, typename IdxT, int BitsPerPass, int BlockSize>
+void radix_topk_one_block(const T* in,
+                          const IdxT* in_idx,
+                          int batch_size,
+                          IdxT len,
+                          IdxT k,
+                          T* out,
+                          IdxT* out_idx,
+                          bool select_min,
+                          int sm_cnt,
+                          rmm::cuda_stream_view stream,
+                          rmm::mr::device_memory_resource* mr)
+{
+  static_assert(calc_num_passes<T, BitsPerPass>() > 1);
+
+  auto kernel = radix_topk_one_block_kernel<T, IdxT, BitsPerPass, BlockSize>;
+  const size_t max_chunk_size =
+    calc_chunk_size<T, IdxT, BlockSize>(batch_size, len, sm_cnt, kernel);
+
+  auto pool_guard =
+    raft::get_pool_memory_resource(mr,
+                                   max_chunk_size * len * 2 * (sizeof(T) + sizeof(IdxT)) +
+                                     256 * 4  // might need extra memory for alignment
+    );
+  if (pool_guard) {
+    RAFT_LOG_DEBUG("radix::select_k: using pool memory resource with initial size %zu bytes",
+                   pool_guard->pool_size());
+  }
+
+  rmm::device_uvector<T> buf1(len * max_chunk_size, stream, mr);
+  rmm::device_uvector<IdxT> idx_buf1(len * max_chunk_size, stream, mr);
+  rmm::device_uvector<T> buf2(len * max_chunk_size, stream, mr);
+  rmm::device_uvector<IdxT> idx_buf2(len * max_chunk_size, stream, mr);
+
+  for (size_t offset = 0; offset < static_cast<size_t>(batch_size); offset += max_chunk_size) {
+    int chunk_size = std::min(max_chunk_size, batch_size - offset);
+    kernel<<<chunk_size, BlockSize, 0, stream>>>(in + offset * len,
+                                                 in_idx ? (in_idx + offset * len) : nullptr,
+                                                 len,
+                                                 k,
+                                                 out + offset * k,
+                                                 out_idx + offset * k,
+                                                 select_min,
+                                                 buf1.data(),
+                                                 idx_buf1.data(),
+                                                 buf2.data(),
+                                                 idx_buf2.data());
+  }
 }
 
+}  // namespace impl
+
 /**
  * Select k smallest or largest key/values from each row in the input data.
  *
@@ -546,6 +1099,12 @@ inline dim3 get_optimal_grid_size(size_t req_batch_size, size_t len)
  *   the payload selected together with `out`.
  * @param select_min
  *   whether to select k smallest (true) or largest (false) keys.
+ * @param fused_last_filter
+ *   when it's true, the last filter is fused into the kernel in the last pass and only one thread
+ *   block will do the filtering; when false, a standalone filter kernel with multiple thread
+ *   blocks is called. The later case is preferable when leading bits of input data are almost the
+ *   same. That is, when the value range of input data is narrow. In such case, there could be a
+ *   large number of inputs for the last filter, hence using multiple thread blocks is beneficial.
  * @param stream
  * @param mr an optional memory resource to use across the calls (you can provide a large enough
  *           memory pool here to avoid memory allocations within the call).
@@ -553,109 +1112,65 @@ inline dim3 get_optimal_grid_size(size_t req_batch_size, size_t len)
 template <typename T, typename IdxT, int BitsPerPass, int BlockSize>
 void select_k(const T* in,
               const IdxT* in_idx,
-              size_t batch_size,
-              size_t len,
-              int k,
+              int batch_size,
+              IdxT len,
+              IdxT k,
               T* out,
               IdxT* out_idx,
               bool select_min,
+              bool fused_last_filter,
               rmm::cuda_stream_view stream,
               rmm::mr::device_memory_resource* mr = nullptr)
 {
-  // reduce the block size if the input length is too small.
-  if constexpr (BlockSize > calc_min_block_size<BitsPerPass>()) {
-    if (BlockSize * ITEM_PER_THREAD > len) {
-      return select_k<T, IdxT, BitsPerPass, BlockSize / 2>(
-        in, in_idx, batch_size, len, k, out, out_idx, select_min, stream);
+  if (k == len) {
+    RAFT_CUDA_TRY(
+      cudaMemcpyAsync(out, in, sizeof(T) * batch_size * len, cudaMemcpyDeviceToDevice, stream));
+    if (in_idx) {
+      RAFT_CUDA_TRY(cudaMemcpyAsync(
+        out_idx, in_idx, sizeof(IdxT) * batch_size * len, cudaMemcpyDeviceToDevice, stream));
+    } else {
+      auto out_idx_view =
+        raft::make_device_vector_view(out_idx, static_cast<size_t>(len) * batch_size);
+      raft::device_resources handle(stream);
+      raft::linalg::map_offset(handle, out_idx_view, raft::mod_const_op<IdxT>(len));
     }
+    return;
   }
 
-  // TODO: is it possible to relax this restriction?
-  static_assert(calc_num_passes<T, BitsPerPass>() > 1);
-  constexpr int num_buckets = calc_num_buckets<BitsPerPass>();
-
-  dim3 blocks           = get_optimal_grid_size<T, IdxT, BitsPerPass, BlockSize>(batch_size, len);
-  size_t max_chunk_size = blocks.y;
-
-  size_t req_aux = max_chunk_size * (sizeof(Counter<T, IdxT>) + num_buckets * sizeof(IdxT));
-  size_t req_buf = max_chunk_size * len * 2 * (sizeof(T) + sizeof(IdxT));
-  size_t mem_req = req_aux + req_buf;
-  size_t mem_free, mem_total;
-  RAFT_CUDA_TRY(cudaMemGetInfo(&mem_free, &mem_total));
-  std::optional<rmm::mr::managed_memory_resource> managed_memory;
-  rmm::mr::device_memory_resource* mr_buf = nullptr;
-  if (mem_req > mem_free) {
-    // if there's not enough memory for buffers on the device, resort to the managed memory.
-    mem_req = req_aux;
-    managed_memory.emplace();
-    mr_buf = &managed_memory.value();
-  }
-
-  auto pool_guard = raft::get_pool_memory_resource(mr, mem_req);
-  if (pool_guard) {
-    RAFT_LOG_DEBUG("radix::select_k: using pool memory resource with initial size %zu bytes",
-                   pool_guard->pool_size());
+  // TODO: use device_resources::get_device_properties() instead; should change it when we refactor
+  // resource management
+  int sm_cnt;
+  {
+    int dev;
+    RAFT_CUDA_TRY(cudaGetDevice(&dev));
+    RAFT_CUDA_TRY(cudaDeviceGetAttribute(&sm_cnt, cudaDevAttrMultiProcessorCount, dev));
   }
-  if (mr_buf == nullptr) { mr_buf = mr; }
-
-  rmm::device_uvector<Counter<T, IdxT>> counters(max_chunk_size, stream, mr);
-  rmm::device_uvector<IdxT> histograms(max_chunk_size * num_buckets, stream, mr);
-  rmm::device_uvector<T> buf1(max_chunk_size * len, stream, mr_buf);
-  rmm::device_uvector<IdxT> idx_buf1(max_chunk_size * len, stream, mr_buf);
-  rmm::device_uvector<T> buf2(max_chunk_size * len, stream, mr_buf);
-  rmm::device_uvector<IdxT> idx_buf2(max_chunk_size * len, stream, mr_buf);
 
-  for (size_t offset = 0; offset < batch_size; offset += max_chunk_size) {
-    blocks.y = std::min(max_chunk_size, batch_size - offset);
+  constexpr int items_per_thread = 32;
 
-    RAFT_CUDA_TRY(
-      cudaMemsetAsync(counters.data(), 0, counters.size() * sizeof(Counter<T, IdxT>), stream));
-    RAFT_CUDA_TRY(cudaMemsetAsync(histograms.data(), 0, histograms.size() * sizeof(IdxT), stream));
-
-    const T* in_buf        = nullptr;
-    const IdxT* in_idx_buf = nullptr;
-    T* out_buf             = nullptr;
-    IdxT* out_idx_buf      = nullptr;
-
-    constexpr int num_passes = calc_num_passes<T, BitsPerPass>();
-
-    for (int pass = 0; pass < num_passes; ++pass) {
-      if (pass == 0) {
-        in_buf      = in + offset * len;
-        in_idx_buf  = nullptr;
-        out_buf     = nullptr;
-        out_idx_buf = nullptr;
-      } else if (pass == 1) {
-        in_buf      = in + offset * len;
-        in_idx_buf  = in_idx ? in_idx + offset * len : nullptr;
-        out_buf     = buf1.data();
-        out_idx_buf = idx_buf1.data();
-      } else if (pass % 2 == 0) {
-        in_buf      = buf1.data();
-        in_idx_buf  = idx_buf1.data();
-        out_buf     = buf2.data();
-        out_idx_buf = idx_buf2.data();
-      } else {
-        in_buf      = buf2.data();
-        in_idx_buf  = idx_buf2.data();
-        out_buf     = buf1.data();
-        out_idx_buf = idx_buf1.data();
-      }
-
-      radix_kernel<T, IdxT, BitsPerPass, BlockSize>
-        <<<blocks, BlockSize, 0, stream>>>(in_buf,
-                                           in_idx_buf,
-                                           out_buf,
-                                           out_idx_buf,
-                                           out + offset * k,
-                                           out_idx + offset * k,
-                                           counters.data(),
-                                           histograms.data(),
-                                           len,
-                                           k,
-                                           !select_min,
-                                           pass);
-      RAFT_CUDA_TRY(cudaPeekAtLastError());
+  if (len <= BlockSize * items_per_thread) {
+    impl::radix_topk_one_block<T, IdxT, BitsPerPass, BlockSize>(
+      in, in_idx, batch_size, len, k, out, out_idx, select_min, sm_cnt, stream, mr);
+  } else {
+    unsigned grid_dim =
+      impl::calc_grid_dim<T, IdxT, BitsPerPass, BlockSize>(batch_size, len, sm_cnt);
+    if (grid_dim == 1) {
+      impl::radix_topk_one_block<T, IdxT, BitsPerPass, BlockSize>(
+        in, in_idx, batch_size, len, k, out, out_idx, select_min, sm_cnt, stream, mr);
+    } else {
+      impl::radix_topk<T, IdxT, BitsPerPass, BlockSize>(in,
+                                                        in_idx,
+                                                        batch_size,
+                                                        len,
+                                                        k,
+                                                        out,
+                                                        out_idx,
+                                                        select_min,
+                                                        fused_last_filter,
+                                                        grid_dim,
+                                                        sm_cnt,
+                                                        stream,
+                                                        mr);
     }
   }
 }
diff --git a/cpp/include/raft/spatial/knn/knn.cuh b/cpp/include/raft/spatial/knn/knn.cuh
index 692d262043..a7bbfd9500 100644
--- a/cpp/include/raft/spatial/knn/knn.cuh
+++ b/cpp/include/raft/spatial/knn/knn.cuh
@@ -153,12 +153,12 @@ template <typename idx_t = int, typename value_t = float>
 
     case SelectKAlgo::RADIX_8_BITS:
       matrix::detail::select::radix::select_k<value_t, idx_t, 8, 512>(
-        in_keys, in_values, n_inputs, input_len, k, out_keys, out_values, select_min, stream);
+        in_keys, in_values, n_inputs, input_len, k, out_keys, out_values, select_min, true, stream);
       break;
 
     case SelectKAlgo::RADIX_11_BITS:
       matrix::detail::select::radix::select_k<value_t, idx_t, 11, 512>(
-        in_keys, in_values, n_inputs, input_len, k, out_keys, out_values, select_min, stream);
+        in_keys, in_values, n_inputs, input_len, k, out_keys, out_values, select_min, true, stream);
       break;
 
     case SelectKAlgo::WARP_SORT:
diff --git a/cpp/internal/raft_internal/matrix/select_k.cuh b/cpp/internal/raft_internal/matrix/select_k.cuh
index ede6382c33..188122c9b4 100644
--- a/cpp/internal/raft_internal/matrix/select_k.cuh
+++ b/cpp/internal/raft_internal/matrix/select_k.cuh
@@ -33,7 +33,8 @@ struct params {
   size_t len;
   int k;
   bool select_min;
-  bool use_index_input = true;
+  bool use_index_input       = true;
+  bool use_same_leading_bits = false;
 };
 
 inline auto operator<<(std::ostream& os, const params& ss) -> std::ostream&
@@ -42,7 +43,8 @@ inline auto operator<<(std::ostream& os, const params& ss) -> std::ostream&
   os << ", len: " << ss.len;
   os << ", k: " << ss.k;
   os << (ss.select_min ? ", asc" : ", dsc");
-  os << (ss.use_index_input ? "}" : ", no-input-index}");
+  os << (ss.use_index_input ? "" : ", no-input-index");
+  os << (ss.use_same_leading_bits ? ", same-leading-bits}" : "}");
   return os;
 }
 
@@ -50,6 +52,7 @@ enum class Algo {
   kPublicApi,
   kRadix8bits,
   kRadix11bits,
+  kRadix11bitsExtraPass,
   kWarpAuto,
   kWarpImmediate,
   kWarpFiltered,
@@ -63,6 +66,7 @@ inline auto operator<<(std::ostream& os, const Algo& algo) -> std::ostream&
     case Algo::kPublicApi: return os << "kPublicApi";
     case Algo::kRadix8bits: return os << "kRadix8bits";
     case Algo::kRadix11bits: return os << "kRadix11bits";
+    case Algo::kRadix11bitsExtraPass: return os << "kRadix11bitsExtraPass";
     case Algo::kWarpAuto: return os << "kWarpAuto";
     case Algo::kWarpImmediate: return os << "kWarpImmediate";
     case Algo::kWarpFiltered: return os << "kWarpFiltered";
@@ -103,11 +107,38 @@ void select_k_impl(const device_resources& handle,
       }
     }
     case Algo::kRadix8bits:
-      return detail::select::radix::select_k<T, IdxT, 8, 512>(
-        in, in_idx, batch_size, len, k, out, out_idx, select_min, stream);
+      return detail::select::radix::select_k<T, IdxT, 8, 512>(in,
+                                                              in_idx,
+                                                              batch_size,
+                                                              len,
+                                                              k,
+                                                              out,
+                                                              out_idx,
+                                                              select_min,
+                                                              true,  // fused_last_filter
+                                                              stream);
     case Algo::kRadix11bits:
-      return detail::select::radix::select_k<T, IdxT, 11, 512>(
-        in, in_idx, batch_size, len, k, out, out_idx, select_min, stream);
+      return detail::select::radix::select_k<T, IdxT, 11, 512>(in,
+                                                               in_idx,
+                                                               batch_size,
+                                                               len,
+                                                               k,
+                                                               out,
+                                                               out_idx,
+                                                               select_min,
+                                                               true,  // fused_last_filter
+                                                               stream);
+    case Algo::kRadix11bitsExtraPass:
+      return detail::select::radix::select_k<T, IdxT, 11, 512>(in,
+                                                               in_idx,
+                                                               batch_size,
+                                                               len,
+                                                               k,
+                                                               out,
+                                                               out_idx,
+                                                               select_min,
+                                                               false,  // fused_last_filter
+                                                               stream);
     case Algo::kWarpAuto:
       return detail::select::warpsort::select_k<T, IdxT>(
         in, in_idx, batch_size, len, k, out, out_idx, select_min, stream);
diff --git a/cpp/test/matrix/select_k.cu b/cpp/test/matrix/select_k.cu
index 392464eb27..2a40d70abc 100644
--- a/cpp/test/matrix/select_k.cu
+++ b/cpp/test/matrix/select_k.cu
@@ -332,6 +332,7 @@ INSTANTIATE_TEST_CASE_P(                // NOLINT
                    testing::Values(select::Algo::kPublicApi,
                                    select::Algo::kRadix8bits,
                                    select::Algo::kRadix11bits,
+                                   select::Algo::kRadix11bitsExtraPass,
                                    select::Algo::kWarpImmediate,
                                    select::Algo::kWarpFiltered,
                                    select::Algo::kWarpDistributed)));
@@ -426,6 +427,7 @@ INSTANTIATE_TEST_CASE_P(                          // NOLINT
   testing::Combine(inputs_random_longlist,
                    testing::Values(select::Algo::kRadix8bits,
                                    select::Algo::kRadix11bits,
+                                   select::Algo::kRadix11bitsExtraPass,
                                    select::Algo::kWarpImmediate,
                                    select::Algo::kWarpFiltered,
                                    select::Algo::kWarpDistributed,
@@ -440,6 +442,7 @@ INSTANTIATE_TEST_CASE_P(                             // NOLINT
   testing::Combine(inputs_random_longlist,
                    testing::Values(select::Algo::kRadix8bits,
                                    select::Algo::kRadix11bits,
+                                   select::Algo::kRadix11bitsExtraPass,
                                    select::Algo::kWarpImmediate,
                                    select::Algo::kWarpFiltered,
                                    select::Algo::kWarpDistributed,
@@ -451,7 +454,11 @@ TEST_P(ReferencedRandomDoubleInt, LargeSize) { run(); }  // NOLINT
 INSTANTIATE_TEST_CASE_P(                                 // NOLINT
   SelectK,
   ReferencedRandomDoubleInt,
-  testing::Combine(inputs_random_largesize, testing::Values(select::Algo::kWarpAuto)));
+  testing::Combine(inputs_random_largesize,
+                   testing::Values(select::Algo::kWarpAuto,
+                                   select::Algo::kRadix8bits,
+                                   select::Algo::kRadix11bits,
+                                   select::Algo::kRadix11bitsExtraPass)));
 
 using ReferencedRandomFloatSizeT =
   SelectK<float, uint64_t, with_ref<select::Algo::kRadix8bits>::params_random>;
@@ -459,6 +466,7 @@ TEST_P(ReferencedRandomFloatSizeT, LargeK) { run(); }  // NOLINT
 INSTANTIATE_TEST_CASE_P(SelectK,                       // NOLINT
                         ReferencedRandomFloatSizeT,
                         testing::Combine(inputs_random_largek,
-                                         testing::Values(select::Algo::kRadix11bits)));
+                                         testing::Values(select::Algo::kRadix11bits,
+                                                         select::Algo::kRadix11bitsExtraPass)));
 
 }  // namespace raft::matrix

From 9389108b7f7f100c883092a46f09738f23ab8151 Mon Sep 17 00:00:00 2001
From: "Corey J. Nolet" <cjnolet@gmail.com>
Date: Fri, 24 Mar 2023 13:42:03 -0400
Subject: [PATCH 15/25] RAFT skeleton project template (#1312)

This is a copy and modification of a user's project but I think this is going to be generally useful to users as the same types of challenges are going to come up again. In this case, the user wasn't able to build/link because they weren't using `rapids-cmake` to propagate important configuration settings. I think having a skeleton project available that we build in CI and keep up to date will help new users build more applications on RAFT.


TODO:
- [x] Make building the template optional
- [x] Verify this can build in CMake and reuse already built/installed bits
- [x] Add to docs / readme and reference in README.md
- [x] Add a little example of invoking an API (maybe `pairwise_distances`?) to `main()`

Authors:
  - Corey J. Nolet (https://github.com/cjnolet)
  - Ben Frederickson (https://github.com/benfred)

Approvers:
  - Micka (https://github.com/lowener)
  - Dante Gama Dessavre (https://github.com/dantegd)
  - Divye Gala (https://github.com/divyegala)
  - AJ Schmidt (https://github.com/ajschmidt8)

URL: https://github.com/rapidsai/raft/pull/1312
---
 .github/workflows/build.yaml                  |  1 +
 README.md                                     | 61 ++++--------------
 build.sh                                      | 15 ++++-
 .../recipes/libraft/build_libraft_template.sh |  5 ++
 conda/recipes/libraft/meta.yaml               | 36 +++++++++++
 cpp/template/CMakeLists.txt                   | 38 +++++++++++
 cpp/template/README.md                        | 18 ++++++
 cpp/template/build.sh                         | 41 ++++++++++++
 .../cmake/thirdparty/fetch_rapids.cmake       | 21 ++++++
 cpp/template/cmake/thirdparty/get_raft.cmake  | 62 ++++++++++++++++++
 cpp/template/src/test_distance.cu             | 42 ++++++++++++
 docs/source/build.md                          | 64 ++++++++-----------
 python/pylibraft/setup.cfg                    | 38 +++++++++++
 setup.cfg                                     | 55 ++++++++++++++++
 14 files changed, 409 insertions(+), 88 deletions(-)
 create mode 100644 conda/recipes/libraft/build_libraft_template.sh
 create mode 100644 cpp/template/CMakeLists.txt
 create mode 100644 cpp/template/README.md
 create mode 100755 cpp/template/build.sh
 create mode 100644 cpp/template/cmake/thirdparty/fetch_rapids.cmake
 create mode 100644 cpp/template/cmake/thirdparty/get_raft.cmake
 create mode 100644 cpp/template/src/test_distance.cu
 create mode 100644 python/pylibraft/setup.cfg
 create mode 100644 setup.cfg

diff --git a/.github/workflows/build.yaml b/.github/workflows/build.yaml
index 41b6a639d8..32aab5656b 100644
--- a/.github/workflows/build.yaml
+++ b/.github/workflows/build.yaml
@@ -52,6 +52,7 @@ jobs:
       branch: ${{ inputs.branch }}
       date: ${{ inputs.date }}
       sha: ${{ inputs.sha }}
+      skip_upload_pkgs: libraft-template
   docs-build:
     if: github.ref_type == 'branch' && github.event_name == 'push'
     needs: python-build
diff --git a/README.md b/README.md
index 8c6e817bf9..81973ff82e 100755
--- a/README.md
+++ b/README.md
@@ -1,6 +1,5 @@
 # <div align="left"><img src="https://rapids.ai/assets/images/rapids_logo.png" width="90px"/>&nbsp;RAFT: Reusable Accelerated Functions and Tools</div>
 
-
 ![Navigating the canyons of accelerated possibilities](img/raft.png)
 
 ## Resources
@@ -85,9 +84,9 @@ raft::device_resources handle;
 int n_samples = 5000;
 int n_features = 50;
 
-auto input = raft::make_device_matrix<float>(handle, n_samples, n_features);
-auto labels = raft::make_device_vector<int>(handle, n_samples);
-auto output = raft::make_device_matrix<float>(handle, n_samples, n_samples);
+auto input = raft::make_device_matrix<float, int>(handle, n_samples, n_features);
+auto labels = raft::make_device_vector<int, int>(handle, n_samples);
+auto output = raft::make_device_matrix<float, int>(handle, n_samples, n_samples);
 
 raft::random::make_blobs(handle, input.view(), labels.view());
 
@@ -222,52 +221,15 @@ pip install raft-dask-cu11 --extra-index-url=https://pypi.ngc.nvidia.com
 
 ### CMake & CPM
 
-RAFT uses the [RAPIDS-CMake](https://github.com/rapidsai/rapids-cmake) library, which makes it simple to include in downstream cmake projects. RAPIDS CMake provides a convenience layer around CPM.
-
-After [installing](https://github.com/rapidsai/rapids-cmake#installation) rapids-cmake in your project, you can begin using RAFT by placing the code snippet below in a file named `get_raft.cmake` and including it in your cmake build with `include(get_raft.cmake)`. This will make available several targets to add to configure the link libraries for your artifacts.
-
-```cmake
-
-set(RAFT_VERSION "22.12")
-set(RAFT_FORK "rapidsai")
-set(RAFT_PINNED_TAG "branch-${RAFT_VERSION}")
-
-function(find_and_configure_raft)
-  set(oneValueArgs VERSION FORK PINNED_TAG COMPILE_LIBRARIES)
-  cmake_parse_arguments(PKG "${options}" "${oneValueArgs}"
-                            "${multiValueArgs}" ${ARGN} )
-
-  #-----------------------------------------------------
-  # Invoke CPM find_package()
-  #-----------------------------------------------------
-
-  rapids_cpm_find(raft ${PKG_VERSION}
-          GLOBAL_TARGETS      raft::raft
-          BUILD_EXPORT_SET    projname-exports
-          INSTALL_EXPORT_SET  projname-exports
-          CPM_ARGS
-          GIT_REPOSITORY https://github.com/${PKG_FORK}/raft.git
-          GIT_TAG        ${PKG_PINNED_TAG}
-          SOURCE_SUBDIR  cpp
-          OPTIONS
-          "BUILD_TESTS OFF"
-          "BUILD_BENCH OFF"
-          "RAFT_COMPILE_LIBRARIES ${PKG_COMPILE_LIBRARIES}"
-  )
-
-endfunction()
-
-# Change pinned tag here to test a commit in CI
-# To use a different RAFT locally, set the CMake variable
-# CPM_raft_SOURCE=/path/to/local/raft
-find_and_configure_raft(VERSION    ${RAFT_VERSION}.00
-        FORK             ${RAFT_FORK}
-        PINNED_TAG       ${RAFT_PINNED_TAG}
-        COMPILE_LIBRARIES      NO
-)
-```
+RAFT uses the [RAPIDS-CMake](https://github.com/rapidsai/rapids-cmake) library, which makes it easy to include in downstream cmake projects. RAPIDS-CMake provides a convenience layer around CPM. Please refer to [these instructions](https://github.com/rapidsai/rapids-cmake#installation) to install and use rapids-cmake in your project.
+
+#### Example Template Project
+
+You can find an [example RAFT](cpp/template/README.md) project template in the `cpp/template` directory, which demonstrates how to build a new application with RAFT or incorporate RAFT into an existing cmake project.
+
+#### CMake Targets
 
-Several CMake targets can be made available by adding components in the table below to the `RAFT_COMPONENTS` list above, separated by spaces. The `raft::raft` target will always be available. RAFT headers require, at a minimum, the CUDA toolkit libraries and RMM dependencies.
+Additional CMake targets can be made available by adding components in the table below to the `RAFT_COMPONENTS` list above, separated by spaces. The `raft::raft` target will always be available. RAFT headers require, at a minimum, the CUDA toolkit libraries and RMM dependencies.
 
 | Component   | Target              | Description                                               | Base Dependencies                     |
 |-------------|---------------------|-----------------------------------------------------------|---------------------------------------|
@@ -321,6 +283,7 @@ The folder structure mirrors other RAPIDS repos, with the following folders:
   - `internal`: A private header-only component that hosts the code shared between benchmarks and tests.
   - `scripts`: Helpful scripts for development
   - `src`: Compiled APIs and template specializations for the shared libraries
+  - `template`: A skeleton template containing the bare-bones file structure and cmake configuration for writing applications with RAFT.
   - `test`: Googletests source code
 - `docs`: Source code and scripts for building library documentation (Uses breath, doxygen, & pydocs)
 - `python`: Source code for Python libraries.
diff --git a/build.sh b/build.sh
index b5a72f4205..9468d2cab0 100755
--- a/build.sh
+++ b/build.sh
@@ -18,7 +18,7 @@ ARGS=$*
 # script, and that this script resides in the repo dir!
 REPODIR=$(cd $(dirname $0); pwd)
 
-VALIDARGS="clean libraft pylibraft raft-dask docs tests bench clean --uninstall  -v -g -n --compile-lib --allgpuarch --no-nvtx --show_depr_warn -h"
+VALIDARGS="clean libraft pylibraft raft-dask docs tests bench template clean --uninstall  -v -g -n --compile-lib --allgpuarch --no-nvtx --show_depr_warn -h"
 HELP="$0 [<target> ...] [<flag> ...] [--cmake-args=\"<args>\"] [--cache-tool=<tool>] [--limit-tests=<targets>] [--limit-bench=<targets>]
  where <target> is:
    clean            - remove all existing build artifacts and configuration (start over)
@@ -29,6 +29,7 @@ HELP="$0 [<target> ...] [<flag> ...] [--cmake-args=\"<args>\"] [--cache-tool=<to
    docs             - build the documentation
    tests            - build the tests
    bench            - build the benchmarks
+   template         - build the example RAFT application template
 
  and <flag> is:
    -v                          - verbose build mode
@@ -354,13 +355,12 @@ if (( ${NUMARGS} == 0 )) || hasArg libraft || hasArg docs || hasArg tests || has
           -DCMAKE_INSTALL_PREFIX=${INSTALL_PREFIX} \
           -DCMAKE_CUDA_ARCHITECTURES=${RAFT_CMAKE_CUDA_ARCHITECTURES} \
           -DCMAKE_BUILD_TYPE=${BUILD_TYPE} \
-          -DRAFT_COMPILE_LIBRARIES=${COMPILE_LIBRARIES} \
+          -DRAFT_COMPILE_LIBRARY=${COMPILE_LIBRARY} \
           -DRAFT_NVTX=${NVTX} \
           -DDISABLE_DEPRECATION_WARNINGS=${DISABLE_DEPRECATION_WARNINGS} \
           -DBUILD_TESTS=${BUILD_TESTS} \
           -DBUILD_BENCH=${BUILD_BENCH} \
           -DCMAKE_MESSAGE_LOG_LEVEL=${CMAKE_LOG_LEVEL} \
-          -DRAFT_COMPILE_LIBRARY=${COMPILE_LIBRARY} \
           ${CACHE_ARGS} \
           ${EXTRA_CMAKE_ARGS}
 
@@ -410,3 +410,12 @@ if hasArg docs; then
     cd ${SPHINX_BUILD_DIR}
     sphinx-build -b html source _html
 fi
+
+################################################################################
+# Initiate build for example RAFT application template (if needed)
+
+if hasArg template; then
+    pushd cpp/template
+    ./build.sh
+    popd
+fi
diff --git a/conda/recipes/libraft/build_libraft_template.sh b/conda/recipes/libraft/build_libraft_template.sh
new file mode 100644
index 0000000000..9759402884
--- /dev/null
+++ b/conda/recipes/libraft/build_libraft_template.sh
@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# Copyright (c) 2022-2023, NVIDIA CORPORATION.
+
+# Just building template so we verify it uses libraft.so and fail if it doesn't build
+./build.sh template
\ No newline at end of file
diff --git a/conda/recipes/libraft/meta.yaml b/conda/recipes/libraft/meta.yaml
index 2a724672ab..f911166a9a 100644
--- a/conda/recipes/libraft/meta.yaml
+++ b/conda/recipes/libraft/meta.yaml
@@ -150,3 +150,39 @@ outputs:
       home: https://rapids.ai/
       license: Apache-2.0
       summary: libraft tests
+  - name: libraft-template
+    version: {{ version }}
+    script: build_libraft_template.sh
+    build:
+      script_env: *script_env
+      number: {{ GIT_DESCRIBE_NUMBER }}
+      string: cuda{{ cuda_major }}_{{ date_string }}_{{ GIT_DESCRIBE_HASH }}_{{ GIT_DESCRIBE_NUMBER }}
+      ignore_run_exports_from:
+        - {{ compiler('cuda') }}
+    requirements:
+      build:
+        - {{ compiler('c') }}
+        - {{ compiler('cuda') }} {{ cuda_version }}
+        - {{ compiler('cxx') }}
+        - cmake {{ cmake_version }}
+        - ninja
+        - sysroot_{{ target_platform }} {{ sysroot_version }}
+      host:
+        - {{ pin_subpackage('libraft', exact=True) }}
+        - {{ pin_subpackage('libraft-headers', exact=True) }}
+        - cuda-profiler-api {{ cuda_profiler_api_host_version }}
+        - libcublas {{ libcublas_host_version }}
+        - libcublas-dev {{ libcublas_host_version }}
+        - libcurand {{ libcurand_host_version }}
+        - libcurand-dev {{ libcurand_host_version }}
+        - libcusolver {{ libcusolver_host_version }}
+        - libcusolver-dev {{ libcusolver_host_version }}
+        - libcusparse {{ libcusparse_host_version }}
+        - libcusparse-dev {{ libcusparse_host_version }}
+      run:
+        - {{ pin_subpackage('libraft', exact=True) }}
+        - {{ pin_subpackage('libraft-headers', exact=True) }}
+    about:
+      home: https://rapids.ai/
+      license: Apache-2.0
+      summary: libraft template
diff --git a/cpp/template/CMakeLists.txt b/cpp/template/CMakeLists.txt
new file mode 100644
index 0000000000..501a5c9503
--- /dev/null
+++ b/cpp/template/CMakeLists.txt
@@ -0,0 +1,38 @@
+# =============================================================================
+# Copyright (c) 2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+# in compliance with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software distributed under the License
+# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+# or implied. See the License for the specific language governing permissions and limitations under
+# the License.
+
+cmake_minimum_required(VERSION 3.23.1 FATAL_ERROR)
+
+# ------------- configure rapids-cmake --------------#
+
+include(cmake/thirdparty/fetch_rapids.cmake)
+include(rapids-cmake)
+include(rapids-cpm)
+include(rapids-cuda)
+include(rapids-export)
+include(rapids-find)
+
+# ------------- configure project --------------#
+
+rapids_cuda_init_architectures(test_raft)
+
+project(test_raft LANGUAGES CXX CUDA)
+
+# ------------- configure raft -----------------#
+
+rapids_cpm_init()
+include(cmake/thirdparty/get_raft.cmake)
+
+# -------------- compile tasks ----------------- #
+add_executable(TEST_RAFT src/test_distance.cu)
+target_link_libraries(TEST_RAFT PRIVATE raft::raft raft::compiled)
diff --git a/cpp/template/README.md b/cpp/template/README.md
new file mode 100644
index 0000000000..348dff270a
--- /dev/null
+++ b/cpp/template/README.md
@@ -0,0 +1,18 @@
+# Example RAFT Project Template
+
+This template project provides a drop-in sample to either start building a new application with, or using RAFT in an existing CMake project. 
+
+First, please refer to our [installation docs](https://docs.rapids.ai/api/raft/stable/build.html#cuda-gpu-requirements) for the minimum requirements to use RAFT.
+
+Once the minimum requirements are satisfied, this example template application can be built with the provided `build.sh` script. This is a bash script that calls the appropriate CMake commands, so you can look into it to see the typical CMake based build workflow.  
+
+This directory (`RAFT_SOURCE/cpp/template`) can be copied directly in order to build a new application with RAFT.
+
+RAFT can be integrated into an existing CMake project by copying the contents in the `configure rapids-cmake` and `configure raft` sections of the provided `CMakeLists.txt` into your project, along with `cmake/thirdparty/get_raft.cmake`. 
+
+Make sure to link against the appropriate Cmake targets. Use `raft::raft`to add make the headers available and `raft::compiled` when utilizing the shared library.
+
+```cmake
+target_link_libraries(your_app_target PRIVATE raft::raft raft::compiled)
+```
+
diff --git a/cpp/template/build.sh b/cpp/template/build.sh
new file mode 100755
index 0000000000..3ac00fc9af
--- /dev/null
+++ b/cpp/template/build.sh
@@ -0,0 +1,41 @@
+#!/bin/bash
+
+# Copyright (c) 2023, NVIDIA CORPORATION.
+
+# raft empty project template build script
+
+# Abort script on first error
+set -e
+
+PARALLEL_LEVEL=${PARALLEL_LEVEL:=`nproc`}
+
+BUILD_TYPE=Release
+BUILD_DIR=build/
+
+RAFT_REPO_REL=""
+EXTRA_CMAKE_ARGS=""
+set -e
+
+
+if [[ ${RAFT_REPO_REL} != "" ]]; then
+  RAFT_REPO_PATH="`readlink -f \"${RAFT_REPO_REL}\"`"
+  EXTRA_CMAKE_ARGS="${EXTRA_CMAKE_ARGS} -DCPM_raft_SOURCE=${RAFT_REPO_PATH}"
+fi
+
+if [ "$1" == "clean" ]; then
+  rm -rf build
+  exit 0
+fi
+
+mkdir -p $BUILD_DIR
+cd $BUILD_DIR
+
+cmake \
+ -DCMAKE_BUILD_TYPE=${BUILD_TYPE} \
+ -DRAFT_NVTX=OFF \
+ -DCMAKE_CUDA_ARCHITECTURES="NATIVE" \
+ -DCMAKE_EXPORT_COMPILE_COMMANDS=ON \
+ ${EXTRA_CMAKE_ARGS} \
+ ../
+
+cmake  --build . -j${PARALLEL_LEVEL}
diff --git a/cpp/template/cmake/thirdparty/fetch_rapids.cmake b/cpp/template/cmake/thirdparty/fetch_rapids.cmake
new file mode 100644
index 0000000000..40ba83be9e
--- /dev/null
+++ b/cpp/template/cmake/thirdparty/fetch_rapids.cmake
@@ -0,0 +1,21 @@
+# =============================================================================
+# Copyright (c) 2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+# in compliance with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software distributed under the License
+# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+# or implied. See the License for the specific language governing permissions and limitations under
+# the License.
+
+# Use this variable to update RAPIDS and RAFT versions
+set(RAPIDS_VERSION "23.04")
+
+if(NOT EXISTS ${CMAKE_CURRENT_BINARY_DIR}/RAFT_RAPIDS.cmake)
+    file(DOWNLOAD https://raw.githubusercontent.com/rapidsai/rapids-cmake/branch-${RAPIDS_VERSION}/RAPIDS.cmake
+            ${CMAKE_CURRENT_BINARY_DIR}/RAFT_RAPIDS.cmake)
+endif()
+include(${CMAKE_CURRENT_BINARY_DIR}/RAFT_RAPIDS.cmake)
diff --git a/cpp/template/cmake/thirdparty/get_raft.cmake b/cpp/template/cmake/thirdparty/get_raft.cmake
new file mode 100644
index 0000000000..5463942adf
--- /dev/null
+++ b/cpp/template/cmake/thirdparty/get_raft.cmake
@@ -0,0 +1,62 @@
+# =============================================================================
+# Copyright (c) 2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+# in compliance with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software distributed under the License
+# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+# or implied. See the License for the specific language governing permissions and limitations under
+# the License.
+
+# Use RAPIDS_VERSION from cmake/thirdparty/fetch_rapids.cmake
+set(RAFT_VERSION "${RAPIDS_VERSION}")
+set(RAFT_FORK "rapidsai")
+set(RAFT_PINNED_TAG "branch-${RAPIDS_VERSION}")
+
+function(find_and_configure_raft)
+    set(oneValueArgs VERSION FORK PINNED_TAG COMPILE_LIBRARY ENABLE_NVTX ENABLE_MNMG_DEPENDENCIES)
+    cmake_parse_arguments(PKG "${options}" "${oneValueArgs}"
+            "${multiValueArgs}" ${ARGN} )
+
+    set(RAFT_COMPONENTS "")
+    if(PKG_COMPILE_LIBRARY)
+        string(APPEND RAFT_COMPONENTS " compiled")
+    endif()
+
+    if(PKG_ENABLE_MNMG_DEPENDENCIES)
+        string(APPEND RAFT_COMPONENTS " distributed")
+    endif()
+
+    #-----------------------------------------------------
+    # Invoke CPM find_package()
+    #-----------------------------------------------------
+    rapids_cpm_find(raft ${PKG_VERSION}
+            GLOBAL_TARGETS      raft::raft
+            BUILD_EXPORT_SET    raft-template-exports
+            INSTALL_EXPORT_SET  raft-template-exports
+            COMPONENTS          ${RAFT_COMPONENTS}
+            CPM_ARGS
+            GIT_REPOSITORY https://github.com/${PKG_FORK}/raft.git
+            GIT_TAG        ${PKG_PINNED_TAG}
+            SOURCE_SUBDIR  cpp
+            OPTIONS
+            "BUILD_TESTS OFF"
+            "BUILD_BENCH OFF"
+            "RAFT_NVTX   ${ENABLE_NVTX}"
+            "RAFT_COMPILE_LIBRARY ${PKG_COMPILE_LIBRARY}"
+            )
+endfunction()
+
+# Change pinned tag here to test a commit in CI
+# To use a different RAFT locally, set the CMake variable
+# CPM_raft_SOURCE=/path/to/local/raft
+find_and_configure_raft(VERSION  ${RAFT_VERSION}.00
+        FORK                     ${RAFT_FORK}
+        PINNED_TAG               ${RAFT_PINNED_TAG}
+        COMPILE_LIBRARY          ON
+        ENABLE_MNMG_DEPENDENCIES OFF
+        ENABLE_NVTX              OFF
+)
diff --git a/cpp/template/src/test_distance.cu b/cpp/template/src/test_distance.cu
new file mode 100644
index 0000000000..b86dde70e5
--- /dev/null
+++ b/cpp/template/src/test_distance.cu
@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include <cstdint>
+#include <raft/core/device_mdarray.hpp>
+#include <raft/core/device_resources.hpp>
+#include <raft/distance/distance.cuh>
+#include <raft/random/make_blobs.cuh>
+
+#ifdef RAFT_COMPILED
+#include <raft/distance/specializations.cuh>
+#endif
+
+int main()
+{
+  raft::device_resources handle;
+
+  int n_samples  = 5000;
+  int n_features = 50;
+
+  auto input  = raft::make_device_matrix<float, int>(handle, n_samples, n_features);
+  auto labels = raft::make_device_vector<int, int>(handle, n_samples);
+  auto output = raft::make_device_matrix<float, int>(handle, n_samples, n_samples);
+
+  raft::random::make_blobs(handle, input.view(), labels.view());
+
+  auto metric = raft::distance::DistanceType::L2SqrtExpanded;
+  raft::distance::pairwise_distance(handle, input.view(), input.view(), output.view(), metric);
+}
diff --git a/docs/source/build.md b/docs/source/build.md
index bbb454736a..e8e6ac8a14 100644
--- a/docs/source/build.md
+++ b/docs/source/build.md
@@ -75,7 +75,7 @@ Once installed, `libraft` headers (and dependencies which were downloaded and in
 ```
 
 
-### C++ Shared Libraries (optional)
+### C++ Shared Library (optional)
 
 A shared library can be built for speeding up compile times. The shared library also contains a runtime API that allows you to invoke RAFT APIs directly from C++ source files (without `nvcc`). The shared library can also significantly improve re-compile times both while developing RAFT and using its APIs to develop applications. Pass the `--compile-lib` flag to `build.sh` to build the library:
 ```bash
@@ -109,7 +109,7 @@ Compile the tests using the `tests` target in `build.sh`.
 Test compile times can be improved significantly by using the optional shared libraries. If installed, they will be used automatically when building the tests but `--compile-libs` can be used to add additional compilation units and compile them with the tests.
 
 ```bash
-./build.sh libraft tests --compile-libs
+./build.sh libraft tests --compile-lib
 ```
 
 The tests are broken apart by algorithm category, so you will find several binaries in `cpp/build/` named `*_TEST`.
@@ -151,19 +151,17 @@ make -j<parallel_level> install
 
 RAFT's cmake has the following configurable flags available:.
 
-| Flag | Possible Values | Default Value | Behavior |
-| --- | --- | --- | --- |
-| BUILD_TESTS | ON, OFF | ON | Compile Googletests |
-| BUILD_BENCH | ON, OFF | OFF | Compile benchmarks |
-| raft_FIND_COMPONENTS | nn distance | | Configures the optional components as a space-separated list |
-| RAFT_COMPILE_LIBRARIES | ON, OFF | ON if either BUILD_TESTS or BUILD_BENCH is ON; otherwise OFF | Compiles all `libraft` shared libraries (these are required for Googletests) |
-| RAFT_COMPILE_NN_LIBRARY | ON, OFF | OFF | Compiles the `libraft-nn` shared library |
-| RAFT_COMPILE_DIST_LIBRARY | ON, OFF | OFF | Compiles the `libraft-distance` shared library |
-| DETECT_CONDA_ENV | ON, OFF | ON | Enable detection of conda environment for dependencies |
-| RAFT_NVTX | ON, OFF | OFF | Enable NVTX Markers |
-| CUDA_ENABLE_KERNELINFO | ON, OFF | OFF | Enables `kernelinfo` in nvcc. This is useful for `compute-sanitizer` |
-| CUDA_ENABLE_LINEINFO  | ON, OFF | OFF | Enable the -lineinfo option for nvcc |
-| CUDA_STATIC_RUNTIME | ON, OFF | OFF | Statically link the CUDA runtime |
+| Flag                      | Possible Values      | Default Value | Behavior |
+|---------------------------|----------------------| --- | --- |
+| BUILD_TESTS               | ON, OFF              | ON | Compile Googletests |
+| BUILD_BENCH               | ON, OFF              | OFF | Compile benchmarks |
+| raft_FIND_COMPONENTS      | compiled distributed | | Configures the optional components as a space-separated list |
+| RAFT_COMPILE_LIBRARY      | ON, OFF              | ON if either BUILD_TESTS or BUILD_BENCH is ON; otherwise OFF | Compiles all `libraft` shared libraries (these are required for Googletests) |
+| DETECT_CONDA_ENV          | ON, OFF              | ON | Enable detection of conda environment for dependencies |
+| RAFT_NVTX                 | ON, OFF              | OFF | Enable NVTX Markers |
+| CUDA_ENABLE_KERNELINFO    | ON, OFF              | OFF | Enables `kernelinfo` in nvcc. This is useful for `compute-sanitizer` |
+| CUDA_ENABLE_LINEINFO      | ON, OFF              | OFF | Enable the -lineinfo option for nvcc |
+| CUDA_STATIC_RUNTIME       | ON, OFF              | OFF | Statically link the CUDA runtime |
 
 Currently, shared libraries are provided for the `libraft-nn` and `libraft-distance` components.
 
@@ -248,9 +246,9 @@ PROPERTIES CXX_STANDARD                        17
 ```
 
 
-### C++ header-only integration
+### C++ header-only integration (without cmake)
 
-When the needed [build dependencies](#build-dependencies) are already satisfied, RAFT can be trivially integrated into downstream projects by cloning the repository and adding `cpp/include` from RAFT to the include path:
+While not a highly suggested method for building against RAFT, when all of the needed [build dependencies](#build-dependencies) are already satisfied, RAFT can be integrated into downstream projects by cloning the repository and adding `cpp/include` from RAFT to the include path:
 ```cmake
 set(RAFT_GIT_DIR ${CMAKE_CURRENT_BINARY_DIR}/raft CACHE STRING "Path to RAFT repo")
 ExternalProject_Add(raft
@@ -262,8 +260,12 @@ ExternalProject_Add(raft
   INSTALL_COMMAND   "")
 set(RAFT_INCLUDE_DIR ${RAFT_GIT_DIR}/raft/cpp/include CACHE STRING "RAFT include variable")
 ```
+### C++ header-only integration (with cmake)
 
-If RAFT has already been installed, such as by using the `build.sh` script, use `find_package(raft)` and the `raft::raft` target.
+
+When using cmake, you can install RAFT headers into your environment with `./build.sh libraft`. 
+
+If the RAFT headers have already been installed into your environment with cmake or through conda, such as by using the `build.sh` script, use `find_package(raft)` and the `raft::raft` target.
 
 ### Using C++ pre-compiled shared libraries
 
@@ -271,17 +273,19 @@ Use `find_package(raft COMPONENTS compiled distributed)` to enable the shared li
 
 The pre-compiled libraries contain template specializations for commonly used types, such as single- and double-precision floating-point. In order to use the symbols in the pre-compiled libraries, the compiler needs to be told not to instantiate templates that are already contained in the shared libraries. By convention, these header files are named `specializations.cuh` and located in the base directory for the packages that contain specializations.
 
-The following example tells the compiler to ignore the pre-compiled templates for the `raft::distance` API so any symbols already compiled into the `libraft` shared library will be used instead:
+The following example tells the compiler to ignore the pre-compiled templates for the `raft::distance` API so any symbols already compiled into the `libraft` shared library will be used instead. RAFT's cmake creates a variable `RAFT_COMPILED` which can be used to ignore the pre-compiled template specializations only when the shared library has been enabled through cmake (such as by specifying the `compiled` component in `find_package`):
 ```c++
+#ifdef RAFT_COMPILED
 #include <raft/distance/distance.cuh>
 #include <raft/distance/specializations.cuh>
+#endif
 ```
 
 ### Building RAFT C++ from source in cmake
 
 RAFT uses the [RAPIDS-CMake](https://github.com/rapidsai/rapids-cmake) library so it can be more easily included into downstream projects. RAPIDS cmake provides a convenience layer around the [CMake Package Manager (CPM)](https://github.com/cpm-cmake/CPM.cmake).
 
-The following example is similar to invoking `find_package(raft)` but uses `rapids_cpm_find`, which provides a richer and more flexible configuration landscape by using CPM to fetch any dependencies not already available to the build. The `raft::raft` link target will be made available and it's recommended that it be used as a `PRIVATE` link dependency in downstream projects. The `COMPILE_LIBRARIES` option enables the building the shared libraries.
+The following example is similar to invoking `find_package(raft)` but uses `rapids_cpm_find`, which provides a richer and more flexible configuration landscape by using CPM to fetch any dependencies not already available to the build. The `raft::raft` link target will be made available and it's recommended that it be used as a `PRIVATE` link dependency in downstream projects. The `COMPILE_LIBRARY` option enables the building the shared libraries.
 
 The following `cmake` snippet enables a flexible configuration of RAFT:
 
@@ -292,19 +296,10 @@ set(RAFT_FORK "rapidsai")
 set(RAFT_PINNED_TAG "branch-${RAFT_VERSION}")
 
 function(find_and_configure_raft)
-  set(oneValueArgs VERSION FORK PINNED_TAG COMPILE_LIBRARY CLONE_ON_PIN)
+  set(oneValueArgs VERSION FORK PINNED_TAG COMPILE_LIBRARY)
   cmake_parse_arguments(PKG "${options}" "${oneValueArgs}"
                             "${multiValueArgs}" ${ARGN} )
-
-  #-----------------------------------------------------
-  # Clone RAFT locally if PINNED_TAG has been changed
-  #-----------------------------------------------------
-  if(PKG_CLONE_ON_PIN AND NOT PKG_PINNED_TAG STREQUAL "branch-${RAFT_VERSION}")
-    message("Pinned tag found: ${PKG_PINNED_TAG}. Cloning raft locally.")
-    set(CPM_DOWNLOAD_raft ON)
-    set(CMAKE_IGNORE_PATH "${CMAKE_INSTALL_PREFIX}/include/raft;${CMAKE_IGNORE_PATH})
-  endif()
-
+  
   #-----------------------------------------------------
   # Invoke CPM find_package()
   #-----------------------------------------------------
@@ -332,15 +327,12 @@ endfunction()
 find_and_configure_raft(VERSION    ${RAFT_VERSION}.00
         FORK             ${RAFT_FORK}
         PINNED_TAG       ${RAFT_PINNED_TAG}
-
-        # When PINNED_TAG above doesn't match cuml,
-        # force local raft clone in build directory
-        # even if it's already installed.
-        CLONE_ON_PIN     ON
         COMPILE_LIBRARY          NO
 )
 ```
 
+You can find a fully-functioning [example template project](../../cpp/template/README.md) in the `cpp/template` directory, which provides everything you need to build a new application with RAFT or incorporate RAFT Into your existing libraries.
+
 ## Uninstall
 
 Once built and installed, RAFT can be safely uninstalled using `build.sh` by specifying any or all of the installed components. Please note that since `pylibraft` depends on `libraft`, uninstalling `pylibraft` will also uninstall `libraft`:
diff --git a/python/pylibraft/setup.cfg b/python/pylibraft/setup.cfg
new file mode 100644
index 0000000000..7d1a0c9065
--- /dev/null
+++ b/python/pylibraft/setup.cfg
@@ -0,0 +1,38 @@
+# Copyright (c) 2022-2023, NVIDIA CORPORATION.
+
+[isort]
+line_length=79
+multi_line_output=3
+include_trailing_comma=True
+force_grid_wrap=0
+combine_as_imports=True
+order_by_type=True
+known_dask=
+    dask
+    distributed
+    dask_cuda
+known_rapids=
+    nvtext
+    cudf
+    cuml
+    cugraph
+    dask_cudf
+    rmm
+known_first_party=
+    raft
+    pylibraft
+default_section=THIRDPARTY
+sections=FUTURE,STDLIB,THIRDPARTY,DASK,RAPIDS,FIRSTPARTY,LOCALFOLDER
+skip=
+    thirdparty
+    .eggs
+    .git
+    .hg
+    .mypy_cache
+    .tox
+    .venv
+    _build
+    buck-out
+    build
+    dist
+    __init__.py
diff --git a/setup.cfg b/setup.cfg
new file mode 100644
index 0000000000..e64641d05b
--- /dev/null
+++ b/setup.cfg
@@ -0,0 +1,55 @@
+# Copyright (c) 2022-2023, NVIDIA CORPORATION.
+
+[flake8]
+filename = *.py, *.pyx, *.pxd, *.pxi
+exclude = __init__.py, *.egg, build, docs, .git
+force-check = True
+ignore =
+    # line break before binary operator
+    W503,
+    # whitespace before :
+    E203
+per-file-ignores =
+    # Rules ignored only in Cython:
+    # E211: whitespace before '(' (used in multi-line imports)
+    # E225: Missing whitespace around operators (breaks cython casting syntax like <int>)
+    # E226: Missing whitespace around arithmetic operators (breaks cython pointer syntax like int*)
+    # E227: Missing whitespace around bitwise or shift operator (Can also break casting syntax)
+    # E275: Missing whitespace after keyword (Doesn't work with Cython except?)
+    # E402: invalid syntax (works for Python, not Cython)
+    # E999: invalid syntax (works for Python, not Cython)
+    # W504: line break after binary operator (breaks lines that end with a pointer)
+    *.pyx: E211, E225, E226, E227, E275, E402, E999, W504
+    *.pxd: E211, E225, E226, E227, E275, E402, E999, W504
+    *.pxi: E211, E225, E226, E227, E275, E402, E999, W504
+
+[pydocstyle]
+# Due to https://github.com/PyCQA/pydocstyle/issues/363, we must exclude rather
+# than include using match-dir. Note that as discussed in
+# https://stackoverflow.com/questions/65478393/how-to-filter-directories-using-the-match-dir-flag-for-pydocstyle,
+# unlike the match option above this match-dir will have no effect when
+# pydocstyle is invoked from pre-commit. Therefore this exclusion list must
+# also be maintained in the pre-commit config file.
+match-dir = ^(?!(ci|cpp|conda|docs|java|notebooks)).*$
+# Allow missing docstrings for docutils
+ignore-decorators = .*(docutils|doc_apply|copy_docstring).*
+select =
+    D201, D204, D206, D207, D208, D209, D210, D211, D214, D215, D300, D301, D302, D403, D405, D406, D407, D408, D409, D410, D411, D412, D414, D418
+    # Would like to enable the following rules in the future:
+    # D200, D202, D205, D400
+
+[mypy]
+ignore_missing_imports = True
+# If we don't specify this, then mypy will check excluded files if
+# they are imported by a checked file.
+follow_imports = skip
+
+[codespell]
+# note: pre-commit passes explicit lists of files here, which this skip file list doesn't override -
+# this is only to allow you to run codespell interactively
+skip = ./.git,./.github,./cpp/build,.*egg-info.*,./.mypy_cache,.*_skbuild
+# ignore short words, and typename parameters like OffsetT
+ignore-regex = \b(.{1,4}|[A-Z]\w*T)\b
+ignore-words-list = inout,unparseable,numer
+builtin = clear
+quiet-level = 3

From f4c7f1f94e135c511de67459ffac3d9d6e9f9794 Mon Sep 17 00:00:00 2001
From: "Corey J. Nolet" <cjnolet@gmail.com>
Date: Fri, 24 Mar 2023 17:40:46 -0400
Subject: [PATCH 16/25] Adding some functions back in that seem to be a
 copy/paste error (#1373)

Authors:
  - Corey J. Nolet (https://github.com/cjnolet)

Approvers:
  - Ben Frederickson (https://github.com/benfred)

URL: https://github.com/rapidsai/raft/pull/1373
---
 cpp/include/raft/util/cuda_dev_essentials.cuh | 26 +++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/cpp/include/raft/util/cuda_dev_essentials.cuh b/cpp/include/raft/util/cuda_dev_essentials.cuh
index 5080dc33ee..bb9ebbba59 100644
--- a/cpp/include/raft/util/cuda_dev_essentials.cuh
+++ b/cpp/include/raft/util/cuda_dev_essentials.cuh
@@ -88,4 +88,30 @@ DI int laneId()
   return id;
 }
 
+/** Device function to apply the input lambda across threads in the grid */
+template <int ItemsPerThread, typename L>
+DI void forEach(int num, L lambda)
+{
+  int idx              = (blockDim.x * blockIdx.x) + threadIdx.x;
+  const int numThreads = blockDim.x * gridDim.x;
+#pragma unroll
+  for (int itr = 0; itr < ItemsPerThread; ++itr, idx += numThreads) {
+    if (idx < num) lambda(idx, itr);
+  }
+}
+
+/**
+ * @brief Swap two values
+ * @tparam T the datatype of the values
+ * @param a first input
+ * @param b second input
+ */
+template <typename T>
+HDI void swapVals(T& a, T& b)
+{
+  T tmp = a;
+  a     = b;
+  b     = tmp;
+}
+
 }  // namespace raft

From 76c828dd4da4dc922626ba2a440a46dea6ab03b9 Mon Sep 17 00:00:00 2001
From: Allard Hendriksen <ahendriksen@nvidia.com>
Date: Sat, 25 Mar 2023 20:09:35 +0100
Subject: [PATCH 17/25] Add extern template for ivfflat_interleaved_scan
 (#1360)

This should cut compilation time for refine_d_int64_t_float.cu.o et al from ~900 seconds to 29 seconds.

The refine specialization contain >100 instances of the ivfflat_interleaved_scan kernel, even though these should be seperately compiled by the ivfflat_search specializations.

The call to ivf_flat_interleaved_scan is [here](https://github.com/rapidsai/raft/blob/56ac43ad93a319a61073dce1b3b937f6f13ade63/cpp/include/raft/neighbors/detail/refine.cuh#L121).

Depends on (so please merge after) PR #1307.

Authors:
  - Allard Hendriksen (https://github.com/ahendriksen)
  - Corey J. Nolet (https://github.com/cjnolet)

Approvers:
  - Corey J. Nolet (https://github.com/cjnolet)

URL: https://github.com/rapidsai/raft/pull/1360
---
 .../raft/neighbors/detail/ivf_flat_search.cuh |  8 ++++
 cpp/include/raft/neighbors/detail/refine.cuh  |  8 ++++
 .../neighbors/specializations/ivf_flat.cuh    | 25 ++++++++++++-
 .../ivfflat_search_float_int64_t.cu           | 37 ++++++++++++++++---
 .../ivfflat_search_int8_t_int64_t.cu          | 28 +++++++++++---
 .../ivfflat_search_uint8_t_int64_t.cu         | 28 +++++++++++---
 6 files changed, 115 insertions(+), 19 deletions(-)

diff --git a/cpp/include/raft/neighbors/detail/ivf_flat_search.cuh b/cpp/include/raft/neighbors/detail/ivf_flat_search.cuh
index f657070df4..e6533eaf51 100644
--- a/cpp/include/raft/neighbors/detail/ivf_flat_search.cuh
+++ b/cpp/include/raft/neighbors/detail/ivf_flat_search.cuh
@@ -1065,6 +1065,14 @@ void ivfflat_interleaved_scan(const index<T, IdxT>& index,
                               uint32_t& grid_dim_x,
                               rmm::cuda_stream_view stream)
 {
+  // greppable-id-specializations-ivf-flat-search: The ivfflat_interleaved_scan
+  // function is used in both raft::neighbors::ivf_flat::search and
+  // raft::neighbors::detail::refine_device. To prevent a duplicate
+  // instantiation of this function (which defines ~270 kernels) in the refine
+  // specializations, an extern template definition is provided. Please check
+  // related function calls after editing this function definition. Search for
+  // `greppable-id-specializations-ivf-flat-search` to find them.
+
   const int capacity = bound_by_power_of_two(k);
   select_interleaved_scan_kernel<T, AccT, IdxT>::run(capacity,
                                                      index.veclen(),
diff --git a/cpp/include/raft/neighbors/detail/refine.cuh b/cpp/include/raft/neighbors/detail/refine.cuh
index f244d5875c..aedfc42698 100644
--- a/cpp/include/raft/neighbors/detail/refine.cuh
+++ b/cpp/include/raft/neighbors/detail/refine.cuh
@@ -117,6 +117,14 @@ void refine_device(raft::device_resources const& handle,
                                                            n_queries,
                                                            n_candidates);
 
+  // greppable-id-specializations-ivf-flat-search: The ivfflat_interleaved_scan
+  // function is used in both raft::neighbors::ivf_flat::search and
+  // raft::neighbors::detail::refine_device. To prevent a duplicate
+  // instantiation of this function (which defines ~270 kernels) in the refine
+  // specializations, an extern template definition is provided. Please check
+  // and adjust the extern template definition and the instantiation when the
+  // below function call is edited. Search for
+  // `greppable-id-specializations-ivf-flat-search` to find them.
   uint32_t grid_dim_x = 1;
   raft::neighbors::ivf_flat::detail::ivfflat_interleaved_scan<
     data_t,
diff --git a/cpp/include/raft/neighbors/specializations/ivf_flat.cuh b/cpp/include/raft/neighbors/specializations/ivf_flat.cuh
index 013c7359e5..161f3462c9 100644
--- a/cpp/include/raft/neighbors/specializations/ivf_flat.cuh
+++ b/cpp/include/raft/neighbors/specializations/ivf_flat.cuh
@@ -20,6 +20,13 @@
 
 namespace raft::neighbors::ivf_flat {
 
+// greppable-id-specializations-ivf-flat-search: The ivfflat_interleaved_scan
+// function is used in both raft::neighbors::ivf_flat::search and
+// raft::neighbors::detail::refine_device. To prevent a duplicate instantiation
+// of this function (which defines ~270 kernels) in the refine specializations,
+// an extern template definition is provided here. Please check related function
+// calls after editing template definition below. Search for
+// `greppable-id-specializations-ivf-flat-search` to find them.
 #define RAFT_INST(T, IdxT)                                                               \
   extern template auto build(raft::device_resources const& handle,                       \
                              const index_params& params,                                 \
@@ -44,7 +51,23 @@ namespace raft::neighbors::ivf_flat {
                               const raft::neighbors::ivf_flat::index<T, IdxT>&,          \
                               raft::device_matrix_view<const T, IdxT, row_major>,        \
                               raft::device_matrix_view<IdxT, IdxT, row_major>,           \
-                              raft::device_matrix_view<float, IdxT, row_major>);
+                              raft::device_matrix_view<float, IdxT, row_major>);         \
+                                                                                         \
+  extern template void raft::neighbors::ivf_flat::detail::ivfflat_interleaved_scan<      \
+    T,                                                                                   \
+    typename raft::spatial::knn::detail::utils::config<T>::value_t,                      \
+    IdxT>(const index<T, IdxT>& index,                                                   \
+          const T* queries,                                                              \
+          const uint32_t* coarse_query_results,                                          \
+          const uint32_t n_queries,                                                      \
+          const raft::distance::DistanceType metric,                                     \
+          const uint32_t n_probes,                                                       \
+          const uint32_t k,                                                              \
+          const bool select_min,                                                         \
+          IdxT* neighbors,                                                               \
+          float* distances,                                                              \
+          uint32_t& grid_dim_x,                                                          \
+          rmm::cuda_stream_view stream);
 
 RAFT_INST(float, int64_t);
 RAFT_INST(int8_t, int64_t);
diff --git a/cpp/src/neighbors/specializations/ivfflat_search_float_int64_t.cu b/cpp/src/neighbors/specializations/ivfflat_search_float_int64_t.cu
index 6de65546c8..dce7083139 100644
--- a/cpp/src/neighbors/specializations/ivfflat_search_float_int64_t.cu
+++ b/cpp/src/neighbors/specializations/ivfflat_search_float_int64_t.cu
@@ -18,12 +18,37 @@
 
 namespace raft::neighbors::ivf_flat {
 
-#define RAFT_MAKE_INSTANCE(T, IdxT)                                        \
-  template void search(raft::device_resources const&,                      \
-                       raft::neighbors::ivf_flat::search_params const&,    \
-                       const raft::neighbors::ivf_flat::index<T, IdxT>&,   \
-                       raft::device_matrix_view<const T, IdxT, row_major>, \
-                       raft::device_matrix_view<IdxT, IdxT, row_major>,    \
+// greppable-id-specializations-ivf-flat-search: The ivfflat_interleaved_scan
+// function is used in both raft::neighbors::ivf_flat::search and
+// raft::neighbors::detail::refine_device. To prevent a duplicate instantiation
+// of this function (which defines ~270 kernels) in the refine specializations,
+// an extern template definition is provided. To make sure
+// ivfflat_interleaved_scan is actually compiled here, we explicitly instantiate
+// it below. Please check related function calls after editing template
+// definition below. Search for `greppable-id-specializations-ivf-flat-search`
+// to find them.
+#define RAFT_MAKE_INSTANCE(T, IdxT)                                          \
+  template void raft::neighbors::ivf_flat::detail::ivfflat_interleaved_scan< \
+    T,                                                                       \
+    typename raft::spatial::knn::detail::utils::config<T>::value_t,          \
+    IdxT>(const index<T, IdxT>& index,                                       \
+          const T* queries,                                                  \
+          const uint32_t* coarse_query_results,                              \
+          const uint32_t n_queries,                                          \
+          const raft::distance::DistanceType metric,                         \
+          const uint32_t n_probes,                                           \
+          const uint32_t k,                                                  \
+          const bool select_min,                                             \
+          IdxT* neighbors,                                                   \
+          float* distances,                                                  \
+          uint32_t& grid_dim_x,                                              \
+          rmm::cuda_stream_view stream);                                     \
+                                                                             \
+  template void search(raft::device_resources const&,                        \
+                       raft::neighbors::ivf_flat::search_params const&,      \
+                       const raft::neighbors::ivf_flat::index<T, IdxT>&,     \
+                       raft::device_matrix_view<const T, IdxT, row_major>,   \
+                       raft::device_matrix_view<IdxT, IdxT, row_major>,      \
                        raft::device_matrix_view<float, IdxT, row_major>);
 
 RAFT_MAKE_INSTANCE(float, int64_t);
diff --git a/cpp/src/neighbors/specializations/ivfflat_search_int8_t_int64_t.cu b/cpp/src/neighbors/specializations/ivfflat_search_int8_t_int64_t.cu
index 8eda240ccd..b03d878bae 100644
--- a/cpp/src/neighbors/specializations/ivfflat_search_int8_t_int64_t.cu
+++ b/cpp/src/neighbors/specializations/ivfflat_search_int8_t_int64_t.cu
@@ -18,12 +18,28 @@
 
 namespace raft::neighbors::ivf_flat {
 
-#define RAFT_MAKE_INSTANCE(T, IdxT)                                        \
-  template void search(raft::device_resources const&,                      \
-                       raft::neighbors::ivf_flat::search_params const&,    \
-                       const raft::neighbors::ivf_flat::index<T, IdxT>&,   \
-                       raft::device_matrix_view<const T, IdxT, row_major>, \
-                       raft::device_matrix_view<IdxT, IdxT, row_major>,    \
+#define RAFT_MAKE_INSTANCE(T, IdxT)                                          \
+  template void raft::neighbors::ivf_flat::detail::ivfflat_interleaved_scan< \
+    T,                                                                       \
+    typename raft::spatial::knn::detail::utils::config<T>::value_t,          \
+    IdxT>(const index<T, IdxT>& index,                                       \
+          const T* queries,                                                  \
+          const uint32_t* coarse_query_results,                              \
+          const uint32_t n_queries,                                          \
+          const raft::distance::DistanceType metric,                         \
+          const uint32_t n_probes,                                           \
+          const uint32_t k,                                                  \
+          const bool select_min,                                             \
+          IdxT* neighbors,                                                   \
+          float* distances,                                                  \
+          uint32_t& grid_dim_x,                                              \
+          rmm::cuda_stream_view stream);                                     \
+                                                                             \
+  template void search(raft::device_resources const&,                        \
+                       raft::neighbors::ivf_flat::search_params const&,      \
+                       const raft::neighbors::ivf_flat::index<T, IdxT>&,     \
+                       raft::device_matrix_view<const T, IdxT, row_major>,   \
+                       raft::device_matrix_view<IdxT, IdxT, row_major>,      \
                        raft::device_matrix_view<float, IdxT, row_major>);
 
 RAFT_MAKE_INSTANCE(int8_t, int64_t);
diff --git a/cpp/src/neighbors/specializations/ivfflat_search_uint8_t_int64_t.cu b/cpp/src/neighbors/specializations/ivfflat_search_uint8_t_int64_t.cu
index 8ff6533628..2d42bae0d1 100644
--- a/cpp/src/neighbors/specializations/ivfflat_search_uint8_t_int64_t.cu
+++ b/cpp/src/neighbors/specializations/ivfflat_search_uint8_t_int64_t.cu
@@ -18,12 +18,28 @@
 
 namespace raft::neighbors::ivf_flat {
 
-#define RAFT_MAKE_INSTANCE(T, IdxT)                                        \
-  template void search(raft::device_resources const&,                      \
-                       raft::neighbors::ivf_flat::search_params const&,    \
-                       const raft::neighbors::ivf_flat::index<T, IdxT>&,   \
-                       raft::device_matrix_view<const T, IdxT, row_major>, \
-                       raft::device_matrix_view<IdxT, IdxT, row_major>,    \
+#define RAFT_MAKE_INSTANCE(T, IdxT)                                          \
+  template void raft::neighbors::ivf_flat::detail::ivfflat_interleaved_scan< \
+    T,                                                                       \
+    typename raft::spatial::knn::detail::utils::config<T>::value_t,          \
+    IdxT>(const index<T, IdxT>& index,                                       \
+          const T* queries,                                                  \
+          const uint32_t* coarse_query_results,                              \
+          const uint32_t n_queries,                                          \
+          const raft::distance::DistanceType metric,                         \
+          const uint32_t n_probes,                                           \
+          const uint32_t k,                                                  \
+          const bool select_min,                                             \
+          IdxT* neighbors,                                                   \
+          float* distances,                                                  \
+          uint32_t& grid_dim_x,                                              \
+          rmm::cuda_stream_view stream);                                     \
+                                                                             \
+  template void search(raft::device_resources const&,                        \
+                       raft::neighbors::ivf_flat::search_params const&,      \
+                       const raft::neighbors::ivf_flat::index<T, IdxT>&,     \
+                       raft::device_matrix_view<const T, IdxT, row_major>,   \
+                       raft::device_matrix_view<IdxT, IdxT, row_major>,      \
                        raft::device_matrix_view<float, IdxT, row_major>);
 
 RAFT_MAKE_INSTANCE(uint8_t, int64_t);

From 0d3bd3da5a2eb77a5ca2f7f9b9ed367030811c06 Mon Sep 17 00:00:00 2001
From: Ben Frederickson <ben@benfrederickson.com>
Date: Tue, 28 Mar 2023 01:00:57 -0700
Subject: [PATCH 18/25] add a distance epilogue function to the bfknn call
 (#1371)

Add the ability for a user to specify an epilogue function to run after the distance in the brute_force::knn call.

This lets us remove faiss from cuml, by updating the hdbscan reachability code (https://github.com/rapidsai/cuml/pull/5293)

Authors:
  - Ben Frederickson (https://github.com/benfred)
  - Corey J. Nolet (https://github.com/cjnolet)

Approvers:
  - Corey J. Nolet (https://github.com/cjnolet)

URL: https://github.com/rapidsai/raft/pull/1371
---
 cpp/include/raft/neighbors/brute_force.cuh    | 32 ++++++------
 .../raft/neighbors/detail/knn_brute_force.cuh | 51 ++++++++++++++-----
 .../neighbors/specializations/brute_force.cuh |  3 +-
 .../raft/spatial/knn/detail/ball_cover.cuh    |  1 -
 .../brute_force_knn_int64_t_float.cu          | 11 +---
 .../brute_force_knn_impl_long_float_int.cu    |  3 +-
 .../brute_force_knn_impl_long_float_uint.cu   |  3 +-
 .../brute_force_knn_impl_uint_float_int.cu    |  3 +-
 .../brute_force_knn_impl_uint_float_uint.cu   |  3 +-
 cpp/test/neighbors/ball_cover.cu              |  1 -
 cpp/test/neighbors/knn.cu                     |  2 +-
 11 files changed, 69 insertions(+), 44 deletions(-)

diff --git a/cpp/include/raft/neighbors/brute_force.cuh b/cpp/include/raft/neighbors/brute_force.cuh
index 4891cc5f8d..dac1a29c7f 100644
--- a/cpp/include/raft/neighbors/brute_force.cuh
+++ b/cpp/include/raft/neighbors/brute_force.cuh
@@ -122,9 +122,8 @@ inline void knn_merge_parts(
  *
  *  raft::raft::device_resources handle;
  *  ...
- *  int k = 10;
  *  auto metric = raft::distance::DistanceType::L2SqrtExpanded;
- *  brute_force::knn(handle, index, search, indices, distances, k, metric);
+ *  brute_force::knn(handle, index, search, indices, distances, metric);
  * @endcode
  *
  * @param[in] handle: the cuml handle to use
@@ -132,28 +131,31 @@ inline void knn_merge_parts(
  * @param[in] search: matrix (size n*d) to be used for searching the index
  * @param[out] indices: matrix (size n*k) to store output knn indices
  * @param[out] distances: matrix (size n*k) to store the output knn distance
- * @param[in] k: the number of nearest neighbors to return
  * @param[in] metric: distance metric to use. Euclidean (L2) is used by default
  * @param[in] metric_arg: the value of `p` for Minkowski (l-p) distances. This
  * 					 is ignored if the metric_type is not Minkowski.
  * @param[in] global_id_offset: optional starting global id mapping for the local partition
  *                              (assumes the index contains contiguous ids in the global id space)
+ * @param[in] distance_epilogue: optional epilogue function to run after computing distances. This
+                                 function takes a triple of the (value, rowid, colid) for each
+                                 element in the pairwise distances and returns a transformed value
+                                 back.
  */
 template <typename idx_t,
           typename value_t,
-          typename value_int,
           typename matrix_idx,
           typename index_layout,
-          typename search_layout>
+          typename search_layout,
+          typename epilogue_op = raft::identity_op>
 void knn(raft::device_resources const& handle,
          std::vector<raft::device_matrix_view<const value_t, matrix_idx, index_layout>> index,
          raft::device_matrix_view<const value_t, matrix_idx, search_layout> search,
          raft::device_matrix_view<idx_t, matrix_idx, row_major> indices,
          raft::device_matrix_view<value_t, matrix_idx, row_major> distances,
-         value_int k,
          distance::DistanceType metric         = distance::DistanceType::L2Unexpanded,
          std::optional<float> metric_arg       = std::make_optional<float>(2.0f),
-         std::optional<idx_t> global_id_offset = std::nullopt)
+         std::optional<idx_t> global_id_offset = std::nullopt,
+         epilogue_op distance_epilogue         = raft::identity_op())
 {
   RAFT_EXPECTS(index[0].extent(1) == search.extent(1),
                "Number of dimensions for both index and search matrices must be equal");
@@ -161,15 +163,14 @@ void knn(raft::device_resources const& handle,
   RAFT_EXPECTS(indices.extent(0) == distances.extent(0) && distances.extent(0) == search.extent(0),
                "Number of rows in output indices and distances matrices must equal number of rows "
                "in search matrix.");
-  RAFT_EXPECTS(
-    indices.extent(1) == distances.extent(1) && distances.extent(1) == static_cast<matrix_idx>(k),
-    "Number of columns in output indices and distances matrices must be equal to k");
+  RAFT_EXPECTS(indices.extent(1) == distances.extent(1) && distances.extent(1),
+               "Number of columns in output indices and distances matrices must the same");
 
   bool rowMajorIndex = std::is_same_v<index_layout, layout_c_contiguous>;
   bool rowMajorQuery = std::is_same_v<search_layout, layout_c_contiguous>;
 
   std::vector<value_t*> inputs;
-  std::vector<value_int> sizes;
+  std::vector<matrix_idx> sizes;
   for (std::size_t i = 0; i < index.size(); ++i) {
     inputs.push_back(const_cast<value_t*>(index[i].data_handle()));
     sizes.push_back(index[i].extent(0));
@@ -183,18 +184,19 @@ void knn(raft::device_resources const& handle,
   raft::neighbors::detail::brute_force_knn_impl(handle,
                                                 inputs,
                                                 sizes,
-                                                static_cast<value_int>(index[0].extent(1)),
+                                                index[0].extent(1),
                                                 // TODO: This is unfortunate. Need to fix.
                                                 const_cast<value_t*>(search.data_handle()),
-                                                static_cast<value_int>(search.extent(0)),
+                                                search.extent(0),
                                                 indices.data_handle(),
                                                 distances.data_handle(),
-                                                k,
+                                                indices.extent(1),
                                                 rowMajorIndex,
                                                 rowMajorQuery,
                                                 trans_arg,
                                                 metric,
-                                                metric_arg.value_or(2.0f));
+                                                metric_arg.value_or(2.0f),
+                                                distance_epilogue);
 }
 
 /**
diff --git a/cpp/include/raft/neighbors/detail/knn_brute_force.cuh b/cpp/include/raft/neighbors/detail/knn_brute_force.cuh
index 875fc3b37c..a776ce2586 100644
--- a/cpp/include/raft/neighbors/detail/knn_brute_force.cuh
+++ b/cpp/include/raft/neighbors/detail/knn_brute_force.cuh
@@ -47,7 +47,9 @@ using namespace raft::spatial::knn;
  * Calculates brute force knn, using a fixed memory budget
  * by tiling over both the rows and columns of pairwise_distances
  */
-template <typename ElementType = float, typename IndexType = int64_t>
+template <typename ElementType      = float,
+          typename IndexType        = int64_t,
+          typename DistanceEpilogue = raft::identity_op>
 void tiled_brute_force_knn(const raft::device_resources& handle,
                            const ElementType* search,  // size (m ,d)
                            const ElementType* index,   // size (n ,d)
@@ -58,9 +60,10 @@ void tiled_brute_force_knn(const raft::device_resources& handle,
                            ElementType* distances,  // size (m, k)
                            IndexType* indices,      // size (m, k)
                            raft::distance::DistanceType metric,
-                           float metric_arg         = 0.0,
-                           size_t max_row_tile_size = 0,
-                           size_t max_col_tile_size = 0)
+                           float metric_arg                   = 2.0,
+                           size_t max_row_tile_size           = 0,
+                           size_t max_col_tile_size           = 0,
+                           DistanceEpilogue distance_epilogue = raft::identity_op())
 {
   // Figure out the number of rows/cols to tile for
   size_t tile_rows   = 0;
@@ -152,25 +155,41 @@ void tiled_brute_force_knn(const raft::device_resources& handle,
                                                     metric_arg);
       if (metric == raft::distance::DistanceType::L2Expanded ||
           metric == raft::distance::DistanceType::L2SqrtExpanded) {
-        auto row_norms = search_norms.data() + i;
-        auto col_norms = index_norms.data() + j;
+        auto row_norms = search_norms.data();
+        auto col_norms = index_norms.data();
         auto dist      = temp_distances.data();
 
         raft::linalg::map_offset(
           handle,
           raft::make_device_vector_view(dist, current_query_size * current_centroid_size),
-          [=] __device__(IndexType i) {
-            IndexType row = i / current_centroid_size, col = i % current_centroid_size;
+          [=] __device__(IndexType idx) {
+            IndexType row = i + (idx / current_centroid_size);
+            IndexType col = j + (idx % current_centroid_size);
 
-            auto val = row_norms[row] + col_norms[col] - 2.0 * dist[i];
+            auto val = row_norms[row] + col_norms[col] - 2.0 * dist[idx];
 
             // due to numerical instability (especially around self-distance)
             // the distances here could be slightly negative, which will
             // cause NaN values in the subsequent sqrt. Clamp to 0
             val = val * (val >= 0.0001);
             if (metric == raft::distance::DistanceType::L2SqrtExpanded) { val = sqrt(val); }
+            val = distance_epilogue(val, row, col);
             return val;
           });
+      } else {
+        // if we're not l2 distance, and we have a distance epilogue - run it now
+        if constexpr (!std::is_same_v<DistanceEpilogue, raft::identity_op>) {
+          auto distances_ptr = temp_distances.data();
+          raft::linalg::map_offset(
+            handle,
+            raft::make_device_vector_view(temp_distances.data(),
+                                          current_query_size * current_centroid_size),
+            [=] __device__(size_t idx) {
+              IndexType row = i + (idx / current_centroid_size);
+              IndexType col = j + (idx % current_centroid_size);
+              return distance_epilogue(distances_ptr[idx], row, col);
+            });
+        }
       }
 
       select_k<IndexType, ElementType>(temp_distances.data(),
@@ -250,7 +269,10 @@ void tiled_brute_force_knn(const raft::device_resources& handle,
  * @param[in] metric corresponds to the raft::distance::DistanceType enum (default is L2Expanded)
  * @param[in] metricArg metric argument to use. Corresponds to the p arg for lp norm
  */
-template <typename IntType = int, typename IdxType = std::int64_t, typename value_t = float>
+template <typename IntType          = int,
+          typename IdxType          = std::int64_t,
+          typename value_t          = float,
+          typename DistanceEpilogue = raft::identity_op>
 void brute_force_knn_impl(
   raft::device_resources const& handle,
   std::vector<value_t*>& input,
@@ -265,7 +287,8 @@ void brute_force_knn_impl(
   bool rowMajorQuery                  = true,
   std::vector<IdxType>* translations  = nullptr,
   raft::distance::DistanceType metric = raft::distance::DistanceType::L2Expanded,
-  float metricArg                     = 0)
+  float metricArg                     = 0,
+  DistanceEpilogue distance_epilogue  = raft::identity_op())
 {
   auto userStream = handle.get_stream();
 
@@ -355,6 +378,7 @@ void brute_force_knn_impl(
     auto stream = handle.get_next_usable_stream(i);
 
     if (k <= 64 && rowMajorQuery == rowMajorIndex && rowMajorQuery == true &&
+        std::is_same_v<DistanceEpilogue, raft::identity_op> &&
         (metric == raft::distance::DistanceType::L2Unexpanded ||
          metric == raft::distance::DistanceType::L2SqrtUnexpanded ||
          metric == raft::distance::DistanceType::L2Expanded ||
@@ -424,7 +448,10 @@ void brute_force_knn_impl(
                                                   out_d_ptr,
                                                   out_i_ptr,
                                                   tiled_metric,
-                                                  metricArg);
+                                                  metricArg,
+                                                  0,
+                                                  0,
+                                                  distance_epilogue);
           break;
       }
     }
diff --git a/cpp/include/raft/neighbors/specializations/brute_force.cuh b/cpp/include/raft/neighbors/specializations/brute_force.cuh
index d418d40185..1337beb68a 100644
--- a/cpp/include/raft/neighbors/specializations/brute_force.cuh
+++ b/cpp/include/raft/neighbors/specializations/brute_force.cuh
@@ -36,7 +36,8 @@ namespace raft::neighbors::detail {
                                                            bool rowMajorQuery,                   \
                                                            std::vector<IdxT>* translations,      \
                                                            raft::distance::DistanceType metric,  \
-                                                           float metricArg);
+                                                           float metricArg,                      \
+                                                           raft::identity_op);
 RAFT_INST(long, float, int);
 RAFT_INST(long, float, unsigned int);
 RAFT_INST(uint32_t, float, int);
diff --git a/cpp/include/raft/spatial/knn/detail/ball_cover.cuh b/cpp/include/raft/spatial/knn/detail/ball_cover.cuh
index 99d688e232..c8fc6eefda 100644
--- a/cpp/include/raft/spatial/knn/detail/ball_cover.cuh
+++ b/cpp/include/raft/spatial/knn/detail/ball_cover.cuh
@@ -185,7 +185,6 @@ void k_closest_landmarks(raft::device_resources const& handle,
     make_device_matrix_view(query_pts, n_query_pts, inputs[0].extent(1)),
     make_device_matrix_view(R_knn_inds, n_query_pts, k),
     make_device_matrix_view(R_knn_dists, n_query_pts, k),
-    k,
     index.get_metric());
 }
 
diff --git a/cpp/src/neighbors/brute_force_knn_int64_t_float.cu b/cpp/src/neighbors/brute_force_knn_int64_t_float.cu
index 585084fc97..88545b3607 100644
--- a/cpp/src/neighbors/brute_force_knn_int64_t_float.cu
+++ b/cpp/src/neighbors/brute_force_knn_int64_t_float.cu
@@ -38,15 +38,8 @@ namespace raft::runtime::neighbors::brute_force {
   {                                                                                      \
     std::vector<raft::device_matrix_view<const DATA_T, MATRIX_IDX_T, INDEX_LAYOUT>> vec; \
     vec.push_back(index);                                                                \
-    raft::neighbors::brute_force::knn(handle,                                            \
-                                      vec,                                               \
-                                      search,                                            \
-                                      indices,                                           \
-                                      distances,                                         \
-                                      static_cast<int>(distances.extent(1)),             \
-                                      metric,                                            \
-                                      metric_arg,                                        \
-                                      global_id_offset);                                 \
+    raft::neighbors::brute_force::knn(                                                   \
+      handle, vec, search, indices, distances, metric, metric_arg, global_id_offset);    \
   }
 
 RAFT_INST_BFKNN(int64_t, float, int64_t, raft::row_major, raft::row_major);
diff --git a/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_long_float_int.cu b/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_long_float_int.cu
index 07810aa576..04aa42c9f1 100644
--- a/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_long_float_int.cu
+++ b/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_long_float_int.cu
@@ -32,7 +32,8 @@ namespace raft::neighbors::detail {
                                                     bool rowMajorQuery,                   \
                                                     std::vector<IdxT>* translations,      \
                                                     raft::distance::DistanceType metric,  \
-                                                    float metricArg);
+                                                    float metricArg,                      \
+                                                    raft::identity_op);
 RAFT_INST(long, float, int);
 #undef RAFT_INST
 }  // namespace raft::neighbors::detail
diff --git a/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_long_float_uint.cu b/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_long_float_uint.cu
index 0cb873b40a..a8b9d4299a 100644
--- a/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_long_float_uint.cu
+++ b/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_long_float_uint.cu
@@ -32,7 +32,8 @@ namespace raft::neighbors::detail {
                                                     bool rowMajorQuery,                   \
                                                     std::vector<IdxT>* translations,      \
                                                     raft::distance::DistanceType metric,  \
-                                                    float metricArg);
+                                                    float metricArg,                      \
+                                                    raft::identity_op);
 RAFT_INST(long, float, unsigned int);
 #undef RAFT_INST
 }  // namespace raft::neighbors::detail
diff --git a/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_uint_float_int.cu b/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_uint_float_int.cu
index f8a69b896f..c97e6e936a 100644
--- a/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_uint_float_int.cu
+++ b/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_uint_float_int.cu
@@ -32,7 +32,8 @@ namespace raft::neighbors::detail {
                                                     bool rowMajorQuery,                   \
                                                     std::vector<IdxT>* translations,      \
                                                     raft::distance::DistanceType metric,  \
-                                                    float metricArg);
+                                                    float metricArg,                      \
+                                                    raft::identity_op);
 RAFT_INST(uint32_t, float, int);
 #undef RAFT_INST
 }  // namespace raft::neighbors::detail
diff --git a/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_uint_float_uint.cu b/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_uint_float_uint.cu
index 3c23d1f3e0..87451c385a 100644
--- a/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_uint_float_uint.cu
+++ b/cpp/src/neighbors/specializations/detail/brute_force_knn_impl_uint_float_uint.cu
@@ -32,7 +32,8 @@ namespace raft::neighbors::detail {
                                                     bool rowMajorQuery,                   \
                                                     std::vector<IdxT>* translations,      \
                                                     raft::distance::DistanceType metric,  \
-                                                    float metricArg);
+                                                    float metricArg,                      \
+                                                    raft::identity_op);
 RAFT_INST(uint32_t, float, unsigned int);
 #undef RAFT_INST
 }  // namespace raft::neighbors::detail
diff --git a/cpp/test/neighbors/ball_cover.cu b/cpp/test/neighbors/ball_cover.cu
index 9b51d585de..46ef3a9150 100644
--- a/cpp/test/neighbors/ball_cover.cu
+++ b/cpp/test/neighbors/ball_cover.cu
@@ -121,7 +121,6 @@ void compute_bfknn(const raft::device_resources& handle,
                                     make_device_matrix_view(X2, n_query_rows, d),
                                     make_device_matrix_view(inds, n_query_rows, k),
                                     make_device_matrix_view(dists, n_query_rows, k),
-                                    k,
                                     metric);
 }
 
diff --git a/cpp/test/neighbors/knn.cu b/cpp/test/neighbors/knn.cu
index 4bb977432c..bcd4b9cb0b 100644
--- a/cpp/test/neighbors/knn.cu
+++ b/cpp/test/neighbors/knn.cu
@@ -96,7 +96,7 @@ class KNNTest : public ::testing::TestWithParam<KNNInputs> {
       raft::make_device_matrix_view<T, IdxT, row_major>(distances_.data(), rows_, k_);
 
     auto metric = raft::distance::DistanceType::L2Unexpanded;
-    knn(handle, index, search, indices, distances, k_, metric, std::make_optional<IdxT>(0));
+    knn(handle, index, search, indices, distances, metric, std::make_optional<IdxT>(0));
 
     build_actual_output<<<raft::ceildiv(rows_ * k_, 32), 32, 0, stream>>>(
       actual_labels_.data(), rows_, k_, search_labels_.data(), indices_.data());

From 22ebc72e8c0c2738a30a0bbf9b0efc52736eddd6 Mon Sep 17 00:00:00 2001
From: "Corey J. Nolet" <cjnolet@gmail.com>
Date: Tue, 28 Mar 2023 15:54:57 -0400
Subject: [PATCH 19/25] Add end-to-end CUDA ann-benchmarks to raft (#1304)

New `bench/ann` artifact for comparing (C++ APIs for) GPU-acclerated algorithms end-to-end. Working on this w/ @tfeher but had to squash the original commits into a single commit.

Things left to do:
- [x] Separate `benchmarks` executables for each different algorithm
- [x] Separate build targets for `ggnn` and `hnswlib`
- [x] Revise `bench/ann` docs
- [x] Break `factory.cuh` abd `benchmark.cu` / `benchmark.cpp` into individual files for each different algorithm to make it easier to plug in new algorithms.
- [x] Separate into its own conda package

closes #1211

Authors:
  - Corey J. Nolet (https://github.com/cjnolet)

Approvers:
  - Ray Douglass (https://github.com/raydouglass)
  - Ben Frederickson (https://github.com/benfred)
  - Tamas Bela Feher (https://github.com/tfeher)

URL: https://github.com/rapidsai/raft/pull/1304
---
 .pre-commit-config.yaml                       |    2 +-
 build.sh                                      |   68 +-
 ci/checks/copyright.py                        |    3 +-
 .../bench_ann_cuda-118_arch-x86_64.yaml       |   37 +
 .../recipes/libraft/build_libraft_nn_bench.sh |    5 +
 conda/recipes/libraft/build_libraft_tests.sh  |    2 +-
 conda/recipes/libraft/conda_build_config.yaml |   12 +
 conda/recipes/libraft/meta.yaml               |   44 +
 cpp/CMakeLists.txt                            |   30 +-
 cpp/bench/ann/CMakeLists.txt                  |  160 ++
 cpp/bench/ann/README.md                       |    3 +
 cpp/bench/ann/conf/bigann-100M.json           |  174 +++
 cpp/bench/ann/conf/deep-100M.json             |  223 +++
 cpp/bench/ann/conf/deep-1B.json               |   38 +
 cpp/bench/ann/conf/glove-100-inner.json       |  797 ++++++++++
 cpp/bench/ann/conf/sift-128-euclidean.json    | 1321 +++++++++++++++++
 cpp/bench/ann/scripts/eval.pl                 |  430 ++++++
 cpp/bench/ann/scripts/fbin_to_f16bin.py       |   46 +
 cpp/bench/ann/scripts/hdf5_to_fbin.py         |   85 ++
 cpp/bench/ann/scripts/split_groundtruth.pl    |   45 +
 cpp/bench/ann/src/common/ann_types.hpp        |   88 ++
 cpp/bench/ann/src/common/benchmark.hpp        |  591 ++++++++
 cpp/bench/ann/src/common/benchmark_util.hpp   |   33 +
 cpp/bench/ann/src/common/conf.cpp             |  151 ++
 cpp/bench/ann/src/common/conf.h               |   75 +
 cpp/bench/ann/src/common/dataset.h            |  381 +++++
 cpp/bench/ann/src/common/util.cpp             |   68 +
 cpp/bench/ann/src/common/util.h               |   79 +
 cpp/bench/ann/src/faiss/faiss_benchmark.cu    |  150 ++
 cpp/bench/ann/src/faiss/faiss_wrapper.h       |  317 ++++
 cpp/bench/ann/src/ggnn/ggnn_benchmark.cu      |  125 ++
 cpp/bench/ann/src/ggnn/ggnn_wrapper.cuh       |  308 ++++
 .../ann/src/hnswlib/hnswlib_benchmark.cpp     |  120 ++
 cpp/bench/ann/src/hnswlib/hnswlib_wrapper.h   |  327 ++++
 cpp/bench/ann/src/raft/raft_ann_bench_utils.h |   44 +
 cpp/bench/ann/src/raft/raft_benchmark.cu      |  223 +++
 cpp/bench/ann/src/raft/raft_ivf_flat.cu       |   26 +
 .../ann/src/raft/raft_ivf_flat_wrapper.h      |  142 ++
 cpp/bench/ann/src/raft/raft_ivf_pq.cu         |   26 +
 cpp/bench/ann/src/raft/raft_ivf_pq_wrapper.h  |  214 +++
 cpp/bench/ann/src/raft/raft_wrapper.h         |  152 ++
 cpp/bench/prims/CMakeLists.txt                |  141 ++
 cpp/bench/{ => prims}/cluster/kmeans.cu       |    0
 .../{ => prims}/cluster/kmeans_balanced.cu    |    0
 cpp/bench/{ => prims}/common/benchmark.hpp    |    0
 .../{ => prims}/distance/distance_common.cuh  |    0
 .../{ => prims}/distance/distance_cosine.cu   |    2 +-
 .../{ => prims}/distance/distance_exp_l2.cu   |    2 +-
 cpp/bench/{ => prims}/distance/distance_l1.cu |    2 +-
 .../{ => prims}/distance/distance_unexp_l2.cu |    2 +-
 cpp/bench/{ => prims}/distance/fused_l2_nn.cu |    0
 cpp/bench/{ => prims}/distance/kernels.cu     |    0
 cpp/bench/{ => prims}/distance/masked_nn.cu   |    0
 .../distance/tune_pairwise/bench.cu           |    0
 .../distance/tune_pairwise/kernel.cu          |    0
 .../distance/tune_pairwise/kernel.cuh         |    0
 cpp/bench/{ => prims}/linalg/add.cu           |    2 +-
 .../{ => prims}/linalg/map_then_reduce.cu     |    2 +-
 .../{ => prims}/linalg/matrix_vector_op.cu    |    2 +-
 cpp/bench/{ => prims}/linalg/norm.cu          |    2 +-
 cpp/bench/{ => prims}/linalg/normalize.cu     |    2 +-
 cpp/bench/{ => prims}/linalg/reduce.cu        |    2 +-
 .../{ => prims}/linalg/reduce_cols_by_key.cu  |    2 +-
 .../{ => prims}/linalg/reduce_rows_by_key.cu  |    2 +-
 cpp/bench/{ => prims}/main.cpp                |    2 +-
 cpp/bench/{ => prims}/matrix/argmin.cu        |    0
 cpp/bench/{ => prims}/matrix/gather.cu        |    0
 cpp/bench/{ => prims}/matrix/select_k.cu      |    0
 cpp/bench/{ => prims}/neighbors/knn.cuh       |    0
 .../knn/brute_force_float_int64_t.cu          |    2 +-
 .../knn/brute_force_float_uint32_t.cu         |    2 +-
 .../neighbors/knn/ivf_flat_float_int64_t.cu   |    2 +-
 .../neighbors/knn/ivf_flat_int8_t_int64_t.cu  |    2 +-
 .../neighbors/knn/ivf_flat_uint8_t_int64_t.cu |    0
 .../neighbors/knn/ivf_pq_float_int64_t.cu     |    0
 .../neighbors/knn/ivf_pq_int8_t_int64_t.cu    |    0
 .../neighbors/knn/ivf_pq_uint8_t_int64_t.cu   |    0
 cpp/bench/{ => prims}/neighbors/refine.cuh    |    0
 .../neighbors/refine_float_int64_t.cu         |    0
 .../neighbors/refine_uint8_t_int64_t.cu       |    0
 cpp/bench/{ => prims}/random/make_blobs.cu    |    2 +-
 cpp/bench/{ => prims}/random/permute.cu       |    0
 cpp/bench/{ => prims}/random/rng.cu           |    2 +-
 cpp/bench/{ => prims}/sparse/convert_csr.cu   |    0
 cpp/cmake/modules/FindAVX.cmake               |  110 ++
 cpp/cmake/patches/ggnn.patch                  |  206 +++
 cpp/cmake/patches/nlohmann_json.patch         |   38 +
 cpp/cmake/thirdparty/get_faiss.cmake          |   87 ++
 cpp/cmake/thirdparty/get_ggnn.cmake           |   44 +
 cpp/cmake/thirdparty/get_glog.cmake           |   49 +
 cpp/cmake/thirdparty/get_hnswlib.cmake        |   49 +
 cpp/cmake/thirdparty/get_nlohmann_json.cmake  |   39 +
 .../raft/cluster/detail/kmeans_deprecated.cuh |   18 +-
 cpp/include/raft/linalg/detail/lanczos.cuh    |    4 +-
 .../raft/solver/detail/lap_functions.cuh      |   32 +-
 cpp/include/raft/solver/linear_assignment.cuh |    4 +-
 .../raft/sparse/solver/detail/lanczos.cuh     |    4 +-
 .../raft/spectral/detail/matrix_wrappers.hpp  |    2 +-
 cpp/include/raft/util/cudart_utils.hpp        |   45 +-
 dependencies.yaml                             |   21 +
 docs/source/cuda_ann_benchmarks.md            |  322 ++++
 docs/source/index.rst                         |    1 +
 thirdparty/LICENSES/LICENSE.pytorch           |   77 +
 103 files changed, 8371 insertions(+), 125 deletions(-)
 create mode 100644 conda/environments/bench_ann_cuda-118_arch-x86_64.yaml
 create mode 100644 conda/recipes/libraft/build_libraft_nn_bench.sh
 create mode 100644 cpp/bench/ann/CMakeLists.txt
 create mode 100644 cpp/bench/ann/README.md
 create mode 100644 cpp/bench/ann/conf/bigann-100M.json
 create mode 100644 cpp/bench/ann/conf/deep-100M.json
 create mode 100644 cpp/bench/ann/conf/deep-1B.json
 create mode 100644 cpp/bench/ann/conf/glove-100-inner.json
 create mode 100644 cpp/bench/ann/conf/sift-128-euclidean.json
 create mode 100755 cpp/bench/ann/scripts/eval.pl
 create mode 100755 cpp/bench/ann/scripts/fbin_to_f16bin.py
 create mode 100755 cpp/bench/ann/scripts/hdf5_to_fbin.py
 create mode 100755 cpp/bench/ann/scripts/split_groundtruth.pl
 create mode 100644 cpp/bench/ann/src/common/ann_types.hpp
 create mode 100644 cpp/bench/ann/src/common/benchmark.hpp
 create mode 100644 cpp/bench/ann/src/common/benchmark_util.hpp
 create mode 100644 cpp/bench/ann/src/common/conf.cpp
 create mode 100644 cpp/bench/ann/src/common/conf.h
 create mode 100644 cpp/bench/ann/src/common/dataset.h
 create mode 100644 cpp/bench/ann/src/common/util.cpp
 create mode 100644 cpp/bench/ann/src/common/util.h
 create mode 100644 cpp/bench/ann/src/faiss/faiss_benchmark.cu
 create mode 100644 cpp/bench/ann/src/faiss/faiss_wrapper.h
 create mode 100644 cpp/bench/ann/src/ggnn/ggnn_benchmark.cu
 create mode 100644 cpp/bench/ann/src/ggnn/ggnn_wrapper.cuh
 create mode 100644 cpp/bench/ann/src/hnswlib/hnswlib_benchmark.cpp
 create mode 100644 cpp/bench/ann/src/hnswlib/hnswlib_wrapper.h
 create mode 100644 cpp/bench/ann/src/raft/raft_ann_bench_utils.h
 create mode 100644 cpp/bench/ann/src/raft/raft_benchmark.cu
 create mode 100644 cpp/bench/ann/src/raft/raft_ivf_flat.cu
 create mode 100644 cpp/bench/ann/src/raft/raft_ivf_flat_wrapper.h
 create mode 100644 cpp/bench/ann/src/raft/raft_ivf_pq.cu
 create mode 100644 cpp/bench/ann/src/raft/raft_ivf_pq_wrapper.h
 create mode 100644 cpp/bench/ann/src/raft/raft_wrapper.h
 create mode 100644 cpp/bench/prims/CMakeLists.txt
 rename cpp/bench/{ => prims}/cluster/kmeans.cu (100%)
 rename cpp/bench/{ => prims}/cluster/kmeans_balanced.cu (100%)
 rename cpp/bench/{ => prims}/common/benchmark.hpp (100%)
 rename cpp/bench/{ => prims}/distance/distance_common.cuh (100%)
 rename cpp/bench/{ => prims}/distance/distance_cosine.cu (94%)
 rename cpp/bench/{ => prims}/distance/distance_exp_l2.cu (94%)
 rename cpp/bench/{ => prims}/distance/distance_l1.cu (93%)
 rename cpp/bench/{ => prims}/distance/distance_unexp_l2.cu (94%)
 rename cpp/bench/{ => prims}/distance/fused_l2_nn.cu (100%)
 rename cpp/bench/{ => prims}/distance/kernels.cu (100%)
 rename cpp/bench/{ => prims}/distance/masked_nn.cu (100%)
 rename cpp/bench/{ => prims}/distance/tune_pairwise/bench.cu (100%)
 rename cpp/bench/{ => prims}/distance/tune_pairwise/kernel.cu (100%)
 rename cpp/bench/{ => prims}/distance/tune_pairwise/kernel.cuh (100%)
 rename cpp/bench/{ => prims}/linalg/add.cu (96%)
 rename cpp/bench/{ => prims}/linalg/map_then_reduce.cu (97%)
 rename cpp/bench/{ => prims}/linalg/matrix_vector_op.cu (99%)
 rename cpp/bench/{ => prims}/linalg/norm.cu (98%)
 rename cpp/bench/{ => prims}/linalg/normalize.cu (98%)
 rename cpp/bench/{ => prims}/linalg/reduce.cu (97%)
 rename cpp/bench/{ => prims}/linalg/reduce_cols_by_key.cu (98%)
 rename cpp/bench/{ => prims}/linalg/reduce_rows_by_key.cu (98%)
 rename cpp/bench/{ => prims}/main.cpp (92%)
 rename cpp/bench/{ => prims}/matrix/argmin.cu (100%)
 rename cpp/bench/{ => prims}/matrix/gather.cu (100%)
 rename cpp/bench/{ => prims}/matrix/select_k.cu (100%)
 rename cpp/bench/{ => prims}/neighbors/knn.cuh (100%)
 rename cpp/bench/{ => prims}/neighbors/knn/brute_force_float_int64_t.cu (93%)
 rename cpp/bench/{ => prims}/neighbors/knn/brute_force_float_uint32_t.cu (93%)
 rename cpp/bench/{ => prims}/neighbors/knn/ivf_flat_float_int64_t.cu (93%)
 rename cpp/bench/{ => prims}/neighbors/knn/ivf_flat_int8_t_int64_t.cu (93%)
 rename cpp/bench/{ => prims}/neighbors/knn/ivf_flat_uint8_t_int64_t.cu (100%)
 rename cpp/bench/{ => prims}/neighbors/knn/ivf_pq_float_int64_t.cu (100%)
 rename cpp/bench/{ => prims}/neighbors/knn/ivf_pq_int8_t_int64_t.cu (100%)
 rename cpp/bench/{ => prims}/neighbors/knn/ivf_pq_uint8_t_int64_t.cu (100%)
 rename cpp/bench/{ => prims}/neighbors/refine.cuh (100%)
 rename cpp/bench/{ => prims}/neighbors/refine_float_int64_t.cu (100%)
 rename cpp/bench/{ => prims}/neighbors/refine_uint8_t_int64_t.cu (100%)
 rename cpp/bench/{ => prims}/random/make_blobs.cu (98%)
 rename cpp/bench/{ => prims}/random/permute.cu (100%)
 rename cpp/bench/{ => prims}/random/rng.cu (98%)
 rename cpp/bench/{ => prims}/sparse/convert_csr.cu (100%)
 create mode 100644 cpp/cmake/modules/FindAVX.cmake
 create mode 100644 cpp/cmake/patches/ggnn.patch
 create mode 100644 cpp/cmake/patches/nlohmann_json.patch
 create mode 100644 cpp/cmake/thirdparty/get_faiss.cmake
 create mode 100644 cpp/cmake/thirdparty/get_ggnn.cmake
 create mode 100644 cpp/cmake/thirdparty/get_glog.cmake
 create mode 100644 cpp/cmake/thirdparty/get_hnswlib.cmake
 create mode 100644 cpp/cmake/thirdparty/get_nlohmann_json.cmake
 create mode 100644 docs/source/cuda_ann_benchmarks.md
 create mode 100644 thirdparty/LICENSES/LICENSE.pytorch

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index 630b8788f8..d6e4ecb676 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -62,7 +62,7 @@ repos:
                 entry: ./cpp/scripts/run-cmake-format.sh cmake-format
                 language: python
                 types: [cmake]
-                exclude: .*/thirdparty/.*
+                exclude: .*/thirdparty/.*|.*FindAVX.cmake.*
                 # Note that pre-commit autoupdate does not update the versions
                 # of dependencies, so we'll have to update this manually.
                 additional_dependencies:
diff --git a/build.sh b/build.sh
index 9468d2cab0..3758dc26c4 100755
--- a/build.sh
+++ b/build.sh
@@ -2,7 +2,7 @@
 
 # Copyright (c) 2020-2023, NVIDIA CORPORATION.
 
-# raft build script
+# raft build scripts
 
 # This script is used to build the component(s) in this repo from
 # source, and can be called with various options to customize the
@@ -15,11 +15,11 @@ NUMARGS=$#
 ARGS=$*
 
 # NOTE: ensure all dir changes are relative to the location of this
-# script, and that this script resides in the repo dir!
+# scripts, and that this script resides in the repo dir!
 REPODIR=$(cd $(dirname $0); pwd)
 
-VALIDARGS="clean libraft pylibraft raft-dask docs tests bench template clean --uninstall  -v -g -n --compile-lib --allgpuarch --no-nvtx --show_depr_warn -h"
-HELP="$0 [<target> ...] [<flag> ...] [--cmake-args=\"<args>\"] [--cache-tool=<tool>] [--limit-tests=<targets>] [--limit-bench=<targets>]
+VALIDARGS="clean libraft pylibraft raft-dask docs tests template bench-prims bench-ann clean --uninstall  -v -g -n --compile-lib --allgpuarch --no-nvtx --show_depr_warn -h"
+HELP="$0 [<target> ...] [<flag> ...] [--cmake-args=\"<args>\"] [--cache-tool=<tool>] [--limit-tests=<targets>] [--limit-bench-prims=<targets>] [--limit-bench-ann=<targets>]
  where <target> is:
    clean            - remove all existing build artifacts and configuration (start over)
    libraft          - build the raft C++ code only. Also builds the C-wrapper library
@@ -28,7 +28,8 @@ HELP="$0 [<target> ...] [<flag> ...] [--cmake-args=\"<args>\"] [--cache-tool=<to
    raft-dask        - build the raft-dask Python package. this also requires pylibraft.
    docs             - build the documentation
    tests            - build the tests
-   bench            - build the benchmarks
+   bench-prims      - build micro-benchmarks for primitives
+   bench-ann        - build end-to-end ann benchmarks
    template         - build the example RAFT application template
 
  and <flag> is:
@@ -39,7 +40,8 @@ HELP="$0 [<target> ...] [<flag> ...] [--cmake-args=\"<args>\"] [--cache-tool=<to
    --compile-lib               - compile shared libraries for all components
                                  can be useful for a pure header-only install
    --limit-tests               - semicolon-separated list of test executables to compile (e.g. NEIGHBORS_TEST;CLUSTER_TEST)
-   --limit-bench               - semicolon-separated list of benchmark executables to compute (e.g. NEIGHBORS_BENCH;CLUSTER_BENCH)
+   --limit-bench-prims         - semicolon-separated list of prims benchmark executables to compute (e.g. NEIGHBORS_PRIMS_BENCH;CLUSTER_PRIMS_BENCH)
+   --limit-bench-ann           - semicolon-separated list of ann benchmark executables to compute (e.g. HNSWLIB_ANN_BENCH;RAFT_IVF_PQ_ANN_BENCH)
    --allgpuarch                - build for all supported GPU architectures
    --no-nvtx                   - disable nvtx (profiling markers), but allow enabling it in downstream projects
    --show_depr_warn            - show cmake deprecation warnings
@@ -63,7 +65,8 @@ VERBOSE_FLAG=""
 BUILD_ALL_GPU_ARCH=0
 BUILD_TESTS=OFF
 BUILD_TYPE=Release
-BUILD_BENCH=OFF
+BUILD_PRIMS_BENCH=OFF
+BUILD_ANN_BENCH=OFF
 COMPILE_LIBRARY=OFF
 INSTALL_TARGET=install
 
@@ -151,15 +154,30 @@ function limitTests {
 
 function limitBench {
     # Check for option to limit the set of test binaries to build
-    if [[ -n $(echo $ARGS | { grep -E "\-\-limit\-bench" || true; } ) ]]; then
+    if [[ -n $(echo $ARGS | { grep -E "\-\-limit\-bench-prims" || true; } ) ]]; then
         # There are possible weird edge cases that may cause this regex filter to output nothing and fail silently
         # the true pipe will catch any weird edge cases that may happen and will cause the program to fall back
         # on the invalid option error
-        LIMIT_BENCH_TARGETS=$(echo $ARGS | sed -e 's/.*--limit-bench=//' -e 's/ .*//')
-        if [[ -n ${LIMIT_BENCH_TARGETS} ]]; then
+        LIMIT_PRIMS_BENCH_TARGETS=$(echo $ARGS | sed -e 's/.*--limit-bench-prims=//' -e 's/ .*//')
+        if [[ -n ${LIMIT_PRIMS_BENCH_TARGETS} ]]; then
+            # Remove the full LIMIT_PRIMS_BENCH_TARGETS argument from list of args so that it passes validArgs function
+            ARGS=${ARGS//--limit-bench-prims=$LIMIT_PRIMS_BENCH_TARGETS/}
+            PRIMS_BENCH_TARGETS=${LIMIT_PRIMS_BENCH_TARGETS}
+        fi
+    fi
+}
+
+function limitAnnBench {
+    # Check for option to limit the set of test binaries to build
+    if [[ -n $(echo $ARGS | { grep -E "\-\-limit\-bench-ann" || true; } ) ]]; then
+        # There are possible weird edge cases that may cause this regex filter to output nothing and fail silently
+        # the true pipe will catch any weird edge cases that may happen and will cause the program to fall back
+        # on the invalid option error
+        LIMIT_ANN_BENCH_TARGETS=$(echo $ARGS | sed -e 's/.*--limit-bench-ann=//' -e 's/ .*//')
+        if [[ -n ${LIMIT_ANN_BENCH_TARGETS} ]]; then
             # Remove the full LIMIT_TEST_TARGETS argument from list of args so that it passes validArgs function
-            ARGS=${ARGS//--limit-bench=$LIMIT_BENCH_TARGETS/}
-            BENCH_TARGETS=${LIMIT_BENCH_TARGETS}
+            ARGS=${ARGS//--limit-bench-ann=$LIMIT_ANN_BENCH_TARGETS/}
+            ANN_BENCH_TARGETS=${LIMIT_ANN_BENCH_TARGETS}
         fi
     fi
 }
@@ -175,6 +193,7 @@ if (( ${NUMARGS} != 0 )); then
     cacheTool
     limitTests
     limitBench
+    limitAnnBench
     for a in ${ARGS}; do
         if ! (echo " ${VALIDARGS} " | grep -q " ${a} "); then
             echo "Invalid option: ${a}"
@@ -281,18 +300,23 @@ if hasArg tests || (( ${NUMARGS} == 0 )); then
     fi
 fi
 
-if hasArg bench || (( ${NUMARGS} == 0 )); then
-    BUILD_BENCH=ON
-    CMAKE_TARGET="${CMAKE_TARGET};${BENCH_TARGETS}"
+if hasArg bench-prims || (( ${NUMARGS} == 0 )); then
+    BUILD_PRIMS_BENCH=ON
+    CMAKE_TARGET="${CMAKE_TARGET};${PRIMS_BENCH_TARGETS}"
 
     # Force compile library when needed benchmark targets are specified
-    if [[ $CMAKE_TARGET == *"CLUSTER_BENCH"* || \
-          $CMAKE_TARGET == *"MATRIX_BENCH"* || \
-          $CMAKE_TARGET == *"NEIGHBORS_BENCH"* ]]; then
+    if [[ $CMAKE_TARGET == *"CLUSTER_PRIMS_BENCH"* || \
+          $CMAKE_TARGET == *"MATRIX_PRIMS_BENCH"* || \
+          $CMAKE_TARGET == *"NEIGHBORS_PRIMS_BENCH"* ]]; then
       echo "-- Enabling compiled lib for benchmarks"
       COMPILE_LIBRARY=ON
     fi
+fi
 
+if hasArg bench-ann || (( ${NUMARGS} == 0 )); then
+    BUILD_ANN_BENCH=ON
+    CMAKE_TARGET="${CMAKE_TARGET};${ANN_BENCH_TARGETS}"
+    COMPILE_LIBRARY=ON
 fi
 
 if hasArg --no-nvtx; then
@@ -305,8 +329,6 @@ if hasArg clean; then
     CLEAN=1
 fi
 
-
-
 if [[ ${CMAKE_TARGET} == "" ]]; then
     CMAKE_TARGET="all"
 fi
@@ -340,7 +362,7 @@ fi
 
 ################################################################################
 # Configure for building all C++ targets
-if (( ${NUMARGS} == 0 )) || hasArg libraft || hasArg docs || hasArg tests || hasArg bench; then
+if (( ${NUMARGS} == 0 )) || hasArg libraft || hasArg docs || hasArg tests || hasArg bench-prims || hasArg bench-ann; then
     if (( ${BUILD_ALL_GPU_ARCH} == 0 )); then
         RAFT_CMAKE_CUDA_ARCHITECTURES="NATIVE"
         echo "Building for the architecture of the GPU in the system..."
@@ -359,7 +381,8 @@ if (( ${NUMARGS} == 0 )) || hasArg libraft || hasArg docs || hasArg tests || has
           -DRAFT_NVTX=${NVTX} \
           -DDISABLE_DEPRECATION_WARNINGS=${DISABLE_DEPRECATION_WARNINGS} \
           -DBUILD_TESTS=${BUILD_TESTS} \
-          -DBUILD_BENCH=${BUILD_BENCH} \
+          -DBUILD_PRIMS_BENCH=${BUILD_PRIMS_BENCH} \
+          -DBUILD_ANN_BENCH=${BUILD_ANN_BENCH} \
           -DCMAKE_MESSAGE_LOG_LEVEL=${CMAKE_LOG_LEVEL} \
           ${CACHE_ARGS} \
           ${EXTRA_CMAKE_ARGS}
@@ -380,7 +403,6 @@ if (( ${NUMARGS} == 0 )) || hasArg pylibraft; then
     if [[ "${EXTRA_CMAKE_ARGS}" != *"DFIND_RAFT_CPP"* ]]; then
         EXTRA_CMAKE_ARGS="${EXTRA_CMAKE_ARGS} -DFIND_RAFT_CPP=ON"
     fi
-
     cd ${REPODIR}/python/pylibraft
     python setup.py build_ext --inplace -- -DCMAKE_PREFIX_PATH="${RAFT_DASK_BUILD_DIR};${INSTALL_PREFIX}" -DCMAKE_LIBRARY_PATH=${LIBRAFT_BUILD_DIR} ${EXTRA_CMAKE_ARGS} -- -j${PARALLEL_LEVEL:-1}
     if [[ ${INSTALL_TARGET} != "" ]]; then
diff --git a/ci/checks/copyright.py b/ci/checks/copyright.py
index a44314a6ce..123aeba87b 100644
--- a/ci/checks/copyright.py
+++ b/ci/checks/copyright.py
@@ -192,7 +192,8 @@ def checkCopyright_main():
                            action="append",
                            required=False,
                            default=["python/cuml/_thirdparty/",
-                                    "cpp/include/raft/thirdparty/"],
+                                    "cpp/include/raft/thirdparty/",
+                                    "cpp/cmake/modules/FindAVX.cmake"],
                            help=("Exclude the paths specified (regexp). "
                                  "Can be specified multiple times."))
 
diff --git a/conda/environments/bench_ann_cuda-118_arch-x86_64.yaml b/conda/environments/bench_ann_cuda-118_arch-x86_64.yaml
new file mode 100644
index 0000000000..5965aaef8f
--- /dev/null
+++ b/conda/environments/bench_ann_cuda-118_arch-x86_64.yaml
@@ -0,0 +1,37 @@
+# This file is generated by `rapids-dependency-file-generator`.
+# To make changes, edit ../../dependencies.yaml and run `rapids-dependency-file-generator`.
+channels:
+- rapidsai
+- rapidsai-nightly
+- dask/label/dev
+- conda-forge
+- nvidia
+dependencies:
+- c-compiler
+- clang-tools=11.1.0
+- clang=11.1.0
+- cmake>=3.23.1,!=3.25.0
+- cuda-profiler-api=11.8.86
+- cudatoolkit=11.8
+- cxx-compiler
+- cython>=0.29,<0.30
+- faiss-proc=*=cuda
+- gcc_linux-64=11.*
+- glog>=0.6.0
+- h5py>=3.8.0
+- hnswlib=0.7.0
+- libcublas-dev=11.11.3.6
+- libcublas=11.11.3.6
+- libcurand-dev=10.3.0.86
+- libcurand=10.3.0.86
+- libcusolver-dev=11.4.1.48
+- libcusolver=11.4.1.48
+- libcusparse-dev=11.7.5.86
+- libcusparse=11.7.5.86
+- libfaiss>=1.7.1
+- nccl>=2.9.9
+- ninja
+- nlohmann_json>=3.11.2
+- scikit-build>=0.13.1
+- sysroot_linux-64==2.17
+name: bench_ann_cuda-118_arch-x86_64
diff --git a/conda/recipes/libraft/build_libraft_nn_bench.sh b/conda/recipes/libraft/build_libraft_nn_bench.sh
new file mode 100644
index 0000000000..dc6250f0f4
--- /dev/null
+++ b/conda/recipes/libraft/build_libraft_nn_bench.sh
@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# Copyright (c) 2023, NVIDIA CORPORATION.
+
+./build.sh tests bench-ann --allgpuarch --no-nvtx
+cmake --install cpp/build --component ann_bench
diff --git a/conda/recipes/libraft/build_libraft_tests.sh b/conda/recipes/libraft/build_libraft_tests.sh
index aa2c1b3e89..cc28f93fb8 100644
--- a/conda/recipes/libraft/build_libraft_tests.sh
+++ b/conda/recipes/libraft/build_libraft_tests.sh
@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
 # Copyright (c) 2022-2023, NVIDIA CORPORATION.
 
-./build.sh tests bench --allgpuarch --no-nvtx
+./build.sh tests bench-prims --allgpuarch --no-nvtx
 cmake --install cpp/build --component testing
diff --git a/conda/recipes/libraft/conda_build_config.yaml b/conda/recipes/libraft/conda_build_config.yaml
index e1079f4db8..2a66f213a7 100644
--- a/conda/recipes/libraft/conda_build_config.yaml
+++ b/conda/recipes/libraft/conda_build_config.yaml
@@ -19,6 +19,18 @@ nccl_version:
 gtest_version:
   - "=1.10.0"
 
+glog_version:
+  - ">=0.6.0"
+
+faiss_version:
+  - ">=1.7.1"
+
+h5py_version:
+  - ">=3.8.0"
+
+nlohmann_json_version:
+  - ">=3.11.2"
+
 # The CTK libraries below are missing from the conda-forge::cudatoolkit
 # package. The "*_host_*" version specifiers correspond to `11.8` packages and the
 # "*_run_*" version specifiers correspond to `11.x` packages.
diff --git a/conda/recipes/libraft/meta.yaml b/conda/recipes/libraft/meta.yaml
index f911166a9a..7859807777 100644
--- a/conda/recipes/libraft/meta.yaml
+++ b/conda/recipes/libraft/meta.yaml
@@ -186,3 +186,47 @@ outputs:
       home: https://rapids.ai/
       license: Apache-2.0
       summary: libraft template
+  - name: libraft-ann-bench
+    version: {{ version }}
+    script: build_libraft_nn_bench.sh
+    build:
+      script_env: *script_env
+      number: {{ GIT_DESCRIBE_NUMBER }}
+      string: cuda{{ cuda_major }}_{{ date_string }}_{{ GIT_DESCRIBE_HASH }}_{{ GIT_DESCRIBE_NUMBER }}
+      ignore_run_exports_from:
+        - {{ compiler('cuda') }}
+    requirements:
+      build:
+        - {{ compiler('c') }}
+        - {{ compiler('cuda') }} {{ cuda_version }}
+        - {{ compiler('cxx') }}
+        - cmake {{ cmake_version }}
+        - ninja
+        - sysroot_{{ target_platform }} {{ sysroot_version }}
+      host:
+        - {{ pin_subpackage('libraft', exact=True) }}
+        - {{ pin_subpackage('libraft-headers', exact=True) }}
+        - cuda-profiler-api {{ cuda_profiler_api_host_version }}
+        - libcublas {{ libcublas_host_version }}
+        - libcublas-dev {{ libcublas_host_version }}
+        - libcurand {{ libcurand_host_version }}
+        - libcurand-dev {{ libcurand_host_version }}
+        - libcusolver {{ libcusolver_host_version }}
+        - libcusolver-dev {{ libcusolver_host_version }}
+        - libcusparse {{ libcusparse_host_version }}
+        - libcusparse-dev {{ libcusparse_host_version }}
+        - glog {{ glog_version }}
+        - nlohmann_json {{ nlohmann_json_version }}
+        - libfaiss>=1.7.1
+        - faiss-proc=*=cuda
+      run:
+        - {{ pin_subpackage('libraft', exact=True) }}
+        - {{ pin_subpackage('libraft-headers', exact=True) }}
+        - glog {{ glog_version }}
+        - faiss-proc=*=cuda
+        - libfaiss {{ faiss_version }}
+        - h5py {{ h5py_version }}
+    about:
+      home: https://rapids.ai/
+      license: Apache-2.0
+      summary: libraft ann bench
diff --git a/cpp/CMakeLists.txt b/cpp/CMakeLists.txt
index c1704552ec..7bb458c44a 100644
--- a/cpp/CMakeLists.txt
+++ b/cpp/CMakeLists.txt
@@ -46,7 +46,8 @@ set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
 
 option(BUILD_SHARED_LIBS "Build raft shared libraries" ON)
 option(BUILD_TESTS "Build raft unit-tests" ON)
-option(BUILD_BENCH "Build raft C++ benchmark tests" OFF)
+option(BUILD_PRIMS_BENCH "Build raft C++ benchmark tests" OFF)
+option(BUILD_ANN_BENCH "Build raft ann benchmarks" OFF)
 option(CUDA_ENABLE_KERNELINFO "Enable kernel resource usage info" OFF)
 option(CUDA_ENABLE_LINEINFO
        "Enable the -lineinfo option for nvcc (useful for cuda-memcheck / profiler)" OFF
@@ -58,14 +59,20 @@ option(DISABLE_OPENMP "Disable OpenMP" OFF)
 option(RAFT_NVTX "Enable nvtx markers" OFF)
 
 set(RAFT_COMPILE_LIBRARY_DEFAULT OFF)
-if(BUILD_TESTS OR BUILD_BENCH)
+if(BUILD_TESTS
+   OR BUILD_PRIMS_BENCH
+   OR BUILD_ANN_BENCH
+)
   set(RAFT_COMPILE_LIBRARY_DEFAULT ON)
 endif()
 option(RAFT_COMPILE_LIBRARY "Enable building raft shared library instantiations"
        ${RAFT_COMPILE_LIBRARY_DEFAULT}
 )
 
-if(BUILD_TESTS OR BUILD_BENCH)
+if(BUILD_TESTS
+   OR BUILD_PRIMS_BENCH
+   OR BUILD_ANN_BENCH
+)
   # Needed because GoogleBenchmark changes the state of FindThreads.cmake, causing subsequent runs
   # to have different values for the `Threads::Threads` target. Setting this flag ensures
   # `Threads::Threads` is the same value in first run and subsequent runs.
@@ -78,7 +85,7 @@ include(CMakeDependentOption)
 
 message(VERBOSE "RAFT: Building optional components: ${raft_FIND_COMPONENTS}")
 message(VERBOSE "RAFT: Build RAFT unit-tests: ${BUILD_TESTS}")
-message(VERBOSE "RAFT: Building raft C++ benchmarks: ${BUILD_BENCH}")
+message(VERBOSE "RAFT: Building raft C++ benchmarks: ${BUILD_PRIMS_BENCH}")
 message(VERBOSE "RAFT: Enable detection of conda environment for dependencies: ${DETECT_CONDA_ENV}")
 message(VERBOSE "RAFT: Disable depreaction warnings " ${DISABLE_DEPRECATION_WARNINGS})
 message(VERBOSE "RAFT: Disable OpenMP: ${DISABLE_OPENMP}")
@@ -159,7 +166,7 @@ if(BUILD_TESTS)
   include(cmake/thirdparty/get_gtest.cmake)
 endif()
 
-if(BUILD_BENCH)
+if(BUILD_PRIMS_BENCH)
   include(${rapids-cmake-dir}/cpm/gbench.cmake)
   rapids_cpm_gbench()
 endif()
@@ -647,7 +654,7 @@ raft_export(
 # ##################################################################################################
 # * shared test/bench headers ------------------------------------------------
 
-if(BUILD_TESTS OR BUILD_BENCH)
+if(BUILD_TESTS OR BUILD_PRIMS_BENCH)
   include(internal/CMakeLists.txt)
 endif()
 
@@ -661,6 +668,13 @@ endif()
 # ##################################################################################################
 # * build benchmark executable -----------------------------------------------
 
-if(BUILD_BENCH)
-  include(bench/CMakeLists.txt)
+if(BUILD_PRIMS_BENCH)
+  include(bench/prims/CMakeLists.txt)
+endif()
+
+# ##################################################################################################
+# * build ann benchmark executable -----------------------------------------------
+
+if(BUILD_ANN_BENCH)
+  include(bench/ann/CMakeLists.txt)
 endif()
diff --git a/cpp/bench/ann/CMakeLists.txt b/cpp/bench/ann/CMakeLists.txt
new file mode 100644
index 0000000000..6267be518e
--- /dev/null
+++ b/cpp/bench/ann/CMakeLists.txt
@@ -0,0 +1,160 @@
+# =============================================================================
+# Copyright (c) 2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+# in compliance with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software distributed under the License
+# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+# or implied. See the License for the specific language governing permissions and limitations under
+# the License.
+# =============================================================================
+
+# ##################################################################################################
+# * compiler function -----------------------------------------------------------------------------
+
+option(RAFT_ANN_BENCH_USE_FAISS_BFKNN "Include faiss' brute-force knn algorithm in benchmark" ON)
+option(RAFT_ANN_BENCH_USE_FAISS_IVF_FLAT "Include faiss' ivf flat algorithm in benchmark" ON)
+option(RAFT_ANN_BENCH_USE_FAISS_IVF_PQ "Include faiss' ivf pq algorithm in benchmark" ON)
+option(RAFT_ANN_BENCH_USE_RAFT_BFKNN "Include raft's brute-force knn algorithm in benchmark" ON)
+option(RAFT_ANN_BENCH_USE_RAFT_IVF_FLAT "Include raft's ivf flat algorithm in benchmark" ON)
+option(RAFT_ANN_BENCH_USE_RAFT_IVF_PQ "Include raft's ivf pq algorithm in benchmark" ON)
+option(RAFT_ANN_BENCH_USE_HNSWLIB "Include hnsw algorithm in benchmark" ON)
+option(RAFT_ANN_BENCH_USE_GGNN "Include ggnn algorithm in benchmark" ON)
+
+find_package(Threads REQUIRED)
+
+set(RAFT_ANN_BENCH_USE_FAISS OFF)
+if(RAFT_ANN_BENCH_USE_FAISS_BFKNN
+   OR RAFT_ANN_BENCH_USE_FAISS_IVFPQ
+   OR RAFT_ANN_BENCH_USE_FAISS_IFFLAT
+)
+  set(RAFT_ANN_BENCH_USE_FAISS ON)
+endif()
+
+set(RAFT_ANN_BENCH_USE_RAFT OFF)
+if(RAFT_ANN_BENCH_USE_RAFT_BFKNN
+   OR RAFT_ANN_BENCH_USE_RAFT_IVFPQ
+   OR RAFT_ANN_BENCH_USE_RAFT_IVFFLAT
+)
+  set(RAFT_ANN_BENCH_USE_RAFT ON)
+endif()
+
+if(RAFT_ANN_BENCH_USE_HNSWLIB)
+  include(cmake/thirdparty/get_hnswlib.cmake)
+endif()
+
+option(RAFT_ANN_BENCH_USE_MULTIGPU "Use multi-gpus (where possible) in benchmarks" OFF)
+
+include(cmake/thirdparty/get_nlohmann_json.cmake)
+
+if(RAFT_ANN_BENCH_USE_GGNN)
+  include(cmake/thirdparty/get_ggnn.cmake)
+endif()
+
+if(RAFT_ANN_BENCH_USE_FAISS)
+  include(cmake/thirdparty/get_faiss.cmake)
+endif()
+
+function(ConfigureAnnBench)
+
+  set(oneValueArgs NAME)
+  set(multiValueArgs PATH LINKS CXXFLAGS INCLUDES)
+
+  cmake_parse_arguments(
+    ConfigureAnnBench "${options}" "${oneValueArgs}" "${multiValueArgs}" ${ARGN}
+  )
+
+  set(BENCH_NAME ${ConfigureAnnBench_NAME}_ANN_BENCH)
+
+  add_executable(
+    ${BENCH_NAME} ${ConfigureAnnBench_PATH} bench/ann/src/common/conf.cpp
+                  bench/ann/src/common/util.cpp
+  )
+  target_link_libraries(
+    ${BENCH_NAME}
+    PRIVATE raft::raft
+            nlohmann_json::nlohmann_json
+            $<$<BOOL:${RAFT_ANN_BENCH_USE_MULTIGPU}>:NCCL::NCCL>
+            ${ConfigureAnnBench_LINKS}
+            Threads::Threads
+            $<TARGET_NAME_IF_EXISTS:OpenMP::OpenMP_CXX>
+            $<TARGET_NAME_IF_EXISTS:conda_env>
+  )
+
+  set_target_properties(
+    ${BENCH_NAME}
+    PROPERTIES # set target compile options
+               INSTALL_RPATH "\$ORIGIN/../../../lib"
+               CXX_STANDARD 17
+               CXX_STANDARD_REQUIRED ON
+               CUDA_STANDARD 17
+               CUDA_STANDARD_REQUIRED ON
+               POSITION_INDEPENDENT_CODE ON
+               INTERFACE_POSITION_INDEPENDENT_CODE ON
+  )
+
+  set(${ConfigureAnnBench_CXXFLAGS} ${RAFT_CXX_FLAGS} ${ConfigureAnnBench_CXXFLAGS})
+
+  target_compile_options(
+    ${BENCH_NAME} PRIVATE "$<$<COMPILE_LANGUAGE:CXX>:${ConfigureAnnBench_CXXFLAGS}>"
+                          "$<$<COMPILE_LANGUAGE:CUDA>:${RAFT_CUDA_FLAGS}>"
+  )
+
+  if(RAFT_ANN_BENCH_USE_${ConfigureAnnBench_NAME})
+    target_compile_definitions(
+      ${BENCH_NAME}
+      PUBLIC
+        RAFT_ANN_BENCH_USE_${ConfigureAnnBench_NAME}=RAFT_ANN_BENCH_USE_${ConfigureAnnBench_NAME}
+    )
+  endif()
+
+  target_include_directories(
+    ${BENCH_NAME}
+    PUBLIC "$<BUILD_INTERFACE:${RAFT_SOURCE_DIR}/include>"
+    PRIVATE ${ConfigureAnnBench_INCLUDES}
+  )
+
+  install(
+    TARGETS ${BENCH_NAME}
+    COMPONENT ann_bench
+    DESTINATION bin/ann
+    EXCLUDE_FROM_ALL
+  )
+endfunction()
+
+if(RAFT_ANN_BENCH_USE_HNSWLIB)
+  ConfigureAnnBench(
+    NAME HNSWLIB PATH bench/ann/src/hnswlib/hnswlib_benchmark.cpp INCLUDES
+    ${CMAKE_CURRENT_BINARY_DIR}/_deps/hnswlib-src/hnswlib CXXFLAGS "${HNSW_CXX_FLAGS}"
+  )
+endif()
+
+if(RAFT_ANN_BENCH_USE_RAFT)
+  ConfigureAnnBench(
+    NAME
+    RAFT_IVF_PQ
+    PATH
+    bench/ann/src/raft/raft_benchmark.cu
+    $<$<BOOL:${RAFT_ANN_BENCH_USE_RAFT_IVF_PQ}>:bench/ann/src/raft/raft_ivf_pq.cu>
+    $<$<BOOL:${RAFT_ANN_BENCH_USE_RAFT_IVF_FLAT}>:bench/ann/src/raft/raft_ivf_flat.cu>
+    LINKS
+    raft::compiled
+  )
+endif()
+
+if(RAFT_ANN_BENCH_USE_FAISS)
+  ConfigureAnnBench(
+    NAME FAISS_IVF_FLAT PATH bench/ann/src/faiss/faiss_benchmark.cu LINKS faiss::faiss
+  )
+endif()
+
+if(RAFT_ANN_BENCH_USE_GGNN)
+  include(cmake/thirdparty/get_glog.cmake)
+  ConfigureAnnBench(
+    NAME GGNN PATH bench/ann/src/ggnn/ggnn_benchmark.cu INCLUDES
+    ${CMAKE_CURRENT_BINARY_DIR}/_deps/ggnn-src/include LINKS glog::glog
+  )
+endif()
diff --git a/cpp/bench/ann/README.md b/cpp/bench/ann/README.md
new file mode 100644
index 0000000000..1a8af2e448
--- /dev/null
+++ b/cpp/bench/ann/README.md
@@ -0,0 +1,3 @@
+# RAFT CUDA ANN Benchmarks
+
+Please see the [ANN Benchmarks](https://docs.rapids.ai/api/raft/stable/cuda_ann_benchmarks.html) section of the RAFT documentation for instructions on building and using the ANN benchmarks.
\ No newline at end of file
diff --git a/cpp/bench/ann/conf/bigann-100M.json b/cpp/bench/ann/conf/bigann-100M.json
new file mode 100644
index 0000000000..5f16f3378d
--- /dev/null
+++ b/cpp/bench/ann/conf/bigann-100M.json
@@ -0,0 +1,174 @@
+{
+  "dataset" : {
+    "name" : "bigann-100M",
+    "base_file" : "data/bigann-1B/base.1B.u8bin",
+    "subset_size" : 100000000,
+    "query_file" : "data/bigann-1B/query.public.10K.u8bin",
+    "distance" : "euclidean"
+  },
+
+  "search_basic_param" : {
+    "batch_size" : 10000,
+    "k" : 10,
+    "run_count" : 2
+  },
+
+  "index" : [
+    {
+      "name": "raft_ivf_pq.dimpq64-cluster5K-float-float",
+      "algo": "raft_ivf_pq",
+      "build_param": {
+        "niter": 25,
+        "nlist": 5000,
+        "pq_dim": 64,
+        "ratio": 10
+      },
+      "file": "index/bigann-100M/raft_ivf_pq/dimpq64-cluster5K",
+      "search_params": [
+        {
+          "numProbes": 20,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "numProbes": 30,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "numProbes": 40,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "numProbes": 50,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "numProbes": 100,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "numProbes": 200,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "numProbes": 500,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "numProbes": 1000,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        }
+      ],
+      "search_result_file": "result/bigann-100M/raft_ivf_pq/dimpq64-cluster5K-float-float"
+    },
+    {
+      "name" : "hnswlib.M12",
+      "algo" : "hnswlib",
+      "build_param": {"M":12, "efConstruction":500, "numThreads":32},
+      "file" : "index/bigann-100M/hnswlib/M12",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":60, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/bigann-100M/hnswlib/M12"
+    },
+    {
+      "name" : "hnswlib.M16",
+      "algo" : "hnswlib",
+      "build_param": {"M":16, "efConstruction":500, "numThreads":32},
+      "file" : "index/bigann-100M/hnswlib/M16",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":60, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/bigann-100M/hnswlib/M16"
+    },
+    {
+      "name" : "hnswlib.M24",
+      "algo" : "hnswlib",
+      "build_param": {"M":24, "efConstruction":500, "numThreads":32},
+      "file" : "index/bigann-100M/hnswlib/M24",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":60, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/bigann-100M/hnswlib/M24"
+    },
+    {
+      "name" : "hnswlib.M36",
+      "algo" : "hnswlib",
+      "build_param": {"M":36, "efConstruction":500, "numThreads":32},
+      "file" : "index/bigann-100M/hnswlib/M36",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":60, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/bigann-100M/hnswlib/M36"
+    },
+
+
+    {
+      "name" : "ivf_flat.nlist100K",
+      "algo" : "ivf_flat",
+      "build_param": {
+        "nlist" : 100000,
+        "niter" : 25,
+        "ratio" : 5
+      },
+      "file" : "index/bigann-100M/ivf_flat/nlist100K",
+      "search_params" : [
+        {"max_batch":10000, "max_k":10, "nprobe":20},
+        {"max_batch":10000, "max_k":10, "nprobe":30},
+        {"max_batch":10000, "max_k":10, "nprobe":40},
+        {"max_batch":10000, "max_k":10, "nprobe":50},
+        {"max_batch":10000, "max_k":10, "nprobe":100},
+        {"max_batch":10000, "max_k":10, "nprobe":200},
+        {"max_batch":10000, "max_k":10, "nprobe":500},
+        {"max_batch":10000, "max_k":10, "nprobe":1000}
+      ],
+      "search_result_file" : "result/bigann-100M/ivf_flat/nlist100K"
+    },
+
+
+
+  ]
+}
diff --git a/cpp/bench/ann/conf/deep-100M.json b/cpp/bench/ann/conf/deep-100M.json
new file mode 100644
index 0000000000..b3a945d50e
--- /dev/null
+++ b/cpp/bench/ann/conf/deep-100M.json
@@ -0,0 +1,223 @@
+{
+  "dataset" : {
+    "name" : "deep-100M",
+    "base_file" : "data/deep-1B/base.1B.fbin",
+    "subset_size" : 100000000,
+    "query_file" : "data/deep-1B/query.public.10K.fbin",
+    "distance" : "euclidean"
+  },
+
+  "search_basic_param" : {
+    "batch_size" : 10000,
+    "k" : 10,
+    "run_count" : 2
+  },
+
+  "index" : [
+    {
+      "name" : "hnswlib.M12",
+      "algo" : "hnswlib",
+      "build_param": {"M":12, "efConstruction":500, "numThreads":32},
+      "file" : "index/deep-100M/hnswlib/M12",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":60, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/deep-100M/hnswlib/M12"
+    },
+    {
+      "name" : "hnswlib.M16",
+      "algo" : "hnswlib",
+      "build_param": {"M":16, "efConstruction":500, "numThreads":32},
+      "file" : "index/deep-100M/hnswlib/M16",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":60, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/deep-100M/hnswlib/M16"
+    },
+    {
+      "name" : "hnswlib.M24",
+      "algo" : "hnswlib",
+      "build_param": {"M":24, "efConstruction":500, "numThreads":32},
+      "file" : "index/deep-100M/hnswlib/M24",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":60, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/deep-100M/hnswlib/M24"
+    },
+    {
+      "name" : "hnswlib.M36",
+      "algo" : "hnswlib",
+      "build_param": {"M":36, "efConstruction":500, "numThreads":32},
+      "file" : "index/deep-100M/hnswlib/M36",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":60, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/deep-100M/hnswlib/M36"
+    },
+    {
+      "name" : "faiss_ivf_flat.nlist50K",
+      "algo" : "faiss_gpu_ivf_flat",
+      "build_param": {"nlist":50000},
+      "file" : "index/deep-100M/faiss_ivf_flat/nlist50K",
+      "search_params" : [
+        {"nprobe":20},
+        {"nprobe":30},
+        {"nprobe":40},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/deep-100M/faiss_ivf_flat/nlist50K"
+    },
+    {
+      "name" : "faiss_ivf_flat.nlist100K",
+      "algo" : "faiss_gpu_ivf_flat",
+      "build_param": {"nlist":100000},
+      "file" : "index/deep-100M/faiss_ivf_flat/nlist100K",
+      "search_params" : [
+        {"nprobe":20},
+        {"nprobe":30},
+        {"nprobe":40},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/deep-100M/faiss_ivf_flat/nlist100K"
+    },
+    {
+      "name" : "faiss_ivf_flat.nlist200K",
+      "algo" : "faiss_gpu_ivf_flat",
+      "build_param": {"nlist":200000},
+      "file" : "index/deep-100M/faiss_ivf_flat/nlist200K",
+      "search_params" : [
+        {"nprobe":20},
+        {"nprobe":30},
+        {"nprobe":40},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/deep-100M/faiss_ivf_flat/nlist200K"
+    },
+
+
+    {
+      "name" : "faiss_ivf_pq.M48-nlist16K",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":16384, "M":48},
+      "file" : "index/deep-100M/faiss_ivf_pq/M48-nlist16K",
+      "search_params" : [
+        {"nprobe":10},
+        {"nprobe":20},
+        {"nprobe":30},
+        {"nprobe":40},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500}
+      ],
+      "search_result_file" : "result/deep-100M/faiss_ivf_pq/M48-nlist16K"
+    },
+    {
+      "name" : "faiss_ivf_pq.M48-nlist50K",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":50000, "M":48},
+      "file" : "index/deep-100M/faiss_ivf_pq/M48-nlist50K",
+      "search_params" : [
+        {"nprobe":20},
+        {"nprobe":30},
+        {"nprobe":40},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/deep-100M/faiss_ivf_pq/M48-nlist50K"
+    },
+    {
+      "name" : "faiss_ivf_pq.M48-nlist100K",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":100000, "M":48},
+      "file" : "index/deep-100M/faiss_ivf_pq/M48-nlist100K",
+      "search_params" : [
+        {"nprobe":20},
+        {"nprobe":30},
+        {"nprobe":40},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/deep-100M/faiss_ivf_pq/M48-nlist100K"
+    },
+
+
+    {
+      "name" : "ivf_flat.nlist100K",
+      "algo" : "ivf_flat",
+      "build_param": {
+        "nlist" : 100000,
+        "niter" : 25,
+        "ratio" : 5
+      },
+      "file" : "index/deep-100M/ivf_flat/nlist100K",
+      "search_params" : [
+        {"max_batch":10000, "max_k":10, "nprobe":20},
+        {"max_batch":10000, "max_k":10, "nprobe":30},
+        {"max_batch":10000, "max_k":10, "nprobe":40},
+        {"max_batch":10000, "max_k":10, "nprobe":50},
+        {"max_batch":10000, "max_k":10, "nprobe":100},
+        {"max_batch":10000, "max_k":10, "nprobe":200},
+        {"max_batch":10000, "max_k":10, "nprobe":500},
+        {"max_batch":10000, "max_k":10, "nprobe":1000}
+      ],
+      "search_result_file" : "result/deep-100M/ivf_flat/nlist100K"
+    },
+
+
+  ]
+}
diff --git a/cpp/bench/ann/conf/deep-1B.json b/cpp/bench/ann/conf/deep-1B.json
new file mode 100644
index 0000000000..50d1b87602
--- /dev/null
+++ b/cpp/bench/ann/conf/deep-1B.json
@@ -0,0 +1,38 @@
+{
+  "dataset" : {
+    "name" : "deep-1B",
+    "base_file" : "data/deep-1B/base.1B.fbin",
+    "query_file" : "data/deep-1B/query.public.10K.fbin",
+    // although distance should be "euclidean", faiss becomes much slower for that
+    "distance" : "inner_product"
+  },
+
+  "search_basic_param" : {
+    "batch_size" : 10000,
+    "k" : 10,
+    "run_count" : 2
+  },
+
+  "index" : [
+    {
+      "name" : "faiss_ivf_pq.M48-nlist50K",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":50000, "M":48},
+      "file" : "index/deep-1B/faiss_ivf_pq/M48-nlist50K",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000},
+        {"nprobe":2000}
+      ],
+      "search_result_file" : "result/deep-1B/faiss_ivf_pq/M48-nlist50K"
+    },
+
+
+  ]
+}
diff --git a/cpp/bench/ann/conf/glove-100-inner.json b/cpp/bench/ann/conf/glove-100-inner.json
new file mode 100644
index 0000000000..d210aca654
--- /dev/null
+++ b/cpp/bench/ann/conf/glove-100-inner.json
@@ -0,0 +1,797 @@
+{
+  "dataset" : {
+    "name" : "glove-100-inner",
+    "base_file" : "data/glove-100-inner/base.fbin",
+    "query_file" : "data/glove-100-inner/query.fbin",
+    "distance" : "inner_product"
+  },
+
+  "search_basic_param" : {
+    "batch_size" : 1,
+    "k" : 10,
+    "run_count" : 3
+  },
+
+  "index" : [
+    {
+      "name" : "hnswlib.M4",
+      "algo" : "hnswlib",
+      "build_param": {"M":4, "efConstruction":500, "numThreads":4},
+      "file" : "index/glove-100-inner/hnswlib/M4",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/glove-100-inner/hnswlib/M4"
+    },
+
+    {
+      "name" : "hnswlib.M8",
+      "algo" : "hnswlib",
+      "build_param": {"M":8, "efConstruction":500, "numThreads":4},
+      "file" : "index/glove-100-inner/hnswlib/M8",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/glove-100-inner/hnswlib/M8"
+    },
+
+    {
+      "name" : "hnswlib.M12",
+      "algo" : "hnswlib",
+      "build_param": {"M":12, "efConstruction":500, "numThreads":4},
+      "file" : "index/glove-100-inner/hnswlib/M12",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/glove-100-inner/hnswlib/M12"
+    },
+
+    {
+      "name" : "hnswlib.M16",
+      "algo" : "hnswlib",
+      "build_param": {"M":16, "efConstruction":500, "numThreads":4},
+      "file" : "index/glove-100-inner/hnswlib/M16",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/glove-100-inner/hnswlib/M16"
+    },
+
+    {
+      "name" : "hnswlib.M24",
+      "algo" : "hnswlib",
+      "build_param": {"M":24, "efConstruction":500, "numThreads":4},
+      "file" : "index/glove-100-inner/hnswlib/M24",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/glove-100-inner/hnswlib/M24"
+    },
+
+    {
+      "name" : "hnswlib.M36",
+      "algo" : "hnswlib",
+      "build_param": {"M":36, "efConstruction":500, "numThreads":4},
+      "file" : "index/glove-100-inner/hnswlib/M36",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/glove-100-inner/hnswlib/M36"
+    },
+
+    {
+      "name" : "hnswlib.M48",
+      "algo" : "hnswlib",
+      "build_param": {"M":48, "efConstruction":500, "numThreads":4},
+      "file" : "index/glove-100-inner/hnswlib/M48",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/glove-100-inner/hnswlib/M48"
+    },
+
+    {
+      "name" : "hnswlib.M64",
+      "algo" : "hnswlib",
+      "build_param": {"M":64, "efConstruction":500, "numThreads":4},
+      "file" : "index/glove-100-inner/hnswlib/M64",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/glove-100-inner/hnswlib/M64"
+    },
+
+    {
+      "name" : "hnswlib.M96",
+      "algo" : "hnswlib",
+      "build_param": {"M":96, "efConstruction":500, "numThreads":4},
+      "file" : "index/glove-100-inner/hnswlib/M96",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/glove-100-inner/hnswlib/M96"
+    },
+
+    {
+      "name" : "faiss_ivf_flat.nlist1024",
+      "algo" : "faiss_gpu_ivf_flat",
+      "build_param": {"nlist":1024},
+      "file" : "index/glove-100-inner/faiss_ivf_flat/nlist1024",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_flat/nlist1024"
+    },
+
+    {
+      "name" : "faiss_ivf_flat.nlist2048",
+      "algo" : "faiss_gpu_ivf_flat",
+      "build_param": {"nlist":2048},
+      "file" : "index/glove-100-inner/faiss_ivf_flat/nlist2048",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_flat/nlist2048"
+    },
+
+    {
+      "name" : "faiss_ivf_flat.nlist4096",
+      "algo" : "faiss_gpu_ivf_flat",
+      "build_param": {"nlist":4096},
+      "file" : "index/glove-100-inner/faiss_ivf_flat/nlist4096",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_flat/nlist4096"
+    },
+
+    {
+      "name" : "faiss_ivf_flat.nlist8192",
+      "algo" : "faiss_gpu_ivf_flat",
+      "build_param": {"nlist":8192},
+      "file" : "index/glove-100-inner/faiss_ivf_flat/nlist8192",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_flat/nlist8192"
+    },
+
+    {
+      "name" : "faiss_ivf_flat.nlist16384",
+      "algo" : "faiss_gpu_ivf_flat",
+      "build_param": {"nlist":16384},
+      "file" : "index/glove-100-inner/faiss_ivf_flat/nlist16384",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000},
+        {"nprobe":2000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_flat/nlist16384"
+    },
+
+
+
+    {
+      "name" : "faiss_ivf_pq.M2-nlist1024",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":1024, "M":2},
+      "file" : "index/glove-100-inner/faiss_ivf_pq/M2-nlist1024",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_pq/M2-nlist1024"
+    },
+
+    {
+      "name" : "faiss_ivf_pq.M2-nlist2048",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":2048, "M":2},
+      "file" : "index/glove-100-inner/faiss_ivf_pq/M2-nlist2048",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_pq/M2-nlist2048"
+    },
+
+    {
+      "name" : "faiss_ivf_pq.M2-nlist4096",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":4096, "M":2},
+      "file" : "index/glove-100-inner/faiss_ivf_pq/M2-nlist4096",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_pq/M2-nlist4096"
+    },
+
+    {
+      "name" : "faiss_ivf_pq.M2-nlist8192",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":8192, "M":2},
+      "file" : "index/glove-100-inner/faiss_ivf_pq/M2-nlist8192",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_pq/M2-nlist8192"
+    },
+
+    {
+      "name" : "faiss_ivf_pq.M2-nlist16384",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":16384, "M":2},
+      "file" : "index/glove-100-inner/faiss_ivf_pq/M2-nlist16384",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000},
+        {"nprobe":2000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_pq/M2-nlist16384"
+    },
+
+    {
+      "name" : "faiss_ivf_pq.M4-nlist1024",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":1024, "M":4},
+      "file" : "index/glove-100-inner/faiss_ivf_pq/M4-nlist1024",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_pq/M4-nlist1024"
+    },
+
+    {
+      "name" : "faiss_ivf_pq.M4-nlist2048",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":2048, "M":4},
+      "file" : "index/glove-100-inner/faiss_ivf_pq/M4-nlist2048",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_pq/M4-nlist2048"
+    },
+
+    {
+      "name" : "faiss_ivf_pq.M4-nlist4096",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":4096, "M":4},
+      "file" : "index/glove-100-inner/faiss_ivf_pq/M4-nlist4096",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_pq/M4-nlist4096"
+    },
+
+    {
+      "name" : "faiss_ivf_pq.M4-nlist8192",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":8192, "M":4},
+      "file" : "index/glove-100-inner/faiss_ivf_pq/M4-nlist8192",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_pq/M4-nlist8192"
+    },
+
+    {
+      "name" : "faiss_ivf_pq.M4-nlist16384",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":16384, "M":4},
+      "file" : "index/glove-100-inner/faiss_ivf_pq/M4-nlist16384",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000},
+        {"nprobe":2000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_pq/M4-nlist16384"
+    },
+
+    {
+      "name" : "faiss_ivf_pq.M20-nlist1024",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":1024, "M":20},
+      "file" : "index/glove-100-inner/faiss_ivf_pq/M20-nlist1024",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_pq/M20-nlist1024"
+    },
+
+    {
+      "name" : "faiss_ivf_pq.M20-nlist2048",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":2048, "M":20},
+      "file" : "index/glove-100-inner/faiss_ivf_pq/M20-nlist2048",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_pq/M20-nlist2048"
+    },
+
+    {
+      "name" : "faiss_ivf_pq.M20-nlist4096",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":4096, "M":20},
+      "file" : "index/glove-100-inner/faiss_ivf_pq/M20-nlist4096",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_pq/M20-nlist4096"
+    },
+
+    {
+      "name" : "faiss_ivf_pq.M20-nlist8192",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":8192, "M":20},
+      "file" : "index/glove-100-inner/faiss_ivf_pq/M20-nlist8192",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_pq/M20-nlist8192"
+    },
+
+    {
+      "name" : "faiss_ivf_pq.M20-nlist16384",
+      "algo" : "faiss_gpu_ivf_pq",
+      "build_param": {"nlist":16384, "M":20},
+      "file" : "index/glove-100-inner/faiss_ivf_pq/M20-nlist16384",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000},
+        {"nprobe":2000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_pq/M20-nlist16384"
+    },
+
+
+    {
+      "name" : "faiss_ivf_sq.nlist1024-fp16",
+      "algo" : "faiss_gpu_ivf_sq",
+      "build_param": {"nlist":1024, "quantizer_type":"fp16"},
+      "file" : "index/glove-100-inner/faiss_ivf_sq/nlist1024-fp16",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_sq/nlist1024-fp16"
+    },
+
+    {
+      "name" : "faiss_ivf_sq.nlist2048-fp16",
+      "algo" : "faiss_gpu_ivf_sq",
+      "build_param": {"nlist":2048, "quantizer_type":"fp16"},
+      "file" : "index/glove-100-inner/faiss_ivf_sq/nlist2048-fp16",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_sq/nlist2048-fp16"
+    },
+
+    {
+      "name" : "faiss_ivf_sq.nlist4096-fp16",
+      "algo" : "faiss_gpu_ivf_sq",
+      "build_param": {"nlist":4096, "quantizer_type":"fp16"},
+      "file" : "index/glove-100-inner/faiss_ivf_sq/nlist4096-fp16",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_sq/nlist4096-fp16"
+    },
+
+    {
+      "name" : "faiss_ivf_sq.nlist8192-fp16",
+      "algo" : "faiss_gpu_ivf_sq",
+      "build_param": {"nlist":8192, "quantizer_type":"fp16"},
+      "file" : "index/glove-100-inner/faiss_ivf_sq/nlist8192-fp16",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_sq/nlist8192-fp16"
+    },
+
+    {
+      "name" : "faiss_ivf_sq.nlist16384-fp16",
+      "algo" : "faiss_gpu_ivf_sq",
+      "build_param": {"nlist":16384, "quantizer_type":"fp16"},
+      "file" : "index/glove-100-inner/faiss_ivf_sq/nlist16384-fp16",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000},
+        {"nprobe":2000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_sq/nlist16384-fp16"
+    },
+
+
+    {
+      "name" : "faiss_ivf_sq.nlist1024-int8",
+      "algo" : "faiss_gpu_ivf_sq",
+      "build_param": {"nlist":1024, "quantizer_type":"int8"},
+      "file" : "index/glove-100-inner/faiss_ivf_sq/nlist1024-int8",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_sq/nlist1024-int8"
+    },
+
+    {
+      "name" : "faiss_ivf_sq.nlist2048-int8",
+      "algo" : "faiss_gpu_ivf_sq",
+      "build_param": {"nlist":2048, "quantizer_type":"int8"},
+      "file" : "index/glove-100-inner/faiss_ivf_sq/nlist2048-int8",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_sq/nlist2048-int8"
+    },
+
+    {
+      "name" : "faiss_ivf_sq.nlist4096-int8",
+      "algo" : "faiss_gpu_ivf_sq",
+      "build_param": {"nlist":4096, "quantizer_type":"int8"},
+      "file" : "index/glove-100-inner/faiss_ivf_sq/nlist4096-int8",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_sq/nlist4096-int8"
+    },
+
+    {
+      "name" : "faiss_ivf_sq.nlist8192-int8",
+      "algo" : "faiss_gpu_ivf_sq",
+      "build_param": {"nlist":8192, "quantizer_type":"int8"},
+      "file" : "index/glove-100-inner/faiss_ivf_sq/nlist8192-int8",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_sq/nlist8192-int8"
+    },
+
+    {
+      "name" : "faiss_ivf_sq.nlist16384-int8",
+      "algo" : "faiss_gpu_ivf_sq",
+      "build_param": {"nlist":16384, "quantizer_type":"int8"},
+      "file" : "index/glove-100-inner/faiss_ivf_sq/nlist16384-int8",
+      "search_params" : [
+        {"nprobe":1},
+        {"nprobe":5},
+        {"nprobe":10},
+        {"nprobe":50},
+        {"nprobe":100},
+        {"nprobe":200},
+        {"nprobe":500},
+        {"nprobe":1000},
+        {"nprobe":2000}
+      ],
+      "search_result_file" : "result/glove-100-inner/faiss_ivf_sq/nlist16384-int8"
+    },
+
+    {
+      "name" : "faiss_flat",
+      "algo" : "faiss_gpu_flat",
+      "build_param": {},
+      "file" : "index/glove-100-inner/faiss_flat/flat",
+      "search_params" : [{}],
+      "search_result_file" : "result/glove-100-inner/faiss_flat/flat"
+    },
+
+    {
+      "name" : "ggnn.kbuild96-segment64-refine2-k10",
+      "algo" : "ggnn",
+      "build_param": {
+        "k_build": 96,
+        "segment_size": 64,
+        "refine_iterations": 2,
+        "dataset_size": 1183514,
+        "k": 10
+      },
+      "file" : "index/glove-100-inner/ggnn/kbuild96-segment64-refine2-k10",
+      "search_params" : [
+        {"tau":0.001, "block_dim":64, "sorted_size":32},
+        {"tau":0.005, "block_dim":64, "sorted_size":32},
+        {"tau":0.01,  "block_dim":64, "sorted_size":32},
+        {"tau":0.02,  "block_dim":64, "sorted_size":32},
+        {"tau":0.03,  "block_dim":64, "sorted_size":32},
+        {"tau":0.04,  "block_dim":64, "sorted_size":32},
+        {"tau":0.05,  "block_dim":64, "sorted_size":32},
+        {"tau":0.06,  "block_dim":64, "sorted_size":32},
+        {"tau":0.09,  "block_dim":64, "sorted_size":32},
+        {"tau":0.12,  "block_dim":64, "sorted_size":32},
+        {"tau":0.18,  "block_dim":64, "sorted_size":32},
+        {"tau":0.21,  "block_dim":64, "sorted_size":32},
+        {"tau":0.24,  "block_dim":64, "sorted_size":32},
+        {"tau":0.27,  "block_dim":64, "sorted_size":32},
+        {"tau":0.3,   "block_dim":64, "sorted_size":32},
+        {"tau":0.4,   "block_dim":64, "sorted_size":32},
+        {"tau":0.01, "block_dim":128, "max_iterations":2000, "cache_size":1024, "sorted_size":32},
+        {"tau":0.02, "block_dim":128, "max_iterations":2000, "cache_size":1024, "sorted_size":32},
+        {"tau":0.03, "block_dim":128, "max_iterations":2000, "cache_size":1024, "sorted_size":32},
+        {"tau":0.04, "block_dim":128, "max_iterations":2000, "cache_size":1024, "sorted_size":32},
+        {"tau":0.05, "block_dim":128, "max_iterations":2000, "cache_size":1024, "sorted_size":32},
+        {"tau":0.06, "block_dim":128, "max_iterations":2000, "cache_size":1024, "sorted_size":32},
+        {"tau":0.09, "block_dim":128, "max_iterations":2000, "cache_size":1024, "sorted_size":32},
+        {"tau":0.12, "block_dim":128, "max_iterations":2000, "cache_size":1024, "sorted_size":32},
+        {"tau":0.18, "block_dim":128, "max_iterations":2000, "cache_size":1024, "sorted_size":32},
+        {"tau":0.21, "block_dim":128, "max_iterations":2000, "cache_size":1024, "sorted_size":32},
+        {"tau":0.24, "block_dim":128, "max_iterations":2000, "cache_size":1024, "sorted_size":32},
+        {"tau":0.27, "block_dim":128, "max_iterations":2000, "cache_size":1024, "sorted_size":32},
+        {"tau":0.3,  "block_dim":128, "max_iterations":2000, "cache_size":1024, "sorted_size":32},
+        {"tau":0.4,  "block_dim":128, "max_iterations":2000, "cache_size":1024, "sorted_size":32},
+        {"tau":0.5,  "block_dim":128, "max_iterations":2000, "cache_size":1024, "sorted_size":32}
+
+      ],
+      "search_result_file" : "result/glove-100-inner/ggnn/kbuild96-segment64-refine2-k10"
+    },
+
+
+  ]
+
+}
diff --git a/cpp/bench/ann/conf/sift-128-euclidean.json b/cpp/bench/ann/conf/sift-128-euclidean.json
new file mode 100644
index 0000000000..476c363ecd
--- /dev/null
+++ b/cpp/bench/ann/conf/sift-128-euclidean.json
@@ -0,0 +1,1321 @@
+{
+  "dataset": {
+    "name": "sift-128-euclidean",
+    "base_file": "/home/cjnolet/workspace/ann_data/sift-128-euclidean/base.fbin",
+    "query_file": "/home/cjnolet/workspace/ann_data/sift-128-euclidean/query.fbin",
+    "distance": "euclidean"
+  },
+  "search_basic_param": {
+    "batch_size": 5000,
+    "k": 10,
+    "run_count": 3
+  },
+  "index": [
+    {
+      "name" : "hnswlib.M12",
+      "algo" : "hnswlib",
+      "build_param": {"M":12, "efConstruction":500, "numThreads":32},
+      "file" : "index/sift-128-euclidean/hnswlib/M12",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":60, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/sift-128-euclidean/hnswlib/M12"
+    },
+    {
+      "name" : "hnswlib.M16",
+      "algo" : "hnswlib",
+      "build_param": {"M":16, "efConstruction":500, "numThreads":32},
+      "file" : "index/sift-128-euclidean/hnswlib/M16",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":60, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/sift-128-euclidean/hnswlib/M16"
+    },
+    {
+      "name" : "hnswlib.M24",
+      "algo" : "hnswlib",
+      "build_param": {"M":24, "efConstruction":500, "numThreads":32},
+      "file" : "index/sift-128-euclidean/hnswlib/M24",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":60, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/sift-128-euclidean/hnswlib/M24"
+    },
+    {
+      "name" : "hnswlib.M36",
+      "algo" : "hnswlib",
+      "build_param": {"M":36, "efConstruction":500, "numThreads":32},
+      "file" : "index/sift-128-euclidean/hnswlib/M36",
+      "search_params" : [
+        {"ef":10, "numThreads":1},
+        {"ef":20, "numThreads":1},
+        {"ef":40, "numThreads":1},
+        {"ef":60, "numThreads":1},
+        {"ef":80, "numThreads":1},
+        {"ef":120, "numThreads":1},
+        {"ef":200, "numThreads":1},
+        {"ef":400, "numThreads":1},
+        {"ef":600, "numThreads":1},
+        {"ef":800, "numThreads":1}
+      ],
+      "search_result_file" : "result/sift-128-euclidean/hnswlib/M36"
+    },
+
+
+
+      
+	  {
+      "name": "raft_bfknn",
+      "algo": "raft_bfknn",
+      "build_param": {},
+      "file": "index/sift-128-euclidean/raft_bfknn/bfknn",
+      "search_params": [
+        {
+          "probe": 1
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/raft_bfknn/bfknn"
+    },
+    {
+      "name": "faiss_ivf_flat.nlist1024",
+      "algo": "faiss_gpu_ivf_flat",
+      "build_param": {
+        "nlist": 1024
+      },
+      "file": "index/sift-128-euclidean/faiss_ivf_flat/nlist1024",
+      "search_params": [
+        {
+          "nprobe": 1
+        },
+        {
+          "nprobe": 5
+        },
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/faiss_ivf_flat/nlist1024"
+    },
+    {
+      "name": "faiss_ivf_flat.nlist2048",
+      "algo": "faiss_gpu_ivf_flat",
+      "build_param": {
+        "nlist": 2048
+      },
+      "file": "index/sift-128-euclidean/faiss_ivf_flat/nlist2048",
+      "search_params": [
+        {
+          "nprobe": 1
+        },
+        {
+          "nprobe": 5
+        },
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/faiss_ivf_flat/nlist2048"
+    },
+    {
+      "name": "faiss_ivf_flat.nlist4096",
+      "algo": "faiss_gpu_ivf_flat",
+      "build_param": {
+        "nlist": 4096
+      },
+      "file": "index/sift-128-euclidean/faiss_ivf_flat/nlist4096",
+      "search_params": [
+        {
+          "nprobe": 1
+        },
+        {
+          "nprobe": 5
+        },
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/faiss_ivf_flat/nlist4096"
+    },
+    {
+      "name": "faiss_ivf_flat.nlist8192",
+      "algo": "faiss_gpu_ivf_flat",
+      "build_param": {
+        "nlist": 8192
+      },
+      "file": "index/sift-128-euclidean/faiss_ivf_flat/nlist8192",
+      "search_params": [
+        {
+          "nprobe": 1
+        },
+        {
+          "nprobe": 5
+        },
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/faiss_ivf_flat/nlist8192"
+    },
+    {
+      "name": "faiss_ivf_flat.nlist16384",
+      "algo": "faiss_gpu_ivf_flat",
+      "build_param": {
+        "nlist": 16384
+      },
+      "file": "index/sift-128-euclidean/faiss_ivf_flat/nlist16384",
+      "search_params": [
+        {
+          "nprobe": 1
+        },
+        {
+          "nprobe": 5
+        },
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        },
+        {
+          "nprobe": 2000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/faiss_ivf_flat/nlist16384"
+    },
+    {
+      "name": "faiss_ivf_pq.M64-nlist1024",
+      "algo": "faiss_gpu_ivf_pq",
+      "build_param": {
+        "nlist": 1024,
+        "M": 64,
+        "useFloat16": true,
+        "usePrecomputed": true
+      },
+      "file": "index/sift-128-euclidean/faiss_ivf_pq/M64-nlist1024",
+      "search_params": [
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/faiss_ivf_pq/M64-nlist1024"
+    },
+    {
+      "name": "faiss_ivf_pq.M64-nlist1024.noprecomp",
+      "algo": "faiss_gpu_ivf_pq",
+      "build_param": {
+        "nlist": 1024,
+        "M": 64,
+        "useFloat16": true,
+        "usePrecomputed": false
+      },
+      "file": "index/sift-128-euclidean/faiss_ivf_pq/M64-nlist1024.noprecomp",
+      "search_params": [
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/faiss_ivf_pq/M64-nlist1024"
+    },
+    {
+      "name": "faiss_ivf_sq.nlist1024-fp16",
+      "algo": "faiss_gpu_ivf_sq",
+      "build_param": {
+        "nlist": 1024,
+        "quantizer_type": "fp16"
+      },
+      "file": "index/sift-128-euclidean/faiss_ivf_sq/nlist1024-fp16",
+      "search_params": [
+        {
+          "nprobe": 1
+        },
+        {
+          "nprobe": 5
+        },
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/faiss_ivf_sq/nlist1024-fp16"
+    },
+    {
+      "name": "faiss_ivf_sq.nlist2048-fp16",
+      "algo": "faiss_gpu_ivf_sq",
+      "build_param": {
+        "nlist": 2048,
+        "quantizer_type": "fp16"
+      },
+      "file": "index/sift-128-euclidean/faiss_ivf_sq/nlist2048-fp16",
+      "search_params": [
+        {
+          "nprobe": 1
+        },
+        {
+          "nprobe": 5
+        },
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/faiss_ivf_sq/nlist2048-fp16"
+    },
+    {
+      "name": "faiss_ivf_sq.nlist4096-fp16",
+      "algo": "faiss_gpu_ivf_sq",
+      "build_param": {
+        "nlist": 4096,
+        "quantizer_type": "fp16"
+      },
+      "file": "index/sift-128-euclidean/faiss_ivf_sq/nlist4096-fp16",
+      "search_params": [
+        {
+          "nprobe": 1
+        },
+        {
+          "nprobe": 5
+        },
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/faiss_ivf_sq/nlist4096-fp16"
+    },
+    {
+      "name": "faiss_ivf_sq.nlist8192-fp16",
+      "algo": "faiss_gpu_ivf_sq",
+      "build_param": {
+        "nlist": 8192,
+        "quantizer_type": "fp16"
+      },
+      "file": "index/sift-128-euclidean/faiss_ivf_sq/nlist8192-fp16",
+      "search_params": [
+        {
+          "nprobe": 1
+        },
+        {
+          "nprobe": 5
+        },
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/faiss_ivf_sq/nlist8192-fp16"
+    },
+    {
+      "name": "faiss_ivf_sq.nlist16384-fp16",
+      "algo": "faiss_gpu_ivf_sq",
+      "build_param": {
+        "nlist": 16384,
+        "quantizer_type": "fp16"
+      },
+      "file": "index/sift-128-euclidean/faiss_ivf_sq/nlist16384-fp16",
+      "search_params": [
+        {
+          "nprobe": 1
+        },
+        {
+          "nprobe": 5
+        },
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        },
+        {
+          "nprobe": 2000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/faiss_ivf_sq/nlist16384-fp16"
+    },
+    {
+      "name": "faiss_ivf_sq.nlist1024-int8",
+      "algo": "faiss_gpu_ivf_sq",
+      "build_param": {
+        "nlist": 1024,
+        "quantizer_type": "int8"
+      },
+      "file": "index/sift-128-euclidean/faiss_ivf_sq/nlist1024-int8",
+      "search_params": [
+        {
+          "nprobe": 1
+        },
+        {
+          "nprobe": 5
+        },
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/faiss_ivf_sq/nlist1024-int8"
+    },
+    {
+      "name": "faiss_ivf_sq.nlist2048-int8",
+      "algo": "faiss_gpu_ivf_sq",
+      "build_param": {
+        "nlist": 2048,
+        "quantizer_type": "int8"
+      },
+      "file": "index/sift-128-euclidean/faiss_ivf_sq/nlist2048-int8",
+      "search_params": [
+        {
+          "nprobe": 1
+        },
+        {
+          "nprobe": 5
+        },
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/faiss_ivf_sq/nlist2048-int8"
+    },
+    {
+      "name": "faiss_ivf_sq.nlist4096-int8",
+      "algo": "faiss_gpu_ivf_sq",
+      "build_param": {
+        "nlist": 4096,
+        "quantizer_type": "int8"
+      },
+      "file": "index/sift-128-euclidean/faiss_ivf_sq/nlist4096-int8",
+      "search_params": [
+        {
+          "nprobe": 1
+        },
+        {
+          "nprobe": 5
+        },
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/faiss_ivf_sq/nlist4096-int8"
+    },
+    {
+      "name": "faiss_ivf_sq.nlist8192-int8",
+      "algo": "faiss_gpu_ivf_sq",
+      "build_param": {
+        "nlist": 8192,
+        "quantizer_type": "int8"
+      },
+      "file": "index/sift-128-euclidean/faiss_ivf_sq/nlist8192-int8",
+      "search_params": [
+        {
+          "nprobe": 1
+        },
+        {
+          "nprobe": 5
+        },
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/faiss_ivf_sq/nlist8192-int8"
+    },
+    {
+      "name": "faiss_ivf_sq.nlist16384-int8",
+      "algo": "faiss_gpu_ivf_sq",
+      "build_param": {
+        "nlist": 16384,
+        "quantizer_type": "int8"
+      },
+      "file": "index/sift-128-euclidean/faiss_ivf_sq/nlist16384-int8",
+      "search_params": [
+        {
+          "nprobe": 1
+        },
+        {
+          "nprobe": 5
+        },
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        },
+        {
+          "nprobe": 2000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/faiss_ivf_sq/nlist16384-int8"
+    },
+    {
+      "name": "faiss_flat",
+      "algo": "faiss_gpu_flat",
+      "build_param": {},
+      "file": "index/sift-128-euclidean/faiss_flat/flat",
+      "search_params": [
+        {}
+      ],
+      "search_result_file": "result/sift-128-euclidean/faiss_flat/flat"
+    },
+
+    {
+      "name": "raft_ivf_pq.dimpq128-cluster1024",
+      "algo": "raft_ivf_pq",
+      "build_param": {
+        "nlist": 1024,
+        "pq_dim": 128,
+        "ratio": 1,
+        "niter": 25
+      },
+      "file": "index/sift-128-euclidean/raft_ivf_pq/dimpq128-cluster1024",
+      "search_params": [
+        {
+          "k": 10,
+          "numProbes": 10,
+          "internalDistanceDtype": "half",
+          "smemLutDtype": "half"
+        },
+        {
+          "k": 10,
+          "numProbes": 50,
+          "internalDistanceDtype": "half",
+          "smemLutDtype": "half"
+        },
+        {
+          "k": 10,
+          "numProbes": 100,
+          "internalDistanceDtype": "half",
+          "smemLutDtype": "half"
+        },
+        {
+          "k": 10,
+          "numProbes": 200,
+          "internalDistanceDtype": "half",
+          "smemLutDtype": "half"
+        },
+        {
+          "k": 10,
+          "numProbes": 500,
+          "internalDistanceDtype": "half",
+          "smemLutDtype": "half"
+        },
+        {
+          "k": 10,
+          "numProbes": 1024,
+          "internalDistanceDtype": "half",
+          "smemLutDtype": "half"
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/raft_ivf_pq/dimpq128-cluster1024"
+    },
+    {
+      "name": "raft_ivf_pq.dimpq128-cluster1024-float-float",
+      "algo": "raft_ivf_pq",
+      "build_param": {
+        "nlist": 1024,
+        "pq_dim": 128,
+        "ratio": 1,
+        "niter": 25
+      },
+      "file": "index/sift-128-euclidean/raft_ivf_pq/dimpq128-cluster1024-float-float",
+      "search_params": [
+        {
+          "k": 10,
+          "numProbes": 1,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "k": 10,
+          "numProbes": 1,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "k": 10,
+          "numProbes": 5,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "k": 10,
+          "numProbes": 10,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "k": 10,
+          "numProbes": 50,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "k": 10,
+          "numProbes": 100,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "k": 10,
+          "numProbes": 200,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "k": 10,
+          "numProbes": 500,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "k": 10,
+          "numProbes": 1024,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/raft_ivf_pq/dimpq128-cluster1024-float-float"
+    },
+    {
+      "name": "raft_ivf_pq.dimpq128-cluster1024-float-half",
+      "algo": "raft_ivf_pq",
+      "build_param": {
+        "nlist": 1024,
+        "pq_dim": 128,
+        "ratio": 1,
+        "niter": 25
+      },
+      "file": "index/sift-128-euclidean/raft_ivf_pq/dimpq128-cluster1024-float-half",
+      "search_params": [
+        {
+          "k": 10,
+          "numProbes": 10,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "half"
+        },
+        {
+          "k": 10,
+          "numProbes": 50,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "half"
+        },
+        {
+          "k": 10,
+          "numProbes": 100,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "half"
+        },
+        {
+          "k": 10,
+          "numProbes": 200,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "half"
+        },
+        {
+          "k": 10,
+          "numProbes": 500,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "half"
+        },
+        {
+          "k": 10,
+          "numProbes": 1024,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "half"
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/raft_ivf_pq/dimpq128-cluster1024-float-half"
+    },
+    {
+      "name": "raft_ivf_pq.dimpq128-cluster1024-float-fp8",
+      "algo": "raft_ivf_pq",
+      "build_param": {
+        "nlist": 1024,
+        "pq_dim": 128,
+        "ratio": 1,
+        "niter": 25
+      },
+      "file": "index/sift-128-euclidean/raft_ivf_pq/dimpq128-cluster1024-float-fp8",
+      "search_params": [
+        {
+          "k": 10,
+          "numProbes": 10,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 50,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 100,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 200,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 500,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 1024,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/raft_ivf_pq/dimpq128-cluster1024-float-fp8"
+    },
+    {
+      "name": "raft_ivf_pq.dimpq64-cluster1024-float-fp8",
+      "algo": "raft_ivf_pq",
+      "build_param": {
+        "nlist": 1024,
+        "pq_dim": 64,
+        "ratio": 1,
+        "niter": 25
+      },
+      "file": "index/sift-128-euclidean/raft_ivf_pq/dimpq64-cluster1024-float-fp8",
+      "search_params": [
+        {
+          "k": 10,
+          "numProbes": 10,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 50,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 100,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 200,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 500,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 1024,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/raft_ivf_pq/dimpq64-cluster1024-float-fp8"
+    },
+    {
+      "name": "raft_ivf_pq.dimpq64-cluster1024-float-half",
+      "algo": "raft_ivf_pq",
+      "build_param": {
+        "nlist": 1024,
+        "pq_dim": 64,
+        "ratio": 1,
+        "niter": 25
+      },
+      "file": "index/sift-128-euclidean/raft_ivf_pq/dimpq64-cluster1024-float-half",
+      "search_params": [
+        {
+          "k": 10,
+          "numProbes": 10,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "half"
+        },
+        {
+          "k": 10,
+          "numProbes": 50,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "half"
+        },
+        {
+          "k": 10,
+          "numProbes": 100,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "half"
+        },
+        {
+          "k": 10,
+          "numProbes": 200,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "half"
+        },
+        {
+          "k": 10,
+          "numProbes": 500,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "half"
+        },
+        {
+          "k": 10,
+          "numProbes": 1024,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "half"
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/raft_ivf_pq/dimpq64-cluster1024-float-half"
+    },
+    {
+      "name": "raft_ivf_pq.dimpq32-cluster1024-float-fp8",
+      "algo": "raft_ivf_pq",
+      "build_param": {
+        "nlist": 1024,
+        "pq_dim": 32,
+        "ratio": 1,
+        "niter": 25
+      },
+      "file": "index/sift-128-euclidean/raft_ivf_pq/dimpq32-cluster1024-float-fp8",
+      "search_params": [
+        {
+          "k": 10,
+          "numProbes": 10,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 50,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 100,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 200,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 500,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 1024,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/raft_ivf_pq/dimpq32-cluster1024-float-fp8"
+    },
+    {
+      "name": "raft_ivf_pq.dimpq16-cluster1024-float-fp8",
+      "algo": "raft_ivf_pq",
+      "build_param": {
+        "nlist": 1024,
+        "pq_dim": 16,
+        "ratio": 1,
+        "niter": 25
+      },
+      "file": "index/sift-128-euclidean/raft_ivf_pq/dimpq16-cluster1024-float-fp8",
+      "search_params": [
+        {
+          "k": 10,
+          "numProbes": 10,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 50,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 100,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 200,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 500,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        },
+        {
+          "k": 10,
+          "numProbes": 1024,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "fp8"
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/raft_ivf_pq/dimpq16-cluster1024-float-fp8"
+    },
+    {
+      "name": "raft_ivf_pq.dimpq128-cluster1024-half-float",
+      "algo": "raft_ivf_pq",
+      "build_param": {
+        "nlist": 1024,
+        "pq_dim": 128,
+        "ratio": 1,
+        "niter": 25
+      },
+      "file": "index/sift-128-euclidean/raft_ivf_pq/dimpq128-cluster1024-half-float",
+      "search_params": [
+        {
+          "k": 10,
+          "numProbes": 10,
+          "internalDistanceDtype": "half",
+          "smemLutDtype": "float"
+        },
+        {
+          "k": 10,
+          "numProbes": 50,
+          "internalDistanceDtype": "half",
+          "smemLutDtype": "float"
+        },
+        {
+          "k": 10,
+          "numProbes": 100,
+          "internalDistanceDtype": "half",
+          "smemLutDtype": "float"
+        },
+        {
+          "k": 10,
+          "numProbes": 200,
+          "internalDistanceDtype": "half",
+          "smemLutDtype": "float"
+        },
+        {
+          "k": 10,
+          "numProbes": 500,
+          "internalDistanceDtype": "half",
+          "smemLutDtype": "float"
+        },
+        {
+          "k": 10,
+          "numProbes": 1024,
+          "internalDistanceDtype": "half",
+          "smemLutDtype": "float"
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/raft_ivf_pq/dimpq128-cluster1024-half-float"
+    },
+    {
+      "name": "raft_ivf_pq.dimpq512-cluster1024-float-float",
+      "algo": "raft_ivf_pq",
+      "build_param": {
+        "nlist": 1024,
+        "pq_dim": 512,
+        "ratio": 1,
+        "niter": 25
+      },
+      "file": "index/sift-128-euclidean/raft_ivf_pq/dimpq512-cluster1024-float-float",
+      "search_params": [
+        {
+          "k": 10,
+          "numProbes": 10,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "k": 10,
+          "numProbes": 50,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "k": 10,
+          "numProbes": 100,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "k": 10,
+          "numProbes": 200,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "k": 10,
+          "numProbes": 500,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        },
+        {
+          "k": 10,
+          "numProbes": 1024,
+          "internalDistanceDtype": "float",
+          "smemLutDtype": "float"
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/raft_ivf_pq/dimpq512-cluster1024-float-float"
+    },
+    {
+      "name": "raft_ivf_flat.nlist1024",
+      "algo": "raft_ivf_flat",
+      "build_param": {
+        "nlist": 1024,
+        "ratio": 1,
+        "niter": 25
+      },
+      "file": "index/sift-128-euclidean/raft_ivf_flat/nlist1024",
+      "search_params": [
+        {
+          "nprobe": 1
+        },
+        {
+          "nprobe": 5
+        },
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/raft_ivf_flat/nlist1024"
+    },
+    {
+      "name": "raft_ivf_flat.nlist16384",
+      "algo": "raft_ivf_flat",
+      "build_param": {
+        "nlist": 16384,
+        "ratio": 2,
+        "niter": 20
+      },
+      "file": "index/sift-128-euclidean/raft_ivf_flat/nlist16384",
+      "search_params": [
+        {
+          "nprobe": 1
+        },
+        {
+          "nprobe": 5
+        },
+        {
+          "nprobe": 10
+        },
+        {
+          "nprobe": 50
+        },
+        {
+          "nprobe": 100
+        },
+        {
+          "nprobe": 200
+        },
+        {
+          "nprobe": 500
+        },
+        {
+          "nprobe": 1000
+        },
+        {
+          "nprobe": 2000
+        }
+      ],
+      "search_result_file": "result/sift-128-euclidean/raft_ivf_flat/nlist16384"
+    }
+  ]
+}
diff --git a/cpp/bench/ann/scripts/eval.pl b/cpp/bench/ann/scripts/eval.pl
new file mode 100755
index 0000000000..81c5563d79
--- /dev/null
+++ b/cpp/bench/ann/scripts/eval.pl
@@ -0,0 +1,430 @@
+#!/usr/bin/perl
+
+# =============================================================================
+# Copyright (c) 2020-2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+# in compliance with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software distributed under the License
+# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+# or implied. See the License for the specific language governing permissions and limitations under
+# the License.
+
+use warnings;
+use strict;
+use autodie qw(open close);
+use File::Find;
+use Getopt::Std;
+
+my $QPS = 'QPS';
+my $AVG_LATENCY = 'avg_latency(ms)';
+my $P99_LATENCY = 'p99_latency(ms)';
+my $P999_LATENCY = 'p999_latency(ms)';
+my @CONDITIONS = ([$QPS, 2000], ['recall', 0.9], ['recall', 0.95]);
+
+
+my $USAGE = << 'END';
+usage: [-f] [-l avg|p99|p999] [-o output.csv] groundtruth.neighbors.ibin result_paths...
+  result_paths... are paths to the search result files.
+    Can specify multiple paths.
+    For each of them, if it's a directory, all the .txt files found under
+    it recursively will be regarded as inputs.
+
+  -f: force to recompute recall and update it in result file if needed
+  -l: output search latency rather than QPS. Available options:
+        "avg" for average latency;
+        "p99" for 99th percentile latency;
+        "p999" for 99.9th percentile latency.
+  -o: also write result to a csv file
+END
+
+
+my %opt;
+getopts('fl:o:', \%opt)
+  or die $USAGE;
+my $force_calc_recall = exists $opt{f} ? 1 : 0;
+my $csv_file;
+$csv_file = $opt{o} if exists $opt{o};
+my $metric = $QPS;
+if (exists $opt{l}) {
+    my $option = $opt{l};
+    if ($option eq 'avg') {
+        $metric = $AVG_LATENCY;
+    }
+    elsif ($option eq 'p99') {
+        $metric = $P99_LATENCY;
+    }
+    elsif ($option eq 'p999') {
+        $metric = $P999_LATENCY;
+    }
+    else {
+        die
+          "[error] illegal value for '-l': '$option'. Must be 'avg', 'p99' or 'p999'\n";
+    }
+}
+
+@ARGV >= 2
+  or die $USAGE;
+
+
+my $truth_file = shift @ARGV;
+my ($k, $dataset, $distance, $results) = get_all_results($metric, @ARGV);
+if (!defined $k) {
+    print STDERR "no result file found\n";
+    exit -1;
+}
+print STDERR "dataset = $dataset, distance = $distance, k = $k\n\n";
+calc_missing_recall($results, $truth_file, $force_calc_recall);
+
+my @results = sort {
+         $a->{name} cmp $b->{name}
+      or $a->{recall} <=> $b->{recall}
+      or $b->{qps} <=> $a->{qps}
+} @$results;
+printf("%-60s  %6s %16s  %s\n", '', 'Recall', $metric, 'search_param');
+for my $result (@results) {
+    my $fmt = ($metric eq $QPS) ? '%16.1f' : '%16.3f';
+    my $qps = $result->{qps};
+    $qps *= 1000 if $metric ne $QPS;    # the unit of latency is ms
+    printf("%-60s  %6.4f ${fmt}  %s\n",
+        $result->{name}, $result->{recall}, $qps, $result->{search_param});
+}
+if (defined $csv_file) {
+    open my $fh, '>', $csv_file;
+    print {$fh} ",Recall,${metric},search_param\n";
+    for my $result (@results) {
+        my $qps = $result->{qps};
+        $qps *= 1000 if $metric ne $QPS;
+        printf {$fh} (
+            "%s,%.4f,%.3f,%s\n", $result->{name}, $result->{recall},
+            $qps, $result->{search_param}
+        );
+    }
+}
+print "\n";
+calc_and_print_estimation($results, $metric, \@CONDITIONS);
+
+
+
+
+sub read_result {
+    my ($fname) = @_;
+    open my $fh, '<', $fname;
+    my %attr;
+    while (<$fh>) {
+        chomp;
+        next if /^\s*$/;
+        my $pos = index($_, ':');
+        $pos != -1
+          or die "[error] no ':' is found: '$_'\n";
+        my $key = substr($_, 0, $pos);
+        my $val = substr($_, $pos + 1);
+        $key =~ s/^\s+|\s+$//g;
+        $val =~ s/^\s+|\s+$//g;
+
+        # old version benchmark compatible
+        if ($key eq 'search_time') {
+            $key = 'average_search_time';
+            $val *= $attr{batch_size};
+        }
+        $attr{$key} = $val;
+    }
+    return \%attr;
+}
+
+sub overwrite_recall_to_result {
+    my ($fname, $recall) = @_;
+    open my $fh_in, '<', $fname;
+    $recall = sprintf("%f", $recall);
+    my $out;
+    while (<$fh_in>) {
+        s/^recall: .*/recall: $recall/;
+        $out .= $_;
+    }
+    close $fh_in;
+
+    open my $fh_out, '>', $fname;
+    print {$fh_out} $out;
+}
+
+sub append_recall_to_result {
+    my ($fname, $recall) = @_;
+    open my $fh, '>>', $fname;
+    printf {$fh} ("recall: %f\n", $recall);
+}
+
+sub get_all_results {
+    my ($metric) = shift @_;
+
+    my %fname;
+    my $wanted = sub {
+        if (-f && /\.txt$/) {
+            $fname{$File::Find::name} = 1;
+        }
+    };
+    find($wanted, @_);
+
+    my $k;
+    my $dataset;
+    my $distance;
+    my @results;
+    for my $f (sort keys %fname) {
+        print STDERR "reading $f ...\n";
+        my $attr = read_result($f);
+        if (!defined $k) {
+            $k = $attr->{k};
+            $dataset = $attr->{dataset};
+            $distance = $attr->{distance};
+        }
+        else {
+            $attr->{k} eq $k
+              or die "[error] k should be $k, but is $attr->{k} in $f\n";
+            $attr->{dataset} eq $dataset
+              or die
+              "[error] dataset should be $dataset, but is $attr->{dataset} in $f\n";
+            $attr->{distance} eq $distance
+              or die
+              "[error] distance should be $distance, but is $attr->{distance} in $f\n";
+        }
+
+        my $batch_size = $attr->{batch_size};
+        $batch_size =~ s/000000$/M/;
+        $batch_size =~ s/000$/K/;
+        my $search_param = $attr->{search_param};
+        $search_param =~ s/^{//;
+        $search_param =~ s/}$//;
+        $search_param =~ s/,/ /g;
+        $search_param =~ s/"//g;
+
+        my $qps;
+        if ($metric eq $QPS) {
+            $qps = $attr->{batch_size} / $attr->{average_search_time};
+        }
+        elsif ($metric eq $AVG_LATENCY) {
+            $qps = $attr->{average_search_time};
+        }
+        elsif ($metric eq $P99_LATENCY) {
+            exists $attr->{p99_search_time}
+              or die "[error] p99_search_time is not found\n";
+            $qps = $attr->{p99_search_time};
+        }
+        elsif ($metric eq $P999_LATENCY) {
+            exists $attr->{p999_search_time}
+              or die "[error] p999_search_time is not found\n";
+            $qps = $attr->{p999_search_time};
+        }
+        else {
+            die "[error] unknown latency type: '$metric'\n";
+        }
+        my $result = {
+            file => $f,
+            name => "$attr->{name}-batch${batch_size}",
+            search_param => $search_param,
+            qps => $qps,
+        };
+
+        if (exists $attr->{recall}) {
+            $result->{recall} = $attr->{recall};
+        }
+        push @results, $result;
+    }
+    return $k, $dataset, $distance, \@results;
+}
+
+sub read_ibin {
+    my ($fname) = @_;
+
+    open my $fh, '<:raw', $fname;
+    my $raw;
+
+    read($fh, $raw, 8);
+    my ($nrows, $dim) = unpack('LL', $raw);
+
+    my $expected_size = 8 + $nrows * $dim * 4;
+    my $size = (stat($fh))[7];
+    $size == $expected_size
+      or die(
+        "[error] expected size is $expected_size, but actual size is $size\n");
+
+    read($fh, $raw, $nrows * $dim * 4) == $nrows * $dim * 4
+      or die "[error] read $fname failed\n";
+    my @data = unpack('l' x ($nrows * $dim), $raw);
+    return \@data, $nrows, $dim;
+}
+
+sub pick_k_neighbors {
+    my ($neighbors, $nrows, $ncols, $k) = @_;
+
+    my @res;
+    for my $i (0 .. $nrows - 1) {
+        my %neighbor_set;
+        for my $j (0 .. $k - 1) {
+            $neighbor_set{$neighbors->[$i * $ncols + $j]} = 1;
+        }
+        push @res, \%neighbor_set;
+    }
+    return \@res;
+}
+
+
+sub calc_recall {
+    my ($truth_k_neighbors, $result_neighbors, $nrows, $k) = @_;
+
+    my $recall = 0;
+    for my $i (0 .. $nrows - 1) {
+        my $tp = 0;
+        for my $j (0 .. $k - 1) {
+            my $neighbor = $result_neighbors->[$i * $k + $j];
+            ++$tp if exists $truth_k_neighbors->[$i]{$neighbor};
+        }
+        $recall += $tp;
+    }
+    return $recall / $k / $nrows;
+}
+
+sub calc_missing_recall {
+    my ($results, $truth_file, $force_calc_recall) = @_;
+
+    my $need_calc_recall = grep { !exists $_->{recall} } @$results;
+    return unless $need_calc_recall || $force_calc_recall;
+
+    my ($truth_neighbors, $nrows, $truth_k) = read_ibin($truth_file);
+    $truth_k >= $k
+      or die "[error] ground truth k ($truth_k) < k($k)\n";
+    my $truth_k_neighbors =
+      pick_k_neighbors($truth_neighbors, $nrows, $truth_k, $k);
+
+    for my $result (@$results) {
+        next if exists $result->{recall} && !$force_calc_recall;
+
+        my $result_bin_file = $result->{file};
+        $result_bin_file =~ s/txt$/ibin/;
+        print STDERR "calculating recall for $result_bin_file ...\n";
+        my ($result_neighbors, $result_nrows, $result_k) =
+          read_ibin($result_bin_file);
+        $result_k == $k
+          or die
+          "[error] k should be $k, but is $result_k in $result_bin_file\n";
+        $result_nrows == $nrows
+          or die
+          "[error] #row should be $nrows, but is $result_nrows in $result_bin_file\n";
+
+        my $recall =
+          calc_recall($truth_k_neighbors, $result_neighbors, $nrows, $k);
+        if (exists $result->{recall}) {
+            my $new_value = sprintf("%f", $recall);
+            if ($result->{recall} ne $new_value) {
+                print "update recall: $result->{recall} -> $new_value\n";
+                overwrite_recall_to_result($result->{file}, $recall);
+            }
+        }
+        else {
+            append_recall_to_result($result->{file}, $recall);
+        }
+        $result->{recall} = $recall;
+    }
+}
+
+
+sub estimate {
+    my ($results, $condition, $value) = @_;
+    my %point_of;
+    for my $result (@$results) {
+        my $point;
+        if ($condition eq 'recall') {
+            $point = [$result->{recall}, $result->{qps}];
+        }
+        else {
+            $point = [$result->{qps}, $result->{recall}];
+        }
+        push @{$point_of{$result->{name}}}, $point;
+    }
+
+    my @names = sort keys %point_of;
+    my @result;
+    for my $name (@names) {
+        my @points = sort { $a->[0] <=> $b->[0] } @{$point_of{$name}};
+        if ($value < $points[0][0] || $value > $points[$#points][0]) {
+            push @result, -1;
+            next;
+        }
+        elsif ($value == $points[0][0]) {
+            push @result, $points[0][1];
+            next;
+        }
+
+        for my $i (1 .. $#points) {
+            if ($points[$i][0] >= $value) {
+                push @result,
+                  linear_interpolation($value, @{$points[$i - 1]},
+                    @{$points[$i]});
+                last;
+            }
+        }
+    }
+    return \@names, \@result;
+}
+
+sub linear_interpolation {
+    my ($x, $x1, $y1, $x2, $y2) = @_;
+    return $y1 + ($x - $x1) * ($y2 - $y1) / ($x2 - $x1);
+}
+
+sub merge {
+    my ($all, $new, $scale) = @_;
+    @$all == @$new
+      or die "[error] length is not equal\n";
+    for my $i (0 .. @$all - 1) {
+        push @{$all->[$i]}, $new->[$i] * $scale;
+    }
+}
+
+sub calc_and_print_estimation {
+    my ($results, $metric, $conditions) = @_;
+
+    my @conditions = grep {
+        my $target = $_->[0];
+        if ($target eq 'recall' || $target eq $metric) {
+            1;
+        }
+        else {
+                 $target eq $QPS
+              || $target eq $AVG_LATENCY
+              || $target eq $P99_LATENCY
+              || $target eq $P999_LATENCY
+              or die "[error] unknown condition: '$target'\n";
+            0;
+        }
+    } @$conditions;
+
+    my @headers = map {
+        my $header;
+        if ($_->[0] eq 'recall') {
+            $header = $metric . '@recall' . $_->[1];
+        }
+        elsif ($_->[0] eq $metric) {
+            $header = 'recall@' . $metric . $_->[1];
+        }
+        $header;
+    } @conditions;
+
+    my $scale = ($metric eq $QPS) ? 1 : 1000;
+    my $estimations;
+    for my $condition (@conditions) {
+        my ($names, $estimate) = estimate($results, @$condition);
+        if (!defined $estimations) {
+            @$estimations = map { [$_] } @$names;
+        }
+        merge($estimations, $estimate, $scale);
+    }
+
+    my $fmt = "%-60s" . ("  %16s" x @headers) . "\n";
+    printf($fmt, '', @headers);
+    $fmt =~ s/16s/16.4f/g;
+    for (@$estimations) {
+        printf($fmt, @$_);
+    }
+}
diff --git a/cpp/bench/ann/scripts/fbin_to_f16bin.py b/cpp/bench/ann/scripts/fbin_to_f16bin.py
new file mode 100755
index 0000000000..4ea8988d87
--- /dev/null
+++ b/cpp/bench/ann/scripts/fbin_to_f16bin.py
@@ -0,0 +1,46 @@
+# =============================================================================
+# Copyright (c) 2020-2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+# in compliance with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software distributed under the License
+# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+# or implied. See the License for the specific language governing permissions and limitations under
+# the License.
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import print_function
+import sys
+import numpy as np
+
+
+def read_fbin(fname):
+    shape = np.fromfile(fname, dtype=np.uint32, count=2)
+    if float(shape[0]) * shape[1] * 4 > 2000000000:
+        data = np.memmap(fname, dtype=np.float32, offset=8, mode="r").reshape(
+            shape
+        )
+    else:
+        data = np.fromfile(fname, dtype=np.float32, offset=8).reshape(shape)
+    return data
+
+
+def write_bin(fname, data):
+    with open(fname, "wb") as f:
+        np.asarray(data.shape, dtype=np.uint32).tofile(f)
+        data.tofile(f)
+
+
+if len(sys.argv) != 3:
+    print(
+        "usage: %s input.fbin output.f16bin" % (sys.argv[0]),
+        file=sys.stderr,
+    )
+    sys.exit(-1)
+
+data = read_fbin(sys.argv[1]).astype(np.float16)
+write_bin(sys.argv[2], data)
diff --git a/cpp/bench/ann/scripts/hdf5_to_fbin.py b/cpp/bench/ann/scripts/hdf5_to_fbin.py
new file mode 100755
index 0000000000..cfeb184ea8
--- /dev/null
+++ b/cpp/bench/ann/scripts/hdf5_to_fbin.py
@@ -0,0 +1,85 @@
+# =============================================================================
+# Copyright (c) 2020-2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+# in compliance with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software distributed under the License
+# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+# or implied. See the License for the specific language governing permissions and limitations under
+# the License.
+
+import sys
+import numpy as np
+import h5py
+
+
+def normalize(x):
+    norm = np.linalg.norm(x, axis=1)
+    return (x.T / norm).T
+
+
+def write_bin(fname, data):
+    with open(fname, "wb") as f:
+        np.asarray(data.shape, dtype=np.uint32).tofile(f)
+        data.tofile(f)
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2 and len(sys.argv) != 3:
+        print(
+            "usage: %s [-n] <input>.hdf5\n" % (sys.argv[0]),
+            "  -n: normalize base/query set\n",
+            "outputs: <input>.base.fbin\n",
+            "         <input>.query.fbin\n",
+            "         <input>.groundtruth.neighbors.ibin\n",
+            "         <input>.groundtruth.distances.fbin",
+            file=sys.stderr,
+        )
+        sys.exit(-1)
+
+    need_normalize = False
+    if len(sys.argv) == 3:
+        assert sys.argv[1] == "-n"
+        need_normalize = True
+    fname_prefix = sys.argv[-1]
+    assert fname_prefix.endswith(".hdf5")
+    fname_prefix = fname_prefix[:-5]
+
+    hdf5 = h5py.File(sys.argv[-1], "r")
+    assert (
+        hdf5.attrs["distance"] == "angular"
+        or hdf5.attrs["distance"] == "euclidean"
+    )
+    assert hdf5["train"].dtype == np.float32
+    assert hdf5["test"].dtype == np.float32
+    assert hdf5["neighbors"].dtype == np.int32
+    assert hdf5["distances"].dtype == np.float32
+
+    base = hdf5["train"][:]
+    query = hdf5["test"][:]
+    if need_normalize:
+        base = normalize(base)
+        query = normalize(query)
+    elif hdf5.attrs["distance"] == "angular":
+        print(
+            "warning: input has angular distance, specify -n to normalize base/query set!\n"
+        )
+
+    output_fname = fname_prefix + ".base.fbin"
+    print("writing", output_fname, "...")
+    write_bin(output_fname, base)
+
+    output_fname = fname_prefix + ".query.fbin"
+    print("writing", output_fname, "...")
+    write_bin(output_fname, query)
+
+    output_fname = fname_prefix + ".groundtruth.neighbors.ibin"
+    print("writing", output_fname, "...")
+    write_bin(output_fname, hdf5["neighbors"][:])
+
+    output_fname = fname_prefix + ".groundtruth.distances.fbin"
+    print("writing", output_fname, "...")
+    write_bin(output_fname, hdf5["distances"][:])
diff --git a/cpp/bench/ann/scripts/split_groundtruth.pl b/cpp/bench/ann/scripts/split_groundtruth.pl
new file mode 100755
index 0000000000..b0a59f806c
--- /dev/null
+++ b/cpp/bench/ann/scripts/split_groundtruth.pl
@@ -0,0 +1,45 @@
+#!/usr/bin/perl
+
+# =============================================================================
+# Copyright (c) 2020-2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+# in compliance with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software distributed under the License
+# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+# or implied. See the License for the specific language governing permissions and limitations under
+# the License.
+
+use warnings;
+use strict;
+use autodie qw(open close);
+
+
+@ARGV == 2
+  or die "usage: $0 input output_prefix\n";
+
+open my $fh, '<:raw', $ARGV[0];
+
+my $raw;
+read($fh, $raw, 8);
+my ($nrows, $dim) = unpack('LL', $raw);
+
+my $expected_size = 8 + $nrows * $dim * (4 + 4);
+my $size = (stat($fh))[7];
+$size == $expected_size
+  or die("error: expected size is $expected_size, but actual size is $size\n");
+
+
+open my $fh_out1, '>:raw', "$ARGV[1].neighbors.ibin";
+open my $fh_out2, '>:raw', "$ARGV[1].distances.fbin";
+
+print {$fh_out1} $raw;
+print {$fh_out2} $raw;
+
+read($fh, $raw, $nrows * $dim * 4);
+print {$fh_out1} $raw;
+read($fh, $raw, $nrows * $dim * 4);
+print {$fh_out2} $raw;
diff --git a/cpp/bench/ann/src/common/ann_types.hpp b/cpp/bench/ann/src/common/ann_types.hpp
new file mode 100644
index 0000000000..8f73896e07
--- /dev/null
+++ b/cpp/bench/ann/src/common/ann_types.hpp
@@ -0,0 +1,88 @@
+
+
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#pragma once
+#include <string>
+#include <vector>
+
+#include <cuda_runtime_api.h>
+
+namespace raft::bench::ann {
+
+enum class Metric {
+  kInnerProduct,
+  kEuclidean,
+};
+
+enum class MemoryType {
+  Host,
+  HostMmap,
+  Device,
+};
+
+struct AlgoProperty {
+  MemoryType dataset_memory_type;
+  // neighbors/distances should have same memory type as queries
+  MemoryType query_memory_type;
+  bool need_dataset_when_search;
+};
+
+template <typename T>
+class ANN {
+ public:
+  struct AnnSearchParam {
+    virtual ~AnnSearchParam() = default;
+  };
+
+  ANN(Metric metric, int dim) : metric_(metric), dim_(dim) {}
+  virtual ~ANN() = default;
+
+  virtual void build(const T* dataset, size_t nrow, cudaStream_t stream = 0) = 0;
+
+  virtual void set_search_param(const AnnSearchParam& param) = 0;
+  // TODO: this assumes that an algorithm can always return k results.
+  // This is not always possible.
+  virtual void search(const T* queries,
+                      int batch_size,
+                      int k,
+                      size_t* neighbors,
+                      float* distances,
+                      cudaStream_t stream = 0) const = 0;
+
+  virtual void save(const std::string& file) const = 0;
+  virtual void load(const std::string& file)       = 0;
+
+  virtual AlgoProperty get_property() const = 0;
+
+  // Some algorithms don't save the building dataset in their indices.
+  // So they should be given the access to that dataset during searching.
+  // The advantage of this way is that index has smaller size
+  // and many indices can share one dataset.
+  //
+  // AlgoProperty::need_dataset_when_search of such algorithm should be true,
+  // and set_search_dataset() should save the passed-in pointer somewhere.
+  // The client code should call set_search_dataset() before searching,
+  // and should not release dataset before searching is finished.
+  virtual void set_search_dataset(const T* /*dataset*/, size_t /*nrow*/){};
+
+ protected:
+  Metric metric_;
+  int dim_;
+};
+
+}  // namespace raft::bench::ann
diff --git a/cpp/bench/ann/src/common/benchmark.hpp b/cpp/bench/ann/src/common/benchmark.hpp
new file mode 100644
index 0000000000..b4d8fbeee3
--- /dev/null
+++ b/cpp/bench/ann/src/common/benchmark.hpp
@@ -0,0 +1,591 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#ifdef NVTX
+#include <nvToolsExt.h>
+#endif
+#include <unistd.h>
+
+#include <algorithm>
+#include <cmath>
+#include <cstdint>
+#include <fstream>
+#include <iostream>
+#include <limits>
+#include <memory>
+#include <numeric>
+#include <string>
+#include <unordered_set>
+#include <vector>
+
+#include "benchmark_util.hpp"
+#include "conf.h"
+#include "dataset.h"
+#include "util.h"
+
+using std::cerr;
+using std::cout;
+using std::endl;
+using std::string;
+using std::to_string;
+using std::unordered_set;
+using std::vector;
+
+namespace raft::bench::ann {
+
+inline bool check_file_exist(const std::vector<string>& files)
+{
+  bool ret = true;
+  std::unordered_set<std::string> processed;
+  for (const auto& file : files) {
+    if (processed.find(file) == processed.end() && !file_exists(file)) {
+      log_error("file '%s' doesn't exist or is not a regular file", file.c_str());
+      ret = false;
+    }
+    processed.insert(file);
+  }
+  return ret;
+}
+
+inline bool check_file_not_exist(const std::vector<std::string>& files, bool force_overwrite)
+{
+  bool ret = true;
+  for (const auto& file : files) {
+    if (file_exists(file)) {
+      if (force_overwrite) {
+        log_warn("'%s' already exists, will overwrite it", file.c_str());
+      } else {
+        log_error("'%s' already exists, use '-f' to force overwriting", file.c_str());
+        ret = false;
+      }
+    }
+  }
+  return ret;
+}
+
+inline bool check_no_duplicate_file(const std::vector<std::string>& files)
+{
+  bool ret = true;
+  std::unordered_set<string> processed;
+  for (const auto& file : files) {
+    if (processed.find(file) != processed.end()) {
+      log_error("'%s' occurs more than once as output file, would be overwritten", file.c_str());
+      ret = false;
+    }
+    processed.insert(file);
+  }
+  return ret;
+}
+
+inline bool mkdir(const std::vector<std::string>& dirs)
+{
+  std::unordered_set<string> processed;
+  for (const auto& dir : dirs) {
+    if (processed.find(dir) == processed.end() && !dir_exists(dir)) {
+      if (create_dir(dir)) {
+        log_info("mkdir '%s'", dir.c_str());
+      } else {
+        log_error("fail to create output directory '%s'", dir.c_str());
+        // won't create any other dir when problem occurs
+        return false;
+      }
+    }
+    processed.insert(dir);
+  }
+  return true;
+}
+
+inline bool check(const std::vector<Configuration::Index>& indices,
+                  bool build_mode,
+                  bool force_overwrite)
+{
+  std::vector<std::string> files_should_exist;
+  std::vector<std::string> dirs_should_exist;
+  std::vector<std::string> output_files;
+  for (const auto& index : indices) {
+    if (build_mode) {
+      output_files.push_back(index.file);
+      output_files.push_back(index.file + ".txt");
+
+      auto pos = index.file.rfind('/');
+      if (pos != std::string::npos) { dirs_should_exist.push_back(index.file.substr(0, pos)); }
+    } else {
+      files_should_exist.push_back(index.file);
+      files_should_exist.push_back(index.file + ".txt");
+
+      output_files.push_back(index.search_result_file + ".0.ibin");
+      output_files.push_back(index.search_result_file + ".0.txt");
+
+      auto pos = index.search_result_file.rfind('/');
+      if (pos != std::string::npos) {
+        dirs_should_exist.push_back(index.search_result_file.substr(0, pos));
+      }
+    }
+  }
+
+  bool ret = true;
+  if (!check_file_exist(files_should_exist)) { ret = false; }
+  if (!check_file_not_exist(output_files, force_overwrite)) { ret = false; }
+  if (!check_no_duplicate_file(output_files)) { ret = false; }
+  if (ret && !mkdir(dirs_should_exist)) { ret = false; }
+  return ret;
+}
+
+inline void write_build_info(const std::string& file_prefix,
+                             const std::string& dataset,
+                             const std::string& distance,
+                             const std::string& name,
+                             const std::string& algo,
+                             const std::string& build_param,
+                             float build_time)
+{
+  std::ofstream ofs(file_prefix + ".txt");
+  if (!ofs) { throw std::runtime_error("can't open build info file: " + file_prefix + ".txt"); }
+  ofs << "dataset: " << dataset << "\n"
+      << "distance: " << distance << "\n"
+      << "\n"
+      << "name: " << name << "\n"
+      << "algo: " << algo << "\n"
+      << "build_param: " << build_param << "\n"
+      << "build_time: " << build_time << endl;
+  ofs.close();
+  if (!ofs) { throw std::runtime_error("can't write to build info file: " + file_prefix + ".txt"); }
+}
+
+template <typename T>
+void build(const Dataset<T>* dataset, const std::vector<Configuration::Index>& indices)
+{
+  cudaStream_t stream;
+  RAFT_CUDA_TRY(cudaStreamCreate(&stream));
+
+  log_info(
+    "base set from dataset '%s', #vector = %zu", dataset->name().c_str(), dataset->base_set_size());
+
+  for (const auto& index : indices) {
+    log_info("creating algo '%s', param=%s", index.algo.c_str(), index.build_param.dump().c_str());
+    auto algo          = create_algo<T>(index.algo,
+                               dataset->distance(),
+                               dataset->dim(),
+                               index.refine_ratio,
+                               index.build_param,
+                               index.dev_list);
+    auto algo_property = algo->get_property();
+
+    const T* base_set_ptr = nullptr;
+    if (algo_property.dataset_memory_type == MemoryType::Host) {
+      log_info("%s", "loading base set to memory");
+      base_set_ptr = dataset->base_set();
+    } else if (algo_property.dataset_memory_type == MemoryType::HostMmap) {
+      log_info("%s", "mapping base set to memory");
+      base_set_ptr = dataset->mapped_base_set();
+    } else if (algo_property.dataset_memory_type == MemoryType::Device) {
+      log_info("%s", "loading base set to GPU");
+      base_set_ptr = dataset->base_set_on_gpu();
+    }
+
+    log_info("building index '%s'", index.name.c_str());
+    RAFT_CUDA_TRY(cudaStreamSynchronize(stream));
+#ifdef NVTX
+    nvtxRangePush("build");
+#endif
+    Timer timer;
+    algo->build(base_set_ptr, dataset->base_set_size(), stream);
+    RAFT_CUDA_TRY(cudaStreamSynchronize(stream));
+    float elapsed_ms = timer.elapsed_ms();
+#ifdef NVTX
+    nvtxRangePop();
+#endif
+    log_info("built index in %.2f seconds", elapsed_ms / 1000.0f);
+    RAFT_CUDA_TRY(cudaDeviceSynchronize());
+    RAFT_CUDA_TRY(cudaPeekAtLastError());
+
+    algo->save(index.file);
+    write_build_info(index.file,
+                     dataset->name(),
+                     dataset->distance(),
+                     index.name,
+                     index.algo,
+                     index.build_param.dump(),
+                     elapsed_ms / 1000.0f);
+    log_info("saved index to %s", index.file.c_str());
+  }
+
+  RAFT_CUDA_TRY(cudaStreamDestroy(stream));
+}
+
+inline void write_search_result(const std::string& file_prefix,
+                                const std::string& dataset,
+                                const std::string& distance,
+                                const std::string& name,
+                                const std::string& algo,
+                                const std::string& build_param,
+                                const std::string& search_param,
+                                int batch_size,
+                                int run_count,
+                                int k,
+                                float search_time_average,
+                                float search_time_p99,
+                                float search_time_p999,
+                                const int* neighbors,
+                                size_t query_set_size)
+{
+  std::ofstream ofs(file_prefix + ".txt");
+  if (!ofs) { throw std::runtime_error("can't open search result file: " + file_prefix + ".txt"); }
+  ofs << "dataset: " << dataset << "\n"
+      << "distance: " << distance << "\n"
+      << "\n"
+      << "name: " << name << "\n"
+      << "algo: " << algo << "\n"
+      << "build_param: " << build_param << "\n"
+      << "search_param: " << search_param << "\n"
+      << "\n"
+      << "batch_size: " << batch_size << "\n"
+      << "run_count: " << run_count << "\n"
+      << "k: " << k << "\n"
+      << "average_search_time: " << search_time_average << endl;
+  if (search_time_p99 != std::numeric_limits<float>::max()) {
+    ofs << "p99_search_time: " << search_time_p99 << endl;
+  }
+  if (search_time_p999 != std::numeric_limits<float>::max()) {
+    ofs << "p999_search_time: " << search_time_p999 << endl;
+  }
+  ofs.close();
+  if (!ofs) {
+    throw std::runtime_error("can't write to search result file: " + file_prefix + ".txt");
+  }
+
+  BinFile<int> neighbors_file(file_prefix + ".ibin", "w");
+  neighbors_file.write(neighbors, query_set_size, k);
+}
+
+template <typename T>
+inline void search(const Dataset<T>* dataset, const std::vector<Configuration::Index>& indices)
+{
+  if (indices.empty()) { return; }
+  cudaStream_t stream;
+  RAFT_CUDA_TRY(cudaStreamCreate(&stream));
+
+  log_info("loading query set from dataset '%s', #vector = %zu",
+           dataset->name().c_str(),
+           dataset->query_set_size());
+  const T* query_set = dataset->query_set();
+  // query set is usually much smaller than base set, so load it eagerly
+  const T* d_query_set  = dataset->query_set_on_gpu();
+  size_t query_set_size = dataset->query_set_size();
+
+  // currently all indices has same batch_size, k and run_count
+  const int batch_size = indices[0].batch_size;
+  const int k          = indices[0].k;
+  const int run_count  = indices[0].run_count;
+  log_info(
+    "basic search parameters: batch_size = %d, k = %d, run_count = %d", batch_size, k, run_count);
+  if (query_set_size % batch_size != 0) {
+    log_warn("query set size (%zu) % batch size (%d) != 0, the size of last batch is %zu",
+             query_set_size,
+             batch_size,
+             query_set_size % batch_size);
+  }
+  const size_t num_batches = (query_set_size - 1) / batch_size + 1;
+  std::size_t* neighbors   = new std::size_t[query_set_size * k];
+  int* neighbors_buf       = new int[query_set_size * k];
+  float* distances         = new float[query_set_size * k];
+  std::vector<float> search_times;
+  search_times.reserve(num_batches);
+  std::size_t* d_neighbors;
+  float* d_distances;
+  RAFT_CUDA_TRY(cudaMalloc((void**)&d_neighbors, query_set_size * k * sizeof(*d_neighbors)));
+  RAFT_CUDA_TRY(cudaMalloc((void**)&d_distances, query_set_size * k * sizeof(*d_distances)));
+
+  for (const auto& index : indices) {
+    log_info("creating algo '%s', param=%s", index.algo.c_str(), index.build_param.dump().c_str());
+    auto algo          = create_algo<T>(index.algo,
+                               dataset->distance(),
+                               dataset->dim(),
+                               index.refine_ratio,
+                               index.build_param,
+                               index.dev_list);
+    auto algo_property = algo->get_property();
+
+    log_info("loading index '%s' from file '%s'", index.name.c_str(), index.file.c_str());
+    algo->load(index.file);
+
+    const T* this_query_set     = query_set;
+    std::size_t* this_neighbors = neighbors;
+    float* this_distances       = distances;
+    if (algo_property.query_memory_type == MemoryType::Device) {
+      this_query_set = d_query_set;
+      this_neighbors = d_neighbors;
+      this_distances = d_distances;
+    }
+
+    if (algo_property.need_dataset_when_search) {
+      log_info("loading base set from dataset '%s', #vector = %zu",
+               dataset->name().c_str(),
+               dataset->base_set_size());
+      const T* base_set_ptr = nullptr;
+      if (algo_property.dataset_memory_type == MemoryType::Host) {
+        log_info("%s", "loading base set to memory");
+        base_set_ptr = dataset->base_set();
+      } else if (algo_property.dataset_memory_type == MemoryType::HostMmap) {
+        log_info("%s", "mapping base set to memory");
+        base_set_ptr = dataset->mapped_base_set();
+      } else if (algo_property.dataset_memory_type == MemoryType::Device) {
+        log_info("%s", "loading base set to GPU");
+        base_set_ptr = dataset->base_set_on_gpu();
+      }
+      algo->set_search_dataset(base_set_ptr, dataset->base_set_size());
+    }
+
+    for (int i = 0, end_i = index.search_params.size(); i != end_i; ++i) {
+      auto p_param = create_search_param<T>(index.algo, index.search_params[i]);
+      algo->set_search_param(*p_param);
+      log_info("search with param: %s", index.search_params[i].dump().c_str());
+
+      if (algo_property.query_memory_type == MemoryType::Device) {
+        RAFT_CUDA_TRY(cudaMemset(d_neighbors, 0, query_set_size * k * sizeof(*d_neighbors)));
+        RAFT_CUDA_TRY(cudaMemset(d_distances, 0, query_set_size * k * sizeof(*d_distances)));
+      } else {
+        memset(neighbors, 0, query_set_size * k * sizeof(*neighbors));
+        memset(distances, 0, query_set_size * k * sizeof(*distances));
+      }
+
+      float best_search_time_average = std::numeric_limits<float>::max();
+      float best_search_time_p99     = std::numeric_limits<float>::max();
+      float best_search_time_p999    = std::numeric_limits<float>::max();
+      for (int run = 0; run < run_count; ++run) {
+        log_info("run %d / %d", run + 1, run_count);
+        for (std::size_t batch_id = 0; batch_id < num_batches; ++batch_id) {
+          std::size_t row       = batch_id * batch_size;
+          int actual_batch_size = (batch_id == num_batches - 1) ? query_set_size - row : batch_size;
+          RAFT_CUDA_TRY(cudaStreamSynchronize(stream));
+#ifdef NVTX
+          string nvtx_label = "batch" + to_string(batch_id);
+          if (run_count != 1) { nvtx_label = "run" + to_string(run) + "-" + nvtx_label; }
+          if (batch_id == 10) {
+            run = run_count - 1;
+            break;
+          }
+#endif
+          Timer timer;
+#ifdef NVTX
+          nvtxRangePush(nvtx_label.c_str());
+#endif
+          algo->search(this_query_set + row * dataset->dim(),
+                       actual_batch_size,
+                       k,
+                       this_neighbors + row * k,
+                       this_distances + row * k,
+                       stream);
+          RAFT_CUDA_TRY(cudaStreamSynchronize(stream));
+          float elapsed_ms = timer.elapsed_ms();
+#ifdef NVTX
+          nvtxRangePop();
+#endif
+          // If the size of the last batch is less than batch_size, don't count it for
+          // search time. But neighbors of the last batch will still be filled, so it's
+          // counted for recall calculation.
+          if (actual_batch_size == batch_size) {
+            search_times.push_back(elapsed_ms / 1000.0f);  // in seconds
+          }
+        }
+
+        float search_time_average =
+          std::accumulate(search_times.cbegin(), search_times.cend(), 0.0f) / search_times.size();
+        best_search_time_average = std::min(best_search_time_average, search_time_average);
+
+        if (search_times.size() >= 100) {
+          std::sort(search_times.begin(), search_times.end());
+
+          auto calc_percentile_pos = [](float percentile, size_t N) {
+            return static_cast<size_t>(std::ceil(percentile / 100.0 * N)) - 1;
+          };
+
+          float search_time_p99 = search_times[calc_percentile_pos(99, search_times.size())];
+          best_search_time_p99  = std::min(best_search_time_p99, search_time_p99);
+
+          if (search_times.size() >= 1000) {
+            float search_time_p999 = search_times[calc_percentile_pos(99.9, search_times.size())];
+            best_search_time_p999  = std::min(best_search_time_p999, search_time_p999);
+          }
+        }
+        search_times.clear();
+      }
+      RAFT_CUDA_TRY(cudaDeviceSynchronize());
+      RAFT_CUDA_TRY(cudaPeekAtLastError());
+
+      if (algo_property.query_memory_type == MemoryType::Device) {
+        RAFT_CUDA_TRY(cudaMemcpy(neighbors,
+                                 d_neighbors,
+                                 query_set_size * k * sizeof(*d_neighbors),
+                                 cudaMemcpyDeviceToHost));
+        RAFT_CUDA_TRY(cudaMemcpy(distances,
+                                 d_distances,
+                                 query_set_size * k * sizeof(*d_distances),
+                                 cudaMemcpyDeviceToHost));
+      }
+
+      for (size_t j = 0; j < query_set_size * k; ++j) {
+        neighbors_buf[j] = neighbors[j];
+      }
+      write_search_result(index.search_result_file + "." + to_string(i),
+                          dataset->name(),
+                          dataset->distance(),
+                          index.name,
+                          index.algo,
+                          index.build_param.dump(),
+                          index.search_params[i].dump(),
+                          batch_size,
+                          index.run_count,
+                          k,
+                          best_search_time_average,
+                          best_search_time_p99,
+                          best_search_time_p999,
+                          neighbors_buf,
+                          query_set_size);
+    }
+
+    log_info("finish searching for index '%s'", index.name.c_str());
+  }
+
+  delete[] neighbors;
+  delete[] neighbors_buf;
+  delete[] distances;
+  RAFT_CUDA_TRY(cudaFree(d_neighbors));
+  RAFT_CUDA_TRY(cudaFree(d_distances));
+  RAFT_CUDA_TRY(cudaStreamDestroy(stream));
+}
+
+inline const std::string usage(const string& argv0)
+{
+  return "usage: " + argv0 + " -b|s [-c] [-f] [-i index_names] conf.json\n" +
+         "   -b: build mode, will build index\n" +
+         "   -s: search mode, will search using built index\n" +
+         "       one and only one of -b and -s should be specified\n" +
+         "   -c: just check command line options and conf.json are sensible\n" +
+         "       won't build or search\n" + "   -f: force overwriting existing output files\n" +
+         "   -i: by default will build/search all the indices found in conf.json\n" +
+         "       '-i' can be used to select a subset of indices\n" +
+         "       'index_names' is a list of comma-separated index names\n" +
+         "       '*' is allowed as the last character of a name to select all matched indices\n" +
+         "       for example, -i \"hnsw1,hnsw2,faiss\" or -i \"hnsw*,faiss\"";
+}
+
+template <typename T>
+inline int dispatch_benchmark(Configuration& conf,
+                              std::string& index_patterns,
+                              bool force_overwrite,
+                              bool only_check,
+                              bool build_mode,
+                              bool search_mode)
+{
+  try {
+    auto dataset_conf = conf.get_dataset_conf();
+
+    BinDataset<T> dataset(dataset_conf.name,
+                          dataset_conf.base_file,
+                          dataset_conf.subset_first_row,
+                          dataset_conf.subset_size,
+                          dataset_conf.query_file,
+                          dataset_conf.distance);
+
+    vector<Configuration::Index> indices = conf.get_indices(index_patterns);
+    if (!check(indices, build_mode, force_overwrite)) { return -1; }
+
+    std::string message = "will ";
+    message += build_mode ? "build:" : "search:";
+    for (const auto& index : indices) {
+      message += "\n  " + index.name;
+    }
+    log_info("%s", message.c_str());
+
+    if (only_check) {
+      log_info("%s", "all check passed, quit due to option -c");
+      return 0;
+    }
+
+    if (build_mode) {
+      build(&dataset, indices);
+    } else if (search_mode) {
+      search(&dataset, indices);
+    }
+  } catch (const std::exception& e) {
+    log_error("exception occurred: %s", e.what());
+    return -1;
+  }
+
+  return 0;
+}
+
+inline int run_main(int argc, char** argv)
+{
+  bool force_overwrite = false;
+  bool build_mode      = false;
+  bool search_mode     = false;
+  bool only_check      = false;
+  std::string index_patterns("*");
+
+  int opt;
+  while ((opt = getopt(argc, argv, "bscfi:h")) != -1) {
+    switch (opt) {
+      case 'b': build_mode = true; break;
+      case 's': search_mode = true; break;
+      case 'c': only_check = true; break;
+      case 'f': force_overwrite = true; break;
+      case 'i': index_patterns = optarg; break;
+      case 'h': cout << usage(argv[0]) << endl; return -1;
+      default: cerr << "\n" << usage(argv[0]) << endl; return -1;
+    }
+  }
+  if (build_mode == search_mode) {
+    std::cerr << "one and only one of -b and -s should be specified\n\n" << usage(argv[0]) << endl;
+    return -1;
+  }
+  if (argc - optind != 1) {
+    std::cerr << usage(argv[0]) << endl;
+    return -1;
+  }
+  string conf_file = argv[optind];
+
+  std::ifstream conf_stream(conf_file.c_str());
+  if (!conf_stream) {
+    log_error("can't open configuration file: %s", argv[optind]);
+    return -1;
+  }
+
+  try {
+    Configuration conf(conf_stream);
+    std::string dtype = conf.get_dataset_conf().dtype;
+
+    if (dtype == "float") {
+      return dispatch_benchmark<float>(
+        conf, index_patterns, force_overwrite, only_check, build_mode, search_mode);
+    } else if (dtype == "uint8") {
+      return dispatch_benchmark<std::uint8_t>(
+        conf, index_patterns, force_overwrite, only_check, build_mode, search_mode);
+    } else if (dtype == "int8") {
+      return dispatch_benchmark<std::int8_t>(
+        conf, index_patterns, force_overwrite, only_check, build_mode, search_mode);
+    } else {
+      log_error("datatype %s not supported", dtype);
+    }
+
+  } catch (const std::exception& e) {
+    log_error("exception occurred: %s", e.what());
+    return -1;
+  }
+
+  return -1;
+}
+};  // namespace raft::bench::ann
diff --git a/cpp/bench/ann/src/common/benchmark_util.hpp b/cpp/bench/ann/src/common/benchmark_util.hpp
new file mode 100644
index 0000000000..7005883ffc
--- /dev/null
+++ b/cpp/bench/ann/src/common/benchmark_util.hpp
@@ -0,0 +1,33 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#pragma once
+
+#include "ann_types.hpp"
+#include <string>
+
+namespace raft::bench::ann {
+
+inline Metric parse_metric(const std::string& metric_str)
+{
+  if (metric_str == "inner_product") {
+    return raft::bench::ann::Metric::kInnerProduct;
+  } else if (metric_str == "euclidean") {
+    return raft::bench::ann::Metric::kEuclidean;
+  } else {
+    throw std::runtime_error("invalid metric: '" + metric_str + "'");
+  }
+}
+};  // namespace raft::bench::ann
\ No newline at end of file
diff --git a/cpp/bench/ann/src/common/conf.cpp b/cpp/bench/ann/src/common/conf.cpp
new file mode 100644
index 0000000000..f690f68783
--- /dev/null
+++ b/cpp/bench/ann/src/common/conf.cpp
@@ -0,0 +1,151 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#include "conf.h"
+
+#include <iostream>
+#include <stdexcept>
+#include <string>
+#include <unordered_set>
+#include <vector>
+
+#include "util.h"
+
+namespace raft::bench::ann {
+using std::runtime_error;
+using std::string;
+using std::unordered_set;
+using std::vector;
+
+Configuration::Configuration(std::istream& conf_stream)
+{
+  // to enable comments in json
+  auto conf = nlohmann::json::parse(conf_stream, nullptr, true, true);
+
+  parse_dataset_(conf.at("dataset"));
+  parse_index_(conf.at("index"), conf.at("search_basic_param"));
+}
+
+vector<Configuration::Index> Configuration::get_indices(const string& patterns) const
+{
+  vector<string> names;
+  for (const auto& index : indices_) {
+    names.push_back(index.name);
+  }
+
+  auto matched = match_(names, patterns);
+  if (matched.empty()) { throw runtime_error("no available index matches '" + patterns + "'"); }
+
+  vector<Index> res;
+  for (const auto& index : indices_) {
+    if (matched.find(index.name) != matched.end()) { res.push_back(index); }
+  }
+  return res;
+}
+
+void Configuration::parse_dataset_(const nlohmann::json& conf)
+{
+  dataset_conf_.name       = conf.at("name");
+  dataset_conf_.base_file  = conf.at("base_file");
+  dataset_conf_.query_file = conf.at("query_file");
+  dataset_conf_.distance   = conf.at("distance");
+
+  if (conf.contains("subset_first_row")) {
+    dataset_conf_.subset_first_row = conf.at("subset_first_row");
+  }
+  if (conf.contains("subset_size")) { dataset_conf_.subset_size = conf.at("subset_size"); }
+
+  if (conf.contains("dtype")) {
+    dataset_conf_.dtype = conf.at("dtype");
+  } else {
+    auto filename = dataset_conf_.base_file;
+    if (!filename.compare(filename.size() - 4, 4, "fbin")) {
+      dataset_conf_.dtype = "float";
+    } else if (!filename.compare(filename.size() - 5, 5, "u8bin")) {
+      dataset_conf_.dtype = "uint8";
+    } else if (!filename.compare(filename.size() - 5, 5, "i8bin")) {
+      dataset_conf_.dtype = "int8";
+    } else {
+      log_error("Could not determine data type of the dataset");
+    }
+  }
+}
+
+void Configuration::parse_index_(const nlohmann::json& index_conf,
+                                 const nlohmann::json& search_basic_conf)
+{
+  const int batch_size = search_basic_conf.at("batch_size");
+  const int k          = search_basic_conf.at("k");
+  const int run_count  = search_basic_conf.at("run_count");
+
+  for (const auto& conf : index_conf) {
+    Index index;
+    index.name        = conf.at("name");
+    index.algo        = conf.at("algo");
+    index.build_param = conf.at("build_param");
+    index.file        = conf.at("file");
+    index.batch_size  = batch_size;
+    index.k           = k;
+    index.run_count   = run_count;
+
+    if (conf.contains("multigpu")) {
+      for (auto it : conf.at("multigpu")) {
+        index.dev_list.push_back(it);
+      }
+      if (index.dev_list.empty()) { throw std::runtime_error("dev_list shouln't be empty!"); }
+      index.dev_list.shrink_to_fit();
+      index.build_param["multigpu"] = conf["multigpu"];
+    }
+
+    if (conf.contains("refine_ratio")) {
+      float refine_ratio = conf.at("refine_ratio");
+      if (refine_ratio <= 1.0f) {
+        throw runtime_error("'" + index.name + "': refine_ratio should > 1.0");
+      }
+      index.refine_ratio = refine_ratio;
+    }
+
+    for (const auto& param : conf.at("search_params")) {
+      index.search_params.push_back(param);
+    }
+    index.search_result_file = conf.at("search_result_file");
+
+    indices_.push_back(index);
+  }
+}
+
+unordered_set<string> Configuration::match_(const vector<string>& candidates,
+                                            const string& patterns) const
+{
+  unordered_set<string> matched;
+  for (const auto& pat : split(patterns, ',')) {
+    if (pat.empty()) { continue; }
+
+    if (pat.back() == '*') {
+      auto len = pat.size() - 1;
+      for (const auto& item : candidates) {
+        if (item.compare(0, len, pat, 0, len) == 0) { matched.insert(item); }
+      }
+    } else {
+      for (const auto& item : candidates) {
+        if (item == pat) { matched.insert(item); }
+      }
+    }
+  }
+
+  return matched;
+}
+
+}  // namespace raft::bench::ann
diff --git a/cpp/bench/ann/src/common/conf.h b/cpp/bench/ann/src/common/conf.h
new file mode 100644
index 0000000000..845defe94a
--- /dev/null
+++ b/cpp/bench/ann/src/common/conf.h
@@ -0,0 +1,75 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#pragma once
+#include <iostream>
+#include <string>
+#include <unordered_set>
+#include <vector>
+
+#define JSON_DIAGNOSTICS 1
+#include <nlohmann/json.hpp>
+
+namespace raft::bench::ann {
+
+class Configuration {
+ public:
+  struct Index {
+    std::string name;
+    std::string algo;
+    nlohmann::json build_param;
+    std::string file;
+    std::vector<int> dev_list;
+
+    int batch_size;
+    int k;
+    int run_count;
+    std::vector<nlohmann::json> search_params;
+    std::string search_result_file;
+    float refine_ratio{0.0f};
+  };
+
+  struct DatasetConf {
+    std::string name;
+    std::string base_file;
+    // use only a subset of base_file,
+    // the range of rows is [subset_first_row, subset_first_row + subset_size)
+    // however, subset_size = 0 means using all rows after subset_first_row
+    // that is, the subset is [subset_first_row, #rows in base_file)
+    size_t subset_first_row{0};
+    size_t subset_size{0};
+    std::string query_file;
+    std::string distance;
+
+    // data type of input dataset, possible values ["float", "int8", "uint8"]
+    std::string dtype;
+  };
+
+  Configuration(std::istream& conf_stream);
+
+  DatasetConf get_dataset_conf() const { return dataset_conf_; }
+  std::vector<Index> get_indices(const std::string& patterns) const;
+
+ private:
+  void parse_dataset_(const nlohmann::json& conf);
+  void parse_index_(const nlohmann::json& index_conf, const nlohmann::json& search_basic_conf);
+  std::unordered_set<std::string> match_(const std::vector<std::string>& candidates,
+                                         const std::string& patterns) const;
+
+  DatasetConf dataset_conf_;
+  std::vector<Index> indices_;
+};
+
+}  // namespace raft::bench::ann
diff --git a/cpp/bench/ann/src/common/dataset.h b/cpp/bench/ann/src/common/dataset.h
new file mode 100644
index 0000000000..1244935c99
--- /dev/null
+++ b/cpp/bench/ann/src/common/dataset.h
@@ -0,0 +1,381 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#pragma once
+#include <cuda_fp16.h>
+#include <errno.h>
+#include <sys/mman.h>
+#include <sys/stat.h>
+
+#include <cassert>
+#include <cstdint>
+#include <cstdio>
+#include <stdexcept>
+#include <string>
+#include <type_traits>
+#include <vector>
+
+#include <raft/util/cudart_utils.hpp>
+
+namespace raft::bench::ann {
+
+// http://big-ann-benchmarks.com/index.html:
+// binary format that starts with 8 bytes of data consisting of num_points(uint32_t)
+// num_dimensions(uint32) followed by num_pts x num_dimensions x sizeof(type) bytes of
+// data stored one vector after another.
+// Data files will have suffixes .fbin, .u8bin, and .i8bin to represent float32, uint8
+// and int8 type data.
+// As extensions for this benchmark, half and int data files will have suffixes .f16bin
+// and .ibin, respectively.
+template <typename T>
+class BinFile {
+ public:
+  BinFile(const std::string& file,
+          const std::string& mode,
+          uint32_t subset_first_row = 0,
+          uint32_t subset_size      = 0);
+  ~BinFile() { fclose(fp_); }
+  BinFile(const BinFile&) = delete;
+  BinFile& operator=(const BinFile&) = delete;
+
+  void get_shape(size_t* nrows, int* ndims)
+  {
+    assert(read_mode_);
+    *nrows = nrows_;
+    *ndims = ndims_;
+  }
+
+  void read(T* data) const
+  {
+    assert(read_mode_);
+    size_t total = static_cast<size_t>(nrows_) * ndims_;
+    if (fread(data, sizeof(T), total, fp_) != total) {
+      throw std::runtime_error("fread() BinFile " + file_ + " failed");
+    }
+  }
+
+  void write(const T* data, uint32_t nrows, uint32_t ndims)
+  {
+    assert(!read_mode_);
+    if (fwrite(&nrows, sizeof(uint32_t), 1, fp_) != 1) {
+      throw std::runtime_error("fwrite() BinFile " + file_ + " failed");
+    }
+    if (fwrite(&ndims, sizeof(uint32_t), 1, fp_) != 1) {
+      throw std::runtime_error("fwrite() BinFile " + file_ + " failed");
+    }
+
+    size_t total = static_cast<size_t>(nrows) * ndims;
+    if (fwrite(data, sizeof(T), total, fp_) != total) {
+      throw std::runtime_error("fwrite() BinFile " + file_ + " failed");
+    }
+  }
+
+  void* map() const
+  {
+    assert(read_mode_);
+    int fid       = fileno(fp_);
+    auto mmap_ptr = mmap(NULL, file_size_, PROT_READ, MAP_PRIVATE, fid, 0);
+    if (mmap_ptr == MAP_FAILED) {
+      throw std::runtime_error("mmap error: Value of errno " + std::to_string(errno) + ", " +
+                               std::string(strerror(errno)));
+    }
+    return mmap_ptr;
+  }
+
+  void unmap(void* data) const
+  {
+    if (munmap(data, file_size_) == -1) {
+      throw std::runtime_error("munmap error: " + std::string(strerror(errno)));
+    }
+  }
+
+ private:
+  void check_suffix_();
+
+  std::string file_;
+  FILE* fp_;
+  bool read_mode_;
+  uint32_t nrows_;
+  uint32_t ndims_;
+  size_t file_size_;
+};
+
+template <typename T>
+BinFile<T>::BinFile(const std::string& file,
+                    const std::string& mode,
+                    uint32_t subset_first_row,
+                    uint32_t subset_size)
+  : file_(file)
+{
+  check_suffix_();
+
+  if (mode == "r") {
+    read_mode_ = true;
+  } else if (mode == "w") {
+    read_mode_ = false;
+    if (subset_first_row != 0) {
+      throw std::runtime_error("subset_first_row should be zero for write mode");
+    }
+    if (subset_size != 0) { throw std::runtime_error("subset_size should be zero for write mode"); }
+  } else {
+    throw std::runtime_error("BinFile's mode must be either 'r' or 'w': " + file_);
+  }
+
+  fp_ = fopen(file_.c_str(), mode.c_str());
+  if (!fp_) { throw std::runtime_error("open BinFile failed: " + file_); }
+
+  if (read_mode_) {
+    struct stat statbuf;
+    if (stat(file_.c_str(), &statbuf) != 0) { throw std::runtime_error("stat() failed: " + file_); }
+    file_size_ = statbuf.st_size;
+
+    uint32_t header[2];
+    if (fread(header, sizeof(uint32_t), 2, fp_) != 2) {
+      throw std::runtime_error("read header of BinFile failed: " + file_);
+    }
+    nrows_ = header[0];
+    ndims_ = header[1];
+
+    size_t expected_file_size =
+      2 * sizeof(uint32_t) + static_cast<size_t>(nrows_) * ndims_ * sizeof(T);
+    if (file_size_ != expected_file_size) {
+      throw std::runtime_error("expected file size of " + file_ + " is " +
+                               std::to_string(expected_file_size) + ", however, actual size is " +
+                               std::to_string(file_size_));
+    }
+
+    if (subset_first_row >= nrows_) {
+      throw std::runtime_error(file_ + ": subset_first_row (" + std::to_string(subset_first_row) +
+                               ") >= nrows (" + std::to_string(nrows_) + ")");
+    }
+    if (subset_first_row + subset_size > nrows_) {
+      throw std::runtime_error(file_ + ": subset_first_row (" + std::to_string(subset_first_row) +
+                               ") + subset_size (" + std::to_string(subset_size) + ") > nrows (" +
+                               std::to_string(nrows_) + ")");
+    }
+
+    if (subset_first_row) {
+      static_assert(sizeof(long) == 8, "fseek() don't support 64-bit offset");
+      if (fseek(fp_, sizeof(T) * subset_first_row * ndims_, SEEK_CUR) == -1) {
+        throw std::runtime_error(file_ + ": fseek failed");
+      }
+      nrows_ -= subset_first_row;
+    }
+    if (subset_size) { nrows_ = subset_size; }
+  }
+}
+
+template <typename T>
+void BinFile<T>::check_suffix_()
+{
+  auto pos = file_.rfind('.');
+  if (pos == std::string::npos) {
+    throw std::runtime_error("name of BinFile doesn't have a suffix: " + file_);
+  }
+  std::string suffix = file_.substr(pos + 1);
+
+  if constexpr (std::is_same_v<T, float>) {
+    if (suffix != "fbin") {
+      throw std::runtime_error("BinFile<float> should has .fbin suffix: " + file_);
+    }
+  } else if constexpr (std::is_same_v<T, half>) {
+    if (suffix != "f16bin") {
+      throw std::runtime_error("BinFile<half> should has .f16bin suffix: " + file_);
+    }
+  } else if constexpr (std::is_same_v<T, int>) {
+    if (suffix != "ibin") {
+      throw std::runtime_error("BinFile<int> should has .ibin suffix: " + file_);
+    }
+  } else if constexpr (std::is_same_v<T, uint8_t>) {
+    if (suffix != "u8bin") {
+      throw std::runtime_error("BinFile<uint8_t> should has .u8bin suffix: " + file_);
+    }
+  } else if constexpr (std::is_same_v<T, int8_t>) {
+    if (suffix != "i8bin") {
+      throw std::runtime_error("BinFile<int8_t> should has .i8bin suffix: " + file_);
+    }
+  } else {
+    throw std::runtime_error(
+      "T of BinFile<T> should be one of float, half, int, uint8_t, or int8_t");
+  }
+}
+
+template <typename T>
+class Dataset {
+ public:
+  Dataset(const std::string& name) : name_(name) {}
+  Dataset(const std::string& name, const std::string& distance) : name_(name), distance_(distance)
+  {
+  }
+  Dataset(const Dataset&) = delete;
+  Dataset& operator=(const Dataset&) = delete;
+  virtual ~Dataset();
+
+  std::string name() const { return name_; }
+  std::string distance() const { return distance_; }
+  int dim() const { return dim_; }
+  size_t base_set_size() const { return base_set_size_; }
+  size_t query_set_size() const { return query_set_size_; }
+
+  // load data lazily, so don't pay the overhead of reading unneeded set
+  // e.g. don't load base set when searching
+  const T* base_set() const
+  {
+    if (!base_set_) { load_base_set_(); }
+    return base_set_;
+  }
+
+  const T* query_set() const
+  {
+    if (!query_set_) { load_query_set_(); }
+    return query_set_;
+  }
+
+  const T* base_set_on_gpu() const;
+  const T* query_set_on_gpu() const;
+  const T* mapped_base_set() const;
+
+ protected:
+  virtual void load_base_set_() const  = 0;
+  virtual void load_query_set_() const = 0;
+  virtual void map_base_set_() const   = 0;
+
+  std::string name_;
+  std::string distance_;
+  int dim_;
+  size_t base_set_size_;
+  size_t query_set_size_;
+
+  mutable T* base_set_        = nullptr;
+  mutable T* query_set_       = nullptr;
+  mutable T* d_base_set_      = nullptr;
+  mutable T* d_query_set_     = nullptr;
+  mutable T* mapped_base_set_ = nullptr;
+};
+
+template <typename T>
+Dataset<T>::~Dataset()
+{
+  delete[] base_set_;
+  delete[] query_set_;
+  if (d_base_set_) { RAFT_CUDA_TRY_NO_THROW(cudaFree(d_base_set_)); }
+  if (d_query_set_) { RAFT_CUDA_TRY_NO_THROW(cudaFree(d_query_set_)); }
+}
+
+template <typename T>
+const T* Dataset<T>::base_set_on_gpu() const
+{
+  if (!d_base_set_) {
+    base_set();
+    RAFT_CUDA_TRY(cudaMalloc((void**)&d_base_set_, base_set_size_ * dim_ * sizeof(T)));
+    RAFT_CUDA_TRY(cudaMemcpy(
+      d_base_set_, base_set_, base_set_size_ * dim_ * sizeof(T), cudaMemcpyHostToDevice));
+  }
+  return d_base_set_;
+}
+
+template <typename T>
+const T* Dataset<T>::query_set_on_gpu() const
+{
+  if (!d_query_set_) {
+    query_set();
+    RAFT_CUDA_TRY(cudaMalloc((void**)&d_query_set_, query_set_size_ * dim_ * sizeof(T)));
+    RAFT_CUDA_TRY(cudaMemcpy(
+      d_query_set_, query_set_, query_set_size_ * dim_ * sizeof(T), cudaMemcpyHostToDevice));
+  }
+  return d_query_set_;
+}
+
+template <typename T>
+const T* Dataset<T>::mapped_base_set() const
+{
+  if (!mapped_base_set_) { map_base_set_(); }
+  return mapped_base_set_;
+}
+
+template <typename T>
+class BinDataset : public Dataset<T> {
+ public:
+  BinDataset(const std::string& name,
+             const std::string& base_file,
+             size_t subset_first_row,
+             size_t subset_size,
+             const std::string& query_file,
+             const std::string& distance);
+  ~BinDataset()
+  {
+    if (this->mapped_base_set_) {
+      base_file_.unmap(reinterpret_cast<char*>(this->mapped_base_set_) - subset_offset_);
+    }
+  }
+
+ private:
+  void load_base_set_() const override;
+  void load_query_set_() const override;
+  void map_base_set_() const override;
+
+  using Dataset<T>::dim_;
+  using Dataset<T>::base_set_size_;
+  using Dataset<T>::query_set_size_;
+
+  BinFile<T> base_file_;
+  BinFile<T> query_file_;
+
+  size_t subset_offset_;
+};
+
+template <typename T>
+BinDataset<T>::BinDataset(const std::string& name,
+                          const std::string& base_file,
+                          size_t subset_first_row,
+                          size_t subset_size,
+                          const std::string& query_file,
+                          const std::string& distance)
+  : Dataset<T>(name, distance),
+    base_file_(base_file, "r", subset_first_row, subset_size),
+    query_file_(query_file, "r"),
+    subset_offset_(2 * sizeof(uint32_t) + subset_first_row * dim_ * sizeof(T))
+{
+  base_file_.get_shape(&base_set_size_, &dim_);
+  int query_dim;
+  query_file_.get_shape(&query_set_size_, &query_dim);
+  if (query_dim != dim_) {
+    throw std::runtime_error("base set dim (" + std::to_string(dim_) + ") != query set dim (" +
+                             std::to_string(query_dim));
+  }
+}
+
+template <typename T>
+void BinDataset<T>::load_base_set_() const
+{
+  this->base_set_ = new T[base_set_size_ * dim_];
+  base_file_.read(this->base_set_);
+}
+
+template <typename T>
+void BinDataset<T>::load_query_set_() const
+{
+  this->query_set_ = new T[query_set_size_ * dim_];
+  query_file_.read(this->query_set_);
+}
+
+template <typename T>
+void BinDataset<T>::map_base_set_() const
+{
+  char* original_map_ptr = static_cast<char*>(base_file_.map());
+  this->mapped_base_set_ = reinterpret_cast<T*>(original_map_ptr + subset_offset_);
+}
+
+}  // namespace  raft::bench::ann
diff --git a/cpp/bench/ann/src/common/util.cpp b/cpp/bench/ann/src/common/util.cpp
new file mode 100644
index 0000000000..17636f76d7
--- /dev/null
+++ b/cpp/bench/ann/src/common/util.cpp
@@ -0,0 +1,68 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#include "util.h"
+
+#include <sys/stat.h>
+#include <sys/types.h>
+
+#include <cstring>
+#include <sstream>
+
+namespace raft::bench::ann {
+
+std::vector<std::string> split(const std::string& s, char delimiter)
+{
+  std::vector<std::string> tokens;
+  std::string token;
+  std::istringstream iss(s);
+  while (getline(iss, token, delimiter)) {
+    if (!token.empty()) { tokens.push_back(token); }
+  }
+  return tokens;
+}
+
+bool file_exists(const std::string& filename)
+{
+  struct stat statbuf;
+  if (stat(filename.c_str(), &statbuf) != 0) { return false; }
+  return S_ISREG(statbuf.st_mode);
+}
+
+bool dir_exists(const std::string& dir)
+{
+  struct stat statbuf;
+  if (stat(dir.c_str(), &statbuf) != 0) { return false; }
+  return S_ISDIR(statbuf.st_mode);
+}
+
+bool create_dir(const std::string& dir)
+{
+  const auto path = split(dir, '/');
+
+  std::string cwd;
+  if (!dir.empty() && dir[0] == '/') { cwd += '/'; }
+
+  for (const auto& p : path) {
+    cwd += p + "/";
+    if (!dir_exists(cwd)) {
+      int ret = mkdir(cwd.c_str(), S_IRWXU | S_IRGRP | S_IXGRP | S_IROTH | S_IXOTH);
+      if (ret != 0) { return false; }
+    }
+  }
+  return true;
+}
+
+}  // namespace raft::bench::ann
diff --git a/cpp/bench/ann/src/common/util.h b/cpp/bench/ann/src/common/util.h
new file mode 100644
index 0000000000..290bf4cea9
--- /dev/null
+++ b/cpp/bench/ann/src/common/util.h
@@ -0,0 +1,79 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#pragma once
+
+#include <chrono>
+#include <cstdio>
+#include <ctime>
+#include <iostream>
+#include <string>
+#include <vector>
+
+namespace raft::bench::ann {
+
+class Timer {
+ public:
+  Timer() { reset(); }
+  void reset() { start_time_ = std::chrono::steady_clock::now(); }
+  float elapsed_ms()
+  {
+    auto end_time = std::chrono::steady_clock::now();
+    auto dur =
+      std::chrono::duration_cast<std::chrono::duration<float, std::milli>>(end_time - start_time_);
+    return dur.count();
+  }
+
+ private:
+  std::chrono::steady_clock::time_point start_time_;
+};
+
+std::vector<std::string> split(const std::string& s, char delimiter);
+
+bool file_exists(const std::string& filename);
+bool dir_exists(const std::string& dir);
+bool create_dir(const std::string& dir);
+
+template <typename... Ts>
+void log_(const char* level, Ts... vs)
+{
+  char buf[20];
+  std::time_t now = std::time(nullptr);
+  std::strftime(buf, sizeof(buf), "%Y-%m-%d %H:%M:%S", std::localtime(&now));
+  printf("%s [%s] ", buf, level);
+  printf(vs...);
+  printf("\n");
+  fflush(stdout);
+}
+
+template <typename... Ts>
+void log_info(Ts... vs)
+{
+  log_("info", vs...);
+}
+
+template <typename... Ts>
+void log_warn(Ts... vs)
+{
+  log_("warn", vs...);
+}
+
+template <typename... Ts>
+void log_error(Ts... vs)
+{
+  log_("error", vs...);
+}
+
+}  // namespace raft::bench::ann
diff --git a/cpp/bench/ann/src/faiss/faiss_benchmark.cu b/cpp/bench/ann/src/faiss/faiss_benchmark.cu
new file mode 100644
index 0000000000..294da9a14f
--- /dev/null
+++ b/cpp/bench/ann/src/faiss/faiss_benchmark.cu
@@ -0,0 +1,150 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include <algorithm>
+#include <cmath>
+#include <memory>
+#include <stdexcept>
+#include <string>
+#include <type_traits>
+#include <utility>
+
+#include "../common/ann_types.hpp"
+#undef WARP_SIZE
+#include "faiss_wrapper.h"
+#define JSON_DIAGNOSTICS 1
+#include <nlohmann/json.hpp>
+
+namespace raft::bench::ann {
+
+template <typename T>
+void parse_build_param(const nlohmann::json& conf,
+                       typename raft::bench::ann::FaissGpuIVFFlat<T>::BuildParam& param)
+{
+  param.nlist = conf.at("nlist");
+}
+
+template <typename T>
+void parse_build_param(const nlohmann::json& conf,
+                       typename raft::bench::ann::FaissGpuIVFPQ<T>::BuildParam& param)
+{
+  param.nlist = conf.at("nlist");
+  param.M     = conf.at("M");
+  if (conf.contains("usePrecomputed")) {
+    param.usePrecomputed = conf.at("usePrecomputed");
+  } else {
+    param.usePrecomputed = false;
+  }
+  if (conf.contains("useFloat16")) {
+    param.useFloat16 = conf.at("useFloat16");
+  } else {
+    param.useFloat16 = false;
+  }
+}
+
+template <typename T>
+void parse_build_param(const nlohmann::json& conf,
+                       typename raft::bench::ann::FaissGpuIVFSQ<T>::BuildParam& param)
+{
+  param.nlist          = conf.at("nlist");
+  param.quantizer_type = conf.at("quantizer_type");
+}
+
+template <typename T>
+void parse_search_param(const nlohmann::json& conf,
+                        typename raft::bench::ann::FaissGpu<T>::SearchParam& param)
+{
+  param.nprobe = conf.at("nprobe");
+}
+
+template <typename T, template <typename> class Algo>
+std::unique_ptr<raft::bench::ann::ANN<T>> make_algo(raft::bench::ann::Metric metric,
+                                                    int dim,
+                                                    const nlohmann::json& conf)
+{
+  typename Algo<T>::BuildParam param;
+  parse_build_param<T>(conf, param);
+  return std::make_unique<Algo<T>>(metric, dim, param);
+}
+
+template <typename T, template <typename> class Algo>
+std::unique_ptr<raft::bench::ann::ANN<T>> make_algo(raft::bench::ann::Metric metric,
+                                                    int dim,
+                                                    const nlohmann::json& conf,
+                                                    const std::vector<int>& dev_list)
+{
+  typename Algo<T>::BuildParam param;
+  parse_build_param<T>(conf, param);
+
+  (void)dev_list;
+  return std::make_unique<Algo<T>>(metric, dim, param);
+}
+
+template <typename T>
+std::unique_ptr<raft::bench::ann::ANN<T>> create_algo(const std::string& algo,
+                                                      const std::string& distance,
+                                                      int dim,
+                                                      float refine_ratio,
+                                                      const nlohmann::json& conf,
+                                                      const std::vector<int>& dev_list)
+{
+  // stop compiler warning; not all algorithms support multi-GPU so it may not be used
+  (void)dev_list;
+
+  raft::bench::ann::Metric metric = parse_metric(distance);
+  std::unique_ptr<raft::bench::ann::ANN<T>> ann;
+
+  if constexpr (std::is_same_v<T, float>) {
+    if (algo == "faiss_gpu_ivf_flat") {
+      ann = make_algo<T, raft::bench::ann::FaissGpuIVFFlat>(metric, dim, conf, dev_list);
+    } else if (algo == "faiss_gpu_ivf_pq") {
+      ann = make_algo<T, raft::bench::ann::FaissGpuIVFPQ>(metric, dim, conf);
+    } else if (algo == "faiss_gpu_ivf_sq") {
+      ann = make_algo<T, raft::bench::ann::FaissGpuIVFSQ>(metric, dim, conf);
+    } else if (algo == "faiss_gpu_flat") {
+      ann = std::make_unique<raft::bench::ann::FaissGpuFlat<T>>(metric, dim);
+    }
+  }
+
+  if constexpr (std::is_same_v<T, uint8_t>) {}
+
+  if (!ann) { throw std::runtime_error("invalid algo: '" + algo + "'"); }
+
+  if (refine_ratio > 1.0) {}
+  return ann;
+}
+
+template <typename T>
+std::unique_ptr<typename raft::bench::ann::ANN<T>::AnnSearchParam> create_search_param(
+  const std::string& algo, const nlohmann::json& conf)
+{
+  if (algo == "faiss_gpu_ivf_flat" || algo == "faiss_gpu_ivf_pq" || algo == "faiss_gpu_ivf_sq") {
+    auto param = std::make_unique<typename raft::bench::ann::FaissGpu<T>::SearchParam>();
+    parse_search_param<T>(conf, *param);
+    return param;
+  } else if (algo == "faiss_gpu_flat") {
+    auto param = std::make_unique<typename raft::bench::ann::ANN<T>::AnnSearchParam>();
+    return param;
+  }
+  // else
+  throw std::runtime_error("invalid algo: '" + algo + "'");
+}
+
+}  // namespace raft::bench::ann
+
+#include "../common/benchmark.hpp"
+
+int main(int argc, char** argv) { return raft::bench::ann::run_main(argc, argv); }
\ No newline at end of file
diff --git a/cpp/bench/ann/src/faiss/faiss_wrapper.h b/cpp/bench/ann/src/faiss/faiss_wrapper.h
new file mode 100644
index 0000000000..8cfc26ea5b
--- /dev/null
+++ b/cpp/bench/ann/src/faiss/faiss_wrapper.h
@@ -0,0 +1,317 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#ifndef FAISS_WRAPPER_H_
+#define FAISS_WRAPPER_H_
+
+#include <faiss/IndexFlat.h>
+#include <faiss/IndexIVFFlat.h>
+#include <faiss/IndexIVFPQ.h>
+#include <faiss/IndexScalarQuantizer.h>
+#include <faiss/gpu/GpuIndexFlat.h>
+#include <faiss/gpu/GpuIndexIVFFlat.h>
+#include <faiss/gpu/GpuIndexIVFPQ.h>
+#include <faiss/gpu/GpuIndexIVFScalarQuantizer.h>
+#include <faiss/gpu/StandardGpuResources.h>
+#include <faiss/impl/ScalarQuantizer.h>
+#include <faiss/index_io.h>
+#include <omp.h>
+
+#include <cassert>
+#include <memory>
+#include <stdexcept>
+#include <string>
+#include <type_traits>
+
+#include "../common/ann_types.hpp"
+#include "../common/benchmark_util.hpp"
+#include <raft/util/cudart_utils.hpp>
+
+namespace {
+
+faiss::MetricType parse_metric_type(raft::bench::ann::Metric metric)
+{
+  if (metric == raft::bench::ann::Metric::kInnerProduct) {
+    return faiss::METRIC_INNER_PRODUCT;
+  } else if (metric == raft::bench::ann::Metric::kEuclidean) {
+    return faiss::METRIC_L2;
+  } else {
+    throw std::runtime_error("faiss supports only metric type of inner product and L2");
+  }
+}
+
+// note BLAS library can still use multi-threading, and
+// setting environment variable like OPENBLAS_NUM_THREADS can control it
+class OmpSingleThreadScope {
+ public:
+  OmpSingleThreadScope()
+  {
+    max_threads_ = omp_get_max_threads();
+    omp_set_num_threads(1);
+  }
+  ~OmpSingleThreadScope()
+  {
+    // the best we can do
+    omp_set_num_threads(max_threads_);
+  }
+
+ private:
+  int max_threads_;
+};
+
+}  // namespace
+
+namespace raft::bench::ann {
+
+template <typename T>
+class FaissGpu : public ANN<T> {
+ public:
+  using typename ANN<T>::AnnSearchParam;
+  struct SearchParam : public AnnSearchParam {
+    int nprobe;
+  };
+
+  FaissGpu(Metric metric, int dim, int nlist);
+
+  void build(const T* dataset, size_t nrow, cudaStream_t stream = 0) final;
+
+  void set_search_param(const AnnSearchParam& param) override;
+
+  // TODO: if the number of results is less than k, the remaining elements of 'neighbors'
+  // will be filled with (size_t)-1
+  void search(const T* queries,
+              int batch_size,
+              int k,
+              size_t* neighbors,
+              float* distances,
+              cudaStream_t stream = 0) const final;
+
+  AlgoProperty get_property() const override
+  {
+    AlgoProperty property;
+    // to enable building big dataset which is larger than GPU memory
+    property.dataset_memory_type      = MemoryType::Host;
+    property.query_memory_type        = MemoryType::Device;
+    property.need_dataset_when_search = false;
+    return property;
+  }
+
+ protected:
+  template <typename GpuIndex, typename CpuIndex>
+  void save_(const std::string& file) const;
+
+  template <typename GpuIndex, typename CpuIndex>
+  void load_(const std::string& file);
+
+  mutable faiss::gpu::StandardGpuResources gpu_resource_;
+  std::unique_ptr<faiss::gpu::GpuIndex> index_;
+  faiss::MetricType metric_type_;
+  int nlist_;
+  int device_;
+};
+
+template <typename T>
+FaissGpu<T>::FaissGpu(Metric metric, int dim, int nlist)
+  : ANN<T>(metric, dim), metric_type_(parse_metric_type(metric)), nlist_(nlist)
+{
+  static_assert(std::is_same_v<T, float>, "faiss support only float type");
+  RAFT_CUDA_TRY(cudaGetDevice(&device_));
+}
+
+template <typename T>
+void FaissGpu<T>::build(const T* dataset, size_t nrow, cudaStream_t stream)
+{
+  OmpSingleThreadScope omp_single_thread;
+
+  gpu_resource_.setDefaultStream(device_, stream);
+  index_->train(nrow, dataset);  // faiss::gpu::GpuIndexFlat::train() will do nothing
+  assert(index_->is_trained);
+  index_->add(nrow, dataset);
+}
+
+template <typename T>
+void FaissGpu<T>::set_search_param(const AnnSearchParam& param)
+{
+  int nprobe = dynamic_cast<const SearchParam&>(param).nprobe;
+  assert(nprobe <= nlist_);
+  dynamic_cast<faiss::gpu::GpuIndexIVF*>(index_.get())->setNumProbes(nprobe);
+}
+
+template <typename T>
+void FaissGpu<T>::search(const T* queries,
+                         int batch_size,
+                         int k,
+                         size_t* neighbors,
+                         float* distances,
+                         cudaStream_t stream) const
+{
+  static_assert(sizeof(size_t) == sizeof(faiss::Index::idx_t),
+                "sizes of size_t and faiss::Index::idx_t are different");
+  gpu_resource_.setDefaultStream(device_, stream);
+  index_->search(
+    batch_size, queries, k, distances, reinterpret_cast<faiss::Index::idx_t*>(neighbors));
+}
+
+template <typename T>
+template <typename GpuIndex, typename CpuIndex>
+void FaissGpu<T>::save_(const std::string& file) const
+{
+  OmpSingleThreadScope omp_single_thread;
+
+  auto cpu_index = std::make_unique<CpuIndex>();
+  dynamic_cast<GpuIndex*>(index_.get())->copyTo(cpu_index.get());
+  faiss::write_index(cpu_index.get(), file.c_str());
+}
+
+template <typename T>
+template <typename GpuIndex, typename CpuIndex>
+void FaissGpu<T>::load_(const std::string& file)
+{
+  OmpSingleThreadScope omp_single_thread;
+
+  std::unique_ptr<CpuIndex> cpu_index(dynamic_cast<CpuIndex*>(faiss::read_index(file.c_str())));
+  assert(cpu_index);
+  dynamic_cast<GpuIndex*>(index_.get())->copyFrom(cpu_index.get());
+}
+
+template <typename T>
+class FaissGpuIVFFlat : public FaissGpu<T> {
+ public:
+  struct BuildParam {
+    int nlist;
+  };
+
+  FaissGpuIVFFlat(Metric metric, int dim, const BuildParam& param)
+    : FaissGpu<T>(metric, dim, param.nlist)
+  {
+    faiss::gpu::GpuIndexIVFFlatConfig config;
+    config.device = this->device_;
+    this->index_  = std::make_unique<faiss::gpu::GpuIndexIVFFlat>(
+      &(this->gpu_resource_), dim, param.nlist, this->metric_type_, config);
+  }
+
+  void save(const std::string& file) const override
+  {
+    this->template save_<faiss::gpu::GpuIndexIVFFlat, faiss::IndexIVFFlat>(file);
+  }
+  void load(const std::string& file) override
+  {
+    this->template load_<faiss::gpu::GpuIndexIVFFlat, faiss::IndexIVFFlat>(file);
+  }
+};
+
+template <typename T>
+class FaissGpuIVFPQ : public FaissGpu<T> {
+ public:
+  struct BuildParam {
+    int nlist;
+    int M;
+    bool useFloat16;
+    bool usePrecomputed;
+  };
+
+  FaissGpuIVFPQ(Metric metric, int dim, const BuildParam& param)
+    : FaissGpu<T>(metric, dim, param.nlist)
+  {
+    faiss::gpu::GpuIndexIVFPQConfig config;
+    config.useFloat16LookupTables = param.useFloat16;
+    config.usePrecomputedTables   = param.usePrecomputed;
+    config.device                 = this->device_;
+    this->index_ =
+      std::make_unique<faiss::gpu::GpuIndexIVFPQ>(&(this->gpu_resource_),
+                                                  dim,
+                                                  param.nlist,
+                                                  param.M,
+                                                  8,  // FAISS only supports bitsPerCode=8
+                                                  this->metric_type_,
+                                                  config);
+  }
+
+  void save(const std::string& file) const override
+  {
+    this->template save_<faiss::gpu::GpuIndexIVFPQ, faiss::IndexIVFPQ>(file);
+  }
+  void load(const std::string& file) override
+  {
+    this->template load_<faiss::gpu::GpuIndexIVFPQ, faiss::IndexIVFPQ>(file);
+  }
+};
+
+template <typename T>
+class FaissGpuIVFSQ : public FaissGpu<T> {
+ public:
+  struct BuildParam {
+    int nlist;
+    std::string quantizer_type;
+  };
+
+  FaissGpuIVFSQ(Metric metric, int dim, const BuildParam& param)
+    : FaissGpu<T>(metric, dim, param.nlist)
+  {
+    faiss::ScalarQuantizer::QuantizerType qtype;
+    if (param.quantizer_type == "fp16") {
+      qtype = faiss::ScalarQuantizer::QT_fp16;
+    } else if (param.quantizer_type == "int8") {
+      qtype = faiss::ScalarQuantizer::QT_8bit;
+    } else {
+      throw std::runtime_error("FaissGpuIVFSQ supports only fp16 and int8 but got " +
+                               param.quantizer_type);
+    }
+
+    faiss::gpu::GpuIndexIVFScalarQuantizerConfig config;
+    config.device = this->device_;
+    this->index_  = std::make_unique<faiss::gpu::GpuIndexIVFScalarQuantizer>(
+      &(this->gpu_resource_), dim, param.nlist, qtype, this->metric_type_, true, config);
+  }
+
+  void save(const std::string& file) const override
+  {
+    this->template save_<faiss::gpu::GpuIndexIVFScalarQuantizer, faiss::IndexIVFScalarQuantizer>(
+      file);
+  }
+  void load(const std::string& file) override
+  {
+    this->template load_<faiss::gpu::GpuIndexIVFScalarQuantizer, faiss::IndexIVFScalarQuantizer>(
+      file);
+  }
+};
+
+template <typename T>
+class FaissGpuFlat : public FaissGpu<T> {
+ public:
+  FaissGpuFlat(Metric metric, int dim) : FaissGpu<T>(metric, dim, 0)
+  {
+    faiss::gpu::GpuIndexFlatConfig config;
+    config.device = this->device_;
+    this->index_  = std::make_unique<faiss::gpu::GpuIndexFlat>(
+      &(this->gpu_resource_), dim, this->metric_type_, config);
+  }
+
+  // class FaissGpu is more like a IVF class, so need special treating here
+  void set_search_param(const typename ANN<T>::AnnSearchParam&) override{};
+
+  void save(const std::string& file) const override
+  {
+    this->template save_<faiss::gpu::GpuIndexFlat, faiss::IndexFlat>(file);
+  }
+  void load(const std::string& file) override
+  {
+    this->template load_<faiss::gpu::GpuIndexFlat, faiss::IndexFlat>(file);
+  }
+};
+
+}  // namespace raft::bench::ann
+
+#endif
diff --git a/cpp/bench/ann/src/ggnn/ggnn_benchmark.cu b/cpp/bench/ann/src/ggnn/ggnn_benchmark.cu
new file mode 100644
index 0000000000..8072cd857c
--- /dev/null
+++ b/cpp/bench/ann/src/ggnn/ggnn_benchmark.cu
@@ -0,0 +1,125 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include <algorithm>
+#include <cmath>
+#include <memory>
+#include <stdexcept>
+#include <string>
+#include <type_traits>
+#include <utility>
+
+#include "../common/ann_types.hpp"
+#include "ggnn_wrapper.cuh"
+#define JSON_DIAGNOSTICS 1
+#include <nlohmann/json.hpp>
+
+namespace raft::bench::ann {
+
+template <typename T>
+void parse_build_param(const nlohmann::json& conf,
+                       typename raft::bench::ann::Ggnn<T>::BuildParam& param)
+{
+  param.dataset_size = conf.at("dataset_size");
+  param.k            = conf.at("k");
+
+  if (conf.contains("k_build")) { param.k_build = conf.at("k_build"); }
+  if (conf.contains("segment_size")) { param.segment_size = conf.at("segment_size"); }
+  if (conf.contains("num_layers")) { param.num_layers = conf.at("num_layers"); }
+  if (conf.contains("tau")) { param.tau = conf.at("tau"); }
+  if (conf.contains("refine_iterations")) {
+    param.refine_iterations = conf.at("refine_iterations");
+  }
+}
+
+template <typename T>
+void parse_search_param(const nlohmann::json& conf,
+                        typename raft::bench::ann::Ggnn<T>::SearchParam& param)
+{
+  param.tau = conf.at("tau");
+
+  if (conf.contains("block_dim")) { param.block_dim = conf.at("block_dim"); }
+  if (conf.contains("max_iterations")) { param.max_iterations = conf.at("max_iterations"); }
+  if (conf.contains("cache_size")) { param.cache_size = conf.at("cache_size"); }
+  if (conf.contains("sorted_size")) { param.sorted_size = conf.at("sorted_size"); }
+}
+
+template <typename T, template <typename> class Algo>
+std::unique_ptr<raft::bench::ann::ANN<T>> make_algo(raft::bench::ann::Metric metric,
+                                                    int dim,
+                                                    const nlohmann::json& conf)
+{
+  typename Algo<T>::BuildParam param;
+  parse_build_param<T>(conf, param);
+  return std::make_unique<Algo<T>>(metric, dim, param);
+}
+
+template <typename T, template <typename> class Algo>
+std::unique_ptr<raft::bench::ann::ANN<T>> make_algo(raft::bench::ann::Metric metric,
+                                                    int dim,
+                                                    const nlohmann::json& conf,
+                                                    const std::vector<int>& dev_list)
+{
+  typename Algo<T>::BuildParam param;
+  parse_build_param<T>(conf, param);
+
+  (void)dev_list;
+  return std::make_unique<Algo<T>>(metric, dim, param);
+}
+
+template <typename T>
+std::unique_ptr<raft::bench::ann::ANN<T>> create_algo(const std::string& algo,
+                                                      const std::string& distance,
+                                                      int dim,
+                                                      float refine_ratio,
+                                                      const nlohmann::json& conf,
+                                                      const std::vector<int>& dev_list)
+{
+  // stop compiler warning; not all algorithms support multi-GPU so it may not be used
+  (void)dev_list;
+
+  raft::bench::ann::Metric metric = parse_metric(distance);
+  std::unique_ptr<raft::bench::ann::ANN<T>> ann;
+
+  if constexpr (std::is_same_v<T, float>) {}
+
+  if constexpr (std::is_same_v<T, uint8_t>) {}
+
+  if (algo == "ggnn") { ann = make_algo<T, raft::bench::ann::Ggnn>(metric, dim, conf); }
+  if (!ann) { throw std::runtime_error("invalid algo: '" + algo + "'"); }
+
+  if (refine_ratio > 1.0) {}
+  return ann;
+}
+
+template <typename T>
+std::unique_ptr<typename raft::bench::ann::ANN<T>::AnnSearchParam> create_search_param(
+  const std::string& algo, const nlohmann::json& conf)
+{
+  if (algo == "ggnn") {
+    auto param = std::make_unique<typename raft::bench::ann::Ggnn<T>::SearchParam>();
+    parse_search_param<T>(conf, *param);
+    return param;
+  }
+  // else
+  throw std::runtime_error("invalid algo: '" + algo + "'");
+}
+
+}  // namespace raft::bench::ann
+
+#include "../common/benchmark.hpp"
+
+int main(int argc, char** argv) { return raft::bench::ann::run_main(argc, argv); }
\ No newline at end of file
diff --git a/cpp/bench/ann/src/ggnn/ggnn_wrapper.cuh b/cpp/bench/ann/src/ggnn/ggnn_wrapper.cuh
new file mode 100644
index 0000000000..fd8fe0f2ec
--- /dev/null
+++ b/cpp/bench/ann/src/ggnn/ggnn_wrapper.cuh
@@ -0,0 +1,308 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#pragma once
+
+#include <memory>
+#include <stdexcept>
+
+#include "../common/ann_types.hpp"
+#include "../common/benchmark_util.hpp"
+#include <ggnn/cuda_knn_ggnn_gpu_instance.cuh>
+#include <raft/util/cudart_utils.hpp>
+
+namespace raft::bench::ann {
+
+template <typename T, DistanceMeasure measure, int D, int KBuild, int KQuery, int S>
+class GgnnImpl;
+
+template <typename T>
+class Ggnn : public ANN<T> {
+ public:
+  struct BuildParam {
+    int k_build{24};       // KBuild
+    int segment_size{32};  // S
+    int num_layers{4};     // L
+    float tau{0.5};
+    int refine_iterations{2};
+
+    size_t dataset_size;
+    int k;  // GGNN requires to know k during building
+  };
+
+  using typename ANN<T>::AnnSearchParam;
+  struct SearchParam : public AnnSearchParam {
+    float tau;
+    int block_dim{32};
+    int max_iterations{400};
+    int cache_size{512};
+    int sorted_size{256};
+  };
+
+  Ggnn(Metric metric, int dim, const BuildParam& param);
+  ~Ggnn() { delete impl_; }
+
+  void build(const T* dataset, size_t nrow, cudaStream_t stream = 0) override
+  {
+    impl_->build(dataset, nrow, stream);
+  }
+
+  void set_search_param(const AnnSearchParam& param) override { impl_->set_search_param(param); }
+  void search(const T* queries,
+              int batch_size,
+              int k,
+              size_t* neighbors,
+              float* distances,
+              cudaStream_t stream = 0) const override
+  {
+    impl_->search(queries, batch_size, k, neighbors, distances, stream);
+  }
+
+  void save(const std::string& file) const override { impl_->save(file); }
+  void load(const std::string& file) override { impl_->load(file); }
+
+  AlgoProperty get_property() const override { return impl_->get_property(); }
+
+  void set_search_dataset(const T* dataset, size_t nrow) override
+  {
+    impl_->set_search_dataset(dataset, nrow);
+  };
+
+ private:
+  ANN<T>* impl_;
+};
+
+template <typename T>
+Ggnn<T>::Ggnn(Metric metric, int dim, const BuildParam& param) : ANN<T>(metric, dim)
+{
+  // ggnn/src/sift1m.cu
+  if (metric == Metric::kEuclidean && dim == 128 && param.k_build == 24 && param.k == 10 &&
+      param.segment_size == 32) {
+    impl_ = new GgnnImpl<T, Euclidean, 128, 24, 10, 32>(metric, dim, param);
+  }
+  // ggnn/src/deep1b_multi_gpu.cu, and adapt it deep1B
+  else if (metric == Metric::kEuclidean && dim == 96 && param.k_build == 24 && param.k == 10 &&
+           param.segment_size == 32) {
+    impl_ = new GgnnImpl<T, Euclidean, 96, 24, 10, 32>(metric, dim, param);
+  } else if (metric == Metric::kInnerProduct && dim == 96 && param.k_build == 24 && param.k == 10 &&
+             param.segment_size == 32) {
+    impl_ = new GgnnImpl<T, Cosine, 96, 24, 10, 32>(metric, dim, param);
+  } else if (metric == Metric::kInnerProduct && dim == 96 && param.k_build == 96 && param.k == 10 &&
+             param.segment_size == 64) {
+    impl_ = new GgnnImpl<T, Cosine, 96, 96, 10, 64>(metric, dim, param);
+  }
+  // ggnn/src/glove200.cu, adapt it to glove100
+  else if (metric == Metric::kInnerProduct && dim == 100 && param.k_build == 96 && param.k == 10 &&
+           param.segment_size == 64) {
+    impl_ = new GgnnImpl<T, Cosine, 100, 96, 10, 64>(metric, dim, param);
+  } else {
+    throw std::runtime_error(
+      "ggnn: not supported combination of metric, dim and build param; "
+      "see Ggnn's constructor in ggnn_wrapper.cuh for available combinations");
+  }
+}
+
+template <typename T, DistanceMeasure measure, int D, int KBuild, int KQuery, int S>
+class GgnnImpl : public ANN<T> {
+ public:
+  using typename ANN<T>::AnnSearchParam;
+
+  GgnnImpl(Metric metric, int dim, const typename Ggnn<T>::BuildParam& param);
+
+  void build(const T* dataset, size_t nrow, cudaStream_t stream = 0) override;
+
+  void set_search_param(const AnnSearchParam& param) override;
+  void search(const T* queries,
+              int batch_size,
+              int k,
+              size_t* neighbors,
+              float* distances,
+              cudaStream_t stream = 0) const override;
+
+  void save(const std::string& file) const override;
+  void load(const std::string& file) override;
+
+  AlgoProperty get_property() const override
+  {
+    AlgoProperty property;
+    property.dataset_memory_type      = MemoryType::Device;
+    property.query_memory_type        = MemoryType::Device;
+    property.need_dataset_when_search = true;
+    return property;
+  }
+
+  void set_search_dataset(const T* dataset, size_t nrow) override;
+
+ private:
+  using ANN<T>::metric_;
+  using ANN<T>::dim_;
+
+  using GGNNGPUInstance = GGNNGPUInstance<measure,
+                                          int64_t /* KeyT */,
+                                          float /* ValueT */,
+                                          size_t /* GAddrT */,
+                                          T /* BaseT */,
+                                          size_t /* BAddrT */,
+                                          D,
+                                          KBuild,
+                                          KBuild / 2 /* KF */,
+                                          KQuery,
+                                          S>;
+  std::unique_ptr<GGNNGPUInstance> ggnn_;
+  typename Ggnn<T>::BuildParam build_param_;
+  typename Ggnn<T>::SearchParam search_param_;
+};
+
+template <typename T, DistanceMeasure measure, int D, int KBuild, int KQuery, int S>
+GgnnImpl<T, measure, D, KBuild, KQuery, S>::GgnnImpl(Metric metric,
+                                                     int dim,
+                                                     const typename Ggnn<T>::BuildParam& param)
+  : ANN<T>(metric, dim), build_param_(param)
+{
+  if (metric_ == Metric::kInnerProduct) {
+    if (measure != Cosine) { throw std::runtime_error("mis-matched metric"); }
+  } else if (metric_ == Metric::kEuclidean) {
+    if (measure != Euclidean) { throw std::runtime_error("mis-matched metric"); }
+  } else {
+    throw std::runtime_error(
+      "ggnn supports only metric type of InnerProduct, Cosine and Euclidean");
+  }
+
+  if (dim != D) { throw std::runtime_error("mis-matched dim"); }
+
+  int device;
+  RAFT_CUDA_TRY(cudaGetDevice(&device));
+
+  ggnn_ = std::make_unique<GGNNGPUInstance>(
+    device, build_param_.dataset_size, build_param_.num_layers, true, build_param_.tau);
+}
+
+template <typename T, DistanceMeasure measure, int D, int KBuild, int KQuery, int S>
+void GgnnImpl<T, measure, D, KBuild, KQuery, S>::build(const T* dataset,
+                                                       size_t nrow,
+                                                       cudaStream_t stream)
+{
+  if (nrow != build_param_.dataset_size) {
+    throw std::runtime_error(
+      "build_param_.dataset_size = " + std::to_string(build_param_.dataset_size) +
+      " , but nrow = " + std::to_string(nrow));
+  }
+
+  ggnn_->set_base_data(dataset);
+  ggnn_->set_stream(stream);
+  ggnn_->build(0);
+  for (int i = 0; i < build_param_.refine_iterations; ++i) {
+    ggnn_->refine();
+  }
+}
+
+template <typename T, DistanceMeasure measure, int D, int KBuild, int KQuery, int S>
+void GgnnImpl<T, measure, D, KBuild, KQuery, S>::set_search_dataset(const T* dataset, size_t nrow)
+{
+  if (nrow != build_param_.dataset_size) {
+    throw std::runtime_error(
+      "build_param_.dataset_size = " + std::to_string(build_param_.dataset_size) +
+      " , but nrow = " + std::to_string(nrow));
+  }
+  ggnn_->set_base_data(dataset);
+}
+
+template <typename T, DistanceMeasure measure, int D, int KBuild, int KQuery, int S>
+void GgnnImpl<T, measure, D, KBuild, KQuery, S>::set_search_param(const AnnSearchParam& param)
+{
+  search_param_ = dynamic_cast<const typename Ggnn<T>::SearchParam&>(param);
+}
+
+template <typename T, DistanceMeasure measure, int D, int KBuild, int KQuery, int S>
+void GgnnImpl<T, measure, D, KBuild, KQuery, S>::search(const T* queries,
+                                                        int batch_size,
+                                                        int k,
+                                                        size_t* neighbors,
+                                                        float* distances,
+                                                        cudaStream_t stream) const
+{
+  static_assert(sizeof(size_t) == sizeof(int64_t), "sizes of size_t and GGNN's KeyT are different");
+  if (k != KQuery) {
+    throw std::runtime_error(
+      "k = " + std::to_string(k) +
+      ", but this GGNN instance only supports k = " + std::to_string(KQuery));
+  }
+
+  ggnn_->set_stream(stream);
+  RAFT_CUDA_TRY(cudaMemcpyToSymbol(c_tau_query, &search_param_.tau, sizeof(float)));
+
+  const int block_dim      = search_param_.block_dim;
+  const int max_iterations = search_param_.max_iterations;
+  const int cache_size     = search_param_.cache_size;
+  const int sorted_size    = search_param_.sorted_size;
+  // default value
+  if (block_dim == 32 && max_iterations == 400 && cache_size == 512 && sorted_size == 256) {
+    ggnn_->template queryLayer<32, 400, 512, 256, false>(
+      queries, batch_size, reinterpret_cast<int64_t*>(neighbors), distances);
+  }
+  // ggnn/src/sift1m.cu
+  else if (block_dim == 32 && max_iterations == 200 && cache_size == 256 && sorted_size == 64) {
+    ggnn_->template queryLayer<32, 200, 256, 64, false>(
+      queries, batch_size, reinterpret_cast<int64_t*>(neighbors), distances);
+  }
+  // ggnn/src/sift1m.cu
+  else if (block_dim == 32 && max_iterations == 400 && cache_size == 448 && sorted_size == 64) {
+    ggnn_->template queryLayer<32, 400, 448, 64, false>(
+      queries, batch_size, reinterpret_cast<int64_t*>(neighbors), distances);
+  }
+  // ggnn/src/glove200.cu
+  else if (block_dim == 128 && max_iterations == 2000 && cache_size == 2048 && sorted_size == 32) {
+    ggnn_->template queryLayer<128, 2000, 2048, 32, false>(
+      queries, batch_size, reinterpret_cast<int64_t*>(neighbors), distances);
+  }
+  // for glove100
+  else if (block_dim == 64 && max_iterations == 400 && cache_size == 512 && sorted_size == 32) {
+    ggnn_->template queryLayer<64, 400, 512, 32, false>(
+      queries, batch_size, reinterpret_cast<int64_t*>(neighbors), distances);
+  } else if (block_dim == 128 && max_iterations == 2000 && cache_size == 1024 &&
+             sorted_size == 32) {
+    ggnn_->template queryLayer<128, 2000, 1024, 32, false>(
+      queries, batch_size, reinterpret_cast<int64_t*>(neighbors), distances);
+  } else {
+    throw std::runtime_error("ggnn: not supported search param");
+  }
+}
+
+template <typename T, DistanceMeasure measure, int D, int KBuild, int KQuery, int S>
+void GgnnImpl<T, measure, D, KBuild, KQuery, S>::save(const std::string& file) const
+{
+  auto& ggnn_host   = ggnn_->ggnn_cpu_buffers.at(0);
+  auto& ggnn_device = ggnn_->ggnn_shards.at(0);
+  ggnn_->set_stream(0);
+
+  ggnn_host.downloadAsync(ggnn_device);
+  RAFT_CUDA_TRY(cudaStreamSynchronize(ggnn_device.stream));
+  ggnn_host.store(file);
+}
+
+template <typename T, DistanceMeasure measure, int D, int KBuild, int KQuery, int S>
+void GgnnImpl<T, measure, D, KBuild, KQuery, S>::load(const std::string& file)
+{
+  auto& ggnn_host   = ggnn_->ggnn_cpu_buffers.at(0);
+  auto& ggnn_device = ggnn_->ggnn_shards.at(0);
+  ggnn_->set_stream(0);
+
+  ggnn_host.load(file);
+  ggnn_host.uploadAsync(ggnn_device);
+  RAFT_CUDA_TRY(cudaStreamSynchronize(ggnn_device.stream));
+}
+
+}  // namespace raft::bench::ann
diff --git a/cpp/bench/ann/src/hnswlib/hnswlib_benchmark.cpp b/cpp/bench/ann/src/hnswlib/hnswlib_benchmark.cpp
new file mode 100644
index 0000000000..cd823e8a69
--- /dev/null
+++ b/cpp/bench/ann/src/hnswlib/hnswlib_benchmark.cpp
@@ -0,0 +1,120 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include <algorithm>
+#include <cmath>
+#include <memory>
+#include <stdexcept>
+#include <string>
+#include <type_traits>
+#include <utility>
+
+#include "../common/benchmark_util.hpp"
+
+#include "../common/ann_types.hpp"
+#undef WARP_SIZE
+#include "hnswlib_wrapper.h"
+#define JSON_DIAGNOSTICS 1
+#include <nlohmann/json.hpp>
+
+namespace raft::bench::ann {
+
+template <typename T>
+void parse_build_param(const nlohmann::json& conf,
+                       typename raft::bench::ann::HnswLib<T>::BuildParam& param)
+{
+  param.ef_construction = conf.at("efConstruction");
+  param.M               = conf.at("M");
+  if (conf.contains("numThreads")) { param.num_threads = conf.at("numThreads"); }
+}
+
+template <typename T>
+void parse_search_param(const nlohmann::json& conf,
+                        typename raft::bench::ann::HnswLib<T>::SearchParam& param)
+{
+  param.ef = conf.at("ef");
+  if (conf.contains("numThreads")) { param.num_threads = conf.at("numThreads"); }
+}
+
+template <typename T, template <typename> class Algo>
+std::unique_ptr<raft::bench::ann::ANN<T>> make_algo(raft::bench::ann::Metric metric,
+                                                    int dim,
+                                                    const nlohmann::json& conf)
+{
+  typename Algo<T>::BuildParam param;
+  parse_build_param<T>(conf, param);
+  return std::make_unique<Algo<T>>(metric, dim, param);
+}
+
+template <typename T, template <typename> class Algo>
+std::unique_ptr<raft::bench::ann::ANN<T>> make_algo(raft::bench::ann::Metric metric,
+                                                    int dim,
+                                                    const nlohmann::json& conf,
+                                                    const std::vector<int>& dev_list)
+{
+  typename Algo<T>::BuildParam param;
+  parse_build_param<T>(conf, param);
+
+  (void)dev_list;
+  return std::make_unique<Algo<T>>(metric, dim, param);
+}
+
+template <typename T>
+std::unique_ptr<raft::bench::ann::ANN<T>> create_algo(const std::string& algo,
+                                                      const std::string& distance,
+                                                      int dim,
+                                                      float refine_ratio,
+                                                      const nlohmann::json& conf,
+                                                      const std::vector<int>& dev_list)
+{
+  // stop compiler warning; not all algorithms support multi-GPU so it may not be used
+  (void)dev_list;
+
+  raft::bench::ann::Metric metric = parse_metric(distance);
+  std::unique_ptr<raft::bench::ann::ANN<T>> ann;
+
+  if constexpr (std::is_same_v<T, float>) {
+    if (algo == "hnswlib") { ann = make_algo<T, raft::bench::ann::HnswLib>(metric, dim, conf); }
+  }
+
+  if constexpr (std::is_same_v<T, uint8_t>) {
+    if (algo == "hnswlib") { ann = make_algo<T, raft::bench::ann::HnswLib>(metric, dim, conf); }
+  }
+
+  if (!ann) { throw std::runtime_error("invalid algo: '" + algo + "'"); }
+
+  if (refine_ratio > 1.0) {}
+  return ann;
+}
+
+template <typename T>
+std::unique_ptr<typename raft::bench::ann::ANN<T>::AnnSearchParam> create_search_param(
+  const std::string& algo, const nlohmann::json& conf)
+{
+  if (algo == "hnswlib") {
+    auto param = std::make_unique<typename raft::bench::ann::HnswLib<T>::SearchParam>();
+    parse_search_param<T>(conf, *param);
+    return param;
+  }
+  // else
+  throw std::runtime_error("invalid algo: '" + algo + "'");
+}
+
+};  // namespace raft::bench::ann
+
+#include "../common/benchmark.hpp"
+
+int main(int argc, char** argv) { return raft::bench::ann::run_main(argc, argv); }
\ No newline at end of file
diff --git a/cpp/bench/ann/src/hnswlib/hnswlib_wrapper.h b/cpp/bench/ann/src/hnswlib/hnswlib_wrapper.h
new file mode 100644
index 0000000000..c5c3a4a2a6
--- /dev/null
+++ b/cpp/bench/ann/src/hnswlib/hnswlib_wrapper.h
@@ -0,0 +1,327 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#pragma once
+
+#include <algorithm>
+#include <atomic>
+#include <cassert>
+#include <cmath>
+#include <condition_variable>
+#include <cstdio>
+#include <ctime>
+#include <future>
+#include <memory>
+#include <mutex>
+#include <numeric>
+#include <stdexcept>
+#include <thread>
+#include <utility>
+#include <vector>
+
+#include "../common/ann_types.hpp"
+#include <hnswlib.h>
+
+namespace raft::bench::ann {
+
+template <typename T>
+struct hnsw_dist_t {
+  using type = void;
+};
+
+template <>
+struct hnsw_dist_t<float> {
+  using type = float;
+};
+
+template <>
+struct hnsw_dist_t<uint8_t> {
+  using type = int;
+};
+
+class FixedThreadPool {
+ public:
+  FixedThreadPool(int num_threads)
+  {
+    if (num_threads < 1) {
+      throw std::runtime_error("num_threads must >= 1");
+    } else if (num_threads == 1) {
+      return;
+    }
+
+    tasks_ = new Task_[num_threads];
+
+    threads_.reserve(num_threads);
+    for (int i = 0; i < num_threads; ++i) {
+      threads_.emplace_back([&, i] {
+        auto& task = tasks_[i];
+        while (true) {
+          std::unique_lock<std::mutex> lock(task.mtx);
+          task.cv.wait(lock,
+                       [&] { return task.has_task || finished_.load(std::memory_order_relaxed); });
+          if (finished_.load(std::memory_order_relaxed)) { break; }
+
+          task.task();
+          task.has_task = false;
+        }
+      });
+    }
+  }
+
+  ~FixedThreadPool()
+  {
+    if (threads_.empty()) { return; }
+
+    finished_.store(true, std::memory_order_relaxed);
+    for (unsigned i = 0; i < threads_.size(); ++i) {
+      auto& task = tasks_[i];
+      std::lock_guard<std::mutex>(task.mtx);
+
+      task.cv.notify_one();
+      threads_[i].join();
+    }
+
+    delete[] tasks_;
+  }
+
+  template <typename Func, typename IdxT>
+  void submit(Func f, IdxT len)
+  {
+    if (threads_.empty()) {
+      for (IdxT i = 0; i < len; ++i) {
+        f(i);
+      }
+      return;
+    }
+
+    const int num_threads = threads_.size();
+    // one extra part for competition among threads
+    const IdxT items_per_thread = len / (num_threads + 1);
+    std::atomic<IdxT> cnt(items_per_thread * num_threads);
+
+    auto wrapped_f = [&](IdxT start, IdxT end) {
+      for (IdxT i = start; i < end; ++i) {
+        f(i);
+      }
+
+      while (true) {
+        IdxT i = cnt.fetch_add(1, std::memory_order_relaxed);
+        if (i >= len) { break; }
+        f(i);
+      }
+    };
+
+    std::vector<std::future<void>> futures;
+    futures.reserve(num_threads);
+    for (int i = 0; i < num_threads; ++i) {
+      IdxT start = i * items_per_thread;
+      auto& task = tasks_[i];
+      {
+        std::lock_guard lock(task.mtx);
+        (void)lock;  // stop nvcc warning
+        task.task = std::packaged_task<void()>([=] { wrapped_f(start, start + items_per_thread); });
+        futures.push_back(task.task.get_future());
+        task.has_task = true;
+      }
+      task.cv.notify_one();
+    }
+
+    for (auto& fut : futures) {
+      fut.wait();
+    }
+    return;
+  }
+
+ private:
+  struct alignas(64) Task_ {
+    std::mutex mtx;
+    std::condition_variable cv;
+    bool has_task = false;
+    std::packaged_task<void()> task;
+  };
+
+  Task_* tasks_;
+  std::vector<std::thread> threads_;
+  std::atomic<bool> finished_{false};
+};
+
+template <typename T>
+class HnswLib : public ANN<T> {
+ public:
+  // https://github.com/nmslib/hnswlib/blob/master/ALGO_PARAMS.md
+  struct BuildParam {
+    int M;
+    int ef_construction;
+    int num_threads{1};
+  };
+
+  using typename ANN<T>::AnnSearchParam;
+  struct SearchParam : public AnnSearchParam {
+    int ef;
+    int num_threads{1};
+  };
+
+  HnswLib(Metric metric, int dim, const BuildParam& param);
+
+  void build(const T* dataset, size_t nrow, cudaStream_t stream = 0) override;
+
+  void set_search_param(const AnnSearchParam& param) override;
+  void search(const T* query,
+              int batch_size,
+              int k,
+              size_t* indices,
+              float* distances,
+              cudaStream_t stream = 0) const override;
+
+  void save(const std::string& path_to_index) const override;
+  void load(const std::string& path_to_index) override;
+
+  AlgoProperty get_property() const override
+  {
+    AlgoProperty property;
+    property.dataset_memory_type      = MemoryType::Host;
+    property.query_memory_type        = MemoryType::Host;
+    property.need_dataset_when_search = false;
+    return property;
+  }
+
+ private:
+  void get_search_knn_results_(const T* query, int k, size_t* indices, float* distances) const;
+
+  std::unique_ptr<hnswlib::HierarchicalNSW<typename hnsw_dist_t<T>::type>> appr_alg_;
+  std::unique_ptr<hnswlib::SpaceInterface<typename hnsw_dist_t<T>::type>> space_;
+
+  using ANN<T>::metric_;
+  using ANN<T>::dim_;
+  int ef_construction_;
+  int m_;
+  int num_threads_;
+  std::unique_ptr<FixedThreadPool> thread_pool_;
+};
+
+template <typename T>
+HnswLib<T>::HnswLib(Metric metric, int dim, const BuildParam& param) : ANN<T>(metric, dim)
+{
+  assert(dim_ > 0);
+  static_assert(std::is_same_v<T, float> || std::is_same_v<T, uint8_t>);
+  if constexpr (std::is_same_v<T, uint8_t>) {
+    if (metric_ != Metric::kEuclidean) {
+      throw std::runtime_error("hnswlib<uint8_t> only supports Euclidean distance");
+    }
+  }
+
+  ef_construction_ = param.ef_construction;
+  m_               = param.M;
+  num_threads_     = param.num_threads;
+}
+
+template <typename T>
+void HnswLib<T>::build(const T* dataset, size_t nrow, cudaStream_t)
+{
+  if constexpr (std::is_same_v<T, float>) {
+    if (metric_ == Metric::kInnerProduct) {
+      space_ = std::make_unique<hnswlib::InnerProductSpace>(dim_);
+    } else {
+      space_ = std::make_unique<hnswlib::L2Space>(dim_);
+    }
+  } else if constexpr (std::is_same_v<T, uint8_t>) {
+    space_ = std::make_unique<hnswlib::L2SpaceI>(dim_);
+  }
+
+  appr_alg_ = std::make_unique<hnswlib::HierarchicalNSW<typename hnsw_dist_t<T>::type>>(
+    space_.get(), nrow, m_, ef_construction_);
+
+  thread_pool_                  = std::make_unique<FixedThreadPool>(num_threads_);
+  const size_t items_per_thread = nrow / (num_threads_ + 1);
+
+  thread_pool_->submit(
+    [&](size_t i) {
+      if (i < items_per_thread && i % 10000 == 0) {
+        char buf[20];
+        std::time_t now = std::time(nullptr);
+        std::strftime(buf, sizeof(buf), "%Y-%m-%d %H:%M:%S", std::localtime(&now));
+
+        printf("%s building %zu / %zu\n", buf, i, items_per_thread);
+        fflush(stdout);
+      }
+
+      appr_alg_->addPoint(dataset + i * dim_, i);
+    },
+    nrow);
+}
+
+template <typename T>
+void HnswLib<T>::set_search_param(const AnnSearchParam& param_)
+{
+  auto param     = dynamic_cast<const SearchParam&>(param_);
+  appr_alg_->ef_ = param.ef;
+
+  if (!thread_pool_ || num_threads_ != param.num_threads) {
+    num_threads_ = param.num_threads;
+    thread_pool_ = std::make_unique<FixedThreadPool>(num_threads_);
+  }
+}
+
+template <typename T>
+void HnswLib<T>::search(
+  const T* query, int batch_size, int k, size_t* indices, float* distances, cudaStream_t) const
+{
+  thread_pool_->submit(
+    [&](int i) {
+      get_search_knn_results_(query + i * dim_, k, indices + i * k, distances + i * k);
+    },
+    batch_size);
+}
+
+template <typename T>
+void HnswLib<T>::save(const std::string& path_to_index) const
+{
+  appr_alg_->saveIndex(std::string(path_to_index));
+}
+
+template <typename T>
+void HnswLib<T>::load(const std::string& path_to_index)
+{
+  if constexpr (std::is_same_v<T, float>) {
+    if (metric_ == Metric::kInnerProduct) {
+      space_ = std::make_unique<hnswlib::InnerProductSpace>(dim_);
+    } else {
+      space_ = std::make_unique<hnswlib::L2Space>(dim_);
+    }
+  } else if constexpr (std::is_same_v<T, uint8_t>) {
+    space_ = std::make_unique<hnswlib::L2SpaceI>(dim_);
+  }
+
+  appr_alg_ = std::make_unique<hnswlib::HierarchicalNSW<typename hnsw_dist_t<T>::type>>(
+    space_.get(), path_to_index);
+}
+
+template <typename T>
+void HnswLib<T>::get_search_knn_results_(const T* query,
+                                         int k,
+                                         size_t* indices,
+                                         float* distances) const
+{
+  auto result = appr_alg_->searchKnn(query, k);
+  assert(result.size() >= static_cast<size_t>(k));
+
+  for (int i = k - 1; i >= 0; --i) {
+    indices[i]   = result.top().second;
+    distances[i] = result.top().first;
+    result.pop();
+  }
+}
+
+};  // namespace raft::bench::ann
diff --git a/cpp/bench/ann/src/raft/raft_ann_bench_utils.h b/cpp/bench/ann/src/raft/raft_ann_bench_utils.h
new file mode 100644
index 0000000000..cb30c2693f
--- /dev/null
+++ b/cpp/bench/ann/src/raft/raft_ann_bench_utils.h
@@ -0,0 +1,44 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#pragma once
+#include <cassert>
+#include <fstream>
+#include <iostream>
+#include <memory>
+#include <raft/core/device_mdspan.hpp>
+#include <raft/core/logger.hpp>
+#include <raft/distance/distance_types.hpp>
+#include <raft/util/cudart_utils.hpp>
+#include <rmm/device_uvector.hpp>
+#include <sstream>
+#include <stdexcept>
+#include <string>
+#include <type_traits>
+
+namespace raft::bench::ann {
+
+inline raft::distance::DistanceType parse_metric_type(raft::bench::ann::Metric metric)
+{
+  if (metric == raft::bench::ann::Metric::kInnerProduct) {
+    return raft::distance::DistanceType::InnerProduct;
+  } else if (metric == raft::bench::ann::Metric::kEuclidean) {
+    // Even for L2 expanded RAFT IVF Flat uses unexpanded formula
+    return raft::distance::DistanceType::L2Expanded;
+  } else {
+    throw std::runtime_error("raft supports only metric type of inner product and L2");
+  }
+}
+}  // namespace raft::bench::ann
diff --git a/cpp/bench/ann/src/raft/raft_benchmark.cu b/cpp/bench/ann/src/raft/raft_benchmark.cu
new file mode 100644
index 0000000000..d8e98ce2a9
--- /dev/null
+++ b/cpp/bench/ann/src/raft/raft_benchmark.cu
@@ -0,0 +1,223 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#include <algorithm>
+#include <cmath>
+#include <memory>
+#include <stdexcept>
+#include <string>
+#include <type_traits>
+#include <utility>
+
+#ifdef RAFT_COMPILED
+#include <raft/neighbors/specializations.cuh>
+#endif
+
+#include "../common/ann_types.hpp"
+#include "../common/benchmark_util.hpp"
+#undef WARP_SIZE
+#ifdef RAFT_ANN_BENCH_USE_RAFT_BFKNN
+#include "raft_wrapper.h"
+#endif
+#ifdef RAFT_ANN_BENCH_USE_RAFT_IVF_FLAT
+#include "raft_ivf_flat_wrapper.h"
+extern template class raft::bench::ann::RaftIvfFlatGpu<float, int64_t>;
+extern template class raft::bench::ann::RaftIvfFlatGpu<uint8_t, int64_t>;
+extern template class raft::bench::ann::RaftIvfFlatGpu<int8_t, int64_t>;
+#endif
+#ifdef RAFT_ANN_BENCH_USE_RAFT_IVF_PQ
+#include "raft_ivf_pq_wrapper.h"
+extern template class raft::bench::ann::RaftIvfPQ<float, int64_t>;
+extern template class raft::bench::ann::RaftIvfPQ<uint8_t, int64_t>;
+extern template class raft::bench::ann::RaftIvfPQ<int8_t, int64_t>;
+#endif
+#define JSON_DIAGNOSTICS 1
+#include <nlohmann/json.hpp>
+
+namespace raft::bench::ann {
+
+#ifdef RAFT_ANN_BENCH_USE_RAFT_IVF_FLAT
+template <typename T, typename IdxT>
+void parse_build_param(const nlohmann::json& conf,
+                       typename raft::bench::ann::RaftIvfFlatGpu<T, IdxT>::BuildParam& param)
+{
+  param.n_lists = conf.at("nlist");
+  if (conf.contains("niter")) { param.kmeans_n_iters = conf.at("niter"); }
+  if (conf.contains("ratio")) {
+    param.kmeans_trainset_fraction = 1.0 / (double)conf.at("ratio");
+    std::cout << "kmeans_trainset_fraction " << param.kmeans_trainset_fraction;
+  }
+}
+
+template <typename T, typename IdxT>
+void parse_search_param(const nlohmann::json& conf,
+                        typename raft::bench::ann::RaftIvfFlatGpu<T, IdxT>::SearchParam& param)
+{
+  param.ivf_flat_params.n_probes = conf.at("nprobe");
+}
+#endif
+
+#ifdef RAFT_ANN_BENCH_USE_RAFT_IVF_PQ
+template <typename T, typename IdxT>
+void parse_build_param(const nlohmann::json& conf,
+                       typename raft::bench::ann::RaftIvfPQ<T, IdxT>::BuildParam& param)
+{
+  param.n_lists = conf.at("nlist");
+  if (conf.contains("niter")) { param.kmeans_n_iters = conf.at("niter"); }
+  if (conf.contains("ratio")) { param.kmeans_trainset_fraction = 1.0 / (double)conf.at("ratio"); }
+  if (conf.contains("pq_bits")) { param.pq_bits = conf.at("pq_bits"); }
+  if (conf.contains("pq_dim")) { param.pq_dim = conf.at("pq_dim"); }
+}
+
+template <typename T, typename IdxT>
+void parse_search_param(const nlohmann::json& conf,
+                        typename raft::bench::ann::RaftIvfPQ<T, IdxT>::SearchParam& param)
+{
+  param.pq_param.n_probes = conf.at("numProbes");
+  if (conf.contains("internalDistanceDtype")) {
+    std::string type = conf.at("internalDistanceDtype");
+    if (type == "float") {
+      param.pq_param.internal_distance_dtype = CUDA_R_32F;
+    } else if (type == "half") {
+      param.pq_param.internal_distance_dtype = CUDA_R_16F;
+    } else {
+      throw std::runtime_error("internalDistanceDtype: '" + type +
+                               "', should be either 'float' or 'half'");
+    }
+  } else {
+    // set half as default type
+    param.pq_param.internal_distance_dtype = CUDA_R_16F;
+  }
+
+  if (conf.contains("smemLutDtype")) {
+    std::string type = conf.at("smemLutDtype");
+    if (type == "float") {
+      param.pq_param.lut_dtype = CUDA_R_32F;
+    } else if (type == "half") {
+      param.pq_param.lut_dtype = CUDA_R_16F;
+    } else if (type == "fp8") {
+      param.pq_param.lut_dtype = CUDA_R_8U;
+    } else {
+      throw std::runtime_error("smemLutDtype: '" + type +
+                               "', should be either 'float', 'half' or 'fp8'");
+    }
+  } else {
+    // set half as default
+    param.pq_param.lut_dtype = CUDA_R_16F;
+  }
+}
+#endif
+
+template <typename T, template <typename> class Algo>
+std::unique_ptr<raft::bench::ann::ANN<T>> make_algo(raft::bench::ann::Metric metric,
+                                                    int dim,
+                                                    const nlohmann::json& conf)
+{
+  typename Algo<T>::BuildParam param;
+  parse_build_param<T>(conf, param);
+  return std::make_unique<Algo<T>>(metric, dim, param);
+}
+
+template <typename T, template <typename> class Algo>
+std::unique_ptr<raft::bench::ann::ANN<T>> make_algo(raft::bench::ann::Metric metric,
+                                                    int dim,
+                                                    const nlohmann::json& conf,
+                                                    const std::vector<int>& dev_list)
+{
+  typename Algo<T>::BuildParam param;
+  parse_build_param<T>(conf, param);
+
+  (void)dev_list;
+  return std::make_unique<Algo<T>>(metric, dim, param);
+}
+
+template <typename T>
+std::unique_ptr<raft::bench::ann::ANN<T>> create_algo(const std::string& algo,
+                                                      const std::string& distance,
+                                                      int dim,
+                                                      float refine_ratio,
+                                                      const nlohmann::json& conf,
+                                                      const std::vector<int>& dev_list)
+{
+  // stop compiler warning; not all algorithms support multi-GPU so it may not be used
+  (void)dev_list;
+
+  raft::bench::ann::Metric metric = parse_metric(distance);
+  std::unique_ptr<raft::bench::ann::ANN<T>> ann;
+
+  if constexpr (std::is_same_v<T, float>) {
+#ifdef RAFT_ANN_BENCH_USE_RAFT_BFKNN
+    if (algo == "raft_bfknn") { ann = std::make_unique<raft::bench::ann::RaftGpu<T>>(metric, dim); }
+#endif
+  }
+
+  if constexpr (std::is_same_v<T, uint8_t>) {}
+
+#ifdef RAFT_ANN_BENCH_USE_RAFT_IVF_FLAT
+  if (algo == "raft_ivf_flat") {
+    typename raft::bench::ann::RaftIvfFlatGpu<T, int64_t>::BuildParam param;
+    parse_build_param<T, int64_t>(conf, param);
+    ann = std::make_unique<raft::bench::ann::RaftIvfFlatGpu<T, int64_t>>(metric, dim, param);
+  }
+#endif
+#ifdef RAFT_ANN_BENCH_USE_RAFT_IVF_PQ
+  if (algo == "raft_ivf_pq") {
+    typename raft::bench::ann::RaftIvfPQ<T, int64_t>::BuildParam param;
+    parse_build_param<T, int64_t>(conf, param);
+    ann =
+      std::make_unique<raft::bench::ann::RaftIvfPQ<T, int64_t>>(metric, dim, param, refine_ratio);
+  }
+#endif
+  if (!ann) { throw std::runtime_error("invalid algo: '" + algo + "'"); }
+
+  if (refine_ratio > 1.0) {}
+  return ann;
+}
+
+template <typename T>
+std::unique_ptr<typename raft::bench::ann::ANN<T>::AnnSearchParam> create_search_param(
+  const std::string& algo, const nlohmann::json& conf)
+{
+#ifdef RAFT_ANN_BENCH_USE_RAFT_BFKNN
+  if (algo == "raft_bfknn") {
+    auto param = std::make_unique<typename raft::bench::ann::ANN<T>::AnnSearchParam>();
+    return param;
+  }
+#endif
+#ifdef RAFT_ANN_BENCH_USE_RAFT_IVF_FLAT
+  if (algo == "raft_ivf_flat") {
+    auto param =
+      std::make_unique<typename raft::bench::ann::RaftIvfFlatGpu<T, int64_t>::SearchParam>();
+    parse_search_param<T, int64_t>(conf, *param);
+    return param;
+  }
+#endif
+#ifdef RAFT_ANN_BENCH_USE_RAFT_IVF_PQ
+  if (algo == "raft_ivf_pq") {
+    auto param = std::make_unique<typename raft::bench::ann::RaftIvfPQ<T, int64_t>::SearchParam>();
+    parse_search_param<T, int64_t>(conf, *param);
+    return param;
+  }
+#endif
+  // else
+  throw std::runtime_error("invalid algo: '" + algo + "'");
+}
+
+};  // namespace raft::bench::ann
+
+#include "../common/benchmark.hpp"
+
+int main(int argc, char** argv) { return raft::bench::ann::run_main(argc, argv); }
\ No newline at end of file
diff --git a/cpp/bench/ann/src/raft/raft_ivf_flat.cu b/cpp/bench/ann/src/raft/raft_ivf_flat.cu
new file mode 100644
index 0000000000..ff108080b5
--- /dev/null
+++ b/cpp/bench/ann/src/raft/raft_ivf_flat.cu
@@ -0,0 +1,26 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#include "raft_ivf_flat_wrapper.h"
+
+#ifdef RAFT_COMPILED
+#include <raft/neighbors/specializations.cuh>
+#endif
+
+namespace raft::bench::ann {
+template class RaftIvfFlatGpu<float, int64_t>;
+template class RaftIvfFlatGpu<uint8_t, int64_t>;
+template class RaftIvfFlatGpu<int8_t, int64_t>;
+}  // namespace raft::bench::ann
\ No newline at end of file
diff --git a/cpp/bench/ann/src/raft/raft_ivf_flat_wrapper.h b/cpp/bench/ann/src/raft/raft_ivf_flat_wrapper.h
new file mode 100644
index 0000000000..8b2a7d329b
--- /dev/null
+++ b/cpp/bench/ann/src/raft/raft_ivf_flat_wrapper.h
@@ -0,0 +1,142 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#pragma once
+
+#include <cassert>
+#include <fstream>
+#include <iostream>
+#include <memory>
+#include <raft/core/device_mdspan.hpp>
+#include <raft/core/device_resources.hpp>
+#include <raft/core/logger.hpp>
+#include <raft/distance/detail/distance.cuh>
+#include <raft/distance/distance_types.hpp>
+#include <raft/linalg/unary_op.cuh>
+#include <raft/neighbors/ivf_flat.cuh>
+#include <raft/neighbors/ivf_flat_types.hpp>
+#include <raft/util/cudart_utils.hpp>
+#include <rmm/device_uvector.hpp>
+#include <stdexcept>
+#include <string>
+#include <type_traits>
+
+#include "../common/ann_types.hpp"
+#include "raft_ann_bench_utils.h"
+#include <raft/util/cudart_utils.hpp>
+
+namespace raft::bench::ann {
+
+template <typename T, typename IdxT>
+class RaftIvfFlatGpu : public ANN<T> {
+ public:
+  using typename ANN<T>::AnnSearchParam;
+
+  struct SearchParam : public AnnSearchParam {
+    raft::neighbors::ivf_flat::search_params ivf_flat_params;
+  };
+
+  using BuildParam = raft::neighbors::ivf_flat::index_params;
+
+  RaftIvfFlatGpu(Metric metric, int dim, const BuildParam& param);
+
+  void build(const T* dataset, size_t nrow, cudaStream_t stream) final;
+
+  void set_search_param(const AnnSearchParam& param) override;
+
+  // TODO: if the number of results is less than k, the remaining elements of 'neighbors'
+  // will be filled with (size_t)-1
+  void search(const T* queries,
+              int batch_size,
+              int k,
+              size_t* neighbors,
+              float* distances,
+              cudaStream_t stream = 0) const override;
+
+  // to enable dataset access from GPU memory
+  AlgoProperty get_property() const override
+  {
+    AlgoProperty property;
+    property.dataset_memory_type      = MemoryType::Device;
+    property.query_memory_type        = MemoryType::Device;
+    property.need_dataset_when_search = false;
+    return property;
+  }
+  void save(const std::string& file) const override;
+  void load(const std::string&) override;
+
+ private:
+  raft::device_resources handle_;
+  BuildParam index_params_;
+  raft::neighbors::ivf_flat::search_params search_params_;
+  std::optional<raft::neighbors::ivf_flat::index<T, IdxT>> index_;
+  int device_;
+  int dimension_;
+  rmm::mr::pool_memory_resource<rmm::mr::device_memory_resource> mr_;
+};
+
+template <typename T, typename IdxT>
+RaftIvfFlatGpu<T, IdxT>::RaftIvfFlatGpu(Metric metric, int dim, const BuildParam& param)
+  : ANN<T>(metric, dim),
+    index_params_(param),
+    dimension_(dim),
+    mr_(rmm::mr::get_current_device_resource(), 1024 * 1024 * 1024ull)
+{
+  index_params_.metric = parse_metric_type(metric);
+  RAFT_CUDA_TRY(cudaGetDevice(&device_));
+}
+
+template <typename T, typename IdxT>
+void RaftIvfFlatGpu<T, IdxT>::build(const T* dataset, size_t nrow, cudaStream_t)
+{
+  index_.emplace(
+    raft::neighbors::ivf_flat::build(handle_, index_params_, dataset, IdxT(nrow), dimension_));
+  return;
+}
+
+template <typename T, typename IdxT>
+void RaftIvfFlatGpu<T, IdxT>::set_search_param(const AnnSearchParam& param)
+{
+  auto search_param = dynamic_cast<const SearchParam&>(param);
+  search_params_    = search_param.ivf_flat_params;
+  assert(search_params_.n_probes <= index_params_.n_lists);
+}
+
+template <typename T, typename IdxT>
+void RaftIvfFlatGpu<T, IdxT>::save(const std::string& file) const
+{
+  raft::neighbors::ivf_flat::serialize(handle_, file, *index_);
+  return;
+}
+
+template <typename T, typename IdxT>
+void RaftIvfFlatGpu<T, IdxT>::load(const std::string& file)
+{
+  index_ = raft::neighbors::ivf_flat::deserialize<T, IdxT>(handle_, file);
+  return;
+}
+
+template <typename T, typename IdxT>
+void RaftIvfFlatGpu<T, IdxT>::search(
+  const T* queries, int batch_size, int k, size_t* neighbors, float* distances, cudaStream_t) const
+{
+  rmm::mr::device_memory_resource* mr_ptr = &const_cast<RaftIvfFlatGpu*>(this)->mr_;
+  static_assert(sizeof(size_t) == sizeof(IdxT), "IdxT is incompatible with size_t");
+  raft::neighbors::ivf_flat::search(
+    handle_, search_params_, *index_, queries, batch_size, k, (IdxT*)neighbors, distances, mr_ptr);
+  handle_.sync_stream();
+  return;
+}
+}  // namespace raft::bench::ann
diff --git a/cpp/bench/ann/src/raft/raft_ivf_pq.cu b/cpp/bench/ann/src/raft/raft_ivf_pq.cu
new file mode 100644
index 0000000000..338bc9a32f
--- /dev/null
+++ b/cpp/bench/ann/src/raft/raft_ivf_pq.cu
@@ -0,0 +1,26 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#include "raft_ivf_pq_wrapper.h"
+
+#ifdef RAFT_COMPILED
+#include <raft/neighbors/specializations.cuh>
+#endif
+
+namespace raft::bench::ann {
+template class RaftIvfPQ<float, int64_t>;
+template class RaftIvfPQ<uint8_t, int64_t>;
+template class RaftIvfPQ<int8_t, int64_t>;
+}  // namespace raft::bench::ann
diff --git a/cpp/bench/ann/src/raft/raft_ivf_pq_wrapper.h b/cpp/bench/ann/src/raft/raft_ivf_pq_wrapper.h
new file mode 100644
index 0000000000..70dff81847
--- /dev/null
+++ b/cpp/bench/ann/src/raft/raft_ivf_pq_wrapper.h
@@ -0,0 +1,214 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#pragma once
+
+#include <raft/core/device_mdarray.hpp>
+#include <raft/core/device_mdspan.hpp>
+#include <raft/core/device_resources.hpp>
+#include <raft/core/host_mdarray.hpp>
+#include <raft/core/host_mdspan.hpp>
+#include <raft/core/logger.hpp>
+#include <raft/distance/distance_types.hpp>
+#include <raft/linalg/unary_op.cuh>
+#include <raft/neighbors/ivf_pq_types.hpp>
+#include <raft/util/cudart_utils.hpp>
+#include <raft_runtime/neighbors/ivf_pq.hpp>
+#include <raft_runtime/neighbors/refine.hpp>
+#include <rmm/device_uvector.hpp>
+#include <rmm/mr/device/device_memory_resource.hpp>
+#include <rmm/mr/device/pool_memory_resource.hpp>
+#include <type_traits>
+
+#include "../common/ann_types.hpp"
+#include "raft_ann_bench_utils.h"
+#include <raft/util/cudart_utils.hpp>
+
+namespace raft::bench::ann {
+
+template <typename T, typename IdxT>
+class RaftIvfPQ : public ANN<T> {
+ public:
+  using typename ANN<T>::AnnSearchParam;
+
+  struct SearchParam : public AnnSearchParam {
+    raft::neighbors::ivf_pq::search_params pq_param;
+  };
+
+  using BuildParam = raft::neighbors::ivf_pq::index_params;
+
+  RaftIvfPQ(Metric metric, int dim, const BuildParam& param, float refine_ratio);
+
+  void build(const T* dataset, size_t nrow, cudaStream_t stream) final;
+
+  void set_search_param(const AnnSearchParam& param) override;
+  void set_search_dataset(const T* dataset, size_t nrow) override;
+
+  // TODO: if the number of results is less than k, the remaining elements of 'neighbors'
+  // will be filled with (size_t)-1
+  void search(const T* queries,
+              int batch_size,
+              int k,
+              size_t* neighbors,
+              float* distances,
+              cudaStream_t stream = 0) const override;
+
+  // to enable dataset access from GPU memory
+  AlgoProperty get_property() const override
+  {
+    AlgoProperty property;
+    property.dataset_memory_type      = MemoryType::Host;
+    property.query_memory_type        = MemoryType::Device;
+    property.need_dataset_when_search = true;  // actually it is only used during refinement
+    return property;
+  }
+  void save(const std::string& file) const override;
+  void load(const std::string&) override;
+
+ private:
+  raft::device_resources handle_;
+  BuildParam index_params_;
+  raft::neighbors::ivf_pq::search_params search_params_;
+  std::optional<raft::neighbors::ivf_pq::index<IdxT>> index_;
+  int device_;
+  int dimension_;
+  float refine_ratio_ = 1.0;
+  rmm::mr::pool_memory_resource<rmm::mr::device_memory_resource> mr_;
+  raft::device_matrix_view<const T, IdxT> dataset_;
+};
+template <typename T, typename IdxT>
+RaftIvfPQ<T, IdxT>::RaftIvfPQ(Metric metric, int dim, const BuildParam& param, float refine_ratio)
+  : ANN<T>(metric, dim),
+    index_params_(param),
+    dimension_(dim),
+    refine_ratio_(refine_ratio),
+    mr_(rmm::mr::get_current_device_resource(), 1024 * 1024 * 1024ull)
+{
+  index_params_.metric = parse_metric_type(metric);
+  RAFT_CUDA_TRY(cudaGetDevice(&device_));
+}
+
+template <typename T, typename IdxT>
+void RaftIvfPQ<T, IdxT>::save(const std::string& file) const
+{
+  raft::runtime::neighbors::ivf_pq::serialize(handle_, file, *index_);
+}
+
+template <typename T, typename IdxT>
+void RaftIvfPQ<T, IdxT>::load(const std::string& file)
+{
+  auto index_tmp = raft::neighbors::ivf_pq::index<IdxT>(handle_, index_params_, dimension_);
+  raft::runtime::neighbors::ivf_pq::deserialize(handle_, file, &index_tmp);
+  index_.emplace(std::move(index_tmp));
+  return;
+}
+
+template <typename T, typename IdxT>
+void RaftIvfPQ<T, IdxT>::build(const T* dataset, size_t nrow, cudaStream_t)
+{
+  auto dataset_v = raft::make_device_matrix_view<const T, IdxT>(dataset, IdxT(nrow), index_->dim());
+
+  index_.emplace(raft::runtime::neighbors::ivf_pq::build(handle_, index_params_, dataset_v));
+  return;
+}
+
+template <typename T, typename IdxT>
+void RaftIvfPQ<T, IdxT>::set_search_param(const AnnSearchParam& param)
+{
+  auto search_param = dynamic_cast<const SearchParam&>(param);
+  search_params_    = search_param.pq_param;
+  assert(search_params_.n_probes <= index_params_.n_lists);
+}
+
+template <typename T, typename IdxT>
+void RaftIvfPQ<T, IdxT>::set_search_dataset(const T* dataset, size_t nrow)
+{
+  dataset_ = raft::make_device_matrix_view<const T, IdxT>(dataset, nrow, index_->dim());
+}
+
+template <typename T, typename IdxT>
+void RaftIvfPQ<T, IdxT>::search(const T* queries,
+                                int batch_size,
+                                int k,
+                                size_t* neighbors,
+                                float* distances,
+                                cudaStream_t stream) const
+{
+  if (refine_ratio_ > 1.0f) {
+    uint32_t k0 = static_cast<uint32_t>(refine_ratio_ * k);
+    auto queries_v =
+      raft::make_device_matrix_view<const T, IdxT>(queries, batch_size, index_->dim());
+    auto distances_tmp = raft::make_device_matrix<float, IdxT>(handle_, batch_size, k0);
+    auto candidates    = raft::make_device_matrix<IdxT, IdxT>(handle_, batch_size, k0);
+
+    raft::runtime::neighbors::ivf_pq::search(
+      handle_, search_params_, *index_, queries_v, candidates.view(), distances_tmp.view());
+
+    if (get_property().dataset_memory_type == MemoryType::Device) {
+      auto queries_v =
+        raft::make_device_matrix_view<const T, IdxT>(queries, batch_size, index_->dim());
+      auto neighbors_v = raft::make_device_matrix_view<IdxT, IdxT>((IdxT*)neighbors, batch_size, k);
+      auto distances_v = raft::make_device_matrix_view<float, IdxT>(distances, batch_size, k);
+
+      raft::runtime::neighbors::refine(handle_,
+                                       dataset_,
+                                       queries_v,
+                                       candidates.view(),
+                                       neighbors_v,
+                                       distances_v,
+                                       index_->metric());
+    } else {
+      auto queries_host    = raft::make_host_matrix<T, IdxT>(batch_size, index_->dim());
+      auto candidates_host = raft::make_host_matrix<IdxT, IdxT>(batch_size, k0);
+      auto neighbors_host  = raft::make_host_matrix<IdxT, IdxT>(batch_size, k);
+      auto distances_host  = raft::make_host_matrix<float, IdxT>(batch_size, k);
+
+      raft::copy(queries_host.data_handle(), queries, queries_host.size(), handle_.get_stream());
+      raft::copy(candidates_host.data_handle(),
+                 candidates.data_handle(),
+                 candidates_host.size(),
+                 handle_.get_stream());
+
+      auto dataset_v = raft::make_host_matrix_view<const T, IdxT>(
+        dataset_.data_handle(), batch_size, index_->dim());
+
+      raft::runtime::neighbors::refine(handle_,
+                                       dataset_v,
+                                       queries_host.view(),
+                                       candidates_host.view(),
+                                       neighbors_host.view(),
+                                       distances_host.view(),
+                                       index_->metric());
+
+      raft::copy(neighbors,
+                 (size_t*)neighbors_host.data_handle(),
+                 neighbors_host.size(),
+                 handle_.get_stream());
+      raft::copy(
+        distances, distances_host.data_handle(), distances_host.size(), handle_.get_stream());
+    }
+  } else {
+    auto queries_v =
+      raft::make_device_matrix_view<const T, IdxT>(queries, batch_size, index_->dim());
+    auto neighbors_v = raft::make_device_matrix_view<IdxT, IdxT>((IdxT*)neighbors, batch_size, k);
+    auto distances_v = raft::make_device_matrix_view<float, IdxT>(distances, batch_size, k);
+
+    raft::runtime::neighbors::ivf_pq::search(
+      handle_, search_params_, *index_, queries_v, neighbors_v, distances_v);
+  }
+  handle_.sync_stream();
+  return;
+}
+}  // namespace raft::bench::ann
diff --git a/cpp/bench/ann/src/raft/raft_wrapper.h b/cpp/bench/ann/src/raft/raft_wrapper.h
new file mode 100644
index 0000000000..01f206ab70
--- /dev/null
+++ b/cpp/bench/ann/src/raft/raft_wrapper.h
@@ -0,0 +1,152 @@
+/*
+ * Copyright (c) 2023, NVIDIA CORPORATION.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#pragma once
+
+#include <cassert>
+#include <memory>
+#include <raft/distance/detail/distance.cuh>
+#include <raft/distance/distance_types.hpp>
+#include <raft/spatial/knn/detail/fused_l2_knn.cuh>
+#include <stdexcept>
+#include <string>
+#include <type_traits>
+
+#include "../common/ann_types.hpp"
+
+namespace raft_temp {
+
+inline raft::distance::DistanceType parse_metric_type(raft::bench::ann::Metric metric)
+{
+  if (metric == raft::bench::ann::Metric::kInnerProduct) {
+    return raft::distance::DistanceType::InnerProduct;
+  } else if (metric == raft::bench::ann::Metric::kEuclidean) {
+    return raft::distance::DistanceType::L2Expanded;
+  } else {
+    throw std::runtime_error("raft supports only metric type of inner product and L2");
+  }
+}
+
+}  // namespace raft_temp
+
+namespace raft::bench::ann {
+
+// brute force fused L2 KNN - RAFT
+template <typename T>
+class RaftGpu : public ANN<T> {
+ public:
+  using typename ANN<T>::AnnSearchParam;
+
+  RaftGpu(Metric metric, int dim);
+
+  void build(const T*, size_t, cudaStream_t) final;
+
+  void set_search_param(const AnnSearchParam& param) override;
+
+  // TODO: if the number of results is less than k, the remaining elements of 'neighbors'
+  // will be filled with (size_t)-1
+  void search(const T* queries,
+              int batch_size,
+              int k,
+              size_t* neighbors,
+              float* distances,
+              cudaStream_t stream = 0) const final;
+
+  // to enable dataset access from GPU memory
+  AlgoProperty get_property() const override
+  {
+    AlgoProperty property;
+    property.dataset_memory_type      = MemoryType::Device;
+    property.query_memory_type        = MemoryType::Device;
+    property.need_dataset_when_search = true;
+    return property;
+  }
+  void set_search_dataset(const T* dataset, size_t nrow) override;
+  void save(const std::string& file) const override;
+  void load(const std::string&) override { return; };
+
+ protected:
+  raft::distance::DistanceType metric_type_;
+  int device_;
+  const T* dataset_;
+  size_t nrow_;
+};
+
+template <typename T>
+RaftGpu<T>::RaftGpu(Metric metric, int dim)
+  : ANN<T>(metric, dim), metric_type_(raft_temp::parse_metric_type(metric))
+{
+  static_assert(std::is_same_v<T, float>, "raft support only float type");
+  assert(metric_type_ == raft::distance::DistanceType::L2Expanded);
+  RAFT_CUDA_TRY(cudaGetDevice(&device_));
+}
+
+template <typename T>
+void RaftGpu<T>::build(const T*, size_t, cudaStream_t)
+{
+  // as this is brute force algo so no index building required
+  return;
+}
+
+template <typename T>
+void RaftGpu<T>::set_search_param(const AnnSearchParam&)
+{
+  // Nothing to set here as it is brute force implementation
+}
+
+template <typename T>
+void RaftGpu<T>::set_search_dataset(const T* dataset, size_t nrow)
+{
+  dataset_ = dataset;
+  nrow_    = nrow;
+}
+
+template <typename T>
+void RaftGpu<T>::save(const std::string& file) const
+{
+  // create a empty index file as no index to store.
+  std::fstream fp;
+  fp.open(file.c_str(), std::ios::out);
+  if (!fp) {
+    printf("Error in creating file!!!\n");
+    ;
+    return;
+  }
+  fp.close();
+}
+
+template <typename T>
+void RaftGpu<T>::search(const T* queries,
+                        int batch_size,
+                        int k,
+                        size_t* neighbors,
+                        float* distances,
+                        cudaStream_t stream) const
+{
+  raft::spatial::knn::detail::fusedL2Knn(this->dim_,
+                                         reinterpret_cast<int64_t*>(neighbors),
+                                         distances,
+                                         dataset_,
+                                         queries,
+                                         nrow_,
+                                         static_cast<size_t>(batch_size),
+                                         k,
+                                         true,
+                                         true,
+                                         stream,
+                                         metric_type_);
+}
+
+}  // namespace raft::bench::ann
diff --git a/cpp/bench/prims/CMakeLists.txt b/cpp/bench/prims/CMakeLists.txt
new file mode 100644
index 0000000000..f03a552c1d
--- /dev/null
+++ b/cpp/bench/prims/CMakeLists.txt
@@ -0,0 +1,141 @@
+# =============================================================================
+# Copyright (c) 2022-2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+# in compliance with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software distributed under the License
+# is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+# or implied. See the License for the specific language governing permissions and limitations under
+# the License.
+# =============================================================================
+
+# ##################################################################################################
+# * compiler function -----------------------------------------------------------------------------
+
+function(ConfigureBench)
+
+  set(options OPTIONAL LIB)
+  set(oneValueArgs NAME)
+  set(multiValueArgs PATH TARGETS CONFIGURATIONS)
+
+  cmake_parse_arguments(ConfigureBench "${options}" "${oneValueArgs}" "${multiValueArgs}" ${ARGN})
+
+  set(BENCH_NAME ${ConfigureBench_NAME})
+
+  add_executable(${BENCH_NAME} ${ConfigureBench_PATH})
+
+  target_link_libraries(
+    ${BENCH_NAME}
+    PRIVATE raft::raft
+            raft_internal
+            $<$<BOOL:${ConfigureBench_LIB}>:raft::compiled>
+            benchmark::benchmark
+            Threads::Threads
+            $<TARGET_NAME_IF_EXISTS:OpenMP::OpenMP_CXX>
+            $<TARGET_NAME_IF_EXISTS:conda_env>
+  )
+
+  set_target_properties(
+    ${BENCH_NAME}
+    PROPERTIES # set target compile options
+               INSTALL_RPATH "\$ORIGIN/../../../lib"
+               CXX_STANDARD 17
+               CXX_STANDARD_REQUIRED ON
+               CUDA_STANDARD 17
+               CUDA_STANDARD_REQUIRED ON
+               POSITION_INDEPENDENT_CODE ON
+               INTERFACE_POSITION_INDEPENDENT_CODE ON
+  )
+
+  target_compile_options(
+    ${BENCH_NAME} PRIVATE "$<$<COMPILE_LANGUAGE:CXX>:${RAFT_CXX_FLAGS}>"
+                          "$<$<COMPILE_LANGUAGE:CUDA>:${RAFT_CUDA_FLAGS}>"
+  )
+
+  target_include_directories(${BENCH_NAME} PUBLIC "$<BUILD_INTERFACE:${RAFT_SOURCE_DIR}/bench>")
+
+  install(
+    TARGETS ${BENCH_NAME}
+    COMPONENT testing
+    DESTINATION bin/gbench/prims/libraft
+    EXCLUDE_FROM_ALL
+  )
+
+endfunction()
+
+if(BUILD_BENCH)
+  ConfigureBench(
+    NAME CLUSTER_BENCH PATH bench/prims/cluster/kmeans_balanced.cu bench/prims/cluster/kmeans.cu
+    bench/prims/main.cpp OPTIONAL LIB
+  )
+
+  ConfigureBench(
+    NAME TUNE_DISTANCE PATH bench/prims/distance/tune_pairwise/kernel.cu
+    bench/prims/distance/tune_pairwise/bench.cu bench/prims/main.cpp
+  )
+
+  ConfigureBench(
+    NAME
+    DISTANCE_BENCH
+    PATH
+    bench/prims/distance/distance_cosine.cu
+    bench/prims/distance/distance_exp_l2.cu
+    bench/prims/distance/distance_l1.cu
+    bench/prims/distance/distance_unexp_l2.cu
+    bench/prims/distance/fused_l2_nn.cu
+    bench/prims/distance/masked_nn.cu
+    bench/prims/distance/kernels.cu
+    bench/prims/main.cpp
+    OPTIONAL
+    LIB
+  )
+
+  ConfigureBench(
+    NAME
+    LINALG_BENCH
+    PATH
+    bench/prims/linalg/add.cu
+    bench/prims/linalg/map_then_reduce.cu
+    bench/prims/linalg/matrix_vector_op.cu
+    bench/prims/linalg/norm.cu
+    bench/prims/linalg/normalize.cu
+    bench/prims/linalg/reduce_cols_by_key.cu
+    bench/prims/linalg/reduce_rows_by_key.cu
+    bench/prims/linalg/reduce.cu
+    bench/prims/main.cpp
+  )
+
+  ConfigureBench(
+    NAME MATRIX_BENCH PATH bench/prims/matrix/argmin.cu bench/prims/matrix/gather.cu
+    bench/prims/matrix/select_k.cu bench/prims/main.cpp OPTIONAL LIB
+  )
+
+  ConfigureBench(
+    NAME RANDOM_BENCH PATH bench/prims/random/make_blobs.cu bench/prims/random/permute.cu
+    bench/prims/random/rng.cu bench/prims/main.cpp
+  )
+
+  ConfigureBench(NAME SPARSE_BENCH PATH bench/prims/sparse/convert_csr.cu bench/prims/main.cpp)
+
+  ConfigureBench(
+    NAME
+    NEIGHBORS_BENCH
+    PATH
+    bench/prims/neighbors/knn/brute_force_float_int64_t.cu
+    bench/prims/neighbors/knn/brute_force_float_uint32_t.cu
+    bench/prims/neighbors/knn/ivf_flat_float_int64_t.cu
+    bench/prims/neighbors/knn/ivf_flat_int8_t_int64_t.cu
+    bench/prims/neighbors/knn/ivf_flat_uint8_t_int64_t.cu
+    bench/prims/neighbors/knn/ivf_pq_float_int64_t.cu
+    bench/prims/neighbors/knn/ivf_pq_int8_t_int64_t.cu
+    bench/prims/neighbors/knn/ivf_pq_uint8_t_int64_t.cu
+    bench/prims/neighbors/refine_float_int64_t.cu
+    bench/prims/neighbors/refine_uint8_t_int64_t.cu
+    bench/prims/main.cpp
+    OPTIONAL
+    LIB
+  )
+endif()
diff --git a/cpp/bench/cluster/kmeans.cu b/cpp/bench/prims/cluster/kmeans.cu
similarity index 100%
rename from cpp/bench/cluster/kmeans.cu
rename to cpp/bench/prims/cluster/kmeans.cu
diff --git a/cpp/bench/cluster/kmeans_balanced.cu b/cpp/bench/prims/cluster/kmeans_balanced.cu
similarity index 100%
rename from cpp/bench/cluster/kmeans_balanced.cu
rename to cpp/bench/prims/cluster/kmeans_balanced.cu
diff --git a/cpp/bench/common/benchmark.hpp b/cpp/bench/prims/common/benchmark.hpp
similarity index 100%
rename from cpp/bench/common/benchmark.hpp
rename to cpp/bench/prims/common/benchmark.hpp
diff --git a/cpp/bench/distance/distance_common.cuh b/cpp/bench/prims/distance/distance_common.cuh
similarity index 100%
rename from cpp/bench/distance/distance_common.cuh
rename to cpp/bench/prims/distance/distance_common.cuh
diff --git a/cpp/bench/distance/distance_cosine.cu b/cpp/bench/prims/distance/distance_cosine.cu
similarity index 94%
rename from cpp/bench/distance/distance_cosine.cu
rename to cpp/bench/prims/distance/distance_cosine.cu
index 20f29ce4ef..c8ac8067c8 100644
--- a/cpp/bench/distance/distance_cosine.cu
+++ b/cpp/bench/prims/distance/distance_cosine.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/distance/distance_exp_l2.cu b/cpp/bench/prims/distance/distance_exp_l2.cu
similarity index 94%
rename from cpp/bench/distance/distance_exp_l2.cu
rename to cpp/bench/prims/distance/distance_exp_l2.cu
index 5a3af17193..52b7fff05c 100644
--- a/cpp/bench/distance/distance_exp_l2.cu
+++ b/cpp/bench/prims/distance/distance_exp_l2.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/distance/distance_l1.cu b/cpp/bench/prims/distance/distance_l1.cu
similarity index 93%
rename from cpp/bench/distance/distance_l1.cu
rename to cpp/bench/prims/distance/distance_l1.cu
index 2ad7d5e957..e80db48ef0 100644
--- a/cpp/bench/distance/distance_l1.cu
+++ b/cpp/bench/prims/distance/distance_l1.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/distance/distance_unexp_l2.cu b/cpp/bench/prims/distance/distance_unexp_l2.cu
similarity index 94%
rename from cpp/bench/distance/distance_unexp_l2.cu
rename to cpp/bench/prims/distance/distance_unexp_l2.cu
index 406aca2378..7ac1a8a4b5 100644
--- a/cpp/bench/distance/distance_unexp_l2.cu
+++ b/cpp/bench/prims/distance/distance_unexp_l2.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/distance/fused_l2_nn.cu b/cpp/bench/prims/distance/fused_l2_nn.cu
similarity index 100%
rename from cpp/bench/distance/fused_l2_nn.cu
rename to cpp/bench/prims/distance/fused_l2_nn.cu
diff --git a/cpp/bench/distance/kernels.cu b/cpp/bench/prims/distance/kernels.cu
similarity index 100%
rename from cpp/bench/distance/kernels.cu
rename to cpp/bench/prims/distance/kernels.cu
diff --git a/cpp/bench/distance/masked_nn.cu b/cpp/bench/prims/distance/masked_nn.cu
similarity index 100%
rename from cpp/bench/distance/masked_nn.cu
rename to cpp/bench/prims/distance/masked_nn.cu
diff --git a/cpp/bench/distance/tune_pairwise/bench.cu b/cpp/bench/prims/distance/tune_pairwise/bench.cu
similarity index 100%
rename from cpp/bench/distance/tune_pairwise/bench.cu
rename to cpp/bench/prims/distance/tune_pairwise/bench.cu
diff --git a/cpp/bench/distance/tune_pairwise/kernel.cu b/cpp/bench/prims/distance/tune_pairwise/kernel.cu
similarity index 100%
rename from cpp/bench/distance/tune_pairwise/kernel.cu
rename to cpp/bench/prims/distance/tune_pairwise/kernel.cu
diff --git a/cpp/bench/distance/tune_pairwise/kernel.cuh b/cpp/bench/prims/distance/tune_pairwise/kernel.cuh
similarity index 100%
rename from cpp/bench/distance/tune_pairwise/kernel.cuh
rename to cpp/bench/prims/distance/tune_pairwise/kernel.cuh
diff --git a/cpp/bench/linalg/add.cu b/cpp/bench/prims/linalg/add.cu
similarity index 96%
rename from cpp/bench/linalg/add.cu
rename to cpp/bench/prims/linalg/add.cu
index 7d00b8cbae..456214ad7b 100644
--- a/cpp/bench/linalg/add.cu
+++ b/cpp/bench/prims/linalg/add.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/linalg/map_then_reduce.cu b/cpp/bench/prims/linalg/map_then_reduce.cu
similarity index 97%
rename from cpp/bench/linalg/map_then_reduce.cu
rename to cpp/bench/prims/linalg/map_then_reduce.cu
index 33a3e66264..84aebd85bf 100644
--- a/cpp/bench/linalg/map_then_reduce.cu
+++ b/cpp/bench/prims/linalg/map_then_reduce.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/linalg/matrix_vector_op.cu b/cpp/bench/prims/linalg/matrix_vector_op.cu
similarity index 99%
rename from cpp/bench/linalg/matrix_vector_op.cu
rename to cpp/bench/prims/linalg/matrix_vector_op.cu
index aa388955da..d1fbaee79b 100644
--- a/cpp/bench/linalg/matrix_vector_op.cu
+++ b/cpp/bench/prims/linalg/matrix_vector_op.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/linalg/norm.cu b/cpp/bench/prims/linalg/norm.cu
similarity index 98%
rename from cpp/bench/linalg/norm.cu
rename to cpp/bench/prims/linalg/norm.cu
index efecee88c9..f83953f8e4 100644
--- a/cpp/bench/linalg/norm.cu
+++ b/cpp/bench/prims/linalg/norm.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/linalg/normalize.cu b/cpp/bench/prims/linalg/normalize.cu
similarity index 98%
rename from cpp/bench/linalg/normalize.cu
rename to cpp/bench/prims/linalg/normalize.cu
index d01473ffeb..ad9052a008 100644
--- a/cpp/bench/linalg/normalize.cu
+++ b/cpp/bench/prims/linalg/normalize.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/linalg/reduce.cu b/cpp/bench/prims/linalg/reduce.cu
similarity index 97%
rename from cpp/bench/linalg/reduce.cu
rename to cpp/bench/prims/linalg/reduce.cu
index 015e0b8abe..cf41c5916a 100644
--- a/cpp/bench/linalg/reduce.cu
+++ b/cpp/bench/prims/linalg/reduce.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/linalg/reduce_cols_by_key.cu b/cpp/bench/prims/linalg/reduce_cols_by_key.cu
similarity index 98%
rename from cpp/bench/linalg/reduce_cols_by_key.cu
rename to cpp/bench/prims/linalg/reduce_cols_by_key.cu
index 43aeb69ab0..ac0c612ee4 100644
--- a/cpp/bench/linalg/reduce_cols_by_key.cu
+++ b/cpp/bench/prims/linalg/reduce_cols_by_key.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/linalg/reduce_rows_by_key.cu b/cpp/bench/prims/linalg/reduce_rows_by_key.cu
similarity index 98%
rename from cpp/bench/linalg/reduce_rows_by_key.cu
rename to cpp/bench/prims/linalg/reduce_rows_by_key.cu
index 075bc7c8c4..aa9c9a1f62 100644
--- a/cpp/bench/linalg/reduce_rows_by_key.cu
+++ b/cpp/bench/prims/linalg/reduce_rows_by_key.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/main.cpp b/cpp/bench/prims/main.cpp
similarity index 92%
rename from cpp/bench/main.cpp
rename to cpp/bench/prims/main.cpp
index 3162422e8e..40f539facf 100644
--- a/cpp/bench/main.cpp
+++ b/cpp/bench/prims/main.cpp
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/matrix/argmin.cu b/cpp/bench/prims/matrix/argmin.cu
similarity index 100%
rename from cpp/bench/matrix/argmin.cu
rename to cpp/bench/prims/matrix/argmin.cu
diff --git a/cpp/bench/matrix/gather.cu b/cpp/bench/prims/matrix/gather.cu
similarity index 100%
rename from cpp/bench/matrix/gather.cu
rename to cpp/bench/prims/matrix/gather.cu
diff --git a/cpp/bench/matrix/select_k.cu b/cpp/bench/prims/matrix/select_k.cu
similarity index 100%
rename from cpp/bench/matrix/select_k.cu
rename to cpp/bench/prims/matrix/select_k.cu
diff --git a/cpp/bench/neighbors/knn.cuh b/cpp/bench/prims/neighbors/knn.cuh
similarity index 100%
rename from cpp/bench/neighbors/knn.cuh
rename to cpp/bench/prims/neighbors/knn.cuh
diff --git a/cpp/bench/neighbors/knn/brute_force_float_int64_t.cu b/cpp/bench/prims/neighbors/knn/brute_force_float_int64_t.cu
similarity index 93%
rename from cpp/bench/neighbors/knn/brute_force_float_int64_t.cu
rename to cpp/bench/prims/neighbors/knn/brute_force_float_int64_t.cu
index d981104e20..7df0599670 100644
--- a/cpp/bench/neighbors/knn/brute_force_float_int64_t.cu
+++ b/cpp/bench/prims/neighbors/knn/brute_force_float_int64_t.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/neighbors/knn/brute_force_float_uint32_t.cu b/cpp/bench/prims/neighbors/knn/brute_force_float_uint32_t.cu
similarity index 93%
rename from cpp/bench/neighbors/knn/brute_force_float_uint32_t.cu
rename to cpp/bench/prims/neighbors/knn/brute_force_float_uint32_t.cu
index 60f7edae96..9704d39e76 100644
--- a/cpp/bench/neighbors/knn/brute_force_float_uint32_t.cu
+++ b/cpp/bench/prims/neighbors/knn/brute_force_float_uint32_t.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/neighbors/knn/ivf_flat_float_int64_t.cu b/cpp/bench/prims/neighbors/knn/ivf_flat_float_int64_t.cu
similarity index 93%
rename from cpp/bench/neighbors/knn/ivf_flat_float_int64_t.cu
rename to cpp/bench/prims/neighbors/knn/ivf_flat_float_int64_t.cu
index 594d4d16d2..fbbb4f9acc 100644
--- a/cpp/bench/neighbors/knn/ivf_flat_float_int64_t.cu
+++ b/cpp/bench/prims/neighbors/knn/ivf_flat_float_int64_t.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/neighbors/knn/ivf_flat_int8_t_int64_t.cu b/cpp/bench/prims/neighbors/knn/ivf_flat_int8_t_int64_t.cu
similarity index 93%
rename from cpp/bench/neighbors/knn/ivf_flat_int8_t_int64_t.cu
rename to cpp/bench/prims/neighbors/knn/ivf_flat_int8_t_int64_t.cu
index bd268f036c..7067dbe1b6 100644
--- a/cpp/bench/neighbors/knn/ivf_flat_int8_t_int64_t.cu
+++ b/cpp/bench/prims/neighbors/knn/ivf_flat_int8_t_int64_t.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/neighbors/knn/ivf_flat_uint8_t_int64_t.cu b/cpp/bench/prims/neighbors/knn/ivf_flat_uint8_t_int64_t.cu
similarity index 100%
rename from cpp/bench/neighbors/knn/ivf_flat_uint8_t_int64_t.cu
rename to cpp/bench/prims/neighbors/knn/ivf_flat_uint8_t_int64_t.cu
diff --git a/cpp/bench/neighbors/knn/ivf_pq_float_int64_t.cu b/cpp/bench/prims/neighbors/knn/ivf_pq_float_int64_t.cu
similarity index 100%
rename from cpp/bench/neighbors/knn/ivf_pq_float_int64_t.cu
rename to cpp/bench/prims/neighbors/knn/ivf_pq_float_int64_t.cu
diff --git a/cpp/bench/neighbors/knn/ivf_pq_int8_t_int64_t.cu b/cpp/bench/prims/neighbors/knn/ivf_pq_int8_t_int64_t.cu
similarity index 100%
rename from cpp/bench/neighbors/knn/ivf_pq_int8_t_int64_t.cu
rename to cpp/bench/prims/neighbors/knn/ivf_pq_int8_t_int64_t.cu
diff --git a/cpp/bench/neighbors/knn/ivf_pq_uint8_t_int64_t.cu b/cpp/bench/prims/neighbors/knn/ivf_pq_uint8_t_int64_t.cu
similarity index 100%
rename from cpp/bench/neighbors/knn/ivf_pq_uint8_t_int64_t.cu
rename to cpp/bench/prims/neighbors/knn/ivf_pq_uint8_t_int64_t.cu
diff --git a/cpp/bench/neighbors/refine.cuh b/cpp/bench/prims/neighbors/refine.cuh
similarity index 100%
rename from cpp/bench/neighbors/refine.cuh
rename to cpp/bench/prims/neighbors/refine.cuh
diff --git a/cpp/bench/neighbors/refine_float_int64_t.cu b/cpp/bench/prims/neighbors/refine_float_int64_t.cu
similarity index 100%
rename from cpp/bench/neighbors/refine_float_int64_t.cu
rename to cpp/bench/prims/neighbors/refine_float_int64_t.cu
diff --git a/cpp/bench/neighbors/refine_uint8_t_int64_t.cu b/cpp/bench/prims/neighbors/refine_uint8_t_int64_t.cu
similarity index 100%
rename from cpp/bench/neighbors/refine_uint8_t_int64_t.cu
rename to cpp/bench/prims/neighbors/refine_uint8_t_int64_t.cu
diff --git a/cpp/bench/random/make_blobs.cu b/cpp/bench/prims/random/make_blobs.cu
similarity index 98%
rename from cpp/bench/random/make_blobs.cu
rename to cpp/bench/prims/random/make_blobs.cu
index 950d80c499..f43d914cf2 100644
--- a/cpp/bench/random/make_blobs.cu
+++ b/cpp/bench/prims/random/make_blobs.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/random/permute.cu b/cpp/bench/prims/random/permute.cu
similarity index 100%
rename from cpp/bench/random/permute.cu
rename to cpp/bench/prims/random/permute.cu
diff --git a/cpp/bench/random/rng.cu b/cpp/bench/prims/random/rng.cu
similarity index 98%
rename from cpp/bench/random/rng.cu
rename to cpp/bench/prims/random/rng.cu
index 147adf26ae..d15c9441d7 100644
--- a/cpp/bench/random/rng.cu
+++ b/cpp/bench/prims/random/rng.cu
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2022, NVIDIA CORPORATION.
+ * Copyright (c) 2022-2023, NVIDIA CORPORATION.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
diff --git a/cpp/bench/sparse/convert_csr.cu b/cpp/bench/prims/sparse/convert_csr.cu
similarity index 100%
rename from cpp/bench/sparse/convert_csr.cu
rename to cpp/bench/prims/sparse/convert_csr.cu
diff --git a/cpp/cmake/modules/FindAVX.cmake b/cpp/cmake/modules/FindAVX.cmake
new file mode 100644
index 0000000000..7f3b2dfc76
--- /dev/null
+++ b/cpp/cmake/modules/FindAVX.cmake
@@ -0,0 +1,110 @@
+# =============================================================================
+# Copyright (c) 2016-     Facebook, Inc            (Adam Paszke)
+# Copyright (c) 2014-     Facebook, Inc            (Soumith Chintala)
+# Copyright (c) 2011-2014 Idiap Research Institute (Ronan Collobert)
+# Copyright (c) 2012-2014 Deepmind Technologies    (Koray Kavukcuoglu)
+# Copyright (c) 2011-2012 NEC Laboratories America (Koray Kavukcuoglu)
+# Copyright (c) 2011-2013 NYU                      (Clement Farabet)
+# Copyright (c) 2006-2010 NEC Laboratories America (Ronan Collobert, Leon Bottou, Iain Melvin, Jason Weston)
+# Copyright (c) 2006      Idiap Research Institute (Samy Bengio)
+# Copyright (c) 2001-2004 Idiap Research Institute (Ronan Collobert, Samy Bengio, Johnny Mariethoz)
+#
+# Note: This file was copied from PyTorch and modified for use in the RAFT library.
+# Refer to thirdparty/LICENSES/LICENSE.pytorch for license and additional
+# copyright information.
+# =============================================================================
+
+INCLUDE(CheckCXXSourceRuns)
+
+SET(AVX_CODE
+    "
+  #include <immintrin.h>
+
+  int main()
+  {
+    __m256 a;
+    a = _mm256_set1_ps(0);
+    return 0;
+  }
+"
+)
+
+SET(AVX512_CODE
+    "
+  #include <immintrin.h>
+
+  int main()
+  {
+    __m512i a = _mm512_set_epi8(0, 0, 0, 0, 0, 0, 0, 0,
+                                0, 0, 0, 0, 0, 0, 0, 0,
+                                0, 0, 0, 0, 0, 0, 0, 0,
+                                0, 0, 0, 0, 0, 0, 0, 0,
+                                0, 0, 0, 0, 0, 0, 0, 0,
+                                0, 0, 0, 0, 0, 0, 0, 0,
+                                0, 0, 0, 0, 0, 0, 0, 0,
+                                0, 0, 0, 0, 0, 0, 0, 0);
+    __m512i b = a;
+    __mmask64 equality_mask = _mm512_cmp_epi8_mask(a, b, _MM_CMPINT_EQ);
+    return 0;
+  }
+"
+)
+
+SET(AVX2_CODE
+    "
+  #include <immintrin.h>
+
+  int main()
+  {
+    __m256i a = {0};
+    a = _mm256_abs_epi16(a);
+    __m256i x;
+    _mm256_extract_epi64(x, 0); // we rely on this in our AVX2 code
+    return 0;
+  }
+"
+)
+
+MACRO(CHECK_SSE lang type flags)
+  SET(__FLAG_I 1)
+  SET(CMAKE_REQUIRED_FLAGS_SAVE ${CMAKE_REQUIRED_FLAGS})
+  FOREACH(__FLAG ${flags})
+    IF(NOT ${lang}_${type}_FOUND)
+      SET(CMAKE_REQUIRED_FLAGS ${__FLAG})
+      CHECK_CXX_SOURCE_RUNS("${${type}_CODE}" ${lang}_HAS_${type}_${__FLAG_I})
+      IF(${lang}_HAS_${type}_${__FLAG_I})
+        SET(${lang}_${type}_FOUND
+            TRUE
+            CACHE BOOL "${lang} ${type} support"
+        )
+        SET(${lang}_${type}_FLAGS
+            "${__FLAG}"
+            CACHE STRING "${lang} ${type} flags"
+        )
+      ENDIF()
+      MATH(EXPR __FLAG_I "${__FLAG_I}+1")
+    ENDIF()
+  ENDFOREACH()
+  SET(CMAKE_REQUIRED_FLAGS ${CMAKE_REQUIRED_FLAGS_SAVE})
+
+  IF(NOT ${lang}_${type}_FOUND)
+    SET(${lang}_${type}_FOUND
+        FALSE
+        CACHE BOOL "${lang} ${type} support"
+    )
+    SET(${lang}_${type}_FLAGS
+        ""
+        CACHE STRING "${lang} ${type} flags"
+    )
+  ENDIF()
+
+  MARK_AS_ADVANCED(${lang}_${type}_FOUND ${lang}_${type}_FLAGS)
+
+ENDMACRO()
+
+# CHECK_SSE(C "AVX" " ;-mavx;/arch:AVX") CHECK_SSE(C "AVX2" " ;-mavx2 -mfma;/arch:AVX2") CHECK_SSE(C
+# "AVX512" " ;-mavx512f -mavx512dq -mavx512vl -mavx512bw -mfma;/arch:AVX512")
+#
+CHECK_SSE(CXX "AVX" " ;-mavx;/arch:AVX")
+CHECK_SSE(CXX "AVX2" " ;-mavx2 -mfma;/arch:AVX2")
+CHECK_SSE(CXX "AVX512" " ;-mavx512f -mavx512dq -mavx512vl -mavx512bw -mfma;/arch:AVX512")
diff --git a/cpp/cmake/patches/ggnn.patch b/cpp/cmake/patches/ggnn.patch
new file mode 100644
index 0000000000..95e1aaff4b
--- /dev/null
+++ b/cpp/cmake/patches/ggnn.patch
@@ -0,0 +1,206 @@
+diff --git a/include/ggnn/cuda_knn_ggnn_gpu_instance.cuh b/include/ggnn/cuda_knn_ggnn_gpu_instance.cuh
+index 8cbaf0d..6eb72ac 100644
+--- a/include/ggnn/cuda_knn_ggnn_gpu_instance.cuh
++++ b/include/ggnn/cuda_knn_ggnn_gpu_instance.cuh
+@@ -41,7 +41,6 @@ limitations under the License.
+ #include "ggnn/sym/cuda_knn_sym_query_layer.cuh"
+ #include "ggnn/utils/cuda_knn_utils.cuh"
+ #include "ggnn/utils/cuda_knn_constants.cuh"
+-#include "ggnn/utils/cuda_knn_dataset.cuh"
+ 
+ template <typename ValueT>
+ __global__ void divide(ValueT* res, ValueT* input, ValueT N) {
+@@ -98,9 +97,7 @@ struct GGNNGPUInstance {
+   typedef GGNNGraphDevice<KeyT, BaseT, ValueT> GGNNGraphDevice;
+   typedef GGNNGraphHost<KeyT, BaseT, ValueT> GGNNGraphHost;
+ 
+-  const Dataset<KeyT, BaseT, BAddrT>* dataset;
+   GGNNGraphBuffer<KeyT, ValueT>* ggnn_buffer {nullptr};
+-  GGNNQuery<KeyT, ValueT, BaseT> ggnn_query;
+ 
+   // Graph Shards resident on the GPU
+   std::vector<GGNNGraphDevice> ggnn_shards;
+@@ -117,13 +114,12 @@ struct GGNNGPUInstance {
+   // number of shards that need to be processed by this instance
+   const int num_parts;
+ 
+-  GGNNGPUInstance(const int gpu_id, const Dataset<KeyT, BaseT, BAddrT>* dataset,
++  GGNNGPUInstance(const int gpu_id,
+             const int N_shard, const int L,
+             const bool enable_construction, const float tau_build,
+             const int num_parts=1, const int num_cpu_buffers=1) :
+     N_shard{N_shard}, L{L}, tau_build{tau_build},
+-    dataset{dataset}, gpu_id{gpu_id},
+-    ggnn_query{dataset->N_query, D, KQuery, num_parts},
++    gpu_id{gpu_id},
+     num_parts{num_parts}
+   {
+     CHECK_LE(L, MAX_LAYER);
+@@ -135,7 +131,6 @@ struct GGNNGPUInstance {
+       CHECK_EQ(current_gpu_id, gpu_id) << "cudaSetDevice() needs to be called in advance!";
+     }
+ 
+-    ggnn_query.loadQueriesAsync(dataset->h_query, 0);
+ 
+     computeGraphParameters();
+ 
+@@ -186,7 +181,7 @@ struct GGNNGPUInstance {
+   }
+ 
+   GGNNGPUInstance(const GGNNGPUInstance& other)
+-   : dataset{nullptr}, ggnn_query{0, D, KQuery},
++   :
+      gpu_id{0}, N_shard{0}, num_parts{0} {
+     // this exists to allow using vector::emplace_back
+     // when it triggers a reallocation, this code will be called.
+@@ -305,6 +300,7 @@ struct GGNNGPUInstance {
+ 
+   // io
+ 
++  /*
+   void waitForDiskIO(const int shard_id) {
+     auto& cpu_buffer = ggnn_cpu_buffers[shard_id%ggnn_cpu_buffers.size()];
+     if (cpu_buffer.disk_io_thread.joinable())
+@@ -468,11 +464,12 @@ struct GGNNGPUInstance {
+     CHECK_CUDA(cudaDeviceSynchronize());
+     CHECK_CUDA(cudaPeekAtLastError());
+   }
++  */
+ 
+   // graph operations
+ 
+   template <int BLOCK_DIM_X = 32, int MAX_ITERATIONS = 400, int CACHE_SIZE = 512, int SORTED_SIZE = 256, bool DIST_STATS = false>
+-  void queryLayer(const int shard_id = 0) const {
++  void queryLayer(const BaseT* d_query, int batch_size, KeyT* d_query_result_ids, ValueT* d_query_result_dists, const int shard_id = 0) const {
+     CHECK_CUDA(cudaSetDevice(gpu_id));
+     const auto& shard = ggnn_shards.at(shard_id%ggnn_shards.size());
+ 
+@@ -482,21 +479,21 @@ struct GGNNGPUInstance {
+ 
+     int* m_dist_statistics = nullptr;
+     if (DIST_STATS)
+-      cudaMallocManaged(&m_dist_statistics, dataset->N_query * sizeof(int));
++      cudaMallocManaged(&m_dist_statistics, batch_size * sizeof(int));
+ 
+     QueryKernel query_kernel;
+     query_kernel.d_base = shard.d_base;
+-    query_kernel.d_query = ggnn_query.d_query;
++    query_kernel.d_query = d_query;
+ 
+     query_kernel.d_graph = shard.d_graph;
+-    query_kernel.d_query_results = ggnn_query.d_query_result_ids;
+-    query_kernel.d_query_results_dists = ggnn_query.d_query_result_dists;
++    query_kernel.d_query_results = d_query_result_ids;
++    query_kernel.d_query_results_dists = d_query_result_dists;
+ 
+     query_kernel.d_translation = shard.d_translation;
+ 
+     query_kernel.d_nn1_stats = shard.d_nn1_stats;
+ 
+-    query_kernel.N = dataset->N_query;
++    query_kernel.N = batch_size;
+     query_kernel.N_offset = 0;
+ 
+     query_kernel.d_dist_stats = m_dist_statistics;
+@@ -771,6 +768,16 @@ struct GGNNGPUInstance {
+       sym(layer, shard_id);
+     }
+   }
++
++  void set_stream(cudaStream_t stream) {
++    assert(ggnn_shards.size() == 1);
++    ggnn_shards.at(0).stream = stream;
++  }
++
++  void set_base_data(const BaseT* dataset) {
++    assert(ggnn_shards.size() == 1);
++    ggnn_shards.at(0).d_base = dataset;
++  }
+ };
+ 
+ #endif  // INCLUDE_GGNN_CUDA_KNN_GGNN_GPU_INSTANCE_CUH_
+diff --git a/include/ggnn/graph/cuda_knn_ggnn_graph_device.cuh b/include/ggnn/graph/cuda_knn_ggnn_graph_device.cuh
+index c94a8f1..781226d 100644
+--- a/include/ggnn/graph/cuda_knn_ggnn_graph_device.cuh
++++ b/include/ggnn/graph/cuda_knn_ggnn_graph_device.cuh
+@@ -50,7 +50,7 @@ struct GGNNGraphDevice {
+   ValueT* d_nn1_stats;
+ 
+   /// base data pointer for the shard.
+-  BaseT* d_base;
++  const BaseT* d_base;
+ 
+   /// combined memory pool
+   char* d_memory;
+@@ -69,7 +69,9 @@ struct GGNNGraphDevice {
+     const size_t selection_translation_size = align8(ST_all * sizeof(KeyT));
+     const size_t nn1_stats_size = align8(2 * sizeof(ValueT));
+     total_graph_size = graph_size + 2 * selection_translation_size + nn1_stats_size;
+-    base_size = align8(static_cast<size_t>(N) * D * sizeof(BaseT));
++    // base_size = align8(static_cast<size_t>(N) * D * sizeof(BaseT));
++    (void) N;
++    (void) D;
+ 
+     const size_t total_size = base_size+total_graph_size;
+ 
+@@ -86,8 +88,7 @@ struct GGNNGraphDevice {
+     CHECK_CUDA(cudaMalloc(&d_memory, total_size));
+ 
+     size_t pos = 0;
+-    d_base = reinterpret_cast<BaseT*>(d_memory+pos);
+-    pos += base_size;
++    d_base = nullptr;
+     d_graph = reinterpret_cast<KeyT*>(d_memory+pos);
+     pos += graph_size;
+     d_translation = reinterpret_cast<KeyT*>(d_memory+pos);
+@@ -99,14 +100,14 @@ struct GGNNGraphDevice {
+ 
+     CHECK_EQ(pos, total_size);
+ 
+-    CHECK_CUDA(cudaStreamCreate(&stream));
++    // CHECK_CUDA(cudaStreamCreate(&stream));
+ 
+     CHECK_CUDA(cudaPeekAtLastError());
+     CHECK_CUDA(cudaDeviceSynchronize());
+     CHECK_CUDA(cudaPeekAtLastError());
+   }
+ 
+-  GGNNGraphDevice(const GGNNGraphDevice& other) {
++  GGNNGraphDevice(const GGNNGraphDevice&) {
+     // this exists to allow using vector::emplace_back
+     // when it triggers a reallocation, this code will be called.
+     // always make sure that enough memory is reserved ahead of time.
+@@ -116,7 +117,7 @@ struct GGNNGraphDevice {
+   ~GGNNGraphDevice() {
+     cudaFree(d_memory);
+ 
+-    CHECK_CUDA(cudaStreamDestroy(stream));
++    // CHECK_CUDA(cudaStreamDestroy(stream));
+   }
+ };
+ 
+diff --git a/include/ggnn/graph/cuda_knn_ggnn_graph_host.cuh b/include/ggnn/graph/cuda_knn_ggnn_graph_host.cuh
+index 2055f9e..ef5843a 100644
+--- a/include/ggnn/graph/cuda_knn_ggnn_graph_host.cuh
++++ b/include/ggnn/graph/cuda_knn_ggnn_graph_host.cuh
+@@ -92,7 +92,7 @@ struct GGNNGraphHost {
+     CHECK_CUDA(cudaPeekAtLastError());
+   }
+ 
+-  GGNNGraphHost(const GGNNGraphHost& other) {
++  GGNNGraphHost(const GGNNGraphHost&) {
+     // this exists to allow using vector::emplace_back
+     // when it triggers a reallocation, this code will be called.
+     // always make sure that enough memory is reserved ahead of time.
+diff --git a/include/ggnn/select/cuda_knn_wrs_select_layer.cuh b/include/ggnn/select/cuda_knn_wrs_select_layer.cuh
+index 49d76a1..eef69e6 100644
+--- a/include/ggnn/select/cuda_knn_wrs_select_layer.cuh
++++ b/include/ggnn/select/cuda_knn_wrs_select_layer.cuh
+@@ -22,7 +22,6 @@ limitations under the License.
+ #include <cuda.h>
+ #include <cuda_runtime.h>
+ 
+-#include <gflags/gflags.h>
+ #include <cub/cub.cuh>
+ 
+ #include "ggnn/utils/cuda_knn_constants.cuh"
diff --git a/cpp/cmake/patches/nlohmann_json.patch b/cpp/cmake/patches/nlohmann_json.patch
new file mode 100644
index 0000000000..83dd56bc16
--- /dev/null
+++ b/cpp/cmake/patches/nlohmann_json.patch
@@ -0,0 +1,38 @@
+--- nlohmann/json.hpp	2021-05-06 11:40:39.770669693 +0800
++++ nlohmann/json_patched.hpp	2021-06-02 18:46:43.849334466 +0800
+@@ -16607,6 +16607,21 @@
+         }
+     }
+ 
++
++    template <typename NumberType,
++  	    enable_if_t<std::is_signed<NumberType>::value, int> = 0>
++    bool is_negative_number(NumberType x)
++    {
++        return x < 0;
++    }
++
++    template < typename NumberType,
++  	     enable_if_t < std::is_unsigned<NumberType>::value, int > = 0 >
++    bool is_negative_number(NumberType /*unused*/)
++    {
++        return false;
++    }
++
+     /*!
+     @brief dump an integer
+ 
+@@ -16649,12 +16664,11 @@
+         // use a pointer to fill the buffer
+         auto buffer_ptr = number_buffer.begin(); // NOLINT(llvm-qualified-auto,readability-qualified-auto,cppcoreguidelines-pro-type-vararg,hicpp-vararg)
+ 
+-        const bool is_negative = std::is_same<NumberType, number_integer_t>::value && !(x >= 0); // see issue #755
+         number_unsigned_t abs_value;
+ 
+         unsigned int n_chars{};
+ 
+-        if (is_negative)
++        if (is_negative_number(x))
+         {
+             *buffer_ptr = '-';
+             abs_value = remove_sign(static_cast<number_integer_t>(x));
diff --git a/cpp/cmake/thirdparty/get_faiss.cmake b/cpp/cmake/thirdparty/get_faiss.cmake
new file mode 100644
index 0000000000..b7c132f2f1
--- /dev/null
+++ b/cpp/cmake/thirdparty/get_faiss.cmake
@@ -0,0 +1,87 @@
+#=============================================================================
+# Copyright (c) 2021-2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#=============================================================================
+
+function(find_and_configure_faiss)
+    set(oneValueArgs VERSION REPOSITORY PINNED_TAG BUILD_STATIC_LIBS EXCLUDE_FROM_ALL)
+    cmake_parse_arguments(PKG "${options}" "${oneValueArgs}"
+            "${multiValueArgs}" ${ARGN} )
+
+        rapids_find_generate_module(faiss
+                HEADER_NAMES  faiss/IndexFlat.h
+                LIBRARY_NAMES faiss
+                )
+
+        set(BUILD_SHARED_LIBS ON)
+        if (PKG_BUILD_STATIC_LIBS)
+            set(BUILD_SHARED_LIBS OFF)
+            set(CPM_DOWNLOAD_faiss ON)
+        endif()
+
+        rapids_cpm_find(faiss ${PKG_VERSION}
+                GLOBAL_TARGETS     faiss::faiss
+                CPM_ARGS
+                GIT_REPOSITORY   ${PKG_REPOSITORY}
+                GIT_TAG          ${PKG_PINNED_TAG}
+                EXCLUDE_FROM_ALL ${PKG_EXCLUDE_FROM_ALL}
+                OPTIONS
+                "FAISS_ENABLE_PYTHON OFF"
+                "CUDAToolkit_ROOT ${CUDAToolkit_LIBRARY_DIR}"
+                "FAISS_ENABLE_GPU ON"
+                "BUILD_TESTING OFF"
+                "CMAKE_MESSAGE_LOG_LEVEL VERBOSE"
+                "FAISS_USE_CUDA_TOOLKIT_STATIC ${CUDA_STATIC_RUNTIME}"
+                )
+
+        if(TARGET faiss AND NOT TARGET faiss::faiss)
+            add_library(faiss::faiss ALIAS faiss)
+        endif()
+
+        if(faiss_ADDED)
+            rapids_export(BUILD faiss
+                    EXPORT_SET faiss-targets
+                    GLOBAL_TARGETS faiss
+                    NAMESPACE faiss::)
+        endif()
+
+    # We generate the faiss-config files when we built faiss locally, so always do `find_dependency`
+    rapids_export_package(BUILD OpenMP raft-ann-bench-exports) # faiss uses openMP but doesn't export a need for it
+    rapids_export_package(BUILD faiss raft-ann-bench-exports GLOBAL_TARGETS faiss::faiss faiss)
+    rapids_export_package(INSTALL faiss raft-ann-bench-exports GLOBAL_TARGETS faiss::faiss faiss)
+
+    # Tell cmake where it can find the generated faiss-config.cmake we wrote.
+    include("${rapids-cmake-dir}/export/find_package_root.cmake")
+    rapids_export_find_package_root(BUILD faiss [=[${CMAKE_CURRENT_LIST_DIR}]=] raft-ann-bench-exports)
+endfunction()
+
+if(NOT RAFT_FAISS_GIT_TAG)
+    # TODO: Remove this once faiss supports FAISS_USE_CUDA_TOOLKIT_STATIC
+    # (https://github.com/facebookresearch/faiss/pull/2446)
+    set(RAFT_FAISS_GIT_TAG fea/statically-link-ctk-v1.7.0)
+    # set(RAFT_FAISS_GIT_TAG bde7c0027191f29c9dadafe4f6e68ca0ee31fb30)
+endif()
+
+if(NOT RAFT_FAISS_GIT_REPOSITORY)
+    # TODO: Remove this once faiss supports FAISS_USE_CUDA_TOOLKIT_STATIC
+    # (https://github.com/facebookresearch/faiss/pull/2446)
+    set(RAFT_FAISS_GIT_REPOSITORY https://github.com/trxcllnt/faiss.git)
+    # set(RAFT_FAISS_GIT_REPOSITORY https://github.com/facebookresearch/faiss.git)
+endif()
+
+find_and_configure_faiss(VERSION    1.7.0
+        REPOSITORY  ${RAFT_FAISS_GIT_REPOSITORY}
+        PINNED_TAG  ${RAFT_FAISS_GIT_TAG}
+        BUILD_STATIC_LIBS ${RAFT_USE_FAISS_STATIC}
+        EXCLUDE_FROM_ALL ${RAFT_EXCLUDE_FAISS_FROM_ALL})
\ No newline at end of file
diff --git a/cpp/cmake/thirdparty/get_ggnn.cmake b/cpp/cmake/thirdparty/get_ggnn.cmake
new file mode 100644
index 0000000000..708acb6b8d
--- /dev/null
+++ b/cpp/cmake/thirdparty/get_ggnn.cmake
@@ -0,0 +1,44 @@
+#=============================================================================
+# Copyright (c) 2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#=============================================================================
+
+function(find_and_configure_ggnn)
+    set(oneValueArgs VERSION FORK PINNED_TAG EXCLUDE_FROM_ALL)
+    cmake_parse_arguments(PKG "${options}" "${oneValueArgs}"
+            "${multiValueArgs}" ${ARGN} )
+
+    set ( EXTERNAL_INCLUDES_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/ )
+    if (NOT EXISTS ${EXTERNAL_INCLUDES_DIRECTORY}/_deps/ggnn-src/)
+
+        execute_process (
+                COMMAND git clone "https://github.com/${PKG_FORK}/ggnn" --branch ${PKG_PINNED_TAG} ggnn-src
+                WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/_deps/ )
+
+        message("SOURCE ${CMAKE_CURRENT_SOURCE_DIR}")
+        execute_process (
+                COMMAND git apply ${CMAKE_CURRENT_SOURCE_DIR}/cmake/patches/ggnn.patch
+                WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/_deps/ggnn-src
+        )
+    endif()
+
+endfunction()
+
+# Change pinned tag here to test a commit in CI
+# To use a different RAFT locally, set the CMake variable
+# CPM_raft_SOURCE=/path/to/local/raft
+find_and_configure_ggnn(VERSION          0.5
+        FORK             cgtuebingen
+        PINNED_TAG       release_0.5
+        EXCLUDE_FROM_ALL YES)
diff --git a/cpp/cmake/thirdparty/get_glog.cmake b/cpp/cmake/thirdparty/get_glog.cmake
new file mode 100644
index 0000000000..9334224de5
--- /dev/null
+++ b/cpp/cmake/thirdparty/get_glog.cmake
@@ -0,0 +1,49 @@
+#=============================================================================
+# Copyright (c) 2021-2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#=============================================================================
+
+function(find_and_configure_glog)
+    set(oneValueArgs VERSION FORK PINNED_TAG EXCLUDE_FROM_ALL)
+    cmake_parse_arguments(PKG "${options}" "${oneValueArgs}"
+            "${multiValueArgs}" ${ARGN} )
+
+    rapids_cpm_find(glog ${PKG_VERSION}
+            GLOBAL_TARGETS      glog::glog
+            BUILD_EXPORT_SET    raft-exports
+            INSTALL_EXPORT_SET  raft-exports
+            CPM_ARGS
+            GIT_REPOSITORY         https://github.com/${PKG_FORK}/glog.git
+            GIT_TAG                ${PKG_PINNED_TAG}
+            SOURCE_SUBDIR          cpp
+            EXCLUDE_FROM_ALL       ${PKG_EXCLUDE_FROM_ALL}
+            )
+
+    if(glog_ADDED)
+        message(VERBOSE "RAFT: Using glog located in ${glog_SOURCE_DIR}")
+    else()
+        message(VERBOSE "RAFT: Using glog located in ${glog_DIR}")
+    endif()
+
+
+endfunction()
+
+# Change pinned tag here to test a commit in CI
+# To use a different RAFT locally, set the CMake variable
+# CPM_glog_SOURCE=/path/to/local/glog
+find_and_configure_glog(VERSION 0.6.0
+        FORK             google
+        PINNED_TAG       v0.6.0
+        EXCLUDE_FROM_ALL ON
+        )
\ No newline at end of file
diff --git a/cpp/cmake/thirdparty/get_hnswlib.cmake b/cpp/cmake/thirdparty/get_hnswlib.cmake
new file mode 100644
index 0000000000..94033e8333
--- /dev/null
+++ b/cpp/cmake/thirdparty/get_hnswlib.cmake
@@ -0,0 +1,49 @@
+#=============================================================================
+# Copyright (c) 2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#=============================================================================
+
+function(find_and_configure_hnswlib)
+    set(oneValueArgs VERSION FORK PINNED_TAG EXCLUDE_FROM_ALL)
+    cmake_parse_arguments(PKG "${options}" "${oneValueArgs}"
+            "${multiValueArgs}" ${ARGN} )
+
+    set ( EXTERNAL_INCLUDES_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} )
+    if( NOT EXISTS ${EXTERNAL_INCLUDES_DIRECTORY}/_deps/hnswlib-src )
+
+        execute_process (
+                COMMAND git clone --branch=v0.6.2 https://github.com/nmslib/hnswlib.git hnswlib-src
+                WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/_deps )
+
+    endif ()
+
+    include(cmake/modules/FindAVX.cmake)
+
+    set(HNSW_CXX_FLAGS "")
+    if(CXX_AVX_FOUND)
+        set(HNSW_CXX_FLAGS "${HNSW_CXX_FLAGS} ${CXX_AVX_FLAGS}")
+    elseif(CXX_AVX2_FOUND)
+        set(HNSW_CXX_FLAGS "${HNSW_CXX_FLAGS} ${CXX_AVX2_FLAGS}")
+    elseif(CXX_AVX512_FOUND)
+        set(HNSW_CXX_FLAGS "${HNSW_CXX_FLAGS} ${CXX_AVX512_FLAGS}")
+    endif()
+endfunction()
+
+# Change pinned tag here to test a commit in CI
+# To use a different RAFT locally, set the CMake variable
+# CPM_raft_SOURCE=/path/to/local/raft
+find_and_configure_hnswlib(VERSION  0.6.2
+        FORK             nmslib
+        PINNED_TAG       v0.6.2
+        EXCLUDE_FROM_ALL YES)
diff --git a/cpp/cmake/thirdparty/get_nlohmann_json.cmake b/cpp/cmake/thirdparty/get_nlohmann_json.cmake
new file mode 100644
index 0000000000..5de98a47ce
--- /dev/null
+++ b/cpp/cmake/thirdparty/get_nlohmann_json.cmake
@@ -0,0 +1,39 @@
+#=============================================================================
+# Copyright (c) 2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#=============================================================================
+
+function(find_and_configure_nlohmann_json)
+    set(oneValueArgs VERSION FORK PINNED_TAG EXCLUDE_FROM_ALL)
+    cmake_parse_arguments(PKG "${options}" "${oneValueArgs}"
+            "${multiValueArgs}" ${ARGN} )
+
+    rapids_cpm_find(nlohmann_json ${PKG_VERSION}
+            GLOBAL_TARGETS      nlohmann_json::nlohmann_json
+            BUILD_EXPORT_SET    raft-bench-ann-exports
+            INSTALL_EXPORT_SET  raft-bench-ann-exports
+            CPM_ARGS
+            GIT_REPOSITORY         https://github.com/${PKG_FORK}/json.git
+            GIT_TAG                ${PKG_PINNED_TAG}
+            EXCLUDE_FROM_ALL       ${PKG_EXCLUDE_FROM_ALL})
+
+endfunction()
+
+# Change pinned tag here to test a commit in CI
+# To use a different RAFT locally, set the CMake variable
+# CPM_raft_SOURCE=/path/to/local/raft
+find_and_configure_nlohmann_json(VERSION  3.11.2
+        FORK             nlohmann
+        PINNED_TAG       v3.11.2
+        EXCLUDE_FROM_ALL YES)
diff --git a/cpp/include/raft/cluster/detail/kmeans_deprecated.cuh b/cpp/include/raft/cluster/detail/kmeans_deprecated.cuh
index a9d8777304..bb1d122a24 100644
--- a/cpp/include/raft/cluster/detail/kmeans_deprecated.cuh
+++ b/cpp/include/raft/cluster/detail/kmeans_deprecated.cuh
@@ -383,8 +383,8 @@ static int chooseNewCentroid(raft::device_resources const& handle,
                          thrust::device_pointer_cast(dists),
                          thrust::device_pointer_cast(dists + n),
                          thrust::device_pointer_cast(distsCumSum));
-  CHECK_CUDA(stream);
-  CUDA_TRY(cudaMemcpyAsync(
+  RAFT_CHECK_CUDA(stream);
+  RAFT_CUDA_TRY(cudaMemcpyAsync(
     &distsSum, distsCumSum + n - 1, sizeof(value_type_t), cudaMemcpyDeviceToHost, stream));
 
   // Randomly choose observation vector
@@ -523,7 +523,7 @@ static int initializeCentroids(raft::device_resources const& handle,
       WARNING("error in k-means++ (could not pick centroid)");
 
     // Compute distances from ith centroid
-    CUDA_TRY(cudaMemsetAsync(dists + n, 0, n * sizeof(value_type_t), stream));
+    RAFT_CUDA_TRY(cudaMemsetAsync(dists + n, 0, n * sizeof(value_type_t), stream));
     computeDistances<<<gridDim_warp, blockDim_warp, 0, stream>>>(
       n, d, 1, obs, centroids + IDX(0, i, d), dists + n);
     RAFT_CHECK_CUDA(stream);
@@ -534,7 +534,7 @@ static int initializeCentroids(raft::device_resources const& handle,
   }
 
   // Compute cluster sizes
-  CUDA_TRY(cudaMemsetAsync(clusterSizes, 0, k * sizeof(index_type_t), stream));
+  RAFT_CUDA_TRY(cudaMemsetAsync(clusterSizes, 0, k * sizeof(index_type_t), stream));
   computeClusterSizes<<<gridDim_block, BLOCK_SIZE, 0, stream>>>(n, codes, clusterSizes);
   RAFT_CHECK_CUDA(stream);
 
@@ -598,7 +598,7 @@ static int assignCentroids(raft::device_resources const& handle,
   RAFT_CHECK_CUDA(stream);
 
   // Find centroid closest to each observation vector
-  CUDA_TRY(cudaMemsetAsync(clusterSizes, 0, k * sizeof(index_type_t), stream));
+  RAFT_CUDA_TRY(cudaMemsetAsync(clusterSizes, 0, k * sizeof(index_type_t), stream));
   blockDim.x = BLOCK_SIZE;
   blockDim.y = 1;
   blockDim.z = 1;
@@ -606,7 +606,7 @@ static int assignCentroids(raft::device_resources const& handle,
   gridDim.y  = 1;
   gridDim.z  = 1;
   minDistances<<<gridDim, blockDim, 0, stream>>>(n, k, dists, codes, clusterSizes);
-  CHECK_CUDA(stream);
+  RAFT_CHECK_CUDA(stream);
 
   // Compute residual sum of squares
   *residual_host = thrust::reduce(
@@ -825,8 +825,8 @@ int kmeans(raft::device_resources const& handle,
 
   // Trivial cases
   if (k == 1) {
-    CUDA_TRY(cudaMemsetAsync(codes, 0, n * sizeof(index_type_t), stream));
-    CUDA_TRY(
+    RAFT_CUDA_TRY(cudaMemsetAsync(codes, 0, n * sizeof(index_type_t), stream));
+    RAFT_CUDA_TRY(
       cudaMemcpyAsync(clusterSizes, &n, sizeof(index_type_t), cudaMemcpyHostToDevice, stream));
     if (updateCentroids(handle, n, d, k, obs, codes, clusterSizes, centroids, work, work_int))
       WARNING("could not compute k-means centroids");
@@ -837,7 +837,7 @@ int kmeans(raft::device_resources const& handle,
                  1,
                  std::min(ceildiv<unsigned>(n, BLOCK_SIZE / WARP_SIZE), grid_lower_bound)};
 
-    CUDA_TRY(cudaMemsetAsync(work, 0, n * k * sizeof(value_type_t), stream));
+    RAFT_CUDA_TRY(cudaMemsetAsync(work, 0, n * k * sizeof(value_type_t), stream));
     computeDistances<<<gridDim, blockDim, 0, stream>>>(n, d, 1, obs, centroids, work);
     RAFT_CHECK_CUDA(stream);
     *residual_host = thrust::reduce(
diff --git a/cpp/include/raft/linalg/detail/lanczos.cuh b/cpp/include/raft/linalg/detail/lanczos.cuh
index 8c0cfeba28..73d93ab535 100644
--- a/cpp/include/raft/linalg/detail/lanczos.cuh
+++ b/cpp/include/raft/linalg/detail/lanczos.cuh
@@ -958,7 +958,7 @@ int computeSmallestEigenvectors(
                                 (*effIter) * nEigVecs * sizeof(value_type_t),
                                 cudaMemcpyHostToDevice,
                                 stream));
-  CHECK_CUDA(stream);
+  RAFT_CHECK_CUDA(stream);
 
   // Convert eigenvectors from Lanczos basis to standard basis
   RAFT_CUBLAS_TRY(cublasgemm(cublas_h,
@@ -1305,7 +1305,7 @@ int computeLargestEigenvectors(
                                 cudaMemcpyHostToDevice,
                                 stream));
 
-  CHECK_CUDA(stream);
+  RAFT_CHECK_CUDA(stream);
 
   // Convert eigenvectors from Lanczos basis to standard basis
   RAFT_CUBLAS_TRY(cublasgemm(cublas_h,
diff --git a/cpp/include/raft/solver/detail/lap_functions.cuh b/cpp/include/raft/solver/detail/lap_functions.cuh
index 440e6901c6..63f27e6346 100644
--- a/cpp/include/raft/solver/detail/lap_functions.cuh
+++ b/cpp/include/raft/solver/detail/lap_functions.cuh
@@ -113,7 +113,7 @@ inline void initialReduction(raft::device_resources const& handle,
   kernel_rowReduction<<<blocks_per_grid, threads_per_block, 0, handle.get_stream()>>>(
     d_costs, d_vertices_dev.row_duals, SP, N, std::numeric_limits<weight_t>::max());
 
-  CHECK_CUDA(handle.get_stream());
+  RAFT_CHECK_CUDA(handle.get_stream());
   kernel_columnReduction<<<blocks_per_grid, threads_per_block, 0, handle.get_stream()>>>(
     d_costs,
     d_vertices_dev.row_duals,
@@ -121,7 +121,7 @@ inline void initialReduction(raft::device_resources const& handle,
     SP,
     N,
     std::numeric_limits<weight_t>::max());
-  CHECK_CUDA(handle.get_stream());
+  RAFT_CHECK_CUDA(handle.get_stream());
 }
 
 template <typename vertex_t, typename weight_t>
@@ -159,7 +159,7 @@ inline void computeInitialAssignments(raft::device_resources const& handle,
     SP,
     N,
     epsilon);
-  CHECK_CUDA(handle.get_stream());
+  RAFT_CHECK_CUDA(handle.get_stream());
 }
 
 // Function for finding row cover on individual devices.
@@ -191,7 +191,7 @@ inline int computeRowCovers(raft::device_resources const& handle,
   kernel_computeRowCovers<<<blocks_per_grid, threads_per_block, 0, handle.get_stream()>>>(
     d_vertices.row_assignments, d_vertices.row_covers, d_row_data.is_visited, SP, N);
 
-  CHECK_CUDA(handle.get_stream());
+  RAFT_CHECK_CUDA(handle.get_stream());
 
   return thrust::reduce(thrust::device, d_vertices.row_covers, d_vertices.row_covers + size);
 }
@@ -268,7 +268,7 @@ inline vertex_t zeroCoverIteration(raft::device_resources const& handle,
                                          0,
                                          handle.get_stream()>>>(
       predicates_v.data(), addresses_v.data(), d_row_data_dev.is_visited, SP, N);
-    CHECK_CUDA(handle.get_stream());
+    RAFT_CHECK_CUDA(handle.get_stream());
 
     M = thrust::reduce(thrust::device, addresses_v.begin(), addresses_v.end());
     thrust::exclusive_scan(
@@ -286,7 +286,7 @@ inline vertex_t zeroCoverIteration(raft::device_resources const& handle,
         SP,
         N);
 
-      CHECK_CUDA(handle.get_stream());
+      RAFT_CHECK_CUDA(handle.get_stream());
     }
   }
 
@@ -356,7 +356,7 @@ inline void reversePass(raft::device_resources const& handle,
                                         handle.get_stream()>>>(
     predicates_v.data(), addresses_v.data(), d_col_data_dev.is_visited, size);
 
-  CHECK_CUDA(handle.get_stream());
+  RAFT_CHECK_CUDA(handle.get_stream());
 
   // calculate total number of vertices.
   std::size_t csr_size = thrust::reduce(thrust::device, addresses_v.begin(), addresses_v.end());
@@ -375,11 +375,11 @@ inline void reversePass(raft::device_resources const& handle,
     kernel_augmentScatter<<<blocks_per_grid, threads_per_block, 0, handle.get_stream()>>>(
       elements_v.data(), predicates_v.data(), addresses_v.data(), size);
 
-    CHECK_CUDA(handle.get_stream());
+    RAFT_CHECK_CUDA(handle.get_stream());
 
     kernel_reverseTraversal<<<blocks_per_grid_1, threads_per_block_1, 0, handle.get_stream()>>>(
       elements_v.data(), d_row_data_dev, d_col_data_dev, csr_size);
-    CHECK_CUDA(handle.get_stream());
+    RAFT_CHECK_CUDA(handle.get_stream());
   }
 }
 
@@ -410,7 +410,7 @@ inline void augmentationPass(raft::device_resources const& handle,
                                         handle.get_stream()>>>(
     predicates_v.data(), addresses_v.data(), d_row_data_dev.is_visited, SP * N);
 
-  CHECK_CUDA(handle.get_stream());
+  RAFT_CHECK_CUDA(handle.get_stream());
 
   // calculate total number of vertices.
   // TODO: should be vertex_t
@@ -432,7 +432,7 @@ inline void augmentationPass(raft::device_resources const& handle,
     kernel_augmentScatter<<<blocks_per_grid, threads_per_block, 0, handle.get_stream()>>>(
       elements_v.data(), predicates_v.data(), addresses_v.data(), vertex_t{SP * N});
 
-    CHECK_CUDA(handle.get_stream());
+    RAFT_CHECK_CUDA(handle.get_stream());
 
     kernel_augmentation<<<blocks_per_grid_1, threads_per_block_1, 0, handle.get_stream()>>>(
       d_vertices_dev.row_assignments,
@@ -443,7 +443,7 @@ inline void augmentationPass(raft::device_resources const& handle,
       vertex_t{N},
       row_ids_csr_size);
 
-    CHECK_CUDA(handle.get_stream());
+    RAFT_CHECK_CUDA(handle.get_stream());
   }
 }
 
@@ -471,7 +471,7 @@ inline void dualUpdate(raft::device_resources const& handle,
     N,
     std::numeric_limits<weight_t>::max());
 
-  CHECK_CUDA(handle.get_stream());
+  RAFT_CHECK_CUDA(handle.get_stream());
 
   detail::calculateRectangularDims(blocks_per_grid, threads_per_block, total_blocks, N, SP);
   kernel_dualUpdate_2<<<blocks_per_grid, threads_per_block, 0, handle.get_stream()>>>(
@@ -488,7 +488,7 @@ inline void dualUpdate(raft::device_resources const& handle,
     std::numeric_limits<weight_t>::max(),
     epsilon);
 
-  CHECK_CUDA(handle.get_stream());
+  RAFT_CHECK_CUDA(handle.get_stream());
 }
 
 // Function for calculating optimal objective function value using dual variables.
@@ -508,7 +508,7 @@ inline void calcObjValDual(raft::device_resources const& handle,
   kernel_calcObjValDual<<<blocks_per_grid, threads_per_block, 0, handle.get_stream()>>>(
     d_obj_val, d_vertices_dev.row_duals, d_vertices_dev.col_duals, SP, N);
 
-  CHECK_CUDA(handle.get_stream());
+  RAFT_CHECK_CUDA(handle.get_stream());
 }
 
 // Function for calculating optimal objective function value using dual variables.
@@ -529,7 +529,7 @@ inline void calcObjValPrimal(raft::device_resources const& handle,
   kernel_calcObjValPrimal<<<blocks_per_grid, threads_per_block, 0, handle.get_stream()>>>(
     d_obj_val, d_costs, d_row_assignments, SP, N);
 
-  CHECK_CUDA(handle.get_stream());
+  RAFT_CHECK_CUDA(handle.get_stream());
 }
 
 }  // namespace raft::solver::detail
diff --git a/cpp/include/raft/solver/linear_assignment.cuh b/cpp/include/raft/solver/linear_assignment.cuh
index 7904c04ede..6e66bafe1f 100644
--- a/cpp/include/raft/solver/linear_assignment.cuh
+++ b/cpp/include/raft/solver/linear_assignment.cuh
@@ -170,7 +170,7 @@ class LinearAssignmentProblem {
   {
     weight_t result;
     raft::update_host(&result, obj_val_primal_v.data() + spId, 1, handle_.get_stream());
-    CHECK_CUDA(handle_.get_stream());
+    RAFT_CHECK_CUDA(handle_.get_stream());
     return result;
   }
 
@@ -183,7 +183,7 @@ class LinearAssignmentProblem {
   {
     weight_t result;
     raft::update_host(&result, obj_val_dual_v.data() + spId, 1, handle_.get_stream());
-    CHECK_CUDA(handle_.get_stream());
+    RAFT_CHECK_CUDA(handle_.get_stream());
     return result;
   }
 
diff --git a/cpp/include/raft/sparse/solver/detail/lanczos.cuh b/cpp/include/raft/sparse/solver/detail/lanczos.cuh
index 63bc98b404..67d6f6c412 100644
--- a/cpp/include/raft/sparse/solver/detail/lanczos.cuh
+++ b/cpp/include/raft/sparse/solver/detail/lanczos.cuh
@@ -962,7 +962,7 @@ int computeSmallestEigenvectors(
                                 (*effIter) * nEigVecs * sizeof(value_type_t),
                                 cudaMemcpyHostToDevice,
                                 stream));
-  CHECK_CUDA(stream);
+  RAFT_CHECK_CUDA(stream);
 
   // Convert eigenvectors from Lanczos basis to standard basis
   RAFT_CUBLAS_TRY(raft::linalg::detail::cublasgemm(cublas_h,
@@ -1312,7 +1312,7 @@ int computeLargestEigenvectors(
                                 cudaMemcpyHostToDevice,
                                 stream));
 
-  CHECK_CUDA(stream);
+  RAFT_CHECK_CUDA(stream);
 
   // Convert eigenvectors from Lanczos basis to standard basis
   RAFT_CUBLAS_TRY(raft::linalg::detail::cublasgemm(cublas_h,
diff --git a/cpp/include/raft/spectral/detail/matrix_wrappers.hpp b/cpp/include/raft/spectral/detail/matrix_wrappers.hpp
index e32b718117..73518e20ef 100644
--- a/cpp/include/raft/spectral/detail/matrix_wrappers.hpp
+++ b/cpp/include/raft/spectral/detail/matrix_wrappers.hpp
@@ -352,7 +352,7 @@ struct laplacian_matrix_t : sparse_matrix_t<index_type, value_type> {
     // scales y by beta:
     //
     if (beta == 0) {
-      CUDA_TRY(cudaMemsetAsync(y, 0, n * sizeof(value_type), stream));
+      RAFT_CUDA_TRY(cudaMemsetAsync(y, 0, n * sizeof(value_type), stream));
     } else if (beta != 1) {
       // TODO: Call from public API when ready
       RAFT_CUBLAS_TRY(raft::linalg::detail::cublasscal(cublas_h, n, &beta, y, 1, stream));
diff --git a/cpp/include/raft/util/cudart_utils.hpp b/cpp/include/raft/util/cudart_utils.hpp
index 0a7ca23028..1134513587 100644
--- a/cpp/include/raft/util/cudart_utils.hpp
+++ b/cpp/include/raft/util/cudart_utils.hpp
@@ -14,14 +14,6 @@
  * limitations under the License.
  */
 
-/**
- * This file is deprecated and will be removed in release 22.06.
- * Please use raft_runtime/cudart_utils.hpp instead.
- */
-
-#ifndef __RAFT_RT_CUDART_UTILS_H
-#define __RAFT_RT_CUDART_UTILS_H
-
 #pragma once
 
 #include <raft/core/error.hpp>
@@ -32,7 +24,7 @@
 #include <rmm/mr/device/pool_memory_resource.hpp>
 
 #include <cuda_fp16.h>
-#include <cuda_runtime.h>
+#include <cuda_runtime_api.h>
 
 #include <chrono>
 #include <cstdio>
@@ -43,11 +35,6 @@
 #include <mutex>
 #include <string>
 
-// FIXME: Remove after consumers rename
-#ifndef CUDA_TRY
-#define CUDA_TRY(call) RAFT_CUDA_TRY(call)
-#endif
-
 /**
  * @brief Debug macro to check for CUDA errors
  *
@@ -67,16 +54,6 @@
 #define RAFT_CHECK_CUDA(stream) RAFT_CUDA_TRY(cudaPeekAtLastError());
 #endif
 
-// FIXME: Remove after consumers rename
-#ifndef CHECK_CUDA
-#define CHECK_CUDA(call) RAFT_CHECK_CUDA(call)
-#endif
-
-/** FIXME: remove after cuml rename */
-#ifndef CUDA_CHECK
-#define CUDA_CHECK(call) RAFT_CUDA_TRY(call)
-#endif
-
 // /**
 //  * @brief check for cuda runtime API errors but log error instead of raising
 //  *        exception.
@@ -93,17 +70,6 @@
     }                                                              \
   } while (0)
 
-// FIXME: Remove after cuml rename
-#ifndef CUDA_CHECK_NO_THROW
-#define CUDA_CHECK_NO_THROW(call) RAFT_CUDA_TRY_NO_THROW(call)
-#endif
-
-/**
- * Alias to raft scope for now.
- * TODO: Rename original implementations in 22.04 to fix
- * https://github.com/rapidsai/raft/issues/128
- */
-
 namespace raft {
 
 /** Helper method to get to know warp size in device code */
@@ -215,7 +181,7 @@ class grid_1d_block_t {
 template <typename Type>
 void copy(Type* dst, const Type* src, size_t len, rmm::cuda_stream_view stream)
 {
-  CUDA_CHECK(cudaMemcpyAsync(dst, src, len * sizeof(Type), cudaMemcpyDefault, stream));
+  RAFT_CUDA_TRY(cudaMemcpyAsync(dst, src, len * sizeof(Type), cudaMemcpyDefault, stream));
 }
 
 /**
@@ -241,7 +207,8 @@ void update_host(Type* h_ptr, const Type* d_ptr, size_t len, rmm::cuda_stream_vi
 template <typename Type>
 void copy_async(Type* d_ptr1, const Type* d_ptr2, size_t len, rmm::cuda_stream_view stream)
 {
-  CUDA_CHECK(cudaMemcpyAsync(d_ptr1, d_ptr2, len * sizeof(Type), cudaMemcpyDeviceToDevice, stream));
+  RAFT_CUDA_TRY(
+    cudaMemcpyAsync(d_ptr1, d_ptr2, len * sizeof(Type), cudaMemcpyDeviceToDevice, stream));
 }
 /** @} */
 
@@ -270,7 +237,7 @@ void print_device_vector(const char* variable_name,
                          OutStream& out)
 {
   auto host_mem = std::make_unique<T[]>(componentsCount);
-  CUDA_CHECK(
+  RAFT_CUDA_TRY(
     cudaMemcpy(host_mem.get(), devMem, componentsCount * sizeof(T), cudaMemcpyDeviceToHost));
   print_host_vector(variable_name, host_mem.get(), componentsCount, out);
 }
@@ -532,5 +499,3 @@ inline auto get_pool_memory_resource(rmm::mr::device_memory_resource*& mr, size_
 }
 
 }  // namespace raft
-
-#endif
diff --git a/dependencies.yaml b/dependencies.yaml
index dd361a0cdf..64fd7cd454 100644
--- a/dependencies.yaml
+++ b/dependencies.yaml
@@ -15,6 +15,16 @@ files:
       - run_pylibraft
       - test_python_common
       - test_pylibraft
+  bench_ann:
+    output: conda
+    matrix:
+      cuda: ["11.8"]
+      arch: [x86_64]
+    includes:
+      - build
+      - develop
+      - cudatoolkit
+      - nn_bench
   test_cpp:
     output: none
     includes:
@@ -137,6 +147,17 @@ dependencies:
       - output_types: [conda]
         packages:
           - clang-tools=11.1.0
+  nn_bench:
+    common:
+      - output_types: [conda]
+        packages:
+          - hnswlib=0.7.0
+          - nlohmann_json>=3.11.2
+          - glog>=0.6.0
+          - h5py>=3.8.0
+          - libfaiss>=1.7.1
+          - faiss-proc=*=cuda
+
   cudatoolkit:
     specific:
       - output_types: conda
diff --git a/docs/source/cuda_ann_benchmarks.md b/docs/source/cuda_ann_benchmarks.md
new file mode 100644
index 0000000000..708f5f7dba
--- /dev/null
+++ b/docs/source/cuda_ann_benchmarks.md
@@ -0,0 +1,322 @@
+# CUDA ANN Benchmarks
+
+This project provides a benchmark program for various ANN search implementations. It's especially suitable for comparing GPU implementations as well as comparing GPU against CPU.
+
+## Benchmark
+
+### Dependencies
+
+CUDA 11 and a GPU with Pascal architecture or later are required to run the benchmarks. 
+
+Please refer to the  [installation docs](https://docs.rapids.ai/api/raft/stable/build.html#cuda-gpu-requirements) for the base requirements to build RAFT. 
+
+In addition to the base requirements for building RAFT, additional dependencies needed to build the ANN benchmarks include:
+1. FAISS GPU >= 1.7.1
+2. Google Logging (GLog)
+3. H5Py
+4. HNSWLib
+5. nlohmann_json
+6. GGNN
+
+[rapids-cmake](https://github.com/rapidsai/rapids-cmake) is used to build the ANN benchmarks so the code for dependencies not already supplied in the CUDA toolkit will be downloaded and built automatically.
+
+The easiest (and most reproducible) way to install the dependencies needed to build the ANN benchmarks is to use the conda environment file located in the `conda/environments` directory of the RAFT repository. The following command will use `mamba` (which is preferred over `conda`) to build and activate a new environment for compiling the benchmarks:
+
+```bash
+mamba env create --name raft_ann_benchmarks -f conda/environments/bench_ann_cuda-118_arch-x86_64.yaml
+conda activate raft_ann_benchmarks
+```
+
+The above conda environment will also reduce the compile times as dependencies like FAISS will already be installed and not need to be compiled with `rapids-cmake`.
+
+### Compiling the Benchmarks
+
+After the needed dependencies are satisfied, the easiest way to compile ANN benchmarks is through the `build.sh` script in the root of the RAFT source code repository. The following will build the executables for all the support algorithms:
+```bash
+./build.sh bench-ann
+```
+
+You can limit the algorithms that are built by providing a semicolon-delimited list of executable names (each algorithm is suffixed with `_ANN_BENCH`):
+```bash
+./build.sh bench-ann --limit-bench-ann=HNSWLIB_ANN_BENCH;RAFT_IVF_PQ_ANN_BENCH
+```
+
+Available targets to use with `--limit-bench-ann` are:
+- FAISS_IVF_FLAT_ANN_BENCH
+- FAISS_IVF_PQ_ANN_BENCH
+- FAISS_BFKNN_ANN_BENCH
+- GGNN_ANN_BENCH
+- HNSWLIB_ANN_BENCH
+- RAFT_IVF_PQ_ANN_BENCH
+- RAFT_IVF_FLAT_ANN_BENCH
+- RAFT_BFKNN_ANN_BENCH
+
+By default, the `*_ANN_BENCH` executables program infer the dataset's datatype from the filename's extension. For example, an extension of `fbin` uses a `float` datatype, `f16bin` uses a `float16` datatype, extension of `i8bin` uses `int8_t` datatype, and `u8bin` uses `uint8_t` type. Currently, only `float`, `float16`, int8_t`, and `unit8_t` are supported.
+
+### Usage
+There are 4 general steps to running the benchmarks:
+1. Prepare Dataset
+2. Build Index
+3. Search Using Built Index
+4. Evaluate Result
+
+#### End-to-end Example
+An end-to-end example (run from the RAFT source code root directory):
+```bash
+# (1) prepare a dataset
+pushd
+
+cd cpp/bench/ann
+mkdir data && cd data
+wget http://ann-benchmarks.com/glove-100-angular.hdf5
+
+# option -n is used here to normalize vectors so cosine distance is converted
+# to inner product; don't use -n for l2 distance
+python scripts/hdf5_to_fbin.py -n glove-100-angular.hdf5
+
+mkdir glove-100-inner
+mv glove-100-angular.base.fbin glove-100-inner/base.fbin
+mv glove-100-angular.query.fbin glove-100-inner/query.fbin
+mv glove-100-angular.groundtruth.neighbors.ibin glove-100-inner/groundtruth.neighbors.ibin
+mv glove-100-angular.groundtruth.distances.fbin glove-100-inner/groundtruth.distances.fbin
+popd
+
+# (2) build index
+./cpp/build/RAFT_IVF_FLAT_ANN_BENCH -b -i raft_ivf_flat.nlist1024 conf/glove-100-inner.json
+
+# (3) search
+./cpp/build/RAFT_IVF_FLAT_ANN_BENCH -s -i raft_ivf_flat.nlist1024 conf/glove-100-inner.json
+
+# (4) evaluate result
+pushd
+cd cpp/bench/ann
+./scripts/eval.pl \
+  -o result.csv \
+  data/glove-100-inner/groundtruth.neighbors.ibin \
+  result/glove-100-inner/faiss_ivf_flat
+popd 
+
+# optional step: plot QPS-Recall figure using data in result.csv with your favorite tool
+```
+
+##### Step 1: Prepare Dataset
+A dataset usually has 4 binary files containing database vectors, query vectors, ground truth neighbors and their corresponding distances. For example, Glove-100 dataset has files `base.fbin` (database vectors), `query.fbin` (query vectors), `groundtruth.neighbors.ibin` (ground truth neighbors), and `groundtruth.distances.fbin` (ground truth distances). The first two files are for index building and searching, while the other two are associated with a particular distance and are used for evaluation.
+
+The file suffixes `.fbin`, `.f16bin`, `.ibin`, `.u8bin`, and `.i8bin` denote that the data type of vectors stored in the file are `float32`, `float16`(a.k.a `half`), `int`, `uint8`, and `int8`, respectively.
+These binary files are little-endian and the format is: the first 8 bytes are `num_vectors` (`uint32_t`) and `num_dimensions` (`uint32_t`), and the following `num_vectors * num_dimensions * sizeof(type)` bytes are vectors stored in row-major order.
+
+Some implementation can take `float16` database and query vectors as inputs and will have better performance. Use `script/fbin_to_f16bin.py` to transform dataset from `float32` to `float16` type.
+
+Commonly used datasets can be downloaded from two websites:
+1. Million-scale datasets can be found at the [Data sets](https://github.com/erikbern/ann-benchmarks#data-sets) section of [`ann-benchmarks`](https://github.com/erikbern/ann-benchmarks).
+
+    However, these datasets are in HDF5 format. Use `cpp/bench/ann/scripts/hdf5_to_fbin.py` to transform the format. A few Python packages are required to run it:
+    ```bash
+    pip3 install numpy h5py
+    ```
+    The usage of this script is:
+    ```bash
+    $ cpp/bench/ann/scripts/hdf5_to_fbin.py
+    usage: scripts/hdf5_to_fbin.py [-n] <input>.hdf5
+       -n: normalize base/query set
+     outputs: <input>.base.fbin
+              <input>.query.fbin
+              <input>.groundtruth.neighbors.ibin
+              <input>.groundtruth.distances.fbin
+    ```
+    So for an input `.hdf5` file, four output binary files will be produced. See previous section for an example of prepossessing GloVe dataset.
+
+    Most datasets provided by `ann-benchmarks` use `Angular` or `Euclidean` distance. `Angular` denotes cosine distance. However, computing cosine distance reduces to computing inner product by normalizing vectors beforehand. In practice, we can always do the normalization to decrease computation cost, so it's better to measure the performance of inner product rather than cosine distance. The `-n` option of `hdf5_to_fbin.py` can be used to normalize the dataset.
+
+2. Billion-scale datasets can be found at [`big-ann-benchmarks`](http://big-ann-benchmarks.com). The ground truth file contains both neighbors and distances, thus should be split. A script is provided for this:
+    ```bash
+    $ cpp/bench/ann/scripts/split_groundtruth.pl
+    usage: script/split_groundtruth.pl input output_prefix
+    ```
+    Take Deep-1B dataset as an example:
+    ```bash
+    pushd
+    cd cpp/bench/ann
+    mkdir -p data/deep-1B && cd data/deep-1B
+    # download manually "Ground Truth" file of "Yandex DEEP"
+    # suppose the file name is deep_new_groundtruth.public.10K.bin
+    ../../scripts/split_groundtruth.pl deep_new_groundtruth.public.10K.bin groundtruth
+    # two files 'groundtruth.neighbors.ibin' and 'groundtruth.distances.fbin' should be produced
+    popd
+    ```
+    Besides ground truth files for the whole billion-scale datasets, this site also provides ground truth files for the first 10M or 100M vectors of the base sets. This mean we can use these billion-scale datasets as million-scale datasets. To facilitate this, an optional parameter `subset_size` for dataset can be used. See the next step for further explanation.
+
+
+##### Step 2: Build Index
+An index is a data structure to facilitate searching. Different algorithms may use different data structures for their index. We can use `RAFT_IVF_FLAT_ANN_BENCH -b` to build an index and save it to disk.
+
+To run a benchmark executable, like `RAFT_IVF_FLAT_ANN_BENCH`, a JSON configuration file is required. Refer to [`cpp/bench/ann/conf/glove-100-inner.json`](../../cpp/cpp/bench/ann/conf/glove-100-inner.json) as an example. Configuration file has 3 sections:
+* `dataset` section specifies the name and files of a dataset, and also the distance in use. Since the `*_ANN_BENCH` programs are for index building and searching, only `base_file` for database vectors and `query_file` for query vectors are needed. Ground truth files are for evaluation thus not needed.
+    - To use only a subset of the base dataset, an optional parameter `subset_size` can be specified. It means using only the first `subset_size` vectors of `base_file` as the base dataset.
+* `search_basic_param` section specifies basic parameters for searching:
+    - `k` is the "k" in "k-nn", that is, the number of neighbors (or results) we want from the searching.
+    -  `run_count` means how many times we run the searching. A single run of searching will search neighbors for all vectors in `test` set. The total time used for a run is recorded, and the final searching time is the smallest one among these runs.
+* `index` section specifies an array of configurations for index building and searching:
+    - `build_param` and `search_params` are parameters for building and searching, respectively. `search_params` is an array since we will search with different parameters to get different recall values.
+    - `file` is the file name of index. Building will save built index to this file, while searching will load this file.
+    - `search_result_file` is the file name prefix of searching results. Searching will save results to these files, and plotting script will read these files to plot results. Note this is a prefix rather than a whole file name. Suppose its value is `${prefix}`, then the real file names are like `${prefix}.0.{ibin|txt}`, `${prefix}.1.{ibin|txt}`, etc. Each of them corresponds to an item in `search_params` array. That is, for one searching parameter, there will be some corresponding search result files.
+    - if `multigpu` is specified, multiple GPUs will be used for index build and search.
+    - if `refine_ratio` is specified, refinement, as a post-processing step of search, will be done. It's for algorithms that compress vectors. For example, if `"refine_ratio" : 2` is set, 2`k` results are first computed, then exact distances of them are computed using original uncompressed vectors, and finally top `k` results among them are kept.
+
+
+The usage of `*_ANN_BENCH` can be found by running `*_ANN_BENCH -h` on one of the executables:
+```bash
+$ ./cpp/build/*_ANN_BENCH -h
+usage: ./cpp/build/*_ANN_BENCH -b|s [-f] [-i index_names] conf.json
+   -b: build mode, will build index
+   -s: search mode, will search using built index
+       one and only one of -b and -s should be specified
+   -f: force overwriting existing output files
+   -i: by default will build/search all the indices found in conf.json
+       '-i' can be used to select a subset of indices
+       'index_names' is a list of comma-separated index names
+       '*' is allowed as the last character of a name to select all matched indices
+       for example, -i "hnsw1,hnsw2,faiss" or -i "hnsw*,faiss"
+```
+* `-b`: build index.
+* `-s`: do the searching with built index.
+* `-f`: before doing the real task, the program checks that needed input files exist and output files don't exist. If these conditions are not met, it quits so no file would be overwritten accidentally. To ignore existing output files and force overwrite them, use the `-f` option.
+* `-i`: by default, the `-b` flag will build all indices found in the configuration file, and `-s` will search using all the indices. To select a subset of indices to build or search, we can use the `-i` option.
+
+It's easier to describe the usage of `-i` option with an example. Suppose we have a configuration file `a.json`, and it contains:
+```json
+  "index" : [
+    {
+      "name" : "hnsw1",
+      ...
+    },
+    {
+      "name" : "hnsw1",
+      ...
+    },
+    {
+      "name" : "faiss",
+      ...
+    }
+  ]
+```
+Then,
+```bash
+# build all indices: hnsw1, hnsw2 and faiss
+./cpp/build/HNSWLIB_ANN_BENCH -b a.json
+
+# build only hnsw1
+./cpp/build/HNSWLIB_ANN_BENCH -b -i hnsw1 a.json
+
+# build hnsw1 and hnsw2
+./cpp/build/HNSWLIB_ANN_BENCH -b -i hnsw1,hnsw2 a.json
+
+# build hnsw1 and hnsw2
+./cpp/build/HNSWLIB_ANN_BENCH -b -i 'hnsw*' a.json
+
+# build faiss
+./cpp/build/FAISS_IVF_FLAT_ANN_BENCH -b -i 'faiss' a.json
+```
+In the last two commands, we use wildcard "`*`" to match both `hnsw1` and `hnsw2`. Note the use of "`*`" is quite limited. It can occur only at the end of a pattern, so both "`*nsw1`" and "`h*sw1`" are interpreted literally and will not match anything. Also note that quotation marks must be used to prevent "`*`" from being interpreted by the shell.
+
+
+##### Step 3: Searching
+Use the `-s` flag on any of the `*_ANN_BENCH` executables. Other options are the same as in step 2.
+
+
+##### Step 4: Evaluating Results
+Use `cpp/bench/ann/scripts/eval.pl` to evaluate benchmark results. The usage is:
+```bash
+$ cpp/bench/ann/scripts/eval.pl
+usage: [-f] [-o output.csv] groundtruth.neighbors.ibin result_paths...
+  result_paths... are paths to the search result files.
+    Can specify multiple paths.
+    For each of them, if it's a directory, all the .txt files found under
+    it recursively will be regarded as inputs.
+
+  -f: force to recompute recall and update it in result file if needed
+  -o: also write result to a csv file
+```
+Note that there can be multiple arguments for paths of result files. Each argument can be either a file name or a path. If it's a directory, all files found under it recursively will be used as input files.
+An example:
+```bash
+cpp/bench/ann/scripts/eval.pl groundtruth.neighbors.ibin \
+  result/glove-100-angular/10/hnsw/angular_M_24_*.txt \
+  result/glove-100-angular/10/faiss/
+```
+The search result files used by this command are files matching `result/glove-100-angular/10/hnsw/angular_M_24_*.txt`, and all `.txt` files under directory `result/glove-100-angular/10/faiss/` recursively.
+
+This script prints recall and QPS for every result file. Also, it outputs estimated "recall at QPS=2000" and "QPS at recall=0.9", which can be used to compare performance quantitatively.
+
+It saves recall value in result txt file, so avoids to recompute recall if the same command is run again. To force to recompute recall, option `-f` can be used. If option `-o <output.csv>` is specified, a csv output file will be produced. This file can be used to plot Throughput-Recall curves.
+
+## Adding a new ANN algorithm
+Implementation of a new algorithm should be a class that inherits `class ANN` (defined in `cpp/bench/ann/src/ann.h`) and implements all the pure virtual functions.
+
+In addition, it should define two `struct`s for building and searching parameters. The searching parameter class should inherit `struct ANN<T>::AnnSearchParam`. Take `class HnswLib` as an example, its definition is:
+```c++
+template<typename T>
+class HnswLib : public ANN<T> {
+public:
+  struct BuildParam {
+    int M;
+    int ef_construction;
+    int num_threads;
+  };
+
+  using typename ANN<T>::AnnSearchParam;
+  struct SearchParam : public AnnSearchParam {
+    int ef;
+    int num_threads;
+  };
+
+  // ...
+};
+```
+
+The benchmark program uses JSON configuration file. To add the new algorithm to the benchmark, need be able to specify `build_param`, whose value is a JSON object, and `search_params`, whose value is an array of JSON objects, for this algorithm in configuration file. Still take the configuration for `HnswLib` as an example:
+```json
+{
+  "name" : "...",
+  "algo" : "hnswlib",
+  "build_param": {"M":12, "efConstruction":500, "numThreads":32},
+  "file" : "/path/to/file",
+  "search_params" : [
+    {"ef":10, "numThreads":1},
+    {"ef":20, "numThreads":1},
+    {"ef":40, "numThreads":1},
+  ],
+  "search_result_file" : "/path/to/file"
+},
+```
+
+How to interpret these JSON objects is totally left to the implementation and should be specified in `cpp/bench/ann/src/factory.cuh`:
+1. First, add two functions for parsing JSON object to `struct BuildParam` and `struct SearchParam`, respectively:
+    ```c++
+    template<typename T>
+    void parse_build_param(const nlohmann::json& conf,
+                           typename cuann::HnswLib<T>::BuildParam& param) {
+      param.ef_construction = conf.at("efConstruction");
+      param.M = conf.at("M");
+      if (conf.contains("numThreads")) {
+        param.num_threads = conf.at("numThreads");
+      }
+    }
+
+    template<typename T>
+    void parse_search_param(const nlohmann::json& conf,
+                            typename cuann::HnswLib<T>::SearchParam& param) {
+      param.ef = conf.at("ef");
+      if (conf.contains("numThreads")) {
+        param.num_threads = conf.at("numThreads");
+      }
+    }
+    ```
+
+2. Next, add corresponding `if` case to functions `create_algo()` and `create_search_param()` by calling parsing functions. The string literal in `if` condition statement must be the same as the value of `algo` in configuration file. For example,
+    ```c++
+      // JSON configuration file contains a line like:  "algo" : "hnswlib"
+      if (algo == "hnswlib") {
+         // ...
+      }
+    ```
diff --git a/docs/source/index.rst b/docs/source/index.rst
index 814899c36b..23e346c872 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -44,6 +44,7 @@ While not exhaustive, the following general categories help summarize the accele
    developer_guide.md
    cpp_api.rst
    pylibraft_api.rst
+   cuda_ann_benchmarks.md
    raft_dask_api.rst
    using_comms.rst
    using_libraft.md
diff --git a/thirdparty/LICENSES/LICENSE.pytorch b/thirdparty/LICENSES/LICENSE.pytorch
new file mode 100644
index 0000000000..7ad3d737a5
--- /dev/null
+++ b/thirdparty/LICENSES/LICENSE.pytorch
@@ -0,0 +1,77 @@
+From PyTorch:
+
+Copyright (c) 2016-     Facebook, Inc            (Adam Paszke)
+Copyright (c) 2014-     Facebook, Inc            (Soumith Chintala)
+Copyright (c) 2011-2014 Idiap Research Institute (Ronan Collobert)
+Copyright (c) 2012-2014 Deepmind Technologies    (Koray Kavukcuoglu)
+Copyright (c) 2011-2012 NEC Laboratories America (Koray Kavukcuoglu)
+Copyright (c) 2011-2013 NYU                      (Clement Farabet)
+Copyright (c) 2006-2010 NEC Laboratories America (Ronan Collobert, Leon Bottou, Iain Melvin, Jason Weston)
+Copyright (c) 2006      Idiap Research Institute (Samy Bengio)
+Copyright (c) 2001-2004 Idiap Research Institute (Ronan Collobert, Samy Bengio, Johnny Mariethoz)
+
+From Caffe2:
+
+Copyright (c) 2016-present, Facebook Inc. All rights reserved.
+
+All contributions by Facebook:
+Copyright (c) 2016 Facebook Inc.
+
+All contributions by Google:
+Copyright (c) 2015 Google Inc.
+All rights reserved.
+
+All contributions by Yangqing Jia:
+Copyright (c) 2015 Yangqing Jia
+All rights reserved.
+
+All contributions by Kakao Brain:
+Copyright 2019-2020 Kakao Brain
+
+All contributions by Cruise LLC:
+Copyright (c) 2022 Cruise LLC.
+All rights reserved.
+
+All contributions from Caffe:
+Copyright(c) 2013, 2014, 2015, the respective contributors
+All rights reserved.
+
+All other contributions:
+Copyright(c) 2015, 2016 the respective contributors
+All rights reserved.
+
+Caffe2 uses a copyright model similar to Caffe: each contributor holds
+copyright over their contributions to Caffe2. The project versioning records
+all such contribution and copyright details. If a contributor wants to further
+mark their specific copyright on a particular contribution, they should
+indicate their copyright solely in the commit message of the change when it is
+committed.
+
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+3. Neither the names of Facebook, Deepmind Technologies, NYU, NEC Laboratories America
+   and IDIAP Research Institute nor the names of its contributors may be
+   used to endorse or promote products derived from this software without
+   specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
\ No newline at end of file

From c2cb779d6c3b25d2489c7acf6340f23f5157aa9c Mon Sep 17 00:00:00 2001
From: "Corey J. Nolet" <cjnolet@gmail.com>
Date: Tue, 28 Mar 2023 22:50:32 -0400
Subject: [PATCH 20/25] Fixing index-url link on pip install docs (#1378)

Closes #1377

Authors:
  - Corey J. Nolet (https://github.com/cjnolet)

Approvers:
  - Divye Gala (https://github.com/divyegala)

URL: https://github.com/rapidsai/raft/pull/1378
---
 README.md            | 4 ++--
 docs/source/build.md | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 81973ff82e..b77e906262 100755
--- a/README.md
+++ b/README.md
@@ -215,8 +215,8 @@ After installing RAFT, `find_package(raft COMPONENTS compiled distributed)` can
 
 pylibraft and raft-dask both have experimental packages that can be [installed through pip](https://rapids.ai/pip.html#install):
 ```bash
-pip install pylibraft-cu11 --extra-index-url=https://pypi.ngc.nvidia.com
-pip install raft-dask-cu11 --extra-index-url=https://pypi.ngc.nvidia.com
+pip install pylibraft-cu11 --extra-index-url=https://pypi.nvidia.com
+pip install raft-dask-cu11 --extra-index-url=https://pypi.nvidia.com
 ```
 
 ### CMake & CPM
diff --git a/docs/source/build.md b/docs/source/build.md
index e8e6ac8a14..e36f771682 100644
--- a/docs/source/build.md
+++ b/docs/source/build.md
@@ -21,8 +21,8 @@ After installing RAFT, `find_package(raft COMPONENTS nn distance)` can be used i
 
 pylibraft and raft-dask both have experimental packages that can be [installed through pip](https://rapids.ai/pip.html#install):
 ```bash
-pip install pylibraft-cu11 --extra-index-url=https://pypi.ngc.nvidia.com
-pip install raft-dask-cu11 --extra-index-url=https://pypi.ngc.nvidia.com
+pip install pylibraft-cu11 --extra-index-url=https://pypi.nvidia.com
+pip install raft-dask-cu11 --extra-index-url=https://pypi.nvidia.com
 ```
 
 ## Building and installing RAFT

From e963f5a64371c25f1e2e09ab1e3ca15658293e2d Mon Sep 17 00:00:00 2001
From: Allard Hendriksen <ahendriksen@nvidia.com>
Date: Wed, 29 Mar 2023 18:36:18 +0200
Subject: [PATCH 21/25] build.sh: Add option to log nvcc compile times (#1262)

Add `--time` option to `build.sh` that enables compile time logging of `nvcc`.

Also, add a script `cpp/scripts/analyze_nvcc_log.py` to find the translation units that take the longest time.

Output looks like:

```
$ cpp/scripts/analyze_nvcc_log.py cpp/build/nvcc_compile_log.csv
-- loading data
-- analyzing data
-- Ten longest translation units:
phase  index                                               file        cicc   cudafe++  fatbinary  gcc (compiling)  gcc (preprocessing 1)  gcc (preprocessing 4)        ptxas   total time
0         10  ions/detail/canberra_double_double_double_int.cu    42.431063  10.601856   0.020979         6.747153               3.721194               2.093567  1618.390375  1684.006186
1         11  zations/detail/canberra_float_float_float_int.cu    36.928960   9.804138   0.011537         6.796088               3.481156               1.790703  1584.262875  1643.075457
2         85  ors/specializations/refine_d_uint64_t_uint8_t.cu   602.935531  14.980877   0.529673        36.300566               6.270717               2.889723   933.622969  1597.530056
3         84  bors/specializations/refine_d_uint64_t_int8_t.cu   606.513281  16.243960   0.729282        39.981113               5.608029               3.028493   897.241469  1569.345628
4         53  stance/neighbors/ivfpq_search_int8_t_uint64_t.cu   841.049750   8.233967   1.025554        24.248578               4.069022               1.747108   631.193734  1511.567713
5         52  istance/neighbors/ivfpq_search_float_uint64_t.cu   837.241437   8.145278   1.042313        24.400606               3.433528               1.882623   627.786672  1503.932457
6         54  tance/neighbors/ivfpq_search_uint8_t_uint64_t.cu   846.706656   8.371286   1.025517        24.094691               3.432749               1.645345   618.319234  1503.595479
7         76  izations/detail/ivfpq_search_uint8_t_uint64_t.cu   698.726266   7.086368   1.050021        39.727723               3.259101               1.333935   406.509937  1157.693351
8         74  alizations/detail/ivfpq_search_float_uint64_t.cu   706.702516   6.905794   1.049731        39.923895               2.814361               2.057154   395.604000  1155.057450
9         75  lizations/detail/ivfpq_search_int8_t_uint64_t.cu   689.390281   6.483386   1.025864        39.865668               3.121696               1.297788   409.099562  1150.284245
10        83  hbors/specializations/refine_d_uint64_t_float.cu   334.705594  15.466444   0.680270        36.551977               5.405133               2.947568   715.708781  1111.465767
-- Plotting absolute compile times
-- Wrote absolute compile time plot to cpp/build/nvcc_compile_log.csv.absolute.compile_times.png
-- Plotting relative compile times
-- Wrote relative compile time plot to cpp/build/nvcc_compile_log.csv.relative.compile_times.png
```

Authors:
  - Allard Hendriksen (https://github.com/ahendriksen)

Approvers:
  - Corey J. Nolet (https://github.com/cjnolet)

URL: https://github.com/rapidsai/raft/pull/1262
---
 build.sh                              |  10 +-
 cpp/CMakeLists.txt                    |   1 +
 cpp/cmake/modules/ConfigureCUDA.cmake |   6 +-
 cpp/scripts/analyze_nvcc_log.py       | 134 ++++++++++++++++++++++++++
 4 files changed, 149 insertions(+), 2 deletions(-)
 create mode 100755 cpp/scripts/analyze_nvcc_log.py

diff --git a/build.sh b/build.sh
index 3758dc26c4..7e1a3e7e36 100755
--- a/build.sh
+++ b/build.sh
@@ -18,7 +18,7 @@ ARGS=$*
 # scripts, and that this script resides in the repo dir!
 REPODIR=$(cd $(dirname $0); pwd)
 
-VALIDARGS="clean libraft pylibraft raft-dask docs tests template bench-prims bench-ann clean --uninstall  -v -g -n --compile-lib --allgpuarch --no-nvtx --show_depr_warn -h"
+VALIDARGS="clean libraft pylibraft raft-dask docs tests template bench-prims bench-ann clean --uninstall  -v -g -n --compile-lib --allgpuarch --no-nvtx --show_depr_warn --time -h"
 HELP="$0 [<target> ...] [<flag> ...] [--cmake-args=\"<args>\"] [--cache-tool=<tool>] [--limit-tests=<targets>] [--limit-bench-prims=<targets>] [--limit-bench-ann=<targets>]
  where <target> is:
    clean            - remove all existing build artifacts and configuration (start over)
@@ -48,6 +48,8 @@ HELP="$0 [<target> ...] [<flag> ...] [--cmake-args=\"<args>\"] [--cache-tool=<to
    --cmake-args=\\\"<args>\\\" - pass arbitrary list of CMake configuration options (escape all quotes in argument)
    --cache-tool=<tool>         - pass the build cache tool (eg: ccache, sccache, distcc) that will be used
                                  to speedup the build process.
+   --time                      - Enable nvcc compilation time logging into cpp/build/nvcc_compile_log.csv.
+                                 Results can be interpreted with cpp/scripts/analyze_nvcc_log.py
    -h                          - print this text
 
  default action (no args) is to build libraft, tests, pylibraft and raft-dask targets
@@ -75,6 +77,7 @@ BENCH_TARGETS="CLUSTER_BENCH;NEIGHBORS_BENCH;DISTANCE_BENCH;LINALG_BENCH;MATRIX_
 
 CACHE_ARGS=""
 NVTX=ON
+LOG_COMPILE_TIME=OFF
 CLEAN=0
 UNINSTALL=0
 DISABLE_DEPRECATION_WARNINGS=ON
@@ -322,6 +325,10 @@ fi
 if hasArg --no-nvtx; then
     NVTX=OFF
 fi
+if hasArg --time; then
+    echo "-- Logging compile times to cpp/build/nvcc_compile_log.csv"
+    LOG_COMPILE_TIME=ON
+fi
 if hasArg --show_depr_warn; then
     DISABLE_DEPRECATION_WARNINGS=OFF
 fi
@@ -379,6 +386,7 @@ if (( ${NUMARGS} == 0 )) || hasArg libraft || hasArg docs || hasArg tests || has
           -DCMAKE_BUILD_TYPE=${BUILD_TYPE} \
           -DRAFT_COMPILE_LIBRARY=${COMPILE_LIBRARY} \
           -DRAFT_NVTX=${NVTX} \
+          -DCUDA_LOG_COMPILE_TIME=${LOG_COMPILE_TIME} \
           -DDISABLE_DEPRECATION_WARNINGS=${DISABLE_DEPRECATION_WARNINGS} \
           -DBUILD_TESTS=${BUILD_TESTS} \
           -DBUILD_PRIMS_BENCH=${BUILD_PRIMS_BENCH} \
diff --git a/cpp/CMakeLists.txt b/cpp/CMakeLists.txt
index 7bb458c44a..2e9c726b8e 100644
--- a/cpp/CMakeLists.txt
+++ b/cpp/CMakeLists.txt
@@ -53,6 +53,7 @@ option(CUDA_ENABLE_LINEINFO
        "Enable the -lineinfo option for nvcc (useful for cuda-memcheck / profiler)" OFF
 )
 option(CUDA_STATIC_RUNTIME "Statically link the CUDA toolkit runtime and libraries" OFF)
+option(CUDA_LOG_COMPILE_TIME "Write a log of compilation times to nvcc_compile_log.csv" OFF)
 option(DETECT_CONDA_ENV "Enable detection of conda environment for dependencies" ON)
 option(DISABLE_DEPRECATION_WARNINGS "Disable deprecaction warnings " ON)
 option(DISABLE_OPENMP "Disable OpenMP" OFF)
diff --git a/cpp/cmake/modules/ConfigureCUDA.cmake b/cpp/cmake/modules/ConfigureCUDA.cmake
index 5e68ca5bc4..c733d46985 100644
--- a/cpp/cmake/modules/ConfigureCUDA.cmake
+++ b/cpp/cmake/modules/ConfigureCUDA.cmake
@@ -1,5 +1,5 @@
 # =============================================================================
-# Copyright (c) 2018-2022, NVIDIA CORPORATION.
+# Copyright (c) 2018-2023, NVIDIA CORPORATION.
 #
 # Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
 # in compliance with the License. You may obtain a copy of the License at
@@ -21,6 +21,10 @@ if(CMAKE_COMPILER_IS_GNUCXX)
   list(APPEND RAFT_CXX_FLAGS -Wall -Werror -Wno-unknown-pragmas -Wno-error=deprecated-declarations)
 endif()
 
+if(CUDA_LOG_COMPILE_TIME)
+  list(APPEND RAFT_CUDA_FLAGS "--time=nvcc_compile_log.csv")
+endif()
+
 list(APPEND RAFT_CUDA_FLAGS --expt-extended-lambda --expt-relaxed-constexpr)
 list(APPEND RAFT_CXX_FLAGS "-DCUDA_API_PER_THREAD_DEFAULT_STREAM")
 list(APPEND RAFT_CUDA_FLAGS "-DCUDA_API_PER_THREAD_DEFAULT_STREAM")
diff --git a/cpp/scripts/analyze_nvcc_log.py b/cpp/scripts/analyze_nvcc_log.py
new file mode 100755
index 0000000000..d06e05d265
--- /dev/null
+++ b/cpp/scripts/analyze_nvcc_log.py
@@ -0,0 +1,134 @@
+#!/usr/bin/env python3
+# Copyright (c) 2023, NVIDIA CORPORATION.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import sys
+import pandas as pd
+import numpy as np
+import matplotlib.pyplot as plt
+import seaborn as sns
+from pathlib import Path
+from matplotlib import colors
+
+def main(input_path):
+    input_path = Path(input_path)
+    print("-- loading data")
+    df = pd.read_csv(input_path)
+
+    print("-- analyzing data")
+    # Strip spaces from column names
+    df = df.rename(columns=str.strip)
+    df["seconds"] = df["metric"] / 1000
+    df["file"] = df["source file name"]
+    df["phase"] = df["phase name"].str.strip()
+
+    dfp = (df
+           # Remove nvcc driver entries. They don't contain a source file name
+           .query("phase!='nvcc (driver)'")
+           # Make a pivot table containing files as row, phase (preprocessing,
+           # cicc, etc.) as column and the total times as table entries. NOTE:
+           # if compiled for multiple archs, the archs will be summed.
+           .pivot_table(index="file", values="seconds", columns="phase", aggfunc='sum'))
+
+    dfp_sum = dfp.sum(axis="columns")
+
+    df_fraction = dfp.divide(dfp_sum, axis="index")
+    df_fraction["total time"] = dfp_sum
+    df_fraction = df_fraction.melt(ignore_index=False, id_vars="total time", var_name="phase", value_name="fraction")
+
+    dfp["total time"] = dfp_sum
+    df_absolute = dfp.melt(ignore_index=False, id_vars="total time", var_name="phase", value_name="seconds")
+
+    # host: light red to dark red (preprocessing, cudafe, gcc (compiling))
+    # device: ligt green to dark green (preprocessing, cicc, ptxas)
+    palette = {
+        "gcc (preprocessing 4)": colors.hsv_to_rgb((0, 1, 1)),
+        'cudafe++': colors.hsv_to_rgb((0, 1, .75)),
+        'gcc (compiling)': colors.hsv_to_rgb((0, 1, .4)),
+        "gcc (preprocessing 1)": colors.hsv_to_rgb((.33, 1, 1)),
+        'cicc': colors.hsv_to_rgb((.33, 1, 0.75)),
+        'ptxas': colors.hsv_to_rgb((.33, 1, 0.4)),
+        'fatbinary': "grey",
+    }
+
+    print("-- Ten longest translation units:")
+    colwidth = pd.get_option('display.max_colwidth') - 1
+    dfp = dfp.reset_index()
+    dfp["file"] = dfp["file"].apply(lambda s: s[-colwidth:])
+    print(dfp.sort_values("total time", ascending=False).reset_index().loc[:10])
+
+    print("-- Plotting absolute compile times")
+    abs_out_path = f"{input_path}.absolute.compile_times.png"
+    sns.displot(
+        df_absolute.sort_values("total time").reset_index(),
+        y="file",
+        hue="phase",
+        hue_order=reversed(
+            ["gcc (preprocessing 4)", 'cudafe++', 'gcc (compiling)',
+             "gcc (preprocessing 1)", 'cicc', 'ptxas',
+             'fatbinary',
+        ]),
+        palette=palette,
+        weights="seconds",
+        multiple="stack",
+        kind="hist",
+        height=20,
+    )
+    plt.xlabel("seconds");
+    plt.savefig(abs_out_path)
+    print(f"-- Wrote absolute compile time plot to {abs_out_path}")
+
+    print("-- Plotting relative compile times")
+    rel_out_path = f"{input_path}.relative.compile_times.png"
+    sns.displot(
+        df_fraction.sort_values('total time').reset_index(),
+        y="file",
+        hue="phase",
+        hue_order=reversed(["gcc (preprocessing 4)", 'cudafe++', 'gcc (compiling)',
+                   "gcc (preprocessing 1)", 'cicc', 'ptxas',
+                   'fatbinary',
+                  ]),
+        palette=palette,
+        weights="fraction",
+        multiple="stack",
+        kind="hist",
+        height=15,
+    )
+    plt.xlabel("fraction");
+    plt.savefig(rel_out_path)
+    print(f"-- Wrote relative compile time plot to {rel_out_path}")
+
+if __name__ == "__main__":
+    if len(sys.argv) != 2:
+        printf("""NVCC log analyzer
+
+        Analyzes nvcc logs and outputs a figure with highest ranking translation
+        units.
+
+        Usage:
+        python analyze_nvcc_log.py <nvcc_log_file.csv>
+        cpp/scripts/analyze_nvcc_log.py <nvcc_log_file.csv>
+
+        Generate the nvcc log file by adding:
+
+        list(APPEND RAFT_CUDA_FLAGS "--time=CMakeFiles/nvcc_compile_log.csv")
+
+        to cpp/cmake/modules/ConfigureCUDA.cmake.
+        """)
+
+    input_path = Path(sys.argv[1])
+    if not input_path.exists():
+        print(f"Path {input_path} does not exist.")
+    else:
+        main(input_path)

From a88072cbe4784a25d6efef05d4de4528dd4fa5ae Mon Sep 17 00:00:00 2001
From: Vyas Ramasubramani <vyas.ramasubramani@gmail.com>
Date: Wed, 29 Mar 2023 21:17:48 -0400
Subject: [PATCH 22/25] Update rapids version

---
 cpp/template/cmake/thirdparty/fetch_rapids.cmake | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/cpp/template/cmake/thirdparty/fetch_rapids.cmake b/cpp/template/cmake/thirdparty/fetch_rapids.cmake
index 40ba83be9e..248f4f1af4 100644
--- a/cpp/template/cmake/thirdparty/fetch_rapids.cmake
+++ b/cpp/template/cmake/thirdparty/fetch_rapids.cmake
@@ -12,7 +12,7 @@
 # the License.
 
 # Use this variable to update RAPIDS and RAFT versions
-set(RAPIDS_VERSION "23.04")
+set(RAPIDS_VERSION "23.06")
 
 if(NOT EXISTS ${CMAKE_CURRENT_BINARY_DIR}/RAFT_RAPIDS.cmake)
     file(DOWNLOAD https://raw.githubusercontent.com/rapidsai/rapids-cmake/branch-${RAPIDS_VERSION}/RAPIDS.cmake

From 5f0e66d1b18a8ce992db61add7e726ec4d5c2848 Mon Sep 17 00:00:00 2001
From: Vyas Ramasubramani <vyas.ramasubramani@gmail.com>
Date: Wed, 29 Mar 2023 21:38:40 -0400
Subject: [PATCH 23/25] Update pylibraft version

---
 dependencies.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dependencies.yaml b/dependencies.yaml
index 6a07cd890d..0460e2dd81 100644
--- a/dependencies.yaml
+++ b/dependencies.yaml
@@ -278,7 +278,7 @@ dependencies:
           - ucx-proc=*=gpu
       - output_types: pyproject
         packages:
-          - pylibraft==23.4.*
+          - pylibraft==23.6.*
   test_python_common:
     common:
       - output_types: [conda, requirements, pyproject]

From 3c5b8de4c791e2ab44cadbaa68acd29b8ef9dcbb Mon Sep 17 00:00:00 2001
From: Vyas Ramasubramani <vyas.ramasubramani@gmail.com>
Date: Wed, 29 Mar 2023 21:48:31 -0400
Subject: [PATCH 24/25] Run dfg

---
 python/raft-dask/pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/python/raft-dask/pyproject.toml b/python/raft-dask/pyproject.toml
index 0ca9e7a876..1fb5aa8f7c 100644
--- a/python/raft-dask/pyproject.toml
+++ b/python/raft-dask/pyproject.toml
@@ -40,7 +40,7 @@ dependencies = [
     "joblib>=0.11",
     "numba>=0.49",
     "numpy>=1.21",
-    "pylibraft==23.4.*",
+    "pylibraft==23.6.*",
     "ucx-py==0.32.*",
 ] # This list was generated by `rapids-dependency-file-generator`. To make changes, edit ../../dependencies.yaml and run `rapids-dependency-file-generator`.
 classifiers = [

From 9bac6d53d32567d218b8188c88f4cdf665625fe4 Mon Sep 17 00:00:00 2001
From: Vyas Ramasubramani <vyasr@nvidia.com>
Date: Thu, 30 Mar 2023 09:40:42 -0400
Subject: [PATCH 25/25] Fix dask versions in wheel build preinstallation

---
 .github/workflows/pr.yaml   | 4 ++--
 .github/workflows/test.yaml | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/pr.yaml b/.github/workflows/pr.yaml
index bf080d6ad2..cf8f8cd4b5 100644
--- a/.github/workflows/pr.yaml
+++ b/.github/workflows/pr.yaml
@@ -105,7 +105,7 @@ jobs:
       build_type: pull-request
       package-name: raft_dask
       # Always want to test against latest dask/distributed.
-      test-before-amd64: "RAPIDS_PY_WHEEL_NAME=pylibraft_cu11 rapids-download-wheels-from-s3 ./local-pylibraft-dep && pip install --no-deps ./local-pylibraft-dep/pylibraft*.whl && pip install git+https://github.com/dask/dask.git@main git+https://github.com/dask/distributed.git@main git+https://github.com/rapidsai/dask-cuda.git@branch-23.04"
-      test-before-arm64: "RAPIDS_PY_WHEEL_NAME=pylibraft_cu11 rapids-download-wheels-from-s3 ./local-pylibraft-dep && pip install --no-deps ./local-pylibraft-dep/pylibraft*.whl && pip install git+https://github.com/dask/dask.git@main git+https://github.com/dask/distributed.git@main git+https://github.com/rapidsai/dask-cuda.git@branch-23.04"
+      test-before-amd64: "RAPIDS_PY_WHEEL_NAME=pylibraft_cu11 rapids-download-wheels-from-s3 ./local-pylibraft-dep && pip install --no-deps ./local-pylibraft-dep/pylibraft*.whl && pip install git+https://github.com/dask/dask.git@main git+https://github.com/dask/distributed.git@main git+https://github.com/rapidsai/dask-cuda.git@branch-23.06"
+      test-before-arm64: "RAPIDS_PY_WHEEL_NAME=pylibraft_cu11 rapids-download-wheels-from-s3 ./local-pylibraft-dep && pip install --no-deps ./local-pylibraft-dep/pylibraft*.whl && pip install git+https://github.com/dask/dask.git@main git+https://github.com/dask/distributed.git@main git+https://github.com/rapidsai/dask-cuda.git@branch-23.06"
       test-unittest: "python -m pytest -v ./python/raft-dask/raft_dask/test"
       test-smoketest: "python ./ci/wheel_smoke_test_raft_dask.py"
diff --git a/.github/workflows/test.yaml b/.github/workflows/test.yaml
index f1207c3545..ebf596c958 100644
--- a/.github/workflows/test.yaml
+++ b/.github/workflows/test.yaml
@@ -51,6 +51,6 @@ jobs:
       date: ${{ inputs.date }}
       sha: ${{ inputs.sha }}
       package-name: raft_dask
-      test-before-amd64: "pip install git+https://github.com/dask/dask.git@main git+https://github.com/dask/distributed.git@main git+https://github.com/rapidsai/dask-cuda.git@branch-23.04"
-      test-before-arm64: "pip install git+https://github.com/dask/dask.git@main git+https://github.com/dask/distributed.git@main git+https://github.com/rapidsai/dask-cuda.git@branch-23.04"
+      test-before-amd64: "pip install git+https://github.com/dask/dask.git@main git+https://github.com/dask/distributed.git@main git+https://github.com/rapidsai/dask-cuda.git@branch-23.06"
+      test-before-arm64: "pip install git+https://github.com/dask/dask.git@main git+https://github.com/dask/distributed.git@main git+https://github.com/rapidsai/dask-cuda.git@branch-23.06"
       test-unittest: "python -m pytest -v ./python/raft-dask/raft_dask/test"