hipVS C++ API documentation

2026-03-06

5 min read time

Applies to Linux

• Cluster
  • K-Means
    • Params
      • cuvs::cluster::kmeans::params
      • cuvs::cluster::kmeans::balanced_params
    • K-means
      • fit()
      • fit()
      • fit()
      • fit()
      • fit()
      • fit()
      • fit()
      • predict()
      • predict()
      • predict()
      • predict()
      • predict()
      • predict()
      • predict()
      • fit_predict()
      • fit_predict()
      • fit_predict()
      • fit_predict()
      • fit_predict()
      • fit_predict()
      • transform()
      • transform()
      • cluster_cost()
      • cluster_cost()
    • K-means Helpers
  • Agglomerative
    • Params
      • Linkage
    • Single-linkage
      • single_linkage()
• Interop
  • is_dlpack_device_compatible()
  • is_dlpack_host_compatible()
  • is_c_contiguous()
  • is_f_contiguous()
  • from_dlpack()
  • to_dlpack()
• Distance
  • Distance Types
    • cuvsDistanceType
      • L2Expanded
      • L2SqrtExpanded
      • CosineExpanded
      • L1
      • L2Unexpanded
      • L2SqrtUnexpanded
      • InnerProduct
      • Linf
      • Canberra
      • LpUnexpanded
      • CorrelationExpanded
      • JaccardExpanded
      • HellingerExpanded
      • Haversine
      • BrayCurtis
      • JensenShannon
      • HammingUnexpanded
      • KLDivergence
      • RusselRaoExpanded
      • DiceExpanded
      • BitwiseHamming
      • Precomputed
  • Pairwise Distances
    • pairwise_distance()
    • pairwise_distance()
    • pairwise_distance()
    • pairwise_distance()
    • pairwise_distance()
    • pairwise_distance()
    • pairwise_distance()
    • pairwise_distance()
• Nearest Neighbors
  • All-neighbors
    • All neighbors knn graph build parameters
      • GraphBuildParams
      • cuvs::neighbors::all_neighbors::all_neighbors_params
    • Build
      • build()
      • build()
  • Bruteforce
    • Index
      • cuvs::neighbors::brute_force::index
    • Index build
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
    • Index search
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
    • Index serialize
      • serialize()
      • serialize()
      • serialize()
      • serialize()
      • deserialize()
      • deserialize()
      • deserialize()
      • deserialize()
  • CAGRA
    • Index build parameters
      • cuvs::neighbors::cagra::index_params
    • Index search parameters
      • search_algo
      • hash_mode
      • cuvs::neighbors::cagra::search_params
    • Index extend parameters
      • cuvs::neighbors::cagra::extend_params
    • Index
      • cuvs::neighbors::cagra::index
    • Index build
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
    • Index search
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
    • Index extend
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
    • Index serialize
      • serialize()
      • deserialize()
      • serialize()
      • deserialize()
      • serialize()
      • deserialize()
      • serialize()
      • deserialize()
      • serialize()
      • deserialize()
      • serialize()
      • deserialize()
      • serialize()
      • deserialize()
      • serialize()
      • deserialize()
      • serialize_to_hnswlib()
      • serialize_to_hnswlib()
      • serialize_to_hnswlib()
      • serialize_to_hnswlib()
      • serialize_to_hnswlib()
      • serialize_to_hnswlib()
      • serialize_to_hnswlib()
      • serialize_to_hnswlib()
  • Dynamic Batching
    • Index build parameters
      • cuvs::neighbors::dynamic_batching::index_params
    • Index search parameters
      • cuvs::neighbors::dynamic_batching::search_params
    • Index
      • cuvs::neighbors::dynamic_batching::index
    • Index search
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
  • Epsilon Neighborhood
    • L2-Squared Distance Operations
      • compute()
  • Filtering
    • FilterType
      • None
      • Bitmap
      • Bitset
    • cuvs::neighbors::filtering::base_filter
    • cuvs::neighbors::filtering::none_sample_filter
    • cuvs::neighbors::filtering::ivf_to_sample_filter
    • cuvs::neighbors::filtering::bitmap_filter
    • cuvs::neighbors::filtering::bitset_filter
  • HNSW
    • Index search parameters
      • cuvs::neighbors::hnsw::search_params
    • Index
      • cuvs::neighbors::hnsw::index
    • Index extend parameters
      • cuvs::neighbors::hnsw::extend_params
    • Index extend
      • extend()
      • extend()
      • extend()
      • extend()
    • Index load
      • from_cagra()
      • from_cagra()
      • from_cagra()
      • from_cagra()
    • Index search
      • search()
      • search()
      • search()
      • search()
    • Index serialize
      • serialize()
      • serialize()
      • serialize()
      • serialize()
      • deserialize()
      • deserialize()
      • deserialize()
      • deserialize()
  • IVF-Flat
    • Index build parameters
      • kIndexGroupSize
      • cuvs::neighbors::ivf_flat::index_params
    • Index search parameters
      • list_data
      • cuvs::neighbors::ivf_flat::search_params
      • cuvs::neighbors::ivf_flat::list_spec
    • Index
      • cuvs::neighbors::ivf_flat::index
    • Index build
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
    • Index extend
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
    • Index search
      • search()
      • search()
      • search()
      • search()
    • Index serialize
      • serialize()
      • deserialize()
      • serialize()
      • deserialize()
      • serialize()
      • deserialize()
      • serialize()
      • deserialize()
      • serialize()
      • deserialize()
      • serialize()
      • deserialize()
      • serialize()
      • deserialize()
      • serialize()
      • deserialize()
  • IVF-PQ
    • Index build parameters
      • codebook_gen
      • cuvs::neighbors::ivf_pq::index_params
    • Index search parameters
      • cuvs::neighbors::ivf_pq::search_params
    • Index
      • cuvs::neighbors::ivf_pq::index
    • Index build
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
    • Index extend
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
    • Index search
      • search()
      • search()
      • search()
      • search()
    • Index serialize
      • serialize()
      • serialize()
      • deserialize()
      • deserialize()
    • Helper Methods
      • unpack()
      • unpack_contiguous()
      • pack()
      • pack_contiguous()
      • pack_list_data()
      • pack_contiguous_list_data()
      • unpack_list_data()
      • unpack_list_data()
      • unpack_contiguous_list_data()
      • reconstruct_list_data()
      • reconstruct_list_data()
      • reconstruct_list_data()
      • reconstruct_list_data()
      • reconstruct_list_data()
      • reconstruct_list_data()
      • reconstruct_list_data()
      • reconstruct_list_data()
      • extend_list_with_codes()
      • extend_list()
      • extend_list()
      • extend_list()
      • erase_list()
      • reset_index()
      • make_rotation_matrix()
      • set_centers()
      • extract_centers()
      • extract_centers()
      • recompute_internal_state()
  • NN-Descent
    • Index build parameters
      • cuvs::neighbors::nn_descent::index_params
    • Index
      • cuvs::neighbors::nn_descent::index
    • Index build
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
  • Refinement
    • Index
      • refine()
      • refine()
      • refine()
      • refine()
      • refine()
      • refine()
      • refine()
      • refine()
      • refine()
      • refine()
  • Distributed ANN
    • Index build parameters
      • distribution_mode
      • cuvs::neighbors::mg_index_params
    • Search parameters
      • replicated_search_mode
      • sharded_merge_mode
      • cuvs::neighbors::mg_search_params
    • Index build
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
    • Index extend
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
      • extend()
    • Index search
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
      • search()
    • Index serialize
      • serialize()
      • serialize()
      • serialize()
      • serialize()
      • serialize()
      • serialize()
      • serialize()
      • serialize()
      • serialize()
      • serialize()
      • serialize()
      • serialize()
    • Index deserialize
      • deserialize()
      • deserialize()
      • deserialize()
    • Distribute pre-built local index
      • distribute()
      • distribute()
      • distribute()
  • Vamana
    • Index build parameters
      • cuvs::neighbors::vamana::codebook_params
      • cuvs::neighbors::vamana::index_params
    • Index
      • cuvs::neighbors::vamana::index
    • Index build
      • build()
      • build()
      • build()
      • build()
      • build()
      • build()
    • Index serialize
      • serialize()
      • serialize()
      • serialize()
• Preprocessing
  • Quantize
    • Scalar
      • train()
      • train()
      • transform()
      • transform()
      • inverse_transform()
      • inverse_transform()
      • train()
      • train()
      • transform()
      • transform()
      • inverse_transform()
      • inverse_transform()
      • train()
      • train()
      • transform()
      • transform()
      • inverse_transform()
      • inverse_transform()
      • cuvs::preprocessing::quantize::scalar::params
      • cuvs::preprocessing::quantize::scalar::quantizer
    • Binary
      • bit_threshold
      • transform()
      • transform()
      • transform()
      • transform()
      • transform()
      • transform()
      • transform()
      • transform()
      • transform()
      • transform()
      • transform()
      • transform()
      • cuvs::preprocessing::quantize::binary::params
      • cuvs::preprocessing::quantize::binary::quantizer
  • Spectral Embedding
    • Overview
    • Parameters
      • cuvs::preprocessing::spectral_embedding::params
    • Functions
      • transform()
      • transform()
    • Example Usage
      • Basic Usage with Dataset
      • Using Precomputed Graph
• Selection
  • Select-K
    • select_k()
    • select_k()
    • select_k()
    • select_k()
• Stats
  • Silhouette Score
    • silhouette_score()
    • silhouette_score_batched()
    • silhouette_score()
    • silhouette_score_batched()
  • Trustworthiness Score
    • trustworthiness_score()