usearch 2.10.3 → 2.11.0

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.
Files changed (114) hide show
  1. package/README.md +28 -8
  2. package/binding.gyp +101 -0
  3. package/c/CMakeLists.txt +27 -0
  4. package/c/README.md +244 -0
  5. package/c/lib.cpp +459 -0
  6. package/c/test.c +386 -0
  7. package/c/usearch.h +451 -0
  8. package/cmake/clipp.cmake +7 -0
  9. package/cmake/config.cmake.in +15 -0
  10. package/cmake/emscripten.cmake +8 -0
  11. package/cmake/jemalloc.cmake +62 -0
  12. package/cmake/pkg-config.pc.in +4 -0
  13. package/cmake/usearchConfigVersion.cmake.in +20 -0
  14. package/cpp/CMakeLists.txt +14 -0
  15. package/cpp/README.md +161 -0
  16. package/cpp/bench.cpp +616 -0
  17. package/cpp/test.cpp +335 -0
  18. package/fp16/CMakeLists.txt +176 -0
  19. package/fp16/LICENSE +11 -0
  20. package/fp16/README.md +20 -0
  21. package/fp16/bench/alt-element.cc +89 -0
  22. package/fp16/bench/from-alt-array.cc +175 -0
  23. package/fp16/bench/from-ieee-array.cc +399 -0
  24. package/fp16/bench/ieee-element.cc +272 -0
  25. package/fp16/bench/to-alt-array.cc +91 -0
  26. package/fp16/bench/to-ieee-array.cc +303 -0
  27. package/fp16/cmake/DownloadGoogleBenchmark.cmake +15 -0
  28. package/fp16/cmake/DownloadGoogleTest.cmake +15 -0
  29. package/fp16/cmake/DownloadPSimd.cmake +15 -0
  30. package/fp16/configure.py +65 -0
  31. package/fp16/confu.yaml +8 -0
  32. package/fp16/include/fp16/__init__.py +0 -0
  33. package/fp16/include/fp16/avx.py +50 -0
  34. package/fp16/include/fp16/avx2.py +53 -0
  35. package/fp16/include/fp16/bitcasts.h +92 -0
  36. package/fp16/include/fp16/fp16.h +451 -0
  37. package/fp16/include/fp16/psimd.h +131 -0
  38. package/fp16/include/fp16.h +11 -0
  39. package/fp16/jni/Android.mk +6 -0
  40. package/fp16/jni/Application.mk +4 -0
  41. package/fp16/test/alt-from-fp32-value.cc +498 -0
  42. package/fp16/test/alt-to-fp32-bits.cc +263 -0
  43. package/fp16/test/alt-to-fp32-psimd.cc +145 -0
  44. package/fp16/test/alt-to-fp32-value.cc +348 -0
  45. package/fp16/test/alt-to-fp32x2-psimd.cc +245 -0
  46. package/fp16/test/bitcasts.cc +56 -0
  47. package/fp16/test/ieee-from-fp32-value.cc +523 -0
  48. package/fp16/test/ieee-to-fp32-bits.cc +333 -0
  49. package/fp16/test/ieee-to-fp32-psimd.cc +312 -0
  50. package/fp16/test/ieee-to-fp32-value.cc +420 -0
  51. package/fp16/test/ieee-to-fp32x2-psimd.cc +541 -0
  52. package/fp16/test/peachpy/alt-xmm-to-fp32-xmm-avx.cc +96 -0
  53. package/fp16/test/peachpy/alt-xmm-to-fp32-ymm-avx2.cc +96 -0
  54. package/fp16/test/peachpy/stubs.py +38 -0
  55. package/fp16/test/tables.cc +530 -0
  56. package/fp16/test/tables.h +13 -0
  57. package/fp16/third-party/THHalf.h +92 -0
  58. package/fp16/third-party/eigen-half.h +170 -0
  59. package/fp16/third-party/float16-compressor.h +80 -0
  60. package/fp16/third-party/half.hpp +2916 -0
  61. package/fp16/third-party/npy-halffloat.h +328 -0
  62. package/include/usearch/index.hpp +3838 -0
  63. package/include/usearch/index_dense.hpp +2022 -0
  64. package/include/usearch/index_plugins.hpp +2317 -0
  65. package/javascript/dist/cjs/usearch.js +5 -5
  66. package/javascript/dist/esm/usearch.js +2 -2
  67. package/javascript/dist-package-cjs.json +3 -0
  68. package/javascript/dist-package-esm.json +3 -0
  69. package/javascript/lib.cpp +350 -0
  70. package/javascript/node-gyp-build.d.ts +1 -0
  71. package/javascript/tsconfig-base.json +25 -0
  72. package/javascript/tsconfig-cjs.json +8 -0
  73. package/javascript/tsconfig-esm.json +8 -0
  74. package/javascript/usearch.test.js +84 -0
  75. package/javascript/usearch.ts +640 -0
  76. package/package.json +14 -7
  77. package/prebuilds/darwin-arm64+x64/usearch.node +0 -0
  78. package/prebuilds/linux-arm64/usearch.node +0 -0
  79. package/prebuilds/linux-x64/usearch.node +0 -0
  80. package/prebuilds/win32-ia32/usearch.node +0 -0
  81. package/prebuilds/win32-x64/usearch.node +0 -0
  82. package/simsimd/.releaserc +87 -0
  83. package/simsimd/CONTRIBUTING.md +114 -0
  84. package/simsimd/Cargo.lock +709 -0
  85. package/simsimd/Cargo.toml +44 -0
  86. package/simsimd/LICENSE +201 -0
  87. package/simsimd/README.md +708 -0
  88. package/simsimd/binding.gyp +36 -0
  89. package/simsimd/build.rs +51 -0
  90. package/simsimd/c/lib.c +110 -0
  91. package/simsimd/include/simsimd/binary.h +258 -0
  92. package/simsimd/include/simsimd/dot.h +1237 -0
  93. package/simsimd/include/simsimd/geospatial.h +37 -0
  94. package/simsimd/include/simsimd/probability.h +563 -0
  95. package/simsimd/include/simsimd/simsimd.h +1129 -0
  96. package/simsimd/include/simsimd/spatial.h +1019 -0
  97. package/simsimd/include/simsimd/types.h +309 -0
  98. package/simsimd/javascript/bench.js +127 -0
  99. package/simsimd/javascript/dist-package-cjs.json +3 -0
  100. package/simsimd/javascript/dist-package-esm.json +3 -0
  101. package/simsimd/javascript/fallback.ts +203 -0
  102. package/simsimd/javascript/lib.c +107 -0
  103. package/simsimd/javascript/node-gyp-build.d.ts +1 -0
  104. package/simsimd/javascript/simsimd.ts +135 -0
  105. package/simsimd/javascript/test.mjs +179 -0
  106. package/simsimd/javascript/tsconfig-base.json +37 -0
  107. package/simsimd/javascript/tsconfig-cjs.json +8 -0
  108. package/simsimd/javascript/tsconfig-esm.json +8 -0
  109. package/simsimd/package-lock.json +1709 -0
  110. package/simsimd/package.json +61 -0
  111. package/simsimd/rust/benches/cosine.rs +27 -0
  112. package/simsimd/rust/benches/native.rs +30 -0
  113. package/simsimd/rust/benches/sqeuclidean.rs +27 -0
  114. package/simsimd/rust/lib.rs +778 -0
@@ -0,0 +1,1019 @@
1
+ /**
2
+ * @file spatial.h
3
+ * @brief SIMD-accelerated Spatial Similarity Measures.
4
+ * @author Ash Vardanian
5
+ * @date March 14, 2023
6
+ *
7
+ * Contains:
8
+ * - L2 (Euclidean) squared distance
9
+ * - Cosine (Angular) similarity
10
+ *
11
+ * For datatypes:
12
+ * - 64-bit IEEE floating point numbers
13
+ * - 32-bit IEEE floating point numbers
14
+ * - 16-bit IEEE floating point numbers
15
+ * - 8-bit signed integral numbers
16
+ *
17
+ * For hardware architectures:
18
+ * - Arm (NEON, SVE)
19
+ * - x86 (AVX2, AVX512)
20
+ *
21
+ * x86 intrinsics: https://www.intel.com/content/www/us/en/docs/intrinsics-guide/
22
+ * Arm intrinsics: https://developer.arm.com/architectures/instruction-sets/intrinsics/
23
+ */
24
+ #ifndef SIMSIMD_SPATIAL_H
25
+ #define SIMSIMD_SPATIAL_H
26
+
27
+ #include "types.h"
28
+
29
+ #ifdef __cplusplus
30
+ extern "C" {
31
+ #endif
32
+
33
+ // clang-format off
34
+
35
+ /* Serial backends for all numeric types.
36
+ * By default they use 32-bit arithmetic, unless the arguments themselves contain 64-bit floats.
37
+ * For double-precision computation check out the "*_accurate" variants of those "*_serial" functions.
38
+ */
39
+ SIMSIMD_PUBLIC void simsimd_l2sq_f64_serial(simsimd_f64_t const* a, simsimd_f64_t const*, simsimd_size_t n, simsimd_distance_t* d);
40
+ SIMSIMD_PUBLIC void simsimd_cos_f64_serial(simsimd_f64_t const* a, simsimd_f64_t const*, simsimd_size_t n, simsimd_distance_t* d);
41
+ SIMSIMD_PUBLIC void simsimd_l2sq_f32_serial(simsimd_f32_t const* a, simsimd_f32_t const*, simsimd_size_t n, simsimd_distance_t* d);
42
+ SIMSIMD_PUBLIC void simsimd_cos_f32_serial(simsimd_f32_t const* a, simsimd_f32_t const*, simsimd_size_t n, simsimd_distance_t* d);
43
+ SIMSIMD_PUBLIC void simsimd_l2sq_f16_serial(simsimd_f16_t const* a, simsimd_f16_t const*, simsimd_size_t n, simsimd_distance_t* d);
44
+ SIMSIMD_PUBLIC void simsimd_cos_f16_serial(simsimd_f16_t const* a, simsimd_f16_t const*, simsimd_size_t n, simsimd_distance_t* d);
45
+ SIMSIMD_PUBLIC void simsimd_l2sq_i8_serial(simsimd_i8_t const* a, simsimd_i8_t const*, simsimd_size_t n, simsimd_distance_t* d);
46
+ SIMSIMD_PUBLIC void simsimd_cos_i8_serial(simsimd_i8_t const* a, simsimd_i8_t const*, simsimd_size_t n, simsimd_distance_t* d);
47
+
48
+ /* Double-precision serial backends for all numeric types.
49
+ * For single-precision computation check out the "*_serial" counterparts of those "*_accurate" functions.
50
+ */
51
+ SIMSIMD_PUBLIC void simsimd_l2sq_f32_accurate(simsimd_f32_t const* a, simsimd_f32_t const*, simsimd_size_t n, simsimd_distance_t* d);
52
+ SIMSIMD_PUBLIC void simsimd_cos_f32_accurate(simsimd_f32_t const* a, simsimd_f32_t const*, simsimd_size_t n, simsimd_distance_t* d);
53
+ SIMSIMD_PUBLIC void simsimd_l2sq_f16_accurate(simsimd_f16_t const* a, simsimd_f16_t const*, simsimd_size_t n, simsimd_distance_t* d);
54
+ SIMSIMD_PUBLIC void simsimd_cos_f16_accurate(simsimd_f16_t const* a, simsimd_f16_t const*, simsimd_size_t n, simsimd_distance_t* d);
55
+ SIMSIMD_PUBLIC void simsimd_l2sq_i8_accurate(simsimd_i8_t const* a, simsimd_i8_t const*, simsimd_size_t n, simsimd_distance_t* d);
56
+ SIMSIMD_PUBLIC void simsimd_cos_i8_accurate(simsimd_i8_t const* a, simsimd_i8_t const*, simsimd_size_t n, simsimd_distance_t* d);
57
+
58
+ /* SIMD-powered backends for Arm NEON, mostly using 32-bit arithmetic over 128-bit words.
59
+ * By far the most portable backend, covering most Arm v8 devices, over a billion phones, and almost all
60
+ * server CPUs produced before 2023.
61
+ */
62
+ SIMSIMD_PUBLIC void simsimd_l2sq_f32_neon(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_size_t n, simsimd_distance_t* d);
63
+ SIMSIMD_PUBLIC void simsimd_cos_f32_neon(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_size_t n, simsimd_distance_t* d);
64
+ SIMSIMD_PUBLIC void simsimd_l2sq_f16_neon(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_size_t n, simsimd_distance_t* d);
65
+ SIMSIMD_PUBLIC void simsimd_cos_f16_neon(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_size_t n, simsimd_distance_t* d);
66
+ SIMSIMD_PUBLIC void simsimd_l2sq_i8_neon(simsimd_i8_t const* a, simsimd_i8_t const* b, simsimd_size_t n, simsimd_distance_t* d);
67
+ SIMSIMD_PUBLIC void simsimd_cos_i8_neon(simsimd_i8_t const* a, simsimd_i8_t const* b, simsimd_size_t n, simsimd_distance_t* d);
68
+
69
+ /* SIMD-powered backends for Arm SVE, mostly using 32-bit arithmetic over variable-length platform-defined word sizes.
70
+ * Designed for Arm Graviton 3, Microsoft Cobalt, as well as Nvidia Grace and newer Ampere Altra CPUs.
71
+ */
72
+ SIMSIMD_PUBLIC void simsimd_l2sq_f32_sve(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_size_t n, simsimd_distance_t*);
73
+ SIMSIMD_PUBLIC void simsimd_cos_f32_sve(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_size_t n, simsimd_distance_t*);
74
+ SIMSIMD_PUBLIC void simsimd_l2sq_f16_sve(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_size_t n, simsimd_distance_t*);
75
+ SIMSIMD_PUBLIC void simsimd_cos_f16_sve(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_size_t n, simsimd_distance_t*);
76
+ SIMSIMD_PUBLIC void simsimd_l2sq_f64_sve(simsimd_f64_t const* a, simsimd_f64_t const* b, simsimd_size_t n, simsimd_distance_t*);
77
+ SIMSIMD_PUBLIC void simsimd_cos_f64_sve(simsimd_f64_t const* a, simsimd_f64_t const* b, simsimd_size_t n, simsimd_distance_t*);
78
+
79
+ /* SIMD-powered backends for AVX2 CPUs of Haswell generation and newer, using 32-bit arithmetic over 256-bit words.
80
+ * First demonstrated in 2011, at least one Haswell-based processor was still being sold in 2022 — the Pentium G3420.
81
+ * Practically all modern x86 CPUs support AVX2, FMA, and F16C, making it a perfect baseline for SIMD algorithms.
82
+ * On other hand, there is no need to implement AVX2 versions of `f32` and `f64` functions, as those are
83
+ * properly vectorized by recent compilers.
84
+ */
85
+ SIMSIMD_PUBLIC void simsimd_l2sq_i8_haswell(simsimd_i8_t const* a, simsimd_i8_t const* b, simsimd_size_t n, simsimd_distance_t*);
86
+ SIMSIMD_PUBLIC void simsimd_cos_i8_haswell(simsimd_i8_t const* a, simsimd_i8_t const* b, simsimd_size_t n, simsimd_distance_t*);
87
+ SIMSIMD_PUBLIC void simsimd_l2sq_f16_haswell(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_size_t n, simsimd_distance_t*);
88
+ SIMSIMD_PUBLIC void simsimd_cos_f16_haswell(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_size_t n, simsimd_distance_t*);
89
+
90
+ /* SIMD-powered backends for AVX512 CPUs of Skylake generation and newer, using 32-bit arithmetic over 512-bit words.
91
+ * Skylake was launched in 2015, and discontinued in 2019. Skylake had support for F, CD, VL, DQ, and BW extensions,
92
+ * as well as masked operations. This is enough to supersede auto-vectorization on `f32` and `f64` types.
93
+ */
94
+ SIMSIMD_PUBLIC void simsimd_l2sq_f32_skylake(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_size_t n, simsimd_distance_t*);
95
+ SIMSIMD_PUBLIC void simsimd_cos_f32_skylake(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_size_t n, simsimd_distance_t*);
96
+ SIMSIMD_PUBLIC void simsimd_l2sq_f64_skylake(simsimd_f64_t const* a, simsimd_f64_t const* b, simsimd_size_t n, simsimd_distance_t*);
97
+ SIMSIMD_PUBLIC void simsimd_cos_f64_skylake(simsimd_f64_t const* a, simsimd_f64_t const* b, simsimd_size_t n, simsimd_distance_t*);
98
+
99
+ /* SIMD-powered backends for AVX512 CPUs of Ice Lake generation and newer, using mixed arithmetic over 512-bit words.
100
+ * Ice Lake added VNNI, VPOPCNTDQ, IFMA, VBMI, VAES, GFNI, VBMI2, BITALG, VPCLMULQDQ, and other extensions for integral operations.
101
+ * Sapphire Rapids added tiled matrix operations, but we are most interested in the new mixed-precision FMA instructions.
102
+ */
103
+ SIMSIMD_PUBLIC void simsimd_l2sq_i8_ice(simsimd_i8_t const* a, simsimd_i8_t const* b, simsimd_size_t n, simsimd_distance_t*);
104
+ SIMSIMD_PUBLIC void simsimd_cos_i8_ice(simsimd_i8_t const* a, simsimd_i8_t const* b, simsimd_size_t n, simsimd_distance_t*);
105
+ SIMSIMD_PUBLIC void simsimd_l2sq_f16_sapphire(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_size_t n, simsimd_distance_t*);
106
+ SIMSIMD_PUBLIC void simsimd_cos_f16_sapphire(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_size_t n, simsimd_distance_t*);
107
+
108
+ // clang-format on
109
+
110
+ #define SIMSIMD_MAKE_L2SQ(name, input_type, accumulator_type, converter) \
111
+ SIMSIMD_PUBLIC void simsimd_l2sq_##input_type##_##name(simsimd_##input_type##_t const* a, \
112
+ simsimd_##input_type##_t const* b, simsimd_size_t n, \
113
+ simsimd_distance_t* result) { \
114
+ simsimd_##accumulator_type##_t d2 = 0; \
115
+ for (simsimd_size_t i = 0; i != n; ++i) { \
116
+ simsimd_##accumulator_type##_t ai = converter(a[i]); \
117
+ simsimd_##accumulator_type##_t bi = converter(b[i]); \
118
+ d2 += (ai - bi) * (ai - bi); \
119
+ } \
120
+ *result = d2; \
121
+ }
122
+
123
+ #define SIMSIMD_MAKE_COS(name, input_type, accumulator_type, converter) \
124
+ SIMSIMD_PUBLIC void simsimd_cos_##input_type##_##name(simsimd_##input_type##_t const* a, \
125
+ simsimd_##input_type##_t const* b, simsimd_size_t n, \
126
+ simsimd_distance_t* result) { \
127
+ simsimd_##accumulator_type##_t ab = 0, a2 = 0, b2 = 0; \
128
+ for (simsimd_size_t i = 0; i != n; ++i) { \
129
+ simsimd_##accumulator_type##_t ai = converter(a[i]); \
130
+ simsimd_##accumulator_type##_t bi = converter(b[i]); \
131
+ ab += ai * bi; \
132
+ a2 += ai * ai; \
133
+ b2 += bi * bi; \
134
+ } \
135
+ *result = ab != 0 ? (1 - ab * SIMSIMD_RSQRT(a2) * SIMSIMD_RSQRT(b2)) : 1; \
136
+ }
137
+
138
+ SIMSIMD_MAKE_L2SQ(serial, f64, f64, SIMSIMD_IDENTIFY) // simsimd_l2sq_f64_serial
139
+ SIMSIMD_MAKE_COS(serial, f64, f64, SIMSIMD_IDENTIFY) // simsimd_cos_f64_serial
140
+
141
+ SIMSIMD_MAKE_L2SQ(serial, f32, f32, SIMSIMD_IDENTIFY) // simsimd_l2sq_f32_serial
142
+ SIMSIMD_MAKE_COS(serial, f32, f32, SIMSIMD_IDENTIFY) // simsimd_cos_f32_serial
143
+
144
+ SIMSIMD_MAKE_L2SQ(serial, f16, f32, SIMSIMD_UNCOMPRESS_F16) // simsimd_l2sq_f16_serial
145
+ SIMSIMD_MAKE_COS(serial, f16, f32, SIMSIMD_UNCOMPRESS_F16) // simsimd_cos_f16_serial
146
+
147
+ SIMSIMD_MAKE_L2SQ(serial, i8, i32, SIMSIMD_IDENTIFY) // simsimd_l2sq_i8_serial
148
+ SIMSIMD_MAKE_COS(serial, i8, i32, SIMSIMD_IDENTIFY) // simsimd_cos_i8_serial
149
+
150
+ SIMSIMD_MAKE_L2SQ(accurate, f32, f64, SIMSIMD_IDENTIFY) // simsimd_l2sq_f32_accurate
151
+ SIMSIMD_MAKE_COS(accurate, f32, f64, SIMSIMD_IDENTIFY) // simsimd_cos_f32_accurate
152
+
153
+ SIMSIMD_MAKE_L2SQ(accurate, f16, f64, SIMSIMD_UNCOMPRESS_F16) // simsimd_l2sq_f16_accurate
154
+ SIMSIMD_MAKE_COS(accurate, f16, f64, SIMSIMD_UNCOMPRESS_F16) // simsimd_cos_f16_accurate
155
+
156
+ SIMSIMD_MAKE_L2SQ(accurate, i8, i32, SIMSIMD_IDENTIFY) // simsimd_l2sq_i8_accurate
157
+ SIMSIMD_MAKE_COS(accurate, i8, i32, SIMSIMD_IDENTIFY) // simsimd_cos_i8_accurate
158
+
159
+ #if SIMSIMD_TARGET_ARM
160
+ #if SIMSIMD_TARGET_NEON
161
+ #pragma GCC push_options
162
+ #pragma GCC target("+simd")
163
+ #pragma clang attribute push(__attribute__((target("+simd"))), apply_to = function)
164
+
165
+ SIMSIMD_PUBLIC void simsimd_l2sq_f32_neon(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_size_t n,
166
+ simsimd_distance_t* result) {
167
+ float32x4_t sum_vec = vdupq_n_f32(0);
168
+ simsimd_size_t i = 0;
169
+ for (; i + 4 <= n; i += 4) {
170
+ float32x4_t a_vec = vld1q_f32(a + i);
171
+ float32x4_t b_vec = vld1q_f32(b + i);
172
+ float32x4_t diff_vec = vsubq_f32(a_vec, b_vec);
173
+ sum_vec = vfmaq_f32(sum_vec, diff_vec, diff_vec);
174
+ }
175
+ simsimd_f32_t sum = vaddvq_f32(sum_vec);
176
+ for (; i < n; ++i) {
177
+ simsimd_f32_t diff = a[i] - b[i];
178
+ sum += diff * diff;
179
+ }
180
+ *result = sum;
181
+ }
182
+
183
+ SIMSIMD_PUBLIC void simsimd_cos_f32_neon(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_size_t n,
184
+ simsimd_distance_t* result) {
185
+ float32x4_t ab_vec = vdupq_n_f32(0), a2_vec = vdupq_n_f32(0), b2_vec = vdupq_n_f32(0);
186
+ simsimd_size_t i = 0;
187
+ for (; i + 4 <= n; i += 4) {
188
+ float32x4_t a_vec = vld1q_f32(a + i);
189
+ float32x4_t b_vec = vld1q_f32(b + i);
190
+ ab_vec = vfmaq_f32(ab_vec, a_vec, b_vec);
191
+ a2_vec = vfmaq_f32(a2_vec, a_vec, a_vec);
192
+ b2_vec = vfmaq_f32(b2_vec, b_vec, b_vec);
193
+ }
194
+ simsimd_f32_t ab = vaddvq_f32(ab_vec), a2 = vaddvq_f32(a2_vec), b2 = vaddvq_f32(b2_vec);
195
+ for (; i < n; ++i) {
196
+ simsimd_f32_t ai = a[i], bi = b[i];
197
+ ab += ai * bi, a2 += ai * ai, b2 += bi * bi;
198
+ }
199
+
200
+ // Avoid `simsimd_approximate_inverse_square_root` on Arm NEON
201
+ simsimd_f32_t a2_b2_arr[2] = {a2, b2};
202
+ vst1_f32(a2_b2_arr, vrsqrte_f32(vld1_f32(a2_b2_arr)));
203
+ *result = ab != 0 ? 1 - ab * a2_b2_arr[0] * a2_b2_arr[1] : 1;
204
+ }
205
+
206
+ #pragma clang attribute pop
207
+ #pragma GCC pop_options
208
+
209
+ #pragma GCC push_options
210
+ #pragma GCC target("+simd+fp16")
211
+ #pragma clang attribute push(__attribute__((target("+simd+fp16"))), apply_to = function)
212
+
213
+ SIMSIMD_PUBLIC void simsimd_l2sq_f16_neon(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_size_t n,
214
+ simsimd_distance_t* result) {
215
+ float32x4_t sum_vec = vdupq_n_f32(0);
216
+ simsimd_size_t i = 0;
217
+ for (; i + 4 <= n; i += 4) {
218
+ float32x4_t a_vec = vcvt_f32_f16(vld1_f16((simsimd_f16_for_arm_simd_t const*)a + i));
219
+ float32x4_t b_vec = vcvt_f32_f16(vld1_f16((simsimd_f16_for_arm_simd_t const*)b + i));
220
+ float32x4_t diff_vec = vsubq_f32(a_vec, b_vec);
221
+ sum_vec = vfmaq_f32(sum_vec, diff_vec, diff_vec);
222
+ }
223
+
224
+ // In case the software emulation for `f16` scalars is enabled, the `simsimd_uncompress_f16`
225
+ // function will run. It is extremely slow, so even for the tail, let's combine serial
226
+ // loads and stores with vectorized math.
227
+ if (i < n) {
228
+ union {
229
+ float16x4_t f16_vec;
230
+ simsimd_f16_t f16[4];
231
+ } a_padded_tail, b_padded_tail;
232
+ simsimd_size_t j = 0;
233
+ for (; i < n; ++i, ++j)
234
+ a_padded_tail.f16[j] = a[i], b_padded_tail.f16[j] = b[i];
235
+ for (; j < 4; ++j)
236
+ a_padded_tail.f16[j] = 0, b_padded_tail.f16[j] = 0;
237
+ float32x4_t diff_vec = vsubq_f32(vcvt_f32_f16(a_padded_tail.f16_vec), vcvt_f32_f16(b_padded_tail.f16_vec));
238
+ sum_vec = vfmaq_f32(sum_vec, diff_vec, diff_vec);
239
+ }
240
+
241
+ simsimd_f32_t sum = vaddvq_f32(sum_vec);
242
+ *result = sum;
243
+ }
244
+
245
+ SIMSIMD_PUBLIC void simsimd_cos_f16_neon(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_size_t n,
246
+ simsimd_distance_t* result) {
247
+ float32x4_t ab_vec = vdupq_n_f32(0), a2_vec = vdupq_n_f32(0), b2_vec = vdupq_n_f32(0);
248
+ simsimd_size_t i = 0;
249
+ for (; i + 4 <= n; i += 4) {
250
+ float32x4_t a_vec = vcvt_f32_f16(vld1_f16((simsimd_f16_for_arm_simd_t const*)a + i));
251
+ float32x4_t b_vec = vcvt_f32_f16(vld1_f16((simsimd_f16_for_arm_simd_t const*)b + i));
252
+ ab_vec = vfmaq_f32(ab_vec, a_vec, b_vec);
253
+ a2_vec = vfmaq_f32(a2_vec, a_vec, a_vec);
254
+ b2_vec = vfmaq_f32(b2_vec, b_vec, b_vec);
255
+ }
256
+
257
+ // In case the software emulation for `f16` scalars is enabled, the `simsimd_uncompress_f16`
258
+ // function will run. It is extremely slow, so even for the tail, let's combine serial
259
+ // loads and stores with vectorized math.
260
+ if (i < n) {
261
+ union {
262
+ float16x4_t f16_vec;
263
+ simsimd_f16_t f16[4];
264
+ } a_padded_tail, b_padded_tail;
265
+ simsimd_size_t j = 0;
266
+ for (; i < n; ++i, ++j)
267
+ a_padded_tail.f16[j] = a[i], b_padded_tail.f16[j] = b[i];
268
+ for (; j < 4; ++j)
269
+ a_padded_tail.f16[j] = 0, b_padded_tail.f16[j] = 0;
270
+ float32x4_t a_vec = vcvt_f32_f16(a_padded_tail.f16_vec);
271
+ float32x4_t b_vec = vcvt_f32_f16(b_padded_tail.f16_vec);
272
+ ab_vec = vfmaq_f32(ab_vec, a_vec, b_vec);
273
+ a2_vec = vfmaq_f32(a2_vec, a_vec, a_vec);
274
+ b2_vec = vfmaq_f32(b2_vec, b_vec, b_vec);
275
+ }
276
+
277
+ // Avoid `simsimd_approximate_inverse_square_root` on Arm NEON
278
+ simsimd_f32_t ab = vaddvq_f32(ab_vec), a2 = vaddvq_f32(a2_vec), b2 = vaddvq_f32(b2_vec);
279
+ simsimd_f32_t a2_b2_arr[2] = {a2, b2};
280
+ float32x2_t a2_b2 = vld1_f32(a2_b2_arr);
281
+ a2_b2 = vrsqrte_f32(a2_b2);
282
+ vst1_f32(a2_b2_arr, a2_b2);
283
+ *result = ab != 0 ? 1 - ab * a2_b2_arr[0] * a2_b2_arr[1] : 1;
284
+ }
285
+
286
+ #pragma clang attribute pop
287
+ #pragma GCC pop_options
288
+
289
+ #pragma GCC push_options
290
+ #pragma GCC target("arch=armv8.2-a+dotprod")
291
+ #pragma clang attribute push(__attribute__((target("arch=armv8.2-a+dotprod"))), apply_to = function)
292
+
293
+ SIMSIMD_PUBLIC void simsimd_l2sq_i8_neon(simsimd_i8_t const* a, simsimd_i8_t const* b, simsimd_size_t n,
294
+ simsimd_distance_t* result) {
295
+ int32x4_t d2_vec = vdupq_n_s32(0);
296
+ simsimd_size_t i = 0;
297
+ for (; i + 7 < n; i += 8) {
298
+ int8x8_t a_vec = vld1_s8(a + i);
299
+ int8x8_t b_vec = vld1_s8(b + i);
300
+ int16x8_t a_vec16 = vmovl_s8(a_vec);
301
+ int16x8_t b_vec16 = vmovl_s8(b_vec);
302
+ int16x8_t d_vec = vsubq_s16(a_vec16, b_vec16);
303
+ int32x4_t d_low = vmull_s16(vget_low_s16(d_vec), vget_low_s16(d_vec));
304
+ int32x4_t d_high = vmull_s16(vget_high_s16(d_vec), vget_high_s16(d_vec));
305
+ d2_vec = vaddq_s32(d2_vec, vaddq_s32(d_low, d_high));
306
+ }
307
+ int32_t d2 = vaddvq_s32(d2_vec);
308
+ for (; i < n; ++i) {
309
+ int32_t n = a[i] - b[i];
310
+ d2 += n * n;
311
+ }
312
+ *result = d2;
313
+ }
314
+
315
+ SIMSIMD_PUBLIC void simsimd_cos_i8_neon(simsimd_i8_t const* a, simsimd_i8_t const* b, simsimd_size_t n,
316
+ simsimd_distance_t* result) {
317
+
318
+ int32x4_t ab_vec = vdupq_n_s32(0);
319
+ int32x4_t a2_vec = vdupq_n_s32(0);
320
+ int32x4_t b2_vec = vdupq_n_s32(0);
321
+ simsimd_size_t i = 0;
322
+
323
+ // If the 128-bit `vdot_s32` intrinsic is unavailable, we can use the 64-bit `vdot_s32`.
324
+ // for (simsimd_size_t i = 0; i != n; i += 8) {
325
+ // int16x8_t a_vec = vmovl_s8(vld1_s8(a + i));
326
+ // int16x8_t b_vec = vmovl_s8(vld1_s8(b + i));
327
+ // int16x8_t ab_part_vec = vmulq_s16(a_vec, b_vec);
328
+ // int16x8_t a2_part_vec = vmulq_s16(a_vec, a_vec);
329
+ // int16x8_t b2_part_vec = vmulq_s16(b_vec, b_vec);
330
+ // ab_vec = vaddq_s32(ab_vec, vaddq_s32(vmovl_s16(vget_high_s16(ab_part_vec)), //
331
+ // vmovl_s16(vget_low_s16(ab_part_vec))));
332
+ // a2_vec = vaddq_s32(a2_vec, vaddq_s32(vmovl_s16(vget_high_s16(a2_part_vec)), //
333
+ // vmovl_s16(vget_low_s16(a2_part_vec))));
334
+ // b2_vec = vaddq_s32(b2_vec, vaddq_s32(vmovl_s16(vget_high_s16(b2_part_vec)), //
335
+ // vmovl_s16(vget_low_s16(b2_part_vec))));
336
+ // }
337
+ for (; i + 15 < n; i += 16) {
338
+ int8x16_t a_vec = vld1q_s8(a + i);
339
+ int8x16_t b_vec = vld1q_s8(b + i);
340
+ ab_vec = vdotq_s32(ab_vec, a_vec, b_vec);
341
+ a2_vec = vdotq_s32(a2_vec, a_vec, a_vec);
342
+ b2_vec = vdotq_s32(b2_vec, b_vec, b_vec);
343
+ }
344
+
345
+ int32_t ab = vaddvq_s32(ab_vec);
346
+ int32_t a2 = vaddvq_s32(a2_vec);
347
+ int32_t b2 = vaddvq_s32(b2_vec);
348
+
349
+ // Take care of the tail:
350
+ for (; i < n; ++i) {
351
+ int32_t ai = a[i], bi = b[i];
352
+ ab += ai * bi, a2 += ai * ai, b2 += bi * bi;
353
+ }
354
+
355
+ // Avoid `simsimd_approximate_inverse_square_root` on Arm NEON
356
+ simsimd_f32_t a2_b2_arr[2] = {(simsimd_f32_t)a2, (simsimd_f32_t)b2};
357
+ float32x2_t a2_b2 = vld1_f32(a2_b2_arr);
358
+ a2_b2 = vrsqrte_f32(a2_b2);
359
+ vst1_f32(a2_b2_arr, a2_b2);
360
+ *result = ab != 0 ? 1 - ab * a2_b2_arr[0] * a2_b2_arr[1] : 1;
361
+ }
362
+
363
+ #pragma clang attribute pop
364
+ #pragma GCC pop_options
365
+ #endif // SIMSIMD_TARGET_NEON
366
+
367
+ #if SIMSIMD_TARGET_SVE
368
+ #pragma GCC push_options
369
+ #pragma GCC target("+sve")
370
+ #pragma clang attribute push(__attribute__((target("+sve"))), apply_to = function)
371
+
372
+ SIMSIMD_PUBLIC void simsimd_l2sq_f32_sve(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_size_t n,
373
+ simsimd_distance_t* result) {
374
+ simsimd_size_t i = 0;
375
+ svfloat32_t d2_vec = svdupq_n_f32(0.f, 0.f, 0.f, 0.f);
376
+ do {
377
+ svbool_t pg_vec = svwhilelt_b32((unsigned int)i, (unsigned int)n);
378
+ svfloat32_t a_vec = svld1_f32(pg_vec, a + i);
379
+ svfloat32_t b_vec = svld1_f32(pg_vec, b + i);
380
+ svfloat32_t a_minus_b_vec = svsub_f32_x(pg_vec, a_vec, b_vec);
381
+ d2_vec = svmla_f32_x(pg_vec, d2_vec, a_minus_b_vec, a_minus_b_vec);
382
+ i += svcntw();
383
+ } while (i < n);
384
+ simsimd_f32_t d2 = svaddv_f32(svptrue_b32(), d2_vec);
385
+ *result = d2;
386
+ }
387
+
388
+ SIMSIMD_PUBLIC void simsimd_cos_f32_sve(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_size_t n,
389
+ simsimd_distance_t* result) {
390
+ simsimd_size_t i = 0;
391
+ svfloat32_t ab_vec = svdupq_n_f32(0.f, 0.f, 0.f, 0.f);
392
+ svfloat32_t a2_vec = svdupq_n_f32(0.f, 0.f, 0.f, 0.f);
393
+ svfloat32_t b2_vec = svdupq_n_f32(0.f, 0.f, 0.f, 0.f);
394
+ do {
395
+ svbool_t pg_vec = svwhilelt_b32((unsigned int)i, (unsigned int)n);
396
+ svfloat32_t a_vec = svld1_f32(pg_vec, a + i);
397
+ svfloat32_t b_vec = svld1_f32(pg_vec, b + i);
398
+ ab_vec = svmla_f32_x(pg_vec, ab_vec, a_vec, b_vec);
399
+ a2_vec = svmla_f32_x(pg_vec, a2_vec, a_vec, a_vec);
400
+ b2_vec = svmla_f32_x(pg_vec, b2_vec, b_vec, b_vec);
401
+ i += svcntw();
402
+ } while (i < n);
403
+
404
+ simsimd_f32_t ab = svaddv_f32(svptrue_b32(), ab_vec);
405
+ simsimd_f32_t a2 = svaddv_f32(svptrue_b32(), a2_vec);
406
+ simsimd_f32_t b2 = svaddv_f32(svptrue_b32(), b2_vec);
407
+
408
+ // Avoid `simsimd_approximate_inverse_square_root` on Arm NEON
409
+ simsimd_f32_t a2_b2_arr[2] = {a2, b2};
410
+ float32x2_t a2_b2 = vld1_f32(a2_b2_arr);
411
+ a2_b2 = vrsqrte_f32(a2_b2);
412
+ vst1_f32(a2_b2_arr, a2_b2);
413
+ *result = ab != 0 ? 1 - ab * a2_b2_arr[0] * a2_b2_arr[1] : 1;
414
+ }
415
+
416
+ SIMSIMD_PUBLIC void simsimd_l2sq_f64_sve(simsimd_f64_t const* a, simsimd_f64_t const* b, simsimd_size_t n,
417
+ simsimd_distance_t* result) {
418
+ simsimd_size_t i = 0;
419
+ svfloat64_t d2_vec = svdupq_n_f64(0.0, 0.0);
420
+ do {
421
+ svbool_t pg_vec = svwhilelt_b64((unsigned int)i, (unsigned int)n);
422
+ svfloat64_t a_vec = svld1_f64(pg_vec, a + i);
423
+ svfloat64_t b_vec = svld1_f64(pg_vec, b + i);
424
+ svfloat64_t a_minus_b_vec = svsub_f64_x(pg_vec, a_vec, b_vec);
425
+ d2_vec = svmla_f64_x(pg_vec, d2_vec, a_minus_b_vec, a_minus_b_vec);
426
+ i += svcntd();
427
+ } while (i < n);
428
+ simsimd_f64_t d2 = svaddv_f64(svptrue_b32(), d2_vec);
429
+ *result = d2;
430
+ }
431
+
432
+ SIMSIMD_PUBLIC void simsimd_cos_f64_sve(simsimd_f64_t const* a, simsimd_f64_t const* b, simsimd_size_t n,
433
+ simsimd_distance_t* result) {
434
+ simsimd_size_t i = 0;
435
+ svfloat64_t ab_vec = svdupq_n_f64(0.0, 0.0);
436
+ svfloat64_t a2_vec = svdupq_n_f64(0.0, 0.0);
437
+ svfloat64_t b2_vec = svdupq_n_f64(0.0, 0.0);
438
+ do {
439
+ svbool_t pg_vec = svwhilelt_b64((unsigned int)i, (unsigned int)n);
440
+ svfloat64_t a_vec = svld1_f64(pg_vec, a + i);
441
+ svfloat64_t b_vec = svld1_f64(pg_vec, b + i);
442
+ ab_vec = svmla_f64_x(pg_vec, ab_vec, a_vec, b_vec);
443
+ a2_vec = svmla_f64_x(pg_vec, a2_vec, a_vec, a_vec);
444
+ b2_vec = svmla_f64_x(pg_vec, b2_vec, b_vec, b_vec);
445
+ i += svcntd();
446
+ } while (i < n);
447
+
448
+ simsimd_f64_t ab = svaddv_f64(svptrue_b32(), ab_vec);
449
+ simsimd_f64_t a2 = svaddv_f64(svptrue_b32(), a2_vec);
450
+ simsimd_f64_t b2 = svaddv_f64(svptrue_b32(), b2_vec);
451
+
452
+ // Avoid `simsimd_approximate_inverse_square_root` on Arm NEON
453
+ simsimd_f64_t a2_b2_arr[2] = {a2, b2};
454
+ float64x2_t a2_b2 = vld1q_f64(a2_b2_arr);
455
+ a2_b2 = vrsqrteq_f64(a2_b2);
456
+ vst1q_f64(a2_b2_arr, a2_b2);
457
+ *result = ab != 0 ? 1 - ab * a2_b2_arr[0] * a2_b2_arr[1] : 1;
458
+ }
459
+
460
+ #pragma clang attribute pop
461
+ #pragma GCC pop_options
462
+
463
+ #pragma GCC push_options
464
+ #pragma GCC target("+sve+fp16")
465
+ #pragma clang attribute push(__attribute__((target("+sve+fp16"))), apply_to = function)
466
+
467
+ SIMSIMD_PUBLIC void simsimd_l2sq_f16_sve(simsimd_f16_t const* a_enum, simsimd_f16_t const* b_enum, simsimd_size_t n,
468
+ simsimd_distance_t* result) {
469
+ simsimd_size_t i = 0;
470
+ svfloat16_t d2_vec = svdupq_n_f16(0, 0, 0, 0, 0, 0, 0, 0);
471
+ simsimd_f16_for_arm_simd_t const* a = (simsimd_f16_for_arm_simd_t const*)(a_enum);
472
+ simsimd_f16_for_arm_simd_t const* b = (simsimd_f16_for_arm_simd_t const*)(b_enum);
473
+ do {
474
+ svbool_t pg_vec = svwhilelt_b16((unsigned int)i, (unsigned int)n);
475
+ svfloat16_t a_vec = svld1_f16(pg_vec, a + i);
476
+ svfloat16_t b_vec = svld1_f16(pg_vec, b + i);
477
+ svfloat16_t a_minus_b_vec = svsub_f16_x(pg_vec, a_vec, b_vec);
478
+ d2_vec = svmla_f16_x(pg_vec, d2_vec, a_minus_b_vec, a_minus_b_vec);
479
+ i += svcnth();
480
+ } while (i < n);
481
+ simsimd_f16_for_arm_simd_t d2_f16 = svaddv_f16(svptrue_b16(), d2_vec);
482
+ *result = d2_f16;
483
+ }
484
+
485
+ SIMSIMD_PUBLIC void simsimd_cos_f16_sve(simsimd_f16_t const* a_enum, simsimd_f16_t const* b_enum, simsimd_size_t n,
486
+ simsimd_distance_t* result) {
487
+ simsimd_size_t i = 0;
488
+ svfloat16_t ab_vec = svdupq_n_f16(0, 0, 0, 0, 0, 0, 0, 0);
489
+ svfloat16_t a2_vec = svdupq_n_f16(0, 0, 0, 0, 0, 0, 0, 0);
490
+ svfloat16_t b2_vec = svdupq_n_f16(0, 0, 0, 0, 0, 0, 0, 0);
491
+ simsimd_f16_for_arm_simd_t const* a = (simsimd_f16_for_arm_simd_t const*)(a_enum);
492
+ simsimd_f16_for_arm_simd_t const* b = (simsimd_f16_for_arm_simd_t const*)(b_enum);
493
+ do {
494
+ svbool_t pg_vec = svwhilelt_b16((unsigned int)i, (unsigned int)n);
495
+ svfloat16_t a_vec = svld1_f16(pg_vec, a + i);
496
+ svfloat16_t b_vec = svld1_f16(pg_vec, b + i);
497
+ ab_vec = svmla_f16_x(pg_vec, ab_vec, a_vec, b_vec);
498
+ a2_vec = svmla_f16_x(pg_vec, a2_vec, a_vec, a_vec);
499
+ b2_vec = svmla_f16_x(pg_vec, b2_vec, b_vec, b_vec);
500
+ i += svcnth();
501
+ } while (i < n);
502
+
503
+ simsimd_f16_for_arm_simd_t ab = svaddv_f16(svptrue_b16(), ab_vec);
504
+ simsimd_f16_for_arm_simd_t a2 = svaddv_f16(svptrue_b16(), a2_vec);
505
+ simsimd_f16_for_arm_simd_t b2 = svaddv_f16(svptrue_b16(), b2_vec);
506
+
507
+ // Avoid `simsimd_approximate_inverse_square_root` on Arm NEON
508
+ simsimd_f32_t a2_b2_arr[2] = {a2, b2};
509
+ float32x2_t a2_b2 = vld1_f32(a2_b2_arr);
510
+ a2_b2 = vrsqrte_f32(a2_b2);
511
+ vst1_f32(a2_b2_arr, a2_b2);
512
+ *result = ab != 0 ? 1 - ab * a2_b2_arr[0] * a2_b2_arr[1] : 1;
513
+ }
514
+
515
+ #pragma clang attribute pop
516
+ #pragma GCC pop_options
517
+ #endif // SIMSIMD_TARGET_SVE
518
+ #endif // SIMSIMD_TARGET_ARM
519
+
520
+ #if SIMSIMD_TARGET_X86
521
+ #if SIMSIMD_TARGET_HASWELL
522
+ #pragma GCC push_options
523
+ #pragma GCC target("avx2", "f16c", "fma")
524
+ #pragma clang attribute push(__attribute__((target("avx2,f16c,fma"))), apply_to = function)
525
+
526
+ SIMSIMD_PUBLIC void simsimd_l2sq_f16_haswell(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_size_t n,
527
+ simsimd_distance_t* result) {
528
+ __m256 d2_vec = _mm256_setzero_ps();
529
+ simsimd_size_t i = 0;
530
+ for (; i + 8 <= n; i += 8) {
531
+ __m256 a_vec = _mm256_cvtph_ps(_mm_loadu_si128((__m128i const*)(a + i)));
532
+ __m256 b_vec = _mm256_cvtph_ps(_mm_loadu_si128((__m128i const*)(b + i)));
533
+ __m256 d_vec = _mm256_sub_ps(a_vec, b_vec);
534
+ d2_vec = _mm256_fmadd_ps(d_vec, d_vec, d2_vec);
535
+ }
536
+
537
+ // In case the software emulation for `f16` scalars is enabled, the `simsimd_uncompress_f16`
538
+ // function will run. It is extremely slow, so even for the tail, let's combine serial
539
+ // loads and stores with vectorized math.
540
+ if (i < n) {
541
+ union {
542
+ __m128i f16_vec;
543
+ simsimd_f16_t f16[8];
544
+ } a_padded_tail, b_padded_tail;
545
+ simsimd_size_t j = 0;
546
+ for (; i < n; ++i, ++j)
547
+ a_padded_tail.f16[j] = a[i], b_padded_tail.f16[j] = b[i];
548
+ for (; j < 8; ++j)
549
+ a_padded_tail.f16[j] = 0, b_padded_tail.f16[j] = 0;
550
+ __m256 a_vec = _mm256_cvtph_ps(a_padded_tail.f16_vec);
551
+ __m256 b_vec = _mm256_cvtph_ps(b_padded_tail.f16_vec);
552
+ __m256 d_vec = _mm256_sub_ps(a_vec, b_vec);
553
+ d2_vec = _mm256_fmadd_ps(d_vec, d_vec, d2_vec);
554
+ }
555
+
556
+ d2_vec = _mm256_add_ps(_mm256_permute2f128_ps(d2_vec, d2_vec, 1), d2_vec);
557
+ d2_vec = _mm256_hadd_ps(d2_vec, d2_vec);
558
+ d2_vec = _mm256_hadd_ps(d2_vec, d2_vec);
559
+
560
+ simsimd_f32_t f32_result;
561
+ _mm_store_ss(&f32_result, _mm256_castps256_ps128(d2_vec));
562
+ *result = f32_result;
563
+ }
564
+
565
+ SIMSIMD_PUBLIC void simsimd_cos_f16_haswell(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_size_t n,
566
+ simsimd_distance_t* result) {
567
+
568
+ __m256 ab_vec = _mm256_setzero_ps(), a2_vec = _mm256_setzero_ps(), b2_vec = _mm256_setzero_ps();
569
+ simsimd_size_t i = 0;
570
+ for (; i + 8 <= n; i += 8) {
571
+ __m256 a_vec = _mm256_cvtph_ps(_mm_loadu_si128((__m128i const*)(a + i)));
572
+ __m256 b_vec = _mm256_cvtph_ps(_mm_loadu_si128((__m128i const*)(b + i)));
573
+ ab_vec = _mm256_fmadd_ps(a_vec, b_vec, ab_vec);
574
+ a2_vec = _mm256_fmadd_ps(a_vec, a_vec, a2_vec);
575
+ b2_vec = _mm256_fmadd_ps(b_vec, b_vec, b2_vec);
576
+ }
577
+
578
+ // In case the software emulation for `f16` scalars is enabled, the `simsimd_uncompress_f16`
579
+ // function will run. It is extremely slow, so even for the tail, let's combine serial
580
+ // loads and stores with vectorized math.
581
+ if (i < n) {
582
+ union {
583
+ __m128i f16_vec;
584
+ simsimd_f16_t f16[8];
585
+ } a_padded_tail, b_padded_tail;
586
+ simsimd_size_t j = 0;
587
+ for (; i < n; ++i, ++j)
588
+ a_padded_tail.f16[j] = a[i], b_padded_tail.f16[j] = b[i];
589
+ for (; j < 8; ++j)
590
+ a_padded_tail.f16[j] = 0, b_padded_tail.f16[j] = 0;
591
+ __m256 a_vec = _mm256_cvtph_ps(a_padded_tail.f16_vec);
592
+ __m256 b_vec = _mm256_cvtph_ps(b_padded_tail.f16_vec);
593
+ ab_vec = _mm256_fmadd_ps(a_vec, b_vec, ab_vec);
594
+ a2_vec = _mm256_fmadd_ps(a_vec, a_vec, a2_vec);
595
+ b2_vec = _mm256_fmadd_ps(b_vec, b_vec, b2_vec);
596
+ }
597
+
598
+ // Horizontal reductions:
599
+ ab_vec = _mm256_add_ps(_mm256_permute2f128_ps(ab_vec, ab_vec, 1), ab_vec);
600
+ ab_vec = _mm256_hadd_ps(ab_vec, ab_vec);
601
+ ab_vec = _mm256_hadd_ps(ab_vec, ab_vec);
602
+
603
+ a2_vec = _mm256_add_ps(_mm256_permute2f128_ps(a2_vec, a2_vec, 1), a2_vec);
604
+ a2_vec = _mm256_hadd_ps(a2_vec, a2_vec);
605
+ a2_vec = _mm256_hadd_ps(a2_vec, a2_vec);
606
+
607
+ b2_vec = _mm256_add_ps(_mm256_permute2f128_ps(b2_vec, b2_vec, 1), b2_vec);
608
+ b2_vec = _mm256_hadd_ps(b2_vec, b2_vec);
609
+ b2_vec = _mm256_hadd_ps(b2_vec, b2_vec);
610
+
611
+ simsimd_f32_t ab, a2, b2;
612
+ _mm_store_ss(&ab, _mm256_castps256_ps128(ab_vec));
613
+ _mm_store_ss(&a2, _mm256_castps256_ps128(a2_vec));
614
+ _mm_store_ss(&b2, _mm256_castps256_ps128(b2_vec));
615
+
616
+ // Replace simsimd_approximate_inverse_square_root with `rsqrtss`
617
+ __m128 a2_sqrt_recip = _mm_rsqrt_ss(_mm_set_ss((float)a2));
618
+ __m128 b2_sqrt_recip = _mm_rsqrt_ss(_mm_set_ss((float)b2));
619
+ __m128 result_vec = _mm_mul_ss(a2_sqrt_recip, b2_sqrt_recip); // Multiply the reciprocal square roots
620
+ result_vec = _mm_mul_ss(result_vec, _mm_set_ss((float)ab)); // Multiply by ab
621
+ result_vec = _mm_sub_ss(_mm_set_ss(1.0f), result_vec); // Subtract from 1
622
+ *result = ab != 0 ? _mm_cvtss_f32(result_vec) : 1; // Extract the final result
623
+ }
624
+
625
+ SIMSIMD_PUBLIC void simsimd_l2sq_i8_haswell(simsimd_i8_t const* a, simsimd_i8_t const* b, simsimd_size_t n,
626
+ simsimd_distance_t* result) {
627
+
628
+ __m256i d2_high_vec = _mm256_setzero_si256();
629
+ __m256i d2_low_vec = _mm256_setzero_si256();
630
+
631
+ simsimd_size_t i = 0;
632
+ for (; i + 32 <= n; i += 32) {
633
+ __m256i a_vec = _mm256_loadu_si256((__m256i const*)(a + i));
634
+ __m256i b_vec = _mm256_loadu_si256((__m256i const*)(b + i));
635
+
636
+ // Sign extend int8 to int16
637
+ __m256i a_low = _mm256_cvtepi8_epi16(_mm256_castsi256_si128(a_vec));
638
+ __m256i a_high = _mm256_cvtepi8_epi16(_mm256_extracti128_si256(a_vec, 1));
639
+ __m256i b_low = _mm256_cvtepi8_epi16(_mm256_castsi256_si128(b_vec));
640
+ __m256i b_high = _mm256_cvtepi8_epi16(_mm256_extracti128_si256(b_vec, 1));
641
+
642
+ // Subtract and multiply
643
+ __m256i d_low = _mm256_sub_epi16(a_low, b_low);
644
+ __m256i d_high = _mm256_sub_epi16(a_high, b_high);
645
+ __m256i d2_low_part = _mm256_madd_epi16(d_low, d_low);
646
+ __m256i d2_high_part = _mm256_madd_epi16(d_high, d_high);
647
+
648
+ // Accumulate into int32 vectors
649
+ d2_low_vec = _mm256_add_epi32(d2_low_vec, d2_low_part);
650
+ d2_high_vec = _mm256_add_epi32(d2_high_vec, d2_high_part);
651
+ }
652
+
653
+ // Accumulate the 32-bit integers from `d2_high_vec` and `d2_low_vec`
654
+ __m256i d2_vec = _mm256_add_epi32(d2_low_vec, d2_high_vec);
655
+ __m128i d2_sum = _mm_add_epi32(_mm256_extracti128_si256(d2_vec, 0), _mm256_extracti128_si256(d2_vec, 1));
656
+ d2_sum = _mm_hadd_epi32(d2_sum, d2_sum);
657
+ d2_sum = _mm_hadd_epi32(d2_sum, d2_sum);
658
+ int d2 = _mm_extract_epi32(d2_sum, 0);
659
+
660
+ // Take care of the tail:
661
+ for (; i < n; ++i) {
662
+ int n = a[i] - b[i];
663
+ d2 += n * n;
664
+ }
665
+
666
+ *result = (simsimd_f64_t)d2;
667
+ }
668
+
669
+ SIMSIMD_PUBLIC void simsimd_cos_i8_haswell(simsimd_i8_t const* a, simsimd_i8_t const* b, simsimd_size_t n,
670
+ simsimd_distance_t* result) {
671
+
672
+ __m256i ab_low_vec = _mm256_setzero_si256();
673
+ __m256i ab_high_vec = _mm256_setzero_si256();
674
+ __m256i a2_low_vec = _mm256_setzero_si256();
675
+ __m256i a2_high_vec = _mm256_setzero_si256();
676
+ __m256i b2_low_vec = _mm256_setzero_si256();
677
+ __m256i b2_high_vec = _mm256_setzero_si256();
678
+
679
+ simsimd_size_t i = 0;
680
+ for (; i + 32 <= n; i += 32) {
681
+ __m256i a_vec = _mm256_loadu_si256((__m256i const*)(a + i));
682
+ __m256i b_vec = _mm256_loadu_si256((__m256i const*)(b + i));
683
+
684
+ // Unpack int8 to int16
685
+ __m256i a_low_16 = _mm256_cvtepi8_epi16(_mm256_extracti128_si256(a_vec, 0));
686
+ __m256i a_high_16 = _mm256_cvtepi8_epi16(_mm256_extracti128_si256(a_vec, 1));
687
+ __m256i b_low_16 = _mm256_cvtepi8_epi16(_mm256_extracti128_si256(b_vec, 0));
688
+ __m256i b_high_16 = _mm256_cvtepi8_epi16(_mm256_extracti128_si256(b_vec, 1));
689
+
690
+ // Multiply and accumulate at int16 level, accumulate at int32 level
691
+ ab_low_vec = _mm256_add_epi32(ab_low_vec, _mm256_madd_epi16(a_low_16, b_low_16));
692
+ ab_high_vec = _mm256_add_epi32(ab_high_vec, _mm256_madd_epi16(a_high_16, b_high_16));
693
+ a2_low_vec = _mm256_add_epi32(a2_low_vec, _mm256_madd_epi16(a_low_16, a_low_16));
694
+ a2_high_vec = _mm256_add_epi32(a2_high_vec, _mm256_madd_epi16(a_high_16, a_high_16));
695
+ b2_low_vec = _mm256_add_epi32(b2_low_vec, _mm256_madd_epi16(b_low_16, b_low_16));
696
+ b2_high_vec = _mm256_add_epi32(b2_high_vec, _mm256_madd_epi16(b_high_16, b_high_16));
697
+ }
698
+
699
+ // Horizontal sum across the 256-bit register
700
+ __m256i ab_vec = _mm256_add_epi32(ab_low_vec, ab_high_vec);
701
+ __m128i ab_sum = _mm_add_epi32(_mm256_extracti128_si256(ab_vec, 0), _mm256_extracti128_si256(ab_vec, 1));
702
+ ab_sum = _mm_hadd_epi32(ab_sum, ab_sum);
703
+ ab_sum = _mm_hadd_epi32(ab_sum, ab_sum);
704
+
705
+ __m256i a2_vec = _mm256_add_epi32(a2_low_vec, a2_high_vec);
706
+ __m128i a2_sum = _mm_add_epi32(_mm256_extracti128_si256(a2_vec, 0), _mm256_extracti128_si256(a2_vec, 1));
707
+ a2_sum = _mm_hadd_epi32(a2_sum, a2_sum);
708
+ a2_sum = _mm_hadd_epi32(a2_sum, a2_sum);
709
+
710
+ __m256i b2_vec = _mm256_add_epi32(b2_low_vec, b2_high_vec);
711
+ __m128i b2_sum = _mm_add_epi32(_mm256_extracti128_si256(b2_vec, 0), _mm256_extracti128_si256(b2_vec, 1));
712
+ b2_sum = _mm_hadd_epi32(b2_sum, b2_sum);
713
+ b2_sum = _mm_hadd_epi32(b2_sum, b2_sum);
714
+
715
+ // Further reduce to a single sum for each vector
716
+ int ab = _mm_extract_epi32(ab_sum, 0);
717
+ int a2 = _mm_extract_epi32(a2_sum, 0);
718
+ int b2 = _mm_extract_epi32(b2_sum, 0);
719
+
720
+ // Take care of the tail:
721
+ for (; i < n; ++i) {
722
+ int ai = a[i], bi = b[i];
723
+ ab += ai * bi, a2 += ai * ai, b2 += bi * bi;
724
+ }
725
+
726
+ // Compute the reciprocal of the square roots
727
+ __m128 a2_sqrt_recip = _mm_rsqrt_ss(_mm_set_ss((float)a2));
728
+ __m128 b2_sqrt_recip = _mm_rsqrt_ss(_mm_set_ss((float)b2));
729
+
730
+ // Compute cosine similarity: ab / sqrt(a2 * b2)
731
+ __m128 denom = _mm_mul_ss(a2_sqrt_recip, b2_sqrt_recip); // Reciprocal of sqrt(a2 * b2)
732
+ __m128 result_vec = _mm_mul_ss(_mm_set_ss((float)ab), denom); // ab * reciprocal of sqrt(a2 * b2)
733
+ *result = ab != 0 ? 1 - _mm_cvtss_f32(result_vec) : 0; // Extract the final result
734
+ }
735
+
736
+ #pragma clang attribute pop
737
+ #pragma GCC pop_options
738
+ #endif // SIMSIMD_TARGET_HASWELL
739
+
740
+ #if SIMSIMD_TARGET_SKYLAKE
741
+ #pragma GCC push_options
742
+ #pragma GCC target("avx512f", "avx512vl", "bmi2")
743
+ #pragma clang attribute push(__attribute__((target("avx512f,avx512vl,bmi2"))), apply_to = function)
744
+
745
+ SIMSIMD_PUBLIC void simsimd_l2sq_f32_skylake(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_size_t n,
746
+ simsimd_distance_t* result) {
747
+ __m512 d2_vec = _mm512_setzero();
748
+ __m512 a_vec, b_vec;
749
+
750
+ simsimd_l2sq_f32_skylake_cycle:
751
+ if (n < 16) {
752
+ __mmask16 mask = (__mmask16)_bzhi_u32(0xFFFFFFFF, n);
753
+ a_vec = _mm512_maskz_loadu_ps(mask, a);
754
+ b_vec = _mm512_maskz_loadu_ps(mask, b);
755
+ n = 0;
756
+ } else {
757
+ a_vec = _mm512_loadu_ps(a);
758
+ b_vec = _mm512_loadu_ps(b);
759
+ a += 16, b += 16, n -= 16;
760
+ }
761
+ __m512 d_vec = _mm512_sub_ps(a_vec, b_vec);
762
+ d2_vec = _mm512_fmadd_ps(d_vec, d_vec, d2_vec);
763
+ if (n)
764
+ goto simsimd_l2sq_f32_skylake_cycle;
765
+
766
+ *result = _mm512_reduce_add_ps(d2_vec);
767
+ }
768
+
769
+ SIMSIMD_PUBLIC void simsimd_cos_f32_skylake(simsimd_f32_t const* a, simsimd_f32_t const* b, simsimd_size_t n,
770
+ simsimd_distance_t* result) {
771
+ __m512 ab_vec = _mm512_setzero();
772
+ __m512 a2_vec = _mm512_setzero();
773
+ __m512 b2_vec = _mm512_setzero();
774
+ __m512 a_vec, b_vec;
775
+
776
+ simsimd_cos_f32_skylake_cycle:
777
+ if (n < 16) {
778
+ __mmask16 mask = (__mmask16)_bzhi_u32(0xFFFFFFFF, n);
779
+ a_vec = _mm512_maskz_loadu_ps(mask, a);
780
+ b_vec = _mm512_maskz_loadu_ps(mask, b);
781
+ n = 0;
782
+ } else {
783
+ a_vec = _mm512_loadu_ps(a);
784
+ b_vec = _mm512_loadu_ps(b);
785
+ a += 16, b += 16, n -= 16;
786
+ }
787
+ ab_vec = _mm512_fmadd_ps(a_vec, b_vec, ab_vec);
788
+ a2_vec = _mm512_fmadd_ps(a_vec, a_vec, a2_vec);
789
+ b2_vec = _mm512_fmadd_ps(b_vec, b_vec, b2_vec);
790
+ if (n)
791
+ goto simsimd_cos_f32_skylake_cycle;
792
+
793
+ simsimd_f32_t ab = _mm512_reduce_add_ps(ab_vec);
794
+ simsimd_f32_t a2 = _mm512_reduce_add_ps(a2_vec);
795
+ simsimd_f32_t b2 = _mm512_reduce_add_ps(b2_vec);
796
+
797
+ // Compute the reciprocal square roots of a2 and b2
798
+ // Mysteriously, MSVC has no `_mm_rsqrt14_ps` intrinsic, but has it's masked variants,
799
+ // so let's use `_mm_maskz_rsqrt14_ps(0xFF, ...)` instead.
800
+ __m128 rsqrts = _mm_maskz_rsqrt14_ps(0xFF, _mm_set_ps(0.f, 0.f, a2 + 1.e-9f, b2 + 1.e-9f));
801
+ simsimd_f32_t rsqrt_a2 = _mm_cvtss_f32(rsqrts);
802
+ simsimd_f32_t rsqrt_b2 = _mm_cvtss_f32(_mm_shuffle_ps(rsqrts, rsqrts, _MM_SHUFFLE(0, 0, 0, 1)));
803
+ *result = 1 - ab * rsqrt_a2 * rsqrt_b2;
804
+ }
805
+
806
+ SIMSIMD_PUBLIC void simsimd_l2sq_f64_skylake(simsimd_f64_t const* a, simsimd_f64_t const* b, simsimd_size_t n,
807
+ simsimd_distance_t* result) {
808
+ __m512d d2_vec = _mm512_setzero_pd();
809
+ __m512d a_vec, b_vec;
810
+
811
+ simsimd_l2sq_f64_skylake_cycle:
812
+ if (n < 8) {
813
+ __mmask8 mask = (__mmask8)_bzhi_u32(0xFFFFFFFF, n);
814
+ a_vec = _mm512_maskz_loadu_pd(mask, a);
815
+ b_vec = _mm512_maskz_loadu_pd(mask, b);
816
+ n = 0;
817
+ } else {
818
+ a_vec = _mm512_loadu_pd(a);
819
+ b_vec = _mm512_loadu_pd(b);
820
+ a += 8, b += 8, n -= 8;
821
+ }
822
+ __m512d d_vec = _mm512_sub_pd(a_vec, b_vec);
823
+ d2_vec = _mm512_fmadd_pd(d_vec, d_vec, d2_vec);
824
+ if (n)
825
+ goto simsimd_l2sq_f64_skylake_cycle;
826
+
827
+ *result = _mm512_reduce_add_pd(d2_vec);
828
+ }
829
+
830
+ SIMSIMD_PUBLIC void simsimd_cos_f64_skylake(simsimd_f64_t const* a, simsimd_f64_t const* b, simsimd_size_t n,
831
+ simsimd_distance_t* result) {
832
+ __m512d ab_vec = _mm512_setzero_pd();
833
+ __m512d a2_vec = _mm512_setzero_pd();
834
+ __m512d b2_vec = _mm512_setzero_pd();
835
+ __m512d a_vec, b_vec;
836
+
837
+ simsimd_cos_f64_skylake_cycle:
838
+ if (n < 8) {
839
+ __mmask8 mask = (__mmask8)_bzhi_u32(0xFFFFFFFF, n);
840
+ a_vec = _mm512_maskz_loadu_pd(mask, a);
841
+ b_vec = _mm512_maskz_loadu_pd(mask, b);
842
+ n = 0;
843
+ } else {
844
+ a_vec = _mm512_loadu_pd(a);
845
+ b_vec = _mm512_loadu_pd(b);
846
+ a += 8, b += 8, n -= 8;
847
+ }
848
+ ab_vec = _mm512_fmadd_pd(a_vec, b_vec, ab_vec);
849
+ a2_vec = _mm512_fmadd_pd(a_vec, a_vec, a2_vec);
850
+ b2_vec = _mm512_fmadd_pd(b_vec, b_vec, b2_vec);
851
+ if (n)
852
+ goto simsimd_cos_f64_skylake_cycle;
853
+
854
+ simsimd_f32_t ab = (simsimd_f32_t)_mm512_reduce_add_pd(ab_vec);
855
+ simsimd_f32_t a2 = (simsimd_f32_t)_mm512_reduce_add_pd(a2_vec);
856
+ simsimd_f32_t b2 = (simsimd_f32_t)_mm512_reduce_add_pd(b2_vec);
857
+
858
+ // Compute the reciprocal square roots of a2 and b2
859
+ // Mysteriously, MSVC has no `_mm_rsqrt14_ps` intrinsic, but has it's masked variants,
860
+ // so let's use `_mm_maskz_rsqrt14_ps(0xFF, ...)` instead.
861
+ __m128 rsqrts = _mm_maskz_rsqrt14_ps(0xFF, _mm_set_ps(0.f, 0.f, a2 + 1.e-9f, b2 + 1.e-9f));
862
+ simsimd_f32_t rsqrt_a2 = _mm_cvtss_f32(rsqrts);
863
+ simsimd_f32_t rsqrt_b2 = _mm_cvtss_f32(_mm_shuffle_ps(rsqrts, rsqrts, _MM_SHUFFLE(0, 0, 0, 1)));
864
+ *result = 1 - ab * rsqrt_a2 * rsqrt_b2;
865
+ }
866
+
867
+ #pragma clang attribute pop
868
+ #pragma GCC pop_options
869
+ #endif // SIMSIMD_TARGET_SKYLAKE
870
+
871
+ #if SIMSIMD_TARGET_SAPPHIRE
872
+ #pragma GCC push_options
873
+ #pragma GCC target("avx512f", "avx512vl", "bmi2", "avx512fp16")
874
+ #pragma clang attribute push(__attribute__((target("avx512f,avx512vl,bmi2,avx512fp16"))), apply_to = function)
875
+
876
+ SIMSIMD_PUBLIC void simsimd_l2sq_f16_sapphire(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_size_t n,
877
+ simsimd_distance_t* result) {
878
+ __m512h d2_vec = _mm512_setzero_ph();
879
+ __m512i a_i16_vec, b_i16_vec;
880
+
881
+ simsimd_l2sq_f16_sapphire_cycle:
882
+ if (n < 32) {
883
+ __mmask32 mask = (__mmask32)_bzhi_u32(0xFFFFFFFF, n);
884
+ a_i16_vec = _mm512_maskz_loadu_epi16(mask, a);
885
+ b_i16_vec = _mm512_maskz_loadu_epi16(mask, b);
886
+ n = 0;
887
+ } else {
888
+ a_i16_vec = _mm512_loadu_epi16(a);
889
+ b_i16_vec = _mm512_loadu_epi16(b);
890
+ a += 32, b += 32, n -= 32;
891
+ }
892
+ __m512h d_vec = _mm512_sub_ph(_mm512_castsi512_ph(a_i16_vec), _mm512_castsi512_ph(b_i16_vec));
893
+ d2_vec = _mm512_fmadd_ph(d_vec, d_vec, d2_vec);
894
+ if (n)
895
+ goto simsimd_l2sq_f16_sapphire_cycle;
896
+
897
+ *result = _mm512_reduce_add_ph(d2_vec);
898
+ }
899
+
900
+ SIMSIMD_PUBLIC void simsimd_cos_f16_sapphire(simsimd_f16_t const* a, simsimd_f16_t const* b, simsimd_size_t n,
901
+ simsimd_distance_t* result) {
902
+ __m512h ab_vec = _mm512_setzero_ph();
903
+ __m512h a2_vec = _mm512_setzero_ph();
904
+ __m512h b2_vec = _mm512_setzero_ph();
905
+ __m512i a_i16_vec, b_i16_vec;
906
+
907
+ simsimd_cos_f16_sapphire_cycle:
908
+ if (n < 32) {
909
+ __mmask32 mask = (__mmask32)_bzhi_u32(0xFFFFFFFF, n);
910
+ a_i16_vec = _mm512_maskz_loadu_epi16(mask, a);
911
+ b_i16_vec = _mm512_maskz_loadu_epi16(mask, b);
912
+ n = 0;
913
+ } else {
914
+ a_i16_vec = _mm512_loadu_epi16(a);
915
+ b_i16_vec = _mm512_loadu_epi16(b);
916
+ a += 32, b += 32, n -= 32;
917
+ }
918
+ ab_vec = _mm512_fmadd_ph(_mm512_castsi512_ph(a_i16_vec), _mm512_castsi512_ph(b_i16_vec), ab_vec);
919
+ a2_vec = _mm512_fmadd_ph(_mm512_castsi512_ph(a_i16_vec), _mm512_castsi512_ph(a_i16_vec), a2_vec);
920
+ b2_vec = _mm512_fmadd_ph(_mm512_castsi512_ph(b_i16_vec), _mm512_castsi512_ph(b_i16_vec), b2_vec);
921
+ if (n)
922
+ goto simsimd_cos_f16_sapphire_cycle;
923
+
924
+ simsimd_f32_t ab = _mm512_reduce_add_ph(ab_vec);
925
+ simsimd_f32_t a2 = _mm512_reduce_add_ph(a2_vec);
926
+ simsimd_f32_t b2 = _mm512_reduce_add_ph(b2_vec);
927
+
928
+ // Compute the reciprocal square roots of a2 and b2
929
+ __m128 rsqrts = _mm_rsqrt14_ps(_mm_set_ps(0.f, 0.f, a2 + 1.e-9f, b2 + 1.e-9f));
930
+ simsimd_f32_t rsqrt_a2 = _mm_cvtss_f32(rsqrts);
931
+ simsimd_f32_t rsqrt_b2 = _mm_cvtss_f32(_mm_shuffle_ps(rsqrts, rsqrts, _MM_SHUFFLE(0, 0, 0, 1)));
932
+ *result = 1 - ab * rsqrt_a2 * rsqrt_b2;
933
+ }
934
+
935
+ #pragma clang attribute pop
936
+ #pragma GCC pop_options
937
+ #endif // SIMSIMD_TARGET_SAPPHIRE
938
+
939
+ #if SIMSIMD_TARGET_ICE
940
+ #pragma GCC push_options
941
+ #pragma GCC target("avx512f", "avx512vl", "bmi2", "avx512bw", "avx512vnni")
942
+ #pragma clang attribute push(__attribute__((target("avx512f,avx512vl,bmi2,avx512bw,avx512vnni"))), apply_to = function)
943
+
944
+ SIMSIMD_PUBLIC void simsimd_l2sq_i8_ice(simsimd_i8_t const* a, simsimd_i8_t const* b, simsimd_size_t n,
945
+ simsimd_distance_t* result) {
946
+ __m512i d2_i32s_vec = _mm512_setzero_si512();
947
+ __m512i a_vec, b_vec, d_i16s_vec;
948
+
949
+ simsimd_l2sq_i8_ice_cycle:
950
+ if (n < 32) {
951
+ __mmask32 mask = (__mmask32)_bzhi_u32(0xFFFFFFFF, n);
952
+ a_vec = _mm512_cvtepi8_epi16(_mm256_maskz_loadu_epi8(mask, a));
953
+ b_vec = _mm512_cvtepi8_epi16(_mm256_maskz_loadu_epi8(mask, b));
954
+ n = 0;
955
+ } else {
956
+ a_vec = _mm512_cvtepi8_epi16(_mm256_loadu_epi8(a));
957
+ b_vec = _mm512_cvtepi8_epi16(_mm256_loadu_epi8(b));
958
+ a += 32, b += 32, n -= 32;
959
+ }
960
+ d_i16s_vec = _mm512_sub_epi16(a_vec, b_vec);
961
+ d2_i32s_vec = _mm512_dpwssd_epi32(d2_i32s_vec, d_i16s_vec, d_i16s_vec);
962
+ if (n)
963
+ goto simsimd_l2sq_i8_ice_cycle;
964
+
965
+ *result = _mm512_reduce_add_epi32(d2_i32s_vec);
966
+ }
967
+
968
+ SIMSIMD_PUBLIC void simsimd_cos_i8_ice(simsimd_i8_t const* a, simsimd_i8_t const* b, simsimd_size_t n,
969
+ simsimd_distance_t* result) {
970
+ __m512i ab_i32s_vec = _mm512_setzero_si512();
971
+ __m512i a2_i32s_vec = _mm512_setzero_si512();
972
+ __m512i b2_i32s_vec = _mm512_setzero_si512();
973
+ __m512i a_vec, b_vec;
974
+
975
+ simsimd_cos_i8_ice_cycle:
976
+ if (n < 32) {
977
+ __mmask32 mask = (__mmask32)_bzhi_u32(0xFFFFFFFF, n);
978
+ a_vec = _mm512_cvtepi8_epi16(_mm256_maskz_loadu_epi8(mask, a));
979
+ b_vec = _mm512_cvtepi8_epi16(_mm256_maskz_loadu_epi8(mask, b));
980
+ n = 0;
981
+ } else {
982
+ a_vec = _mm512_cvtepi8_epi16(_mm256_loadu_epi8(a));
983
+ b_vec = _mm512_cvtepi8_epi16(_mm256_loadu_epi8(b));
984
+ a += 32, b += 32, n -= 32;
985
+ }
986
+ // Unfortunately we can't use the `_mm512_dpbusd_epi32` intrinsics here either,
987
+ // as it's assymetric with respect to the sign of the input arguments:
988
+ // Signed(ZeroExtend16(a.byte[4*j]) * SignExtend16(b.byte[4*j]))
989
+ // So we have to use the `_mm512_dpwssd_epi32` intrinsics instead, upcasting
990
+ // to 16-bit beforehand.
991
+ ab_i32s_vec = _mm512_dpwssd_epi32(ab_i32s_vec, a_vec, b_vec);
992
+ a2_i32s_vec = _mm512_dpwssd_epi32(a2_i32s_vec, a_vec, a_vec);
993
+ b2_i32s_vec = _mm512_dpwssd_epi32(b2_i32s_vec, b_vec, b_vec);
994
+ if (n)
995
+ goto simsimd_cos_i8_ice_cycle;
996
+
997
+ simsimd_f32_t ab = _mm512_reduce_add_epi32(ab_i32s_vec);
998
+ simsimd_f32_t a2 = _mm512_reduce_add_epi32(a2_i32s_vec);
999
+ simsimd_f32_t b2 = _mm512_reduce_add_epi32(b2_i32s_vec);
1000
+
1001
+ // Compute the reciprocal square roots of a2 and b2
1002
+ // Mysteriously, MSVC has no `_mm_rsqrt14_ps` intrinsic, but has it's masked variants,
1003
+ // so let's use `_mm_maskz_rsqrt14_ps(0xFF, ...)` instead.
1004
+ __m128 rsqrts = _mm_maskz_rsqrt14_ps(0xFF, _mm_set_ps(0.f, 0.f, a2 + 1.e-9f, b2 + 1.e-9f));
1005
+ simsimd_f32_t rsqrt_a2 = _mm_cvtss_f32(rsqrts);
1006
+ simsimd_f32_t rsqrt_b2 = _mm_cvtss_f32(_mm_shuffle_ps(rsqrts, rsqrts, _MM_SHUFFLE(0, 0, 0, 1)));
1007
+ *result = 1 - ab * rsqrt_a2 * rsqrt_b2;
1008
+ }
1009
+
1010
+ #pragma clang attribute pop
1011
+ #pragma GCC pop_options
1012
+ #endif // SIMSIMD_TARGET_ICE
1013
+ #endif // SIMSIMD_TARGET_X86
1014
+
1015
+ #ifdef __cplusplus
1016
+ }
1017
+ #endif
1018
+
1019
+ #endif