usearch 2.15.1 → 2.15.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,804 @@
1
+ /**
2
+ * @file curved.h
3
+ * @brief SIMD-accelerated Similarity Measures for curved spaces.
4
+ * @author Ash Vardanian
5
+ * @date August 27, 2024
6
+ *
7
+ * Contains:
8
+ * - Bilinear form multiplication
9
+ * - Mahalanobis distance
10
+ *
11
+ * For datatypes:
12
+ * - 32-bit floating point numbers
13
+ * - 16-bit floating point numbers
14
+ * - 16-bit brain-floating point numbers
15
+ *
16
+ * For hardware architectures:
17
+ * - Arm (NEON, SVE)
18
+ * - x86 (AVX2, AVX512)
19
+ *
20
+ * x86 intrinsics: https://www.intel.com/content/www/us/en/docs/intrinsics-guide/
21
+ * Arm intrinsics: https://developer.arm.com/architectures/instruction-sets/intrinsics/
22
+ */
23
+ #ifndef SIMSIMD_CURVED_H
24
+ #define SIMSIMD_CURVED_H
25
+
26
+ #include "types.h"
27
+
28
+ #include "dot.h" // `_simsimd_partial_load_f16x4_neon` and friends
29
+ #include "spatial.h" // `_simsimd_substract_bf16x32_genoa`
30
+
31
+ #ifdef __cplusplus
32
+ extern "C" {
33
+ #endif
34
+
35
+ // clang-format off
36
+
37
+ /* Serial backends for all numeric types.
38
+ * By default they use 32-bit arithmetic, unless the arguments themselves contain 64-bit floats.
39
+ * For double-precision computation check out the "*_accurate" variants of those "*_serial" functions.
40
+ */
41
+ SIMSIMD_PUBLIC void simsimd_bilinear_f64_serial(simsimd_f64_t const* a, simsimd_f64_t const* b, simsimd_f64_t const* c, simsimd_size_t n, simsimd_distance_t* result);
42
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_f64_serial(simsimd_f64_t const* a, simsimd_f64_t const* b, simsimd_f64_t const* c, simsimd_size_t n, simsimd_distance_t* result);
43
+ SIMSIMD_PUBLIC void simsimd_bilinear_f32_serial(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_f32_t const* c, simsimd_size_t n, simsimd_distance_t* result);
44
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_f32_serial(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_f32_t const* c, simsimd_size_t n, simsimd_distance_t* result);
45
+ SIMSIMD_PUBLIC void simsimd_bilinear_f16_serial(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_f16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
46
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_f16_serial(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_f16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
47
+ SIMSIMD_PUBLIC void simsimd_bilinear_bf16_serial(simsimd_bf16_t const* a, simsimd_bf16_t const* b, simsimd_bf16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
48
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_bf16_serial(simsimd_bf16_t const* a, simsimd_bf16_t const* b, simsimd_bf16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
49
+
50
+ /* Double-precision serial backends for all numeric types.
51
+ * For single-precision computation check out the "*_serial" counterparts of those "*_accurate" functions.
52
+ */
53
+ SIMSIMD_PUBLIC void simsimd_bilinear_f32_accurate(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_f32_t const* c, simsimd_size_t n, simsimd_distance_t* result);
54
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_f32_accurate(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_f32_t const* c, simsimd_size_t n, simsimd_distance_t* result);
55
+ SIMSIMD_PUBLIC void simsimd_bilinear_f16_accurate(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_f16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
56
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_f16_accurate(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_f16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
57
+ SIMSIMD_PUBLIC void simsimd_bilinear_bf16_accurate(simsimd_bf16_t const* a, simsimd_bf16_t const* b, simsimd_bf16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
58
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_bf16_accurate(simsimd_bf16_t const* a, simsimd_bf16_t const* b, simsimd_bf16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
59
+
60
+ /* SIMD-powered backends for Arm NEON, mostly using 32-bit arithmetic over 128-bit words.
61
+ * By far the most portable backend, covering most Arm v8 devices, over a billion phones, and almost all
62
+ * server CPUs produced before 2023.
63
+ */
64
+ SIMSIMD_PUBLIC void simsimd_bilinear_f32_neon(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_f32_t const* c, simsimd_size_t n, simsimd_distance_t* result);
65
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_f32_neon(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_f32_t const* c, simsimd_size_t n, simsimd_distance_t* result);
66
+ SIMSIMD_PUBLIC void simsimd_bilinear_f16_neon(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_f16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
67
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_f16_neon(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_f16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
68
+ SIMSIMD_PUBLIC void simsimd_bilinear_bf16_neon(simsimd_bf16_t const* a, simsimd_bf16_t const* b, simsimd_bf16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
69
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_bf16_neon(simsimd_bf16_t const* a, simsimd_bf16_t const* b, simsimd_bf16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
70
+
71
+ /* SIMD-powered backends for AVX2 CPUs of Haswell generation and newer, using 32-bit arithmetic over 256-bit words.
72
+ * First demonstrated in 2011, at least one Haswell-based processor was still being sold in 2022 — the Pentium G3420.
73
+ * Practically all modern x86 CPUs support AVX2, FMA, and F16C, making it a perfect baseline for SIMD algorithms.
74
+ * On other hand, there is no need to implement AVX2 versions of `f32` and `f64` functions, as those are
75
+ * properly vectorized by recent compilers.
76
+ */
77
+ SIMSIMD_PUBLIC void simsimd_bilinear_f16_haswell(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_f16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
78
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_f16_haswell(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_f16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
79
+ SIMSIMD_PUBLIC void simsimd_bilinear_bf16_haswell(simsimd_bf16_t const* a, simsimd_bf16_t const* b, simsimd_bf16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
80
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_bf16_haswell(simsimd_bf16_t const* a, simsimd_bf16_t const* b, simsimd_bf16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
81
+
82
+ /* SIMD-powered backends for various generations of AVX512 CPUs.
83
+ * Skylake is handy, as it supports masked loads and other operations, avoiding the need for the tail loop.
84
+ * Ice Lake added VNNI, VPOPCNTDQ, IFMA, VBMI, VAES, GFNI, VBMI2, BITALG, VPCLMULQDQ, and other extensions for integral operations.
85
+ * Sapphire Rapids added tiled matrix operations, but we are most interested in the new mixed-precision FMA instructions.
86
+ */
87
+ SIMSIMD_PUBLIC void simsimd_bilinear_f32_skylake(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_f32_t const* c, simsimd_size_t n, simsimd_distance_t* result);
88
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_f32_skylake(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_f32_t const* c, simsimd_size_t n, simsimd_distance_t* result);
89
+ SIMSIMD_PUBLIC void simsimd_bilinear_bf16_genoa(simsimd_bf16_t const* a, simsimd_bf16_t const* b, simsimd_bf16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
90
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_bf16_genoa(simsimd_bf16_t const* a, simsimd_bf16_t const* b, simsimd_bf16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
91
+ SIMSIMD_PUBLIC void simsimd_bilinear_f16_sapphire(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_f16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
92
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_f16_sapphire(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_f16_t const* c, simsimd_size_t n, simsimd_distance_t* result);
93
+ // clang-format on
94
+
95
+ #define SIMSIMD_MAKE_BILINEAR(name, input_type, accumulator_type, load_and_convert) \
96
+ SIMSIMD_PUBLIC void simsimd_bilinear_##input_type##_##name( \
97
+ simsimd_##input_type##_t const* a, simsimd_##input_type##_t const* b, simsimd_##input_type##_t const* c, \
98
+ simsimd_size_t n, simsimd_distance_t* result) { \
99
+ simsimd_##accumulator_type##_t sum = 0; \
100
+ for (simsimd_size_t i = 0; i != n; ++i) { \
101
+ simsimd_##accumulator_type##_t partial = 0; \
102
+ simsimd_##accumulator_type##_t a_i = load_and_convert(a + i); \
103
+ for (simsimd_size_t j = 0; j != n; ++j) { \
104
+ simsimd_##accumulator_type##_t b_j = load_and_convert(b + j); \
105
+ simsimd_##accumulator_type##_t c_ij = load_and_convert(c + i * n + j); \
106
+ partial += c_ij * b_j; \
107
+ } \
108
+ sum += a_i * partial; \
109
+ } \
110
+ *result = (simsimd_distance_t)sum; \
111
+ }
112
+
113
+ #define SIMSIMD_MAKE_MAHALANOBIS(name, input_type, accumulator_type, load_and_convert) \
114
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_##input_type##_##name( \
115
+ simsimd_##input_type##_t const* a, simsimd_##input_type##_t const* b, simsimd_##input_type##_t const* c, \
116
+ simsimd_size_t n, simsimd_distance_t* result) { \
117
+ simsimd_##accumulator_type##_t sum = 0; \
118
+ for (simsimd_size_t i = 0; i != n; ++i) { \
119
+ simsimd_##accumulator_type##_t partial = 0; \
120
+ simsimd_##accumulator_type##_t diff_i = load_and_convert(a + i) - load_and_convert(b + i); \
121
+ for (simsimd_size_t j = 0; j != n; ++j) { \
122
+ simsimd_##accumulator_type##_t diff_j = load_and_convert(a + j) - load_and_convert(b + j); \
123
+ simsimd_##accumulator_type##_t c_ij = load_and_convert(c + i * n + j); \
124
+ partial += c_ij * diff_j; \
125
+ } \
126
+ sum += diff_i * partial; \
127
+ } \
128
+ *result = (simsimd_distance_t)SIMSIMD_SQRT(sum); \
129
+ }
130
+
131
+ SIMSIMD_MAKE_BILINEAR(serial, f64, f64, SIMSIMD_DEREFERENCE) // simsimd_bilinear_f64_serial
132
+ SIMSIMD_MAKE_MAHALANOBIS(serial, f64, f64, SIMSIMD_DEREFERENCE) // simsimd_mahalanobis_f64_serial
133
+
134
+ SIMSIMD_MAKE_BILINEAR(serial, f32, f32, SIMSIMD_DEREFERENCE) // simsimd_bilinear_f32_serial
135
+ SIMSIMD_MAKE_MAHALANOBIS(serial, f32, f32, SIMSIMD_DEREFERENCE) // simsimd_mahalanobis_f32_serial
136
+
137
+ SIMSIMD_MAKE_BILINEAR(serial, f16, f32, SIMSIMD_F16_TO_F32) // simsimd_bilinear_f16_serial
138
+ SIMSIMD_MAKE_MAHALANOBIS(serial, f16, f32, SIMSIMD_F16_TO_F32) // simsimd_mahalanobis_f16_serial
139
+
140
+ SIMSIMD_MAKE_BILINEAR(serial, bf16, f32, SIMSIMD_BF16_TO_F32) // simsimd_bilinear_bf16_serial
141
+ SIMSIMD_MAKE_MAHALANOBIS(serial, bf16, f32, SIMSIMD_BF16_TO_F32) // simsimd_mahalanobis_bf16_serial
142
+
143
+ SIMSIMD_MAKE_BILINEAR(accurate, f32, f64, SIMSIMD_DEREFERENCE) // simsimd_bilinear_f32_accurate
144
+ SIMSIMD_MAKE_MAHALANOBIS(accurate, f32, f64, SIMSIMD_DEREFERENCE) // simsimd_mahalanobis_f32_accurate
145
+
146
+ SIMSIMD_MAKE_BILINEAR(accurate, f16, f64, SIMSIMD_F16_TO_F32) // simsimd_bilinear_f16_accurate
147
+ SIMSIMD_MAKE_MAHALANOBIS(accurate, f16, f64, SIMSIMD_F16_TO_F32) // simsimd_mahalanobis_f16_accurate
148
+
149
+ SIMSIMD_MAKE_BILINEAR(accurate, bf16, f64, SIMSIMD_BF16_TO_F32) // simsimd_bilinear_bf16_accurate
150
+ SIMSIMD_MAKE_MAHALANOBIS(accurate, bf16, f64, SIMSIMD_BF16_TO_F32) // simsimd_mahalanobis_bf16_accurate
151
+
152
+ #if SIMSIMD_TARGET_ARM
153
+ #if SIMSIMD_TARGET_NEON
154
+ #pragma GCC push_options
155
+ #pragma GCC target("arch=armv8.2-a+simd")
156
+ #pragma clang attribute push(__attribute__((target("arch=armv8.2-a+simd"))), apply_to = function)
157
+
158
+ SIMSIMD_PUBLIC void simsimd_bilinear_f32_neon(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_f32_t const* c,
159
+ simsimd_size_t n, simsimd_distance_t* result) {
160
+ float32x4_t sum_vec = vdupq_n_f32(0);
161
+ for (simsimd_size_t i = 0; i != n; ++i) {
162
+ float32x4_t a_vec = vdupq_n_f32(a[i]);
163
+ float32x4_t partial_sum_vec = vdupq_n_f32(0);
164
+ for (simsimd_size_t j = 0; j + 4 <= n; j += 4) {
165
+ float32x4_t b_vec = vld1q_f32(b + j);
166
+ float32x4_t c_vec = vld1q_f32(c + i * n + j);
167
+ partial_sum_vec = vmlaq_f32(partial_sum_vec, b_vec, c_vec);
168
+ }
169
+ sum_vec = vmlaq_f32(sum_vec, a_vec, partial_sum_vec);
170
+ }
171
+
172
+ // Handle the tail of every row
173
+ simsimd_f64_t sum = vaddvq_f32(sum_vec);
174
+ simsimd_size_t tail_length = n % 4;
175
+ simsimd_size_t tail_start = n - tail_length;
176
+ if (tail_length) {
177
+ for (simsimd_size_t i = 0; i != n; ++i) {
178
+ simsimd_f32_t a_i = a[i];
179
+ simsimd_f32_t partial_sum = 0;
180
+ for (simsimd_size_t j = tail_start; j != n; ++j)
181
+ partial_sum += b[j] * c[i * n + j];
182
+ sum += a[i] * partial_sum;
183
+ }
184
+ }
185
+
186
+ *result = sum;
187
+ }
188
+
189
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_f32_neon(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_f32_t const* c,
190
+ simsimd_size_t n, simsimd_distance_t* result) {
191
+ float32x4_t sum_vec = vdupq_n_f32(0);
192
+ for (simsimd_size_t i = 0; i != n; ++i) {
193
+ float32x4_t diff_i_vec = vdupq_n_f32(a[i] - b[i]);
194
+ float32x4_t partial_sum_vec = vdupq_n_f32(0);
195
+ for (simsimd_size_t j = 0; j + 4 <= n; j += 4) {
196
+ float32x4_t diff_j_vec = vsubq_f32(vld1q_f32(a + j), vld1q_f32(b + j));
197
+ float32x4_t c_vec = vld1q_f32(c + i * n + j);
198
+ partial_sum_vec = vmlaq_f32(partial_sum_vec, diff_j_vec, c_vec);
199
+ }
200
+
201
+ sum_vec = vmlaq_f32(sum_vec, diff_i_vec, partial_sum_vec);
202
+ }
203
+
204
+ // Handle the tail of every row
205
+ simsimd_f64_t sum = vaddvq_f32(sum_vec);
206
+ simsimd_size_t tail_length = n % 4;
207
+ simsimd_size_t tail_start = n - tail_length;
208
+ if (tail_length) {
209
+ for (simsimd_size_t i = 0; i != n; ++i) {
210
+ simsimd_f32_t diff_i = a[i] - b[i];
211
+ simsimd_f32_t partial_sum = 0;
212
+ for (simsimd_size_t j = tail_start; j != n; ++j) {
213
+ simsimd_f32_t diff_j = a[j] - b[j];
214
+ partial_sum += diff_j * c[i * n + j];
215
+ }
216
+ sum += diff_i * partial_sum;
217
+ }
218
+ }
219
+
220
+ *result = _simsimd_sqrt_f64_neon(sum);
221
+ }
222
+
223
+ #pragma clang attribute pop
224
+ #pragma GCC pop_options
225
+ #endif // SIMSIMD_TARGET_NEON
226
+
227
+ #if SIMSIMD_TARGET_NEON_F16
228
+ #pragma GCC push_options
229
+ #pragma GCC target("arch=armv8.2-a+simd+fp16")
230
+ #pragma clang attribute push(__attribute__((target("arch=armv8.2-a+simd+fp16"))), apply_to = function)
231
+
232
+ SIMSIMD_PUBLIC void simsimd_bilinear_f16_neon(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_f16_t const* c,
233
+ simsimd_size_t n, simsimd_distance_t* result) {
234
+ float32x4_t sum_vec = vdupq_n_f32(0);
235
+ for (simsimd_size_t i = 0; i != n; ++i) {
236
+ // MSVC doesn't recognize `vdup_n_f16` as a valid intrinsic
237
+ float32x4_t a_vec = vcvt_f32_f16(vreinterpret_f16_s16(vdup_n_s16(*(short const*)(a + i))));
238
+ float32x4_t partial_sum_vec = vdupq_n_f32(0);
239
+ for (simsimd_size_t j = 0; j + 4 <= n; j += 4) {
240
+ float32x4_t b_vec = vcvt_f32_f16(vld1_f16((simsimd_f16_for_arm_simd_t const*)(b + j)));
241
+ float32x4_t c_vec = vcvt_f32_f16(vld1_f16((simsimd_f16_for_arm_simd_t const*)(c + i * n + j)));
242
+ partial_sum_vec = vmlaq_f32(partial_sum_vec, b_vec, c_vec);
243
+ }
244
+ sum_vec = vmlaq_f32(sum_vec, a_vec, partial_sum_vec);
245
+ }
246
+
247
+ // Handle the tail of every row
248
+ simsimd_f64_t sum = vaddvq_f32(sum_vec);
249
+ simsimd_size_t tail_length = n % 4;
250
+ simsimd_size_t tail_start = n - tail_length;
251
+ if (tail_length) {
252
+ for (simsimd_size_t i = 0; i != n; ++i) {
253
+ simsimd_f32_t a_i = vaddvq_f32(vcvt_f32_f16(_simsimd_partial_load_f16x4_neon(a + i, 1)));
254
+ float32x4_t b_vec = vcvt_f32_f16(_simsimd_partial_load_f16x4_neon(b + tail_start, tail_length));
255
+ float32x4_t c_vec = vcvt_f32_f16(_simsimd_partial_load_f16x4_neon(c + i * n + tail_start, tail_length));
256
+ simsimd_f32_t partial_sum = vaddvq_f32(vmulq_f32(b_vec, c_vec));
257
+ sum += a_i * partial_sum;
258
+ }
259
+ }
260
+
261
+ *result = sum;
262
+ }
263
+
264
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_f16_neon(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_f16_t const* c,
265
+ simsimd_size_t n, simsimd_distance_t* result) {
266
+ float32x4_t sum_vec = vdupq_n_f32(0);
267
+ for (simsimd_size_t i = 0; i != n; ++i) {
268
+ // MSVC doesn't recognize `vdup_n_f16` as a valid intrinsic
269
+ float32x4_t a_i_vec = vcvt_f32_f16(vreinterpret_f16_s16(vdup_n_s16(*(short const*)(a + i))));
270
+ float32x4_t b_i_vec = vcvt_f32_f16(vreinterpret_f16_s16(vdup_n_s16(*(short const*)(b + i))));
271
+ float32x4_t diff_i_vec = vsubq_f32(a_i_vec, b_i_vec);
272
+ float32x4_t partial_sum_vec = vdupq_n_f32(0);
273
+ for (simsimd_size_t j = 0; j + 4 <= n; j += 4) {
274
+ float32x4_t a_j_vec = vcvt_f32_f16(vld1_f16((simsimd_f16_for_arm_simd_t const*)(a + j)));
275
+ float32x4_t b_j_vec = vcvt_f32_f16(vld1_f16((simsimd_f16_for_arm_simd_t const*)(b + j)));
276
+ float32x4_t diff_j_vec = vsubq_f32(a_j_vec, b_j_vec);
277
+ float32x4_t c_vec = vcvt_f32_f16(vld1_f16((simsimd_f16_for_arm_simd_t const*)(c + i * n + j)));
278
+ partial_sum_vec = vmlaq_f32(partial_sum_vec, diff_j_vec, c_vec);
279
+ }
280
+ sum_vec = vmlaq_f32(sum_vec, diff_i_vec, partial_sum_vec);
281
+ }
282
+
283
+ // Handle the tail of every row
284
+ simsimd_f32_t sum = vaddvq_f32(sum_vec);
285
+ simsimd_size_t tail_length = n % 4;
286
+ simsimd_size_t tail_start = n - tail_length;
287
+ if (tail_length) {
288
+ for (simsimd_size_t i = 0; i != n; ++i) {
289
+ simsimd_f32_t a_i = vaddvq_f32(vcvt_f32_f16(_simsimd_partial_load_f16x4_neon(a + i, 1)));
290
+ simsimd_f32_t b_i = vaddvq_f32(vcvt_f32_f16(_simsimd_partial_load_f16x4_neon(b + i, 1)));
291
+ simsimd_f32_t diff_i = a_i - b_i;
292
+ float32x4_t a_j_vec = vcvt_f32_f16(_simsimd_partial_load_f16x4_neon(a + tail_start, tail_length));
293
+ float32x4_t b_j_vec = vcvt_f32_f16(_simsimd_partial_load_f16x4_neon(b + tail_start, tail_length));
294
+ float32x4_t diff_j_vec = vsubq_f32(a_j_vec, b_j_vec);
295
+ float32x4_t c_vec = vcvt_f32_f16(_simsimd_partial_load_f16x4_neon(c + i * n + tail_start, tail_length));
296
+ simsimd_f32_t partial_sum = vaddvq_f32(vmulq_f32(diff_j_vec, c_vec));
297
+ sum += diff_i * partial_sum;
298
+ }
299
+ }
300
+
301
+ *result = _simsimd_sqrt_f32_neon(sum);
302
+ }
303
+
304
+ #pragma clang attribute pop
305
+ #pragma GCC pop_options
306
+ #endif // SIMSIMD_TARGET_NEON_F16
307
+
308
+ #if SIMSIMD_TARGET_NEON_BF16
309
+ #pragma GCC push_options
310
+ #pragma GCC target("arch=armv8.6-a+simd+bf16")
311
+ #pragma clang attribute push(__attribute__((target("arch=armv8.6-a+simd+bf16"))), apply_to = function)
312
+
313
+ SIMSIMD_PUBLIC void simsimd_bilinear_bf16_neon(simsimd_bf16_t const* a, simsimd_bf16_t const* b,
314
+ simsimd_bf16_t const* c, simsimd_size_t n, simsimd_distance_t* result) {
315
+ float32x4_t sum_vec = vdupq_n_f32(0);
316
+ for (simsimd_size_t i = 0; i != n; ++i) {
317
+ float32x4_t a_vec = vdupq_n_f32(simsimd_bf16_to_f32(a + i));
318
+ float32x4_t partial_sum_vec = vdupq_n_f32(0);
319
+ for (simsimd_size_t j = 0; j + 8 <= n; j += 8) {
320
+ bfloat16x8_t b_vec = vld1q_bf16((simsimd_bf16_for_arm_simd_t const*)(b + j));
321
+ bfloat16x8_t c_vec = vld1q_bf16((simsimd_bf16_for_arm_simd_t const*)(c + i * n + j));
322
+ partial_sum_vec = vbfdotq_f32(partial_sum_vec, b_vec, c_vec);
323
+ }
324
+ sum_vec = vmlaq_f32(sum_vec, a_vec, partial_sum_vec);
325
+ }
326
+
327
+ // Handle the tail of every row
328
+ simsimd_f64_t sum = vaddvq_f32(sum_vec);
329
+ simsimd_size_t tail_length = n % 8;
330
+ simsimd_size_t tail_start = n - tail_length;
331
+ if (tail_length) {
332
+ for (simsimd_size_t i = 0; i != n; ++i) {
333
+ simsimd_f32_t a_i = simsimd_bf16_to_f32(a + i);
334
+ bfloat16x8_t b_vec = _simsimd_partial_load_bf16x8_neon(b + tail_start, tail_length);
335
+ bfloat16x8_t c_vec = _simsimd_partial_load_bf16x8_neon(c + i * n + tail_start, tail_length);
336
+ simsimd_f32_t partial_sum = vaddvq_f32(vbfdotq_f32(vdupq_n_f32(0), b_vec, c_vec));
337
+ sum += a_i * partial_sum;
338
+ }
339
+ }
340
+
341
+ *result = sum;
342
+ }
343
+
344
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_bf16_neon(simsimd_bf16_t const* a, simsimd_bf16_t const* b,
345
+ simsimd_bf16_t const* c, simsimd_size_t n,
346
+ simsimd_distance_t* result) {
347
+ float32x4_t sum_vec = vdupq_n_f32(0);
348
+ for (simsimd_size_t i = 0; i != n; ++i) {
349
+ simsimd_f32_t a_i = simsimd_bf16_to_f32(a + i);
350
+ simsimd_f32_t b_i = simsimd_bf16_to_f32(b + i);
351
+ float32x4_t diff_i_vec = vdupq_n_f32(a_i - b_i);
352
+ float32x4_t partial_sum_vec = vdupq_n_f32(0);
353
+ for (simsimd_size_t j = 0; j + 8 <= n; j += 8) {
354
+ bfloat16x8_t a_j_vec = vld1q_bf16((simsimd_bf16_for_arm_simd_t const*)(a + j));
355
+ bfloat16x8_t b_j_vec = vld1q_bf16((simsimd_bf16_for_arm_simd_t const*)(b + j));
356
+
357
+ // Arm NEON does not have a native subtraction instruction for `bf16`,
358
+ // so we need to convert to `f32` first, subtract, and only then get back to `bf16`
359
+ // for multiplication.
360
+ float32x4_t a_j_vec_high = vcvt_f32_bf16(vget_high_bf16(a_j_vec));
361
+ float32x4_t a_j_vec_low = vcvt_f32_bf16(vget_low_bf16(a_j_vec));
362
+ float32x4_t b_j_vec_high = vcvt_f32_bf16(vget_high_bf16(b_j_vec));
363
+ float32x4_t b_j_vec_low = vcvt_f32_bf16(vget_low_bf16(b_j_vec));
364
+ float32x4_t diff_j_vec_high = vsubq_f32(a_j_vec_high, b_j_vec_high);
365
+ float32x4_t diff_j_vec_low = vsubq_f32(a_j_vec_low, b_j_vec_low);
366
+ bfloat16x8_t diff_j_vec = vcombine_bf16(vcvt_bf16_f32(diff_j_vec_low), vcvt_bf16_f32(diff_j_vec_high));
367
+
368
+ bfloat16x8_t c_vec = vld1q_bf16((simsimd_bf16_for_arm_simd_t const*)(c + i * n + j));
369
+ partial_sum_vec = vbfdotq_f32(partial_sum_vec, diff_j_vec, c_vec);
370
+ }
371
+ sum_vec = vmlaq_f32(sum_vec, diff_i_vec, partial_sum_vec);
372
+ }
373
+
374
+ // Handle the tail of every row
375
+ simsimd_f32_t sum = vaddvq_f32(sum_vec);
376
+ simsimd_size_t tail_length = n % 8;
377
+ simsimd_size_t tail_start = n - tail_length;
378
+ if (tail_length) {
379
+ for (simsimd_size_t i = 0; i != n; ++i) {
380
+ simsimd_f32_t a_i = simsimd_bf16_to_f32(a + i);
381
+ simsimd_f32_t b_i = simsimd_bf16_to_f32(b + i);
382
+ simsimd_f32_t diff_i = a_i - b_i;
383
+ bfloat16x8_t a_j_vec = _simsimd_partial_load_bf16x8_neon(a + tail_start, tail_length);
384
+ bfloat16x8_t b_j_vec = _simsimd_partial_load_bf16x8_neon(b + tail_start, tail_length);
385
+
386
+ // Again, upcast for subtraction
387
+ float32x4_t a_j_vec_high = vcvt_f32_bf16(vget_high_bf16(a_j_vec));
388
+ float32x4_t a_j_vec_low = vcvt_f32_bf16(vget_low_bf16(a_j_vec));
389
+ float32x4_t b_j_vec_high = vcvt_f32_bf16(vget_high_bf16(b_j_vec));
390
+ float32x4_t b_j_vec_low = vcvt_f32_bf16(vget_low_bf16(b_j_vec));
391
+ float32x4_t diff_j_vec_high = vsubq_f32(a_j_vec_high, b_j_vec_high);
392
+ float32x4_t diff_j_vec_low = vsubq_f32(a_j_vec_low, b_j_vec_low);
393
+ bfloat16x8_t diff_j_vec = vcombine_bf16(vcvt_bf16_f32(diff_j_vec_low), vcvt_bf16_f32(diff_j_vec_high));
394
+
395
+ bfloat16x8_t c_vec = _simsimd_partial_load_bf16x8_neon(c + i * n + tail_start, tail_length);
396
+ simsimd_f32_t partial_sum = vaddvq_f32(vbfdotq_f32(vdupq_n_f32(0), diff_j_vec, c_vec));
397
+ sum += diff_i * partial_sum;
398
+ }
399
+ }
400
+
401
+ *result = _simsimd_sqrt_f32_neon(sum);
402
+ }
403
+
404
+ #pragma clang attribute pop
405
+ #pragma GCC pop_options
406
+ #endif // SIMSIMD_TARGET_NEON_BF16
407
+
408
+ #endif // SIMSIMD_TARGET_ARM
409
+
410
+ #if SIMSIMD_TARGET_X86
411
+ #if SIMSIMD_TARGET_HASWELL
412
+ #pragma GCC push_options
413
+ #pragma GCC target("avx2", "f16c", "fma")
414
+ #pragma clang attribute push(__attribute__((target("avx2,f16c,fma"))), apply_to = function)
415
+
416
+ SIMSIMD_PUBLIC void simsimd_bilinear_f16_haswell(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_f16_t const* c,
417
+ simsimd_size_t n, simsimd_distance_t* result) {
418
+ __m256 sum_vec = _mm256_setzero_ps();
419
+ for (simsimd_size_t i = 0; i != n; ++i) {
420
+ __m256 a_vec = _mm256_cvtph_ps(_mm_set1_epi16(*(short const*)(a + i)));
421
+ __m256 partial_sum_vec = _mm256_setzero_ps();
422
+ for (simsimd_size_t j = 0; j + 8 <= n; j += 8) {
423
+ __m256 b_vec = _mm256_cvtph_ps(_mm_loadu_si128((__m128i const*)(b + j)));
424
+ __m256 c_vec = _mm256_cvtph_ps(_mm_loadu_si128((__m128i const*)(c + i * n + j)));
425
+ partial_sum_vec = _mm256_fmadd_ps(b_vec, c_vec, partial_sum_vec);
426
+ }
427
+ sum_vec = _mm256_fmadd_ps(a_vec, partial_sum_vec, sum_vec);
428
+ }
429
+
430
+ // Handle the tail of every row
431
+ simsimd_f32_t sum = _simsimd_reduce_f32x8_haswell(sum_vec);
432
+ simsimd_size_t tail_length = n % 8;
433
+ simsimd_size_t tail_start = n - tail_length;
434
+ if (tail_length) {
435
+ for (simsimd_size_t i = 0; i != n; ++i) {
436
+ simsimd_f32_t a_i = _mm256_cvtss_f32(_mm256_cvtph_ps(_mm_set1_epi16(*(short const*)(a + i))));
437
+ __m256 b_vec = _simsimd_partial_load_f16x8_haswell(b + tail_start, tail_length);
438
+ __m256 c_vec = _simsimd_partial_load_f16x8_haswell(c + i * n + tail_start, tail_length);
439
+ simsimd_f32_t partial_sum = _simsimd_reduce_f32x8_haswell(_mm256_mul_ps(b_vec, c_vec));
440
+ sum += a_i * partial_sum;
441
+ }
442
+ }
443
+
444
+ *result = sum;
445
+ }
446
+
447
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_f16_haswell(simsimd_f16_t const* a, simsimd_f16_t const* b,
448
+ simsimd_f16_t const* c, simsimd_size_t n,
449
+ simsimd_distance_t* result) {
450
+ __m256 sum_vec = _mm256_setzero_ps();
451
+ for (simsimd_size_t i = 0; i != n; ++i) {
452
+ __m256 diff_i_vec = _mm256_sub_ps( //
453
+ _mm256_cvtph_ps(_mm_set1_epi16(*(short const*)(a + i))), //
454
+ _mm256_cvtph_ps(_mm_set1_epi16(*(short const*)(b + i))));
455
+ __m256 partial_sum_vec = _mm256_setzero_ps();
456
+ for (simsimd_size_t j = 0; j + 8 <= n; j += 8) {
457
+ __m256 diff_j_vec = _mm256_sub_ps( //
458
+ _mm256_cvtph_ps(_mm_loadu_si128((__m128i const*)(a + j))),
459
+ _mm256_cvtph_ps(_mm_loadu_si128((__m128i const*)(b + j))));
460
+ __m256 c_vec = _mm256_cvtph_ps(_mm_loadu_si128((__m128i const*)(c + i * n + j)));
461
+ partial_sum_vec = _mm256_fmadd_ps(diff_j_vec, c_vec, partial_sum_vec);
462
+ }
463
+ sum_vec = _mm256_fmadd_ps(diff_i_vec, partial_sum_vec, sum_vec);
464
+ }
465
+
466
+ // Handle the tail of every row
467
+ simsimd_f32_t sum = _simsimd_reduce_f32x8_haswell(sum_vec);
468
+ simsimd_size_t tail_length = n % 8;
469
+ simsimd_size_t tail_start = n - tail_length;
470
+ if (tail_length) {
471
+ for (simsimd_size_t i = 0; i != n; ++i) {
472
+ simsimd_f32_t diff_i = _mm256_cvtss_f32(_mm256_sub_ps( //
473
+ _mm256_cvtph_ps(_mm_set1_epi16(*(short const*)(a + i))), //
474
+ _mm256_cvtph_ps(_mm_set1_epi16(*(short const*)(b + i)))));
475
+ __m256 diff_j_vec = _mm256_sub_ps( //
476
+ _simsimd_partial_load_f16x8_haswell(a + tail_start, tail_length),
477
+ _simsimd_partial_load_f16x8_haswell(b + tail_start, tail_length));
478
+ __m256 c_vec = _simsimd_partial_load_f16x8_haswell(c + i * n + tail_start, tail_length);
479
+ simsimd_f32_t partial_sum = _simsimd_reduce_f32x8_haswell(_mm256_mul_ps(diff_j_vec, c_vec));
480
+ sum += diff_i * partial_sum;
481
+ }
482
+ }
483
+
484
+ *result = _simsimd_sqrt_f32_haswell(sum);
485
+ }
486
+
487
+ SIMSIMD_PUBLIC void simsimd_bilinear_bf16_haswell(simsimd_bf16_t const* a, simsimd_bf16_t const* b,
488
+ simsimd_bf16_t const* c, simsimd_size_t n,
489
+ simsimd_distance_t* result) {
490
+ __m256 sum_vec = _mm256_setzero_ps();
491
+ for (simsimd_size_t i = 0; i != n; ++i) {
492
+ // The `simsimd_bf16_to_f32` is cheaper than `_simsimd_bf16x8_to_f32x8_haswell`
493
+ __m256 a_vec = _mm256_set1_ps(simsimd_bf16_to_f32(a + i));
494
+ __m256 partial_sum_vec = _mm256_setzero_ps();
495
+ for (simsimd_size_t j = 0; j + 8 <= n; j += 8) {
496
+ __m256 b_vec = _simsimd_bf16x8_to_f32x8_haswell(_mm_loadu_si128((__m128i const*)(b + j)));
497
+ __m256 c_vec = _simsimd_bf16x8_to_f32x8_haswell(_mm_loadu_si128((__m128i const*)(c + i * n + j)));
498
+ partial_sum_vec = _mm256_fmadd_ps(b_vec, c_vec, partial_sum_vec);
499
+ }
500
+ sum_vec = _mm256_fmadd_ps(a_vec, partial_sum_vec, sum_vec);
501
+ }
502
+
503
+ // Handle the tail of every row
504
+ simsimd_f32_t sum = _simsimd_reduce_f32x8_haswell(sum_vec);
505
+ simsimd_size_t tail_length = n % 8;
506
+ simsimd_size_t tail_start = n - tail_length;
507
+ if (tail_length) {
508
+ for (simsimd_size_t i = 0; i != n; ++i) {
509
+ simsimd_f32_t a_i = simsimd_bf16_to_f32(a + i);
510
+ __m256 b_vec = _simsimd_bf16x8_to_f32x8_haswell( //
511
+ _simsimd_partial_load_bf16x8_haswell(b + tail_start, tail_length));
512
+ __m256 c_vec = _simsimd_bf16x8_to_f32x8_haswell( //
513
+ _simsimd_partial_load_bf16x8_haswell(c + i * n + tail_start, tail_length));
514
+ simsimd_f32_t partial_sum = _simsimd_reduce_f32x8_haswell(_mm256_mul_ps(b_vec, c_vec));
515
+ sum += a_i * partial_sum;
516
+ }
517
+ }
518
+
519
+ *result = sum;
520
+ }
521
+
522
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_bf16_haswell(simsimd_bf16_t const* a, simsimd_bf16_t const* b,
523
+ simsimd_bf16_t const* c, simsimd_size_t n,
524
+ simsimd_distance_t* result) {
525
+ __m256 sum_vec = _mm256_setzero_ps();
526
+ for (simsimd_size_t i = 0; i != n; ++i) {
527
+ __m256 diff_i_vec = _mm256_sub_ps( //
528
+ _mm256_set1_ps(simsimd_bf16_to_f32(a + i)), //
529
+ _mm256_set1_ps(simsimd_bf16_to_f32(b + i)));
530
+ __m256 partial_sum_vec = _mm256_setzero_ps();
531
+ for (simsimd_size_t j = 0; j + 8 <= n; j += 8) {
532
+ __m256 diff_j_vec = _mm256_sub_ps( //
533
+ _simsimd_bf16x8_to_f32x8_haswell(_mm_loadu_si128((__m128i const*)(a + j))), //
534
+ _simsimd_bf16x8_to_f32x8_haswell(_mm_loadu_si128((__m128i const*)(b + j))));
535
+ __m256 c_vec = _simsimd_bf16x8_to_f32x8_haswell(_mm_loadu_si128((__m128i const*)(c + i * n + j)));
536
+ partial_sum_vec = _mm256_fmadd_ps(diff_j_vec, c_vec, partial_sum_vec);
537
+ }
538
+ sum_vec = _mm256_fmadd_ps(diff_i_vec, partial_sum_vec, sum_vec);
539
+ }
540
+
541
+ // Handle the tail of every row
542
+ simsimd_f32_t sum = _simsimd_reduce_f32x8_haswell(sum_vec);
543
+ simsimd_size_t tail_length = n % 8;
544
+ simsimd_size_t tail_start = n - tail_length;
545
+ if (tail_length) {
546
+ for (simsimd_size_t i = 0; i != n; ++i) {
547
+ simsimd_f32_t diff_i = simsimd_bf16_to_f32(a + i) - simsimd_bf16_to_f32(b + i);
548
+ __m256 diff_j_vec = _mm256_sub_ps( //
549
+ _simsimd_bf16x8_to_f32x8_haswell(_simsimd_partial_load_bf16x8_haswell(a + tail_start, tail_length)),
550
+ _simsimd_bf16x8_to_f32x8_haswell(_simsimd_partial_load_bf16x8_haswell(b + tail_start, tail_length)));
551
+ __m256 c_vec = _simsimd_bf16x8_to_f32x8_haswell(
552
+ _simsimd_partial_load_bf16x8_haswell(c + i * n + tail_start, tail_length));
553
+ simsimd_f32_t partial_sum = _simsimd_reduce_f32x8_haswell(_mm256_mul_ps(diff_j_vec, c_vec));
554
+ sum += diff_i * partial_sum;
555
+ }
556
+ }
557
+
558
+ *result = _simsimd_sqrt_f32_haswell(sum);
559
+ }
560
+
561
+ #pragma clang attribute pop
562
+ #pragma GCC pop_options
563
+ #endif // SIMSIMD_TARGET_HASWELL
564
+
565
+ #if SIMSIMD_TARGET_SKYLAKE
566
+ #pragma GCC push_options
567
+ #pragma GCC target("avx2", "avx512f", "avx512vl", "bmi2")
568
+ #pragma clang attribute push(__attribute__((target("avx2,avx512f,avx512vl,bmi2"))), apply_to = function)
569
+
570
+ SIMSIMD_PUBLIC void simsimd_bilinear_f32_skylake(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_f32_t const* c,
571
+ simsimd_size_t n, simsimd_distance_t* result) {
572
+ simsimd_size_t tail_length = n % 16;
573
+ simsimd_size_t tail_start = n - tail_length;
574
+ __m512 sum_vec = _mm512_setzero_ps();
575
+ __mmask16 tail_mask = (__mmask16)_bzhi_u32(0xFFFF, tail_length);
576
+
577
+ for (simsimd_size_t i = 0; i != n; ++i) {
578
+ __m512 a_vec = _mm512_set1_ps(a[i]);
579
+ __m512 partial_sum_vec = _mm512_setzero_ps();
580
+ __m512 b_vec, c_vec;
581
+ simsimd_size_t j = 0;
582
+
583
+ simsimd_bilinear_f32_skylake_cycle:
584
+ if (j + 16 <= n) {
585
+ b_vec = _mm512_loadu_ps(b + j);
586
+ c_vec = _mm512_loadu_ps(c + i * n + j);
587
+ } else {
588
+ b_vec = _mm512_maskz_loadu_ps(tail_mask, b + tail_start);
589
+ c_vec = _mm512_maskz_loadu_ps(tail_mask, c + i * n + tail_start);
590
+ }
591
+ partial_sum_vec = _mm512_fmadd_ps(b_vec, c_vec, partial_sum_vec);
592
+ j += 16;
593
+ if (j < n)
594
+ goto simsimd_bilinear_f32_skylake_cycle;
595
+ sum_vec = _mm512_fmadd_ps(a_vec, partial_sum_vec, sum_vec);
596
+ }
597
+
598
+ *result = _mm512_reduce_add_ps(sum_vec);
599
+ }
600
+
601
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_f32_skylake(simsimd_f32_t const* a, simsimd_f32_t const* b,
602
+ simsimd_f32_t const* c, simsimd_size_t n,
603
+ simsimd_distance_t* result) {
604
+ simsimd_size_t tail_length = n % 16;
605
+ simsimd_size_t tail_start = n - tail_length;
606
+ __m512 sum_vec = _mm512_setzero_ps();
607
+ __mmask16 tail_mask = (__mmask16)_bzhi_u32(0xFFFF, tail_length);
608
+
609
+ for (simsimd_size_t i = 0; i != n; ++i) {
610
+ __m512 diff_i_vec = _mm512_set1_ps(a[i] - b[i]);
611
+ __m512 partial_sum_vec = _mm512_setzero_ps(), partial_sum_bot_vec = _mm512_setzero_ps();
612
+ __m512 a_j_vec, b_j_vec, diff_j_vec, c_vec;
613
+ simsimd_size_t j = 0;
614
+
615
+ // The nested loop is cleaner to implement with a `goto` in this case:
616
+ simsimd_bilinear_f32_skylake_cycle:
617
+ if (j + 16 <= n) {
618
+ a_j_vec = _mm512_loadu_ps(a + j);
619
+ b_j_vec = _mm512_loadu_ps(b + j);
620
+ c_vec = _mm512_loadu_ps(c + i * n + j);
621
+ } else {
622
+ a_j_vec = _mm512_maskz_loadu_ps(tail_mask, a + tail_start);
623
+ b_j_vec = _mm512_maskz_loadu_ps(tail_mask, b + tail_start);
624
+ c_vec = _mm512_maskz_loadu_ps(tail_mask, c + i * n + tail_start);
625
+ }
626
+ diff_j_vec = _mm512_sub_ps(a_j_vec, b_j_vec);
627
+ partial_sum_vec = _mm512_fmadd_ps(diff_j_vec, c_vec, partial_sum_vec);
628
+ j += 16;
629
+ if (j < n)
630
+ goto simsimd_bilinear_f32_skylake_cycle;
631
+ sum_vec = _mm512_fmadd_ps(diff_i_vec, partial_sum_vec, sum_vec);
632
+ }
633
+
634
+ *result = _simsimd_sqrt_f64_haswell(_mm512_reduce_add_ps(sum_vec));
635
+ }
636
+
637
+ #pragma clang attribute pop
638
+ #pragma GCC pop_options
639
+ #endif // SIMSIMD_TARGET_SKYLAKE
640
+
641
+ #if SIMSIMD_TARGET_GENOA
642
+ #pragma GCC push_options
643
+ #pragma GCC target("avx2", "avx512f", "avx512vl", "bmi2", "avx512bw", "avx512bf16")
644
+ #pragma clang attribute push(__attribute__((target("avx2,avx512f,avx512vl,bmi2,avx512bw,avx512bf16"))), \
645
+ apply_to = function)
646
+
647
+ SIMSIMD_PUBLIC void simsimd_bilinear_bf16_genoa(simsimd_bf16_t const* a, simsimd_bf16_t const* b,
648
+ simsimd_bf16_t const* c, simsimd_size_t n, simsimd_distance_t* result) {
649
+ simsimd_size_t tail_length = n % 32;
650
+ simsimd_size_t tail_start = n - tail_length;
651
+ __m512 sum_vec = _mm512_setzero_ps();
652
+ __mmask32 tail_mask = (__mmask32)_bzhi_u32(0xFFFFFFFF, tail_length);
653
+
654
+ for (simsimd_size_t i = 0; i != n; ++i) {
655
+ __m512 a_vec = _mm512_set1_ps(simsimd_bf16_to_f32(a + i));
656
+ __m512 partial_sum_vec = _mm512_setzero_ps();
657
+ __m512i b_vec, c_vec;
658
+ simsimd_size_t j = 0;
659
+
660
+ simsimd_bilinear_bf16_genoa_cycle:
661
+ if (j + 32 <= n) {
662
+ b_vec = _mm512_loadu_epi16(b + j);
663
+ c_vec = _mm512_loadu_epi16(c + i * n + j);
664
+ } else {
665
+ b_vec = _mm512_maskz_loadu_epi16(tail_mask, b + tail_start);
666
+ c_vec = _mm512_maskz_loadu_epi16(tail_mask, c + i * n + tail_start);
667
+ }
668
+ partial_sum_vec = _mm512_dpbf16_ps(partial_sum_vec, (__m512bh)(b_vec), (__m512bh)(c_vec));
669
+ j += 32;
670
+ if (j < n)
671
+ goto simsimd_bilinear_bf16_genoa_cycle;
672
+ sum_vec = _mm512_fmadd_ps(a_vec, partial_sum_vec, sum_vec);
673
+ }
674
+
675
+ *result = _mm512_reduce_add_ps(sum_vec);
676
+ }
677
+
678
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_bf16_genoa(simsimd_bf16_t const* a, simsimd_bf16_t const* b,
679
+ simsimd_bf16_t const* c, simsimd_size_t n,
680
+ simsimd_distance_t* result) {
681
+ simsimd_size_t tail_length = n % 32;
682
+ simsimd_size_t tail_start = n - tail_length;
683
+ __m512 sum_vec = _mm512_setzero_ps();
684
+ __mmask32 tail_mask = (__mmask32)_bzhi_u32(0xFFFFFFFF, tail_length);
685
+
686
+ for (simsimd_size_t i = 0; i != n; ++i) {
687
+ __m512 diff_i_vec = _mm512_set1_ps(simsimd_bf16_to_f32(a + i) - simsimd_bf16_to_f32(b + i));
688
+ __m512 partial_sum_vec = _mm512_setzero_ps();
689
+ __m512i a_j_vec, b_j_vec, diff_j_vec, c_vec;
690
+ simsimd_size_t j = 0;
691
+
692
+ // The nested loop is cleaner to implement with a `goto` in this case:
693
+ simsimd_mahalanobis_bf16_genoa_cycle:
694
+ if (j + 32 <= n) {
695
+ a_j_vec = _mm512_loadu_epi16(a + j);
696
+ b_j_vec = _mm512_loadu_epi16(b + j);
697
+ c_vec = _mm512_loadu_epi16(c + i * n + j);
698
+ } else {
699
+ a_j_vec = _mm512_maskz_loadu_epi16(tail_mask, a + tail_start);
700
+ b_j_vec = _mm512_maskz_loadu_epi16(tail_mask, b + tail_start);
701
+ c_vec = _mm512_maskz_loadu_epi16(tail_mask, c + i * n + tail_start);
702
+ }
703
+ diff_j_vec = _simsimd_substract_bf16x32_genoa(a_j_vec, b_j_vec);
704
+ partial_sum_vec = _mm512_dpbf16_ps(partial_sum_vec, (__m512bh)(diff_j_vec), (__m512bh)(c_vec));
705
+ j += 32;
706
+ if (j < n)
707
+ goto simsimd_mahalanobis_bf16_genoa_cycle;
708
+ sum_vec = _mm512_fmadd_ps(diff_i_vec, partial_sum_vec, sum_vec);
709
+ }
710
+
711
+ *result = _simsimd_sqrt_f32_haswell(_mm512_reduce_add_ps(sum_vec));
712
+ }
713
+
714
+ #pragma clang attribute pop
715
+ #pragma GCC pop_options
716
+ #endif // SIMSIMD_TARGET_GENOA
717
+
718
+ #if SIMSIMD_TARGET_SAPPHIRE
719
+ #pragma GCC push_options
720
+ #pragma GCC target("avx2", "avx512f", "avx512vl", "bmi2", "avx512bw", "avx512fp16")
721
+ #pragma clang attribute push(__attribute__((target("avx2,avx512f,avx512vl,bmi2,avx512bw,avx512fp16"))), \
722
+ apply_to = function)
723
+
724
+ SIMSIMD_PUBLIC void simsimd_bilinear_f16_sapphire(simsimd_f16_t const* a, simsimd_f16_t const* b,
725
+ simsimd_f16_t const* c, simsimd_size_t n,
726
+ simsimd_distance_t* result) {
727
+ simsimd_size_t tail_length = n % 32;
728
+ simsimd_size_t tail_start = n - tail_length;
729
+ __m512h sum_vec = _mm512_setzero_ph();
730
+ __mmask32 tail_mask = (__mmask32)_bzhi_u32(0xFFFFFFFF, tail_length);
731
+
732
+ for (simsimd_size_t i = 0; i != n; ++i) {
733
+ __m512h a_vec = _mm512_castsi512_ph(_mm512_set1_epi16(*(short const*)(a + i)));
734
+ __m512h partial_sum_vec = _mm512_setzero_ph();
735
+ __m512i b_vec, c_vec;
736
+ simsimd_size_t j = 0;
737
+
738
+ simsimd_bilinear_f16_sapphire_cycle:
739
+ if (j + 32 <= n) {
740
+ b_vec = _mm512_loadu_epi16(b + j);
741
+ c_vec = _mm512_loadu_epi16(c + i * n + j);
742
+ } else {
743
+ b_vec = _mm512_maskz_loadu_epi16(tail_mask, b + tail_start);
744
+ c_vec = _mm512_maskz_loadu_epi16(tail_mask, c + i * n + tail_start);
745
+ }
746
+ partial_sum_vec = _mm512_fmadd_ph(_mm512_castsi512_ph(b_vec), _mm512_castsi512_ph(c_vec), partial_sum_vec);
747
+ j += 32;
748
+ if (j < n)
749
+ goto simsimd_bilinear_f16_sapphire_cycle;
750
+ sum_vec = _mm512_fmadd_ph(a_vec, partial_sum_vec, sum_vec);
751
+ }
752
+
753
+ *result = _mm512_reduce_add_ph(sum_vec);
754
+ }
755
+
756
+ SIMSIMD_PUBLIC void simsimd_mahalanobis_f16_sapphire(simsimd_f16_t const* a, simsimd_f16_t const* b,
757
+ simsimd_f16_t const* c, simsimd_size_t n,
758
+ simsimd_distance_t* result) {
759
+ simsimd_size_t tail_length = n % 32;
760
+ simsimd_size_t tail_start = n - tail_length;
761
+ __m512h sum_vec = _mm512_setzero_ph();
762
+ __mmask32 tail_mask = (__mmask32)_bzhi_u32(0xFFFFFFFF, tail_length);
763
+
764
+ for (simsimd_size_t i = 0; i != n; ++i) {
765
+ __m512h a_i_vec = _mm512_castsi512_ph(_mm512_set1_epi16(*(short const*)(a + i)));
766
+ __m512h b_i_vec = _mm512_castsi512_ph(_mm512_set1_epi16(*(short const*)(b + i)));
767
+ __m512h diff_i_vec = _mm512_sub_ph(a_i_vec, b_i_vec);
768
+ __m512h partial_sum_vec = _mm512_setzero_ph();
769
+ __m512h diff_j_vec;
770
+ __m512i a_j_vec, b_j_vec, c_vec;
771
+ simsimd_size_t j = 0;
772
+
773
+ // The nested loop is cleaner to implement with a `goto` in this case:
774
+ simsimd_mahalanobis_f16_sapphire_cycle:
775
+ if (j + 32 <= n) {
776
+ a_j_vec = _mm512_loadu_epi16(a + j);
777
+ b_j_vec = _mm512_loadu_epi16(b + j);
778
+ c_vec = _mm512_loadu_epi16(c + i * n + j);
779
+ } else {
780
+ a_j_vec = _mm512_maskz_loadu_epi16(tail_mask, a + tail_start);
781
+ b_j_vec = _mm512_maskz_loadu_epi16(tail_mask, b + tail_start);
782
+ c_vec = _mm512_maskz_loadu_epi16(tail_mask, c + i * n + tail_start);
783
+ }
784
+ diff_j_vec = _mm512_sub_ph(_mm512_castsi512_ph(a_j_vec), _mm512_castsi512_ph(b_j_vec));
785
+ partial_sum_vec = _mm512_fmadd_ph(diff_j_vec, _mm512_castsi512_ph(c_vec), partial_sum_vec);
786
+ j += 32;
787
+ if (j < n)
788
+ goto simsimd_mahalanobis_f16_sapphire_cycle;
789
+ sum_vec = _mm512_fmadd_ph(diff_i_vec, partial_sum_vec, sum_vec);
790
+ }
791
+
792
+ *result = _simsimd_sqrt_f32_haswell(_mm512_reduce_add_ph(sum_vec));
793
+ }
794
+
795
+ #pragma clang attribute pop
796
+ #pragma GCC pop_options
797
+ #endif // SIMSIMD_TARGET_SAPPHIRE
798
+ #endif // SIMSIMD_TARGET_X86
799
+
800
+ #ifdef __cplusplus
801
+ }
802
+ #endif
803
+
804
+ #endif