faiss-next 0.6.0

Rust bindings for Faiss (Facebook AI Similarity Search)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128

use faiss_next_sys;

pub fn pairwise_l2_sqr(d: usize, x: &[f32], y: &[f32]) -> Vec<f32> {
    let nq = x.len() / d;
    let nb = y.len() / d;
    let mut dis = vec![0.0f32; nq * nb];
    unsafe {
        faiss_next_sys::faiss_pairwise_L2sqr_with_defaults(
            d as i64,
            nq as i64,
            x.as_ptr(),
            nb as i64,
            y.as_ptr(),
            dis.as_mut_ptr(),
        );
    }
    dis
}

pub fn pairwise_l2_sqr_with_stride(
    d: usize,
    x: &[f32],
    y: &[f32],
    ldq: i64,
    ldb: i64,
    ldd: i64,
) -> Vec<f32> {
    let nq = x.len() / if ldq > 0 { ldq as usize } else { d };
    let nb = y.len() / if ldb > 0 { ldb as usize } else { d };
    let mut dis = vec![0.0f32; nq * if ldd > 0 { ldd as usize } else { nb }];
    unsafe {
        faiss_next_sys::faiss_pairwise_L2sqr(
            d as i64,
            nq as i64,
            x.as_ptr(),
            nb as i64,
            y.as_ptr(),
            dis.as_mut_ptr(),
            ldq,
            ldb,
            ldd,
        );
    }
    dis
}

pub fn inner_products(d: usize, x: &[f32], y: &[f32]) -> Vec<f32> {
    let ny = y.len() / d;
    let mut ip = vec![0.0f32; ny];
    unsafe {
        faiss_next_sys::faiss_fvec_inner_products_ny(
            ip.as_mut_ptr(),
            x.as_ptr(),
            y.as_ptr(),
            d,
            ny,
        );
    }
    ip
}

pub fn l2_sqr_ny(d: usize, x: &[f32], y: &[f32]) -> Vec<f32> {
    let ny = y.len() / d;
    let mut dis = vec![0.0f32; ny];
    unsafe {
        faiss_next_sys::faiss_fvec_L2sqr_ny(dis.as_mut_ptr(), x.as_ptr(), y.as_ptr(), d, ny);
    }
    dis
}

pub fn norm_l2_sqr(x: &[f32], d: usize) -> f32 {
    unsafe { faiss_next_sys::faiss_fvec_norm_L2sqr(x.as_ptr(), d) }
}

pub fn norms_l2(x: &[f32], d: usize) -> Vec<f32> {
    let nx = x.len() / d;
    let mut norms = vec![0.0f32; nx];
    unsafe {
        faiss_next_sys::faiss_fvec_norms_L2(norms.as_mut_ptr(), x.as_ptr(), d, nx);
    }
    norms
}

pub fn norms_l2_sqr(x: &[f32], d: usize) -> Vec<f32> {
    let nx = x.len() / d;
    let mut norms = vec![0.0f32; nx];
    unsafe {
        faiss_next_sys::faiss_fvec_norms_L2sqr(norms.as_mut_ptr(), x.as_ptr(), d, nx);
    }
    norms
}

pub fn renorm_l2(x: &mut [f32], d: usize) {
    let nx = x.len() / d;
    unsafe {
        faiss_next_sys::faiss_fvec_renorm_L2(d, nx, x.as_mut_ptr());
    }
}

pub fn set_distance_compute_blas_threshold(value: i32) {
    unsafe {
        faiss_next_sys::faiss_set_distance_compute_blas_threshold(value as std::os::raw::c_int);
    }
}

pub fn get_distance_compute_blas_threshold() -> i32 {
    unsafe { faiss_next_sys::faiss_get_distance_compute_blas_threshold() }
}

pub fn set_distance_compute_blas_query_bs(value: i32) {
    unsafe {
        faiss_next_sys::faiss_set_distance_compute_blas_query_bs(value as std::os::raw::c_int);
    }
}

pub fn get_distance_compute_blas_query_bs() -> i32 {
    unsafe { faiss_next_sys::faiss_get_distance_compute_blas_query_bs() }
}

pub fn set_distance_compute_blas_database_bs(value: i32) {
    unsafe {
        faiss_next_sys::faiss_set_distance_compute_blas_database_bs(value as std::os::raw::c_int);
    }
}

pub fn get_distance_compute_blas_database_bs() -> i32 {
    unsafe { faiss_next_sys::faiss_get_distance_compute_blas_database_bs() }
}