faiss 0.6.2 → 0.6.3

data/vendor/faiss/faiss/utils/extra_distances.cpp

@@ -29,11 +29,9 @@ namespace {
 template <class VD>
 struct ExtraDistanceComputer : FlatCodesDistanceComputer {
     VD vd;
-    idx_t nb;
-    const float* q;
-    const float* b;
 
     float symmetric_dis(idx_t i, idx_t j) final {
+        const float* b = (const float*)codes;
         return vd(b + j * vd.d, b + i * vd.d);
     }
 
@@ -41,16 +39,9 @@ struct ExtraDistanceComputer : FlatCodesDistanceComputer {
         return vd(q, (float*)code);
     }
 
-    ExtraDistanceComputer(
-            const VD& vd_in,
-            const float* xb,
-            size_t nb_in,
-            const float* q_in = nullptr)
+    ExtraDistanceComputer(const VD& vd_in, const float* xb)
             : FlatCodesDistanceComputer((uint8_t*)xb, vd_in.d * sizeof(float)),
-              vd(vd_in),
-              nb(nb_in),
-              q(q_in),
-              b(xb) {}
+              vd(vd_in) {}
 
     void set_query(const float* x) override {
         q = x;
@@ -149,11 +140,10 @@ FlatCodesDistanceComputer* get_extra_distance_computer(
         size_t d,
         MetricType mt,
         float metric_arg,
-        size_t nb,
         const float* xb) {
     return with_VectorDistance(
             d, mt, metric_arg, [&](auto vd) -> FlatCodesDistanceComputer* {
-                return new ExtraDistanceComputer<decltype(vd)>(vd, xb, nb);
+                return new ExtraDistanceComputer<decltype(vd)>(vd, xb);
             });
 }
 

data/vendor/faiss/faiss/utils/extra_distances.h

@@ -49,12 +49,11 @@ void knn_extra_metrics(
         const IDSelector* sel = nullptr);
 
 /** get a DistanceComputer that refers to this type of distance and
- *  indexes a flat array of size nb */
+ *  indexes a flat array */
 FlatCodesDistanceComputer* get_extra_distance_computer(
         size_t d,
         MetricType mt,
         float metric_arg,
-        size_t nb,
         const float* xb);
 
 /// Dispatch to a lambda with MetricType as a compile-time constant.

data/vendor/faiss/faiss/utils/hamming.cpp

@@ -33,7 +33,7 @@
 // Scalar (NONE) fallback — only needs the generic specializations.
 #define THE_SIMD_LEVEL SIMDLevel::NONE
 // NOLINTNEXTLINE(facebook-hte-InlineHeader)
-#include <faiss/utils/hamming_distance/hamming_computer-generic.h>
+#include <faiss/utils/hamming_distance/hamming_computer-generic.h> // IWYU pragma: keep
 #include <faiss/utils/hamming_distance/hamming_impl.h>
 #undef THE_SIMD_LEVEL
 

data/vendor/faiss/faiss/utils/quantize_lut.cpp

@@ -75,7 +75,7 @@ void round_uint8_per_column(
             max_span = span;
         }
     }
-    float a = 255 / max_span;
+    float a = max_span > 0 ? 255.0f / max_span : 0.0f;
     float b = 0;
     for (size_t i = 0; i < n; i++) {
         b += mins[i];
@@ -111,7 +111,7 @@ void round_uint8_per_column_multi(
             max_span = span;
         }
     }
-    float a = 255 / max_span;
+    float a = max_span > 0 ? 255.0f / max_span : 0.0f;
     float b = 0;
     for (size_t i = 0; i < n; i++) {
         b += mins[i];
@@ -143,7 +143,8 @@ void quantize_LUT_and_bias(
         float* b_out) {
     float a, b;
     if (!bias) {
-        FAISS_THROW_IF_NOT(!lut_is_3d);
+        FAISS_THROW_IF_MSG(
+                lut_is_3d, "3d LUT is not supported when bias is null");
         std::vector<float> mins(M);
         float max_span_LUT = -HUGE_VAL, max_span_dis = 0;
         b = 0;
@@ -154,7 +155,12 @@ void quantize_LUT_and_bias(
             max_span_dis += span;
             b += mins[i];
         }
-        a = std::min(255 / max_span_LUT, 65535 / max_span_dis);
+        a = std::min(
+                max_span_LUT > 0 ? 255.0f / max_span_LUT : HUGE_VALF,
+                max_span_dis > 0 ? 65535.0f / max_span_dis : HUGE_VALF);
+        if (!std::isfinite(a)) {
+            a = 0.0f;
+        }
 
         for (size_t i = 0; i < M; i++) {
             round_tab(LUT + i * ksub, ksub, a, mins[i], LUTq + i * ksub);
@@ -174,7 +180,12 @@ void quantize_LUT_and_bias(
             max_span_dis += span;
             b += mins[i];
         }
-        a = std::min(255 / max_span_LUT, 65535 / max_span_dis);
+        a = std::min(
+                max_span_LUT > 0 ? 255.0f / max_span_LUT : HUGE_VALF,
+                max_span_dis > 0 ? 65535.0f / max_span_dis : HUGE_VALF);
+        if (!std::isfinite(a)) {
+            a = 0.0f;
+        }
         b += bias_min;
 
         for (size_t i = 0; i < M; i++) {
@@ -208,7 +219,12 @@ void quantize_LUT_and_bias(
             b = std::min(b, b2j);
         }
 
-        a = std::min(255 / max_span_LUT, 65535 / max_span_dis);
+        a = std::min(
+                max_span_LUT > 0 ? 255.0f / max_span_LUT : HUGE_VALF,
+                max_span_dis > 0 ? 65535.0f / max_span_dis : HUGE_VALF);
+        if (!std::isfinite(a)) {
+            a = 0.0f;
+        }
 
         ij = 0;
         size_t ij_2 = 0;
@@ -256,7 +272,7 @@ void quantize_LUT_and_bias(
             max_span = std::max(max_span, span);
             b += mins[i];
         }
-        a = 255 / max_span;
+        a = max_span > 0 ? 255.0f / max_span : 0.0f;
         ij = 0;
         size_t ij_2 = 0;
         for (size_t j = 0; j < nprobe; j++) {
@@ -305,7 +321,12 @@ void aq_quantize_LUT_and_bias(
         max_span_dis += (i >= M - M_norm ? span * norm_scale : span);
         b += mins[i];
     }
-    a = std::min(255 / max_span_LUT, 65535 / max_span_dis);
+    a = std::min(
+            max_span_LUT > 0 ? 255.0f / max_span_LUT : HUGE_VALF,
+            max_span_dis > 0 ? 65535.0f / max_span_dis : HUGE_VALF);
+    if (!std::isfinite(a)) {
+        a = 0.0f;
+    }
     b += bias_min;
 
     for (size_t i = 0; i < M; i++) {

data/vendor/faiss/faiss/utils/rabitq_simd.h

@@ -7,6 +7,7 @@
 
 #pragma once
 
+#include <algorithm>
 #include <cstddef>
 #include <cstdint>
 #include <cstring>
@@ -16,6 +17,15 @@
 
 namespace faiss::rabitq {
 
+/// SIMD levels with RaBitQ query/LUT quantization implementations.
+constexpr int RABITQ_QUANTIZATION_SIMD_LEVELS = (1 << int(SIMDLevel::NONE)) |
+        (1 << int(SIMDLevel::AVX2)) | (1 << int(SIMDLevel::AVX512));
+
+struct BitwiseAndDotProductResult {
+    uint64_t dot_product;
+    uint64_t popcount;
+};
+
 /**
  * Compute dot product between query and binary data using popcount on AND.
  *
@@ -32,6 +42,17 @@ uint64_t bitwise_and_dot_product(
         size_t size,
         size_t qb);
 
+/**
+ * Compute bitwise_and_dot_product(query, data, size, qb) and popcount(data,
+ * size) in one pass over data.
+ */
+template <SIMDLevel SL = SINGLE_SIMD_LEVEL>
+BitwiseAndDotProductResult bitwise_and_dot_product_with_popcount(
+        const uint8_t* query,
+        const uint8_t* data,
+        size_t size,
+        size_t qb);
+
 /**
  * Compute dot product between query and binary data using popcount on XOR.
  *
@@ -58,6 +79,56 @@ uint64_t bitwise_xor_dot_product(
 template <SIMDLevel SL = SINGLE_SIMD_LEVEL>
 uint64_t popcount(const uint8_t* data, size_t size);
 
+/**
+ * Rearrange per-dimension quantized query codes into bit-plane layout.
+ *
+ * @p rotated_qq holds one qb-bit code per dimension (one byte each, value in
+ * [0, 2^qb)). @p out receives qb bit-planes of ((d + 7) / 8) bytes each:
+ * bit-plane j packs bit j of code i into bit (i % 8) of byte (i / 8). @p out
+ * must have room for qb * ((d + 7) / 8) bytes and is fully overwritten.
+ *
+ * @param rotated_qq  per-dimension codes (d bytes)
+ * @param d           dimensionality
+ * @param qb          quantization bits per dimension (1..8)
+ * @param out         bit-plane output buffer (qb * ((d + 7) / 8) bytes)
+ */
+template <SIMDLevel SL = SINGLE_SIMD_LEVEL>
+void rearrange_bit_planes(
+        const uint8_t* rotated_qq,
+        size_t d,
+        size_t qb,
+        uint8_t* out);
+
+/// Find min/max of one 16-entry FastScan LUT row.
+template <SIMDLevel SL = SINGLE_SIMD_LEVEL>
+void lut_minmax_16(const float* tab, float& mn, float& mx);
+
+/// Find min/max of an arbitrary-length float vector. For n == 0, mn and mx
+/// are left unchanged.
+template <SIMDLevel SL = SINGLE_SIMD_LEVEL>
+void minmax_values(const float* values, size_t n, float& mn, float& mx);
+
+/// Quantize one 16-entry FastScan LUT row with non-negative half-up rounding.
+template <SIMDLevel SL = SINGLE_SIMD_LEVEL>
+void lut_quantize_16_to_uint8(
+        const float* tab,
+        float mn,
+        float a,
+        uint8_t* out);
+
+/// Quantize rotated query values and accumulate query correction terms.
+template <SIMDLevel SL = SINGLE_SIMD_LEVEL>
+void quantize_query_values(
+        const float* rq,
+        size_t d,
+        float v_min,
+        float inv_delta,
+        uint8_t max_code,
+        bool centered,
+        uint8_t* rqq,
+        size_t& sum_qq,
+        int64_t& sum2_signed_odd_int);
+
 // NONE specializations — scalar fallbacks
 
 template <>
@@ -85,6 +156,35 @@ inline uint64_t bitwise_and_dot_product<SIMDLevel::NONE>(
     return sum;
 }
 
+template <>
+inline BitwiseAndDotProductResult bitwise_and_dot_product_with_popcount<
+        SIMDLevel::NONE>(
+        const uint8_t* query,
+        const uint8_t* data,
+        size_t size,
+        size_t qb) {
+    uint64_t dot_product = 0;
+    uint64_t popcount_sum = 0;
+    size_t offset = 0;
+    for (size_t step = 64 / 8; offset + step <= size; offset += step) {
+        const auto yv = *(const uint64_t*)(data + offset);
+        popcount_sum += popcount64(yv);
+        for (int j = 0; j < qb; j++) {
+            const auto qv = *(const uint64_t*)(query + j * size + offset);
+            dot_product += popcount64(qv & yv) << j;
+        }
+    }
+    for (; offset < size; ++offset) {
+        const auto yv = *(data + offset);
+        popcount_sum += popcount32(yv);
+        for (int j = 0; j < qb; j++) {
+            const auto qv = *(query + j * size + offset);
+            dot_product += popcount32(qv & yv) << j;
+        }
+    }
+    return {dot_product, popcount_sum};
+}
+
 template <>
 inline uint64_t bitwise_xor_dot_product<SIMDLevel::NONE>(
         const uint8_t* query,
@@ -125,6 +225,108 @@ inline uint64_t popcount<SIMDLevel::NONE>(const uint8_t* data, size_t size) {
     return sum;
 }
 
+template <>
+inline void rearrange_bit_planes<SIMDLevel::NONE>(
+        const uint8_t* rotated_qq,
+        size_t d,
+        size_t qb,
+        uint8_t* out) {
+    const size_t offset = (d + 7) / 8;
+    memset(out, 0, offset * qb);
+    for (size_t idim = 0; idim < d; idim++) {
+        for (size_t iv = 0; iv < qb; iv++) {
+            const bool bit = ((rotated_qq[idim] & (1 << iv)) != 0);
+            out[iv * offset + idim / 8] |= bit ? (1 << (idim % 8)) : 0;
+        }
+    }
+}
+
+inline uint8_t round_clamped_byte_scalar(float x, uint8_t max_code) {
+    if (x <= 0.0f) {
+        return 0;
+    }
+    if (x >= max_code) {
+        return max_code;
+    }
+    return static_cast<uint8_t>(static_cast<int>(x + 0.5f));
+}
+
+inline uint8_t round_nonnegative_byte_scalar(float x) {
+    return round_clamped_byte_scalar(x, 255);
+}
+
+template <>
+inline void lut_minmax_16<SIMDLevel::NONE>(
+        const float* tab,
+        float& mn,
+        float& mx) {
+    mn = tab[0];
+    mx = tab[0];
+    for (size_t s = 1; s < 16; s++) {
+        mn = std::min(mn, tab[s]);
+        mx = std::max(mx, tab[s]);
+    }
+}
+
+template <>
+inline void minmax_values<SIMDLevel::NONE>(
+        const float* values,
+        size_t n,
+        float& mn,
+        float& mx) {
+    if (n == 0) {
+        return;
+    }
+    mn = values[0];
+    mx = values[0];
+    for (size_t i = 1; i < n; i++) {
+        mn = std::min(mn, values[i]);
+        mx = std::max(mx, values[i]);
+    }
+}
+
+template <>
+inline void lut_quantize_16_to_uint8<SIMDLevel::NONE>(
+        const float* tab,
+        float mn,
+        float a,
+        uint8_t* out) {
+    for (size_t s = 0; s < 16; s++) {
+        out[s] = round_nonnegative_byte_scalar(a * (tab[s] - mn));
+    }
+}
+
+template <>
+inline void quantize_query_values<SIMDLevel::NONE>(
+        const float* rq,
+        size_t d,
+        float v_min,
+        float inv_delta,
+        uint8_t max_code,
+        bool centered,
+        uint8_t* rqq,
+        size_t& sum_qq,
+        int64_t& sum2_signed_odd_int) {
+    if (centered) {
+        for (size_t i = 0; i < d; i++) {
+            const uint8_t v_qq = round_clamped_byte_scalar(
+                    (rq[i] - v_min) * inv_delta, max_code);
+            rqq[i] = v_qq;
+            sum_qq += v_qq;
+
+            const int64_t signed_odd_int = int64_t(v_qq) * 2 - max_code;
+            sum2_signed_odd_int += signed_odd_int * signed_odd_int;
+        }
+    } else {
+        for (size_t i = 0; i < d; i++) {
+            const uint8_t v_qq = round_clamped_byte_scalar(
+                    (rq[i] - v_min) * inv_delta, max_code);
+            rqq[i] = v_qq;
+            sum_qq += v_qq;
+        }
+    }
+}
+
 } // namespace faiss::rabitq
 
 /*********************************************************

data/vendor/faiss/faiss/utils/simd_impl/distances_avx2.cpp

@@ -11,7 +11,6 @@
 
 #include <faiss/impl/AuxIndexStructures.h>
 #include <faiss/impl/ResultHandler.h>
-#include <faiss/utils/distances_fused/distances_fused.h>
 #include <faiss/utils/simd_impl/exhaustive_L2sqr_blas_cmax.h>
 
 #ifndef FINTEGER