usearch 2.21.3 → 2.25.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 (602) hide show
  1. package/README.md +24 -24
  2. package/binding.gyp +15 -37
  3. package/c/CMakeLists.txt +4 -5
  4. package/c/README.md +7 -7
  5. package/c/lib.cpp +32 -14
  6. package/c/test.c +83 -1
  7. package/c/usearch.h +24 -3
  8. package/cpp/CMakeLists.txt +4 -0
  9. package/cpp/README.md +5 -5
  10. package/cpp/bench.cpp +97 -116
  11. package/cpp/test.cpp +117 -20
  12. package/include/usearch/index.hpp +235 -52
  13. package/include/usearch/index_dense.hpp +105 -40
  14. package/include/usearch/index_plugins.hpp +1387 -204
  15. package/javascript/dist/cjs/usearch.d.ts +8 -3
  16. package/javascript/dist/cjs/usearch.js +12 -4
  17. package/javascript/dist/esm/usearch.d.ts +8 -3
  18. package/javascript/dist/esm/usearch.js +12 -4
  19. package/javascript/lib.cpp +17 -0
  20. package/javascript/usearch.ts +14 -6
  21. package/numkong/.clang-tidy +30 -0
  22. package/{simsimd → numkong}/.cmake-format.py +18 -0
  23. package/numkong/.editorconfig +12 -0
  24. package/numkong/.git-blame-ignore-revs +123 -0
  25. package/numkong/.mailmap +15 -0
  26. package/numkong/.spi.yml +11 -0
  27. package/numkong/.swift-format +14 -0
  28. package/numkong/CITATION.cff +81 -0
  29. package/numkong/CONTRIBUTING.md +500 -0
  30. package/numkong/Cargo.toml +54 -0
  31. package/numkong/MANIFEST.in +8 -0
  32. package/numkong/Package.swift +84 -0
  33. package/numkong/README.md +569 -0
  34. package/numkong/bench/README.md +217 -0
  35. package/numkong/bench/bench-browser.html +323 -0
  36. package/numkong/bench/bench.cpp +344 -0
  37. package/numkong/bench/bench.hpp +816 -0
  38. package/numkong/bench/bench.js +148 -0
  39. package/numkong/bench/bench.mjs +616 -0
  40. package/numkong/bench/bench_attention.cpp +113 -0
  41. package/numkong/bench/bench_cast.cpp +264 -0
  42. package/numkong/bench/bench_cross_amx.cpp +62 -0
  43. package/numkong/bench/bench_cross_arm.cpp +245 -0
  44. package/numkong/bench/bench_cross_blas.cpp +309 -0
  45. package/numkong/bench/bench_cross_loongarch.cpp +106 -0
  46. package/numkong/bench/bench_cross_power.cpp +84 -0
  47. package/numkong/bench/bench_cross_rvv.cpp +121 -0
  48. package/numkong/bench/bench_cross_serial.cpp +151 -0
  49. package/numkong/bench/bench_cross_sme.cpp +163 -0
  50. package/numkong/bench/bench_cross_wasm.cpp +142 -0
  51. package/numkong/bench/bench_cross_x86.cpp +455 -0
  52. package/numkong/bench/bench_curved.cpp +210 -0
  53. package/numkong/bench/bench_dot.cpp +315 -0
  54. package/numkong/bench/bench_each.cpp +503 -0
  55. package/numkong/bench/bench_geospatial.cpp +112 -0
  56. package/numkong/bench/bench_maxsim.cpp +154 -0
  57. package/numkong/bench/bench_mesh.cpp +148 -0
  58. package/numkong/bench/bench_probability.cpp +60 -0
  59. package/numkong/bench/bench_reduce.cpp +371 -0
  60. package/numkong/bench/bench_set.cpp +73 -0
  61. package/numkong/bench/bench_sparse.cpp +198 -0
  62. package/numkong/bench/bench_spatial.cpp +347 -0
  63. package/numkong/bench/bench_trigonometry.cpp +137 -0
  64. package/numkong/bench/swift/Bench.swift +506 -0
  65. package/numkong/binding.gyp +169 -0
  66. package/numkong/build.rs +484 -0
  67. package/numkong/c/dispatch.h +512 -0
  68. package/numkong/c/dispatch_bf16.c +447 -0
  69. package/numkong/c/dispatch_bf16c.c +52 -0
  70. package/numkong/c/dispatch_e2m3.c +296 -0
  71. package/numkong/c/dispatch_e3m2.c +284 -0
  72. package/numkong/c/dispatch_e4m3.c +318 -0
  73. package/numkong/c/dispatch_e5m2.c +316 -0
  74. package/numkong/c/dispatch_f16.c +452 -0
  75. package/numkong/c/dispatch_f16c.c +58 -0
  76. package/numkong/c/dispatch_f32.c +434 -0
  77. package/numkong/c/dispatch_f32c.c +99 -0
  78. package/numkong/c/dispatch_f64.c +348 -0
  79. package/numkong/c/dispatch_f64c.c +98 -0
  80. package/numkong/c/dispatch_i16.c +96 -0
  81. package/numkong/c/dispatch_i32.c +89 -0
  82. package/numkong/c/dispatch_i4.c +153 -0
  83. package/numkong/c/dispatch_i64.c +86 -0
  84. package/numkong/c/dispatch_i8.c +348 -0
  85. package/numkong/c/dispatch_other.c +348 -0
  86. package/numkong/c/dispatch_u1.c +193 -0
  87. package/numkong/c/dispatch_u16.c +124 -0
  88. package/numkong/c/dispatch_u32.c +118 -0
  89. package/numkong/c/dispatch_u4.c +153 -0
  90. package/numkong/c/dispatch_u64.c +102 -0
  91. package/numkong/c/dispatch_u8.c +364 -0
  92. package/numkong/c/numkong.c +940 -0
  93. package/numkong/cmake/nk_arm_isa_probes.cmake +61 -0
  94. package/numkong/cmake/nk_isa_probe.cmake +90 -0
  95. package/numkong/cmake/nk_loongarch_isa_probes.cmake +15 -0
  96. package/numkong/cmake/nk_math_lib.cmake +46 -0
  97. package/numkong/cmake/nk_power_isa_probes.cmake +15 -0
  98. package/numkong/cmake/nk_riscv_isa_probes.cmake +19 -0
  99. package/numkong/cmake/nk_x86_isa_probes.cmake +35 -0
  100. package/numkong/cmake/toolchain-aarch64-gnu.cmake +86 -0
  101. package/numkong/cmake/toolchain-android-arm64.cmake +25 -0
  102. package/numkong/cmake/toolchain-android-armv7.cmake +25 -0
  103. package/numkong/cmake/toolchain-loongarch64-gnu.cmake +68 -0
  104. package/numkong/cmake/toolchain-ppc64le-gnu.cmake +74 -0
  105. package/numkong/cmake/toolchain-riscv64-gnu.cmake +107 -0
  106. package/numkong/cmake/toolchain-riscv64-llvm.cmake +114 -0
  107. package/numkong/cmake/toolchain-wasi.cmake +77 -0
  108. package/numkong/cmake/toolchain-wasm.cmake +70 -0
  109. package/numkong/cmake/toolchain-wasm64.cmake +62 -0
  110. package/numkong/cmake/toolchain-x86_64-llvm.cmake +47 -0
  111. package/numkong/include/README.md +643 -0
  112. package/numkong/include/module.modulemap +129 -0
  113. package/numkong/include/numkong/attention/sapphireamx.h +1363 -0
  114. package/numkong/include/numkong/attention/sme.h +2075 -0
  115. package/numkong/include/numkong/attention.h +49 -0
  116. package/numkong/include/numkong/capabilities.h +930 -0
  117. package/numkong/include/numkong/cast/README.md +262 -0
  118. package/numkong/include/numkong/cast/diamond.h +64 -0
  119. package/numkong/include/numkong/cast/haswell.h +823 -0
  120. package/numkong/include/numkong/cast/icelake.h +475 -0
  121. package/numkong/include/numkong/cast/loongsonasx.h +252 -0
  122. package/numkong/include/numkong/cast/neon.h +1174 -0
  123. package/numkong/include/numkong/cast/powervsx.h +449 -0
  124. package/numkong/include/numkong/cast/rvv.h +970 -0
  125. package/numkong/include/numkong/cast/sapphire.h +262 -0
  126. package/numkong/include/numkong/cast/serial.h +2336 -0
  127. package/numkong/include/numkong/cast/skylake.h +915 -0
  128. package/numkong/include/numkong/cast/v128relaxed.h +537 -0
  129. package/numkong/include/numkong/cast.h +254 -0
  130. package/numkong/include/numkong/cast.hpp +44 -0
  131. package/numkong/include/numkong/curved/README.md +223 -0
  132. package/numkong/include/numkong/curved/genoa.h +182 -0
  133. package/numkong/include/numkong/curved/haswell.h +276 -0
  134. package/numkong/include/numkong/curved/neon.h +329 -0
  135. package/numkong/include/numkong/curved/neonbfdot.h +211 -0
  136. package/numkong/include/numkong/curved/rvv.h +305 -0
  137. package/numkong/include/numkong/curved/serial.h +207 -0
  138. package/numkong/include/numkong/curved/skylake.h +457 -0
  139. package/numkong/include/numkong/curved/smef64.h +530 -0
  140. package/numkong/include/numkong/curved.h +513 -0
  141. package/numkong/include/numkong/curved.hpp +144 -0
  142. package/numkong/include/numkong/dot/README.md +442 -0
  143. package/numkong/include/numkong/dot/alder.h +563 -0
  144. package/numkong/include/numkong/dot/diamond.h +158 -0
  145. package/numkong/include/numkong/dot/genoa.h +289 -0
  146. package/numkong/include/numkong/dot/haswell.h +1723 -0
  147. package/numkong/include/numkong/dot/icelake.h +997 -0
  148. package/numkong/include/numkong/dot/loongsonasx.h +671 -0
  149. package/numkong/include/numkong/dot/neon.h +869 -0
  150. package/numkong/include/numkong/dot/neonbfdot.h +243 -0
  151. package/numkong/include/numkong/dot/neonfhm.h +358 -0
  152. package/numkong/include/numkong/dot/neonfp8.h +323 -0
  153. package/numkong/include/numkong/dot/neonsdot.h +622 -0
  154. package/numkong/include/numkong/dot/powervsx.h +752 -0
  155. package/numkong/include/numkong/dot/rvv.h +722 -0
  156. package/numkong/include/numkong/dot/rvvbb.h +72 -0
  157. package/numkong/include/numkong/dot/rvvbf16.h +123 -0
  158. package/numkong/include/numkong/dot/rvvhalf.h +129 -0
  159. package/numkong/include/numkong/dot/sapphire.h +141 -0
  160. package/numkong/include/numkong/dot/serial.h +874 -0
  161. package/numkong/include/numkong/dot/sierra.h +405 -0
  162. package/numkong/include/numkong/dot/skylake.h +1116 -0
  163. package/numkong/include/numkong/dot/sve.h +420 -0
  164. package/numkong/include/numkong/dot/svebfdot.h +75 -0
  165. package/numkong/include/numkong/dot/svehalf.h +168 -0
  166. package/numkong/include/numkong/dot/svesdot.h +90 -0
  167. package/numkong/include/numkong/dot/v128relaxed.h +1293 -0
  168. package/numkong/include/numkong/dot.h +1136 -0
  169. package/numkong/include/numkong/dot.hpp +94 -0
  170. package/numkong/include/numkong/dots/README.md +496 -0
  171. package/numkong/include/numkong/dots/alder.h +117 -0
  172. package/numkong/include/numkong/dots/diamond.h +86 -0
  173. package/numkong/include/numkong/dots/genoa.h +100 -0
  174. package/numkong/include/numkong/dots/graniteamx.h +733 -0
  175. package/numkong/include/numkong/dots/haswell.h +310 -0
  176. package/numkong/include/numkong/dots/icelake.h +180 -0
  177. package/numkong/include/numkong/dots/loongsonasx.h +176 -0
  178. package/numkong/include/numkong/dots/neon.h +123 -0
  179. package/numkong/include/numkong/dots/neonbfdot.h +59 -0
  180. package/numkong/include/numkong/dots/neonfhm.h +96 -0
  181. package/numkong/include/numkong/dots/neonfp8.h +99 -0
  182. package/numkong/include/numkong/dots/neonsdot.h +144 -0
  183. package/numkong/include/numkong/dots/powervsx.h +194 -0
  184. package/numkong/include/numkong/dots/rvv.h +2593 -0
  185. package/numkong/include/numkong/dots/sapphireamx.h +4017 -0
  186. package/numkong/include/numkong/dots/serial.h +2867 -0
  187. package/numkong/include/numkong/dots/sierra.h +100 -0
  188. package/numkong/include/numkong/dots/skylake.h +207 -0
  189. package/numkong/include/numkong/dots/sme.h +5041 -0
  190. package/numkong/include/numkong/dots/smebi32.h +477 -0
  191. package/numkong/include/numkong/dots/smef64.h +1328 -0
  192. package/numkong/include/numkong/dots/smehalf.h +47 -0
  193. package/numkong/include/numkong/dots/v128relaxed.h +317 -0
  194. package/numkong/include/numkong/dots.h +3110 -0
  195. package/numkong/include/numkong/dots.hpp +641 -0
  196. package/numkong/include/numkong/each/README.md +465 -0
  197. package/numkong/include/numkong/each/haswell.h +1658 -0
  198. package/numkong/include/numkong/each/icelake.h +272 -0
  199. package/numkong/include/numkong/each/neon.h +1138 -0
  200. package/numkong/include/numkong/each/neonbfdot.h +211 -0
  201. package/numkong/include/numkong/each/neonhalf.h +318 -0
  202. package/numkong/include/numkong/each/rvv.h +1121 -0
  203. package/numkong/include/numkong/each/sapphire.h +343 -0
  204. package/numkong/include/numkong/each/serial.h +282 -0
  205. package/numkong/include/numkong/each/skylake.h +1562 -0
  206. package/numkong/include/numkong/each/v128relaxed.h +562 -0
  207. package/numkong/include/numkong/each.h +2232 -0
  208. package/numkong/include/numkong/each.hpp +434 -0
  209. package/numkong/include/numkong/geospatial/README.md +147 -0
  210. package/numkong/include/numkong/geospatial/haswell.h +633 -0
  211. package/numkong/include/numkong/geospatial/neon.h +615 -0
  212. package/numkong/include/numkong/geospatial/rvv.h +701 -0
  213. package/numkong/include/numkong/geospatial/serial.h +309 -0
  214. package/numkong/include/numkong/geospatial/skylake.h +613 -0
  215. package/numkong/include/numkong/geospatial/v128relaxed.h +652 -0
  216. package/numkong/include/numkong/geospatial.h +453 -0
  217. package/numkong/include/numkong/geospatial.hpp +235 -0
  218. package/numkong/include/numkong/matrix.hpp +336 -0
  219. package/numkong/include/numkong/maxsim/README.md +187 -0
  220. package/numkong/include/numkong/maxsim/alder.h +511 -0
  221. package/numkong/include/numkong/maxsim/genoa.h +115 -0
  222. package/numkong/include/numkong/maxsim/haswell.h +553 -0
  223. package/numkong/include/numkong/maxsim/icelake.h +480 -0
  224. package/numkong/include/numkong/maxsim/neonsdot.h +394 -0
  225. package/numkong/include/numkong/maxsim/sapphireamx.h +877 -0
  226. package/numkong/include/numkong/maxsim/serial.h +490 -0
  227. package/numkong/include/numkong/maxsim/sme.h +993 -0
  228. package/numkong/include/numkong/maxsim/v128relaxed.h +280 -0
  229. package/numkong/include/numkong/maxsim.h +571 -0
  230. package/numkong/include/numkong/maxsim.hpp +133 -0
  231. package/numkong/include/numkong/mesh/README.md +219 -0
  232. package/numkong/include/numkong/mesh/haswell.h +2013 -0
  233. package/numkong/include/numkong/mesh/neon.h +1821 -0
  234. package/numkong/include/numkong/mesh/neonbfdot.h +771 -0
  235. package/numkong/include/numkong/mesh/rvv.h +936 -0
  236. package/numkong/include/numkong/mesh/serial.h +721 -0
  237. package/numkong/include/numkong/mesh/skylake.h +2344 -0
  238. package/numkong/include/numkong/mesh/v128relaxed.h +1081 -0
  239. package/numkong/include/numkong/mesh.h +666 -0
  240. package/numkong/include/numkong/mesh.hpp +701 -0
  241. package/numkong/include/numkong/numkong.h +78 -0
  242. package/numkong/include/numkong/numkong.hpp +58 -0
  243. package/numkong/include/numkong/probability/README.md +177 -0
  244. package/numkong/include/numkong/probability/haswell.h +267 -0
  245. package/numkong/include/numkong/probability/neon.h +255 -0
  246. package/numkong/include/numkong/probability/rvv.h +414 -0
  247. package/numkong/include/numkong/probability/serial.h +181 -0
  248. package/numkong/include/numkong/probability/skylake.h +324 -0
  249. package/numkong/include/numkong/probability.h +380 -0
  250. package/numkong/include/numkong/probability.hpp +120 -0
  251. package/numkong/include/numkong/random.h +50 -0
  252. package/numkong/include/numkong/random.hpp +285 -0
  253. package/numkong/include/numkong/reduce/README.md +552 -0
  254. package/numkong/include/numkong/reduce/alder.h +636 -0
  255. package/numkong/include/numkong/reduce/genoa.h +201 -0
  256. package/numkong/include/numkong/reduce/haswell.h +3785 -0
  257. package/numkong/include/numkong/reduce/icelake.h +549 -0
  258. package/numkong/include/numkong/reduce/neon.h +3980 -0
  259. package/numkong/include/numkong/reduce/neonbfdot.h +142 -0
  260. package/numkong/include/numkong/reduce/neonfhm.h +293 -0
  261. package/numkong/include/numkong/reduce/neonsdot.h +357 -0
  262. package/numkong/include/numkong/reduce/rvv.h +3533 -0
  263. package/numkong/include/numkong/reduce/serial.h +753 -0
  264. package/numkong/include/numkong/reduce/sierra.h +338 -0
  265. package/numkong/include/numkong/reduce/skylake.h +3794 -0
  266. package/numkong/include/numkong/reduce/sve.h +52 -0
  267. package/numkong/include/numkong/reduce/v128relaxed.h +2302 -0
  268. package/numkong/include/numkong/reduce.h +1582 -0
  269. package/numkong/include/numkong/reduce.hpp +778 -0
  270. package/numkong/include/numkong/scalar/README.md +89 -0
  271. package/numkong/include/numkong/scalar/haswell.h +122 -0
  272. package/numkong/include/numkong/scalar/loongsonasx.h +74 -0
  273. package/numkong/include/numkong/scalar/neon.h +122 -0
  274. package/numkong/include/numkong/scalar/neonhalf.h +70 -0
  275. package/numkong/include/numkong/scalar/powervsx.h +96 -0
  276. package/numkong/include/numkong/scalar/rvv.h +211 -0
  277. package/numkong/include/numkong/scalar/sapphire.h +74 -0
  278. package/numkong/include/numkong/scalar/serial.h +332 -0
  279. package/numkong/include/numkong/scalar/v128relaxed.h +56 -0
  280. package/numkong/include/numkong/scalar.h +696 -0
  281. package/numkong/include/numkong/set/README.md +179 -0
  282. package/numkong/include/numkong/set/haswell.h +334 -0
  283. package/numkong/include/numkong/set/icelake.h +485 -0
  284. package/numkong/include/numkong/set/loongsonasx.h +181 -0
  285. package/numkong/include/numkong/set/neon.h +363 -0
  286. package/numkong/include/numkong/set/powervsx.h +326 -0
  287. package/numkong/include/numkong/set/rvv.h +226 -0
  288. package/numkong/include/numkong/set/rvvbb.h +117 -0
  289. package/numkong/include/numkong/set/serial.h +174 -0
  290. package/numkong/include/numkong/set/sve.h +187 -0
  291. package/numkong/include/numkong/set/v128relaxed.h +240 -0
  292. package/numkong/include/numkong/set.h +471 -0
  293. package/numkong/include/numkong/set.hpp +114 -0
  294. package/numkong/include/numkong/sets/README.md +149 -0
  295. package/numkong/include/numkong/sets/haswell.h +63 -0
  296. package/numkong/include/numkong/sets/icelake.h +66 -0
  297. package/numkong/include/numkong/sets/loongsonasx.h +52 -0
  298. package/numkong/include/numkong/sets/neon.h +61 -0
  299. package/numkong/include/numkong/sets/powervsx.h +65 -0
  300. package/numkong/include/numkong/sets/serial.h +43 -0
  301. package/numkong/include/numkong/sets/smebi32.h +1135 -0
  302. package/numkong/include/numkong/sets/v128relaxed.h +58 -0
  303. package/numkong/include/numkong/sets.h +382 -0
  304. package/numkong/include/numkong/sparse/README.md +156 -0
  305. package/numkong/include/numkong/sparse/icelake.h +463 -0
  306. package/numkong/include/numkong/sparse/neon.h +288 -0
  307. package/numkong/include/numkong/sparse/serial.h +117 -0
  308. package/numkong/include/numkong/sparse/sve2.h +504 -0
  309. package/numkong/include/numkong/sparse/turin.h +322 -0
  310. package/numkong/include/numkong/sparse.h +363 -0
  311. package/numkong/include/numkong/sparse.hpp +113 -0
  312. package/numkong/include/numkong/spatial/README.md +439 -0
  313. package/numkong/include/numkong/spatial/alder.h +604 -0
  314. package/numkong/include/numkong/spatial/diamond.h +240 -0
  315. package/numkong/include/numkong/spatial/genoa.h +222 -0
  316. package/numkong/include/numkong/spatial/haswell.h +979 -0
  317. package/numkong/include/numkong/spatial/icelake.h +1067 -0
  318. package/numkong/include/numkong/spatial/loongsonasx.h +483 -0
  319. package/numkong/include/numkong/spatial/neon.h +846 -0
  320. package/numkong/include/numkong/spatial/neonbfdot.h +164 -0
  321. package/numkong/include/numkong/spatial/neonfp8.h +258 -0
  322. package/numkong/include/numkong/spatial/neonsdot.h +429 -0
  323. package/numkong/include/numkong/spatial/powervsx.h +738 -0
  324. package/numkong/include/numkong/spatial/rvv.h +991 -0
  325. package/numkong/include/numkong/spatial/rvvbf16.h +128 -0
  326. package/numkong/include/numkong/spatial/rvvhalf.h +120 -0
  327. package/numkong/include/numkong/spatial/serial.h +347 -0
  328. package/numkong/include/numkong/spatial/sierra.h +516 -0
  329. package/numkong/include/numkong/spatial/skylake.h +605 -0
  330. package/numkong/include/numkong/spatial/sve.h +246 -0
  331. package/numkong/include/numkong/spatial/svebfdot.h +125 -0
  332. package/numkong/include/numkong/spatial/svehalf.h +136 -0
  333. package/numkong/include/numkong/spatial/svesdot.h +143 -0
  334. package/numkong/include/numkong/spatial/v128relaxed.h +969 -0
  335. package/numkong/include/numkong/spatial.h +1681 -0
  336. package/numkong/include/numkong/spatial.hpp +183 -0
  337. package/numkong/include/numkong/spatials/README.md +580 -0
  338. package/numkong/include/numkong/spatials/alder.h +94 -0
  339. package/numkong/include/numkong/spatials/diamond.h +82 -0
  340. package/numkong/include/numkong/spatials/genoa.h +94 -0
  341. package/numkong/include/numkong/spatials/graniteamx.h +173 -0
  342. package/numkong/include/numkong/spatials/haswell.h +219 -0
  343. package/numkong/include/numkong/spatials/icelake.h +113 -0
  344. package/numkong/include/numkong/spatials/loongsonasx.h +153 -0
  345. package/numkong/include/numkong/spatials/neon.h +109 -0
  346. package/numkong/include/numkong/spatials/neonbfdot.h +60 -0
  347. package/numkong/include/numkong/spatials/neonfhm.h +92 -0
  348. package/numkong/include/numkong/spatials/neonfp8.h +111 -0
  349. package/numkong/include/numkong/spatials/neonsdot.h +143 -0
  350. package/numkong/include/numkong/spatials/powervsx.h +153 -0
  351. package/numkong/include/numkong/spatials/rvv.h +1976 -0
  352. package/numkong/include/numkong/spatials/sapphireamx.h +1149 -0
  353. package/numkong/include/numkong/spatials/serial.h +248 -0
  354. package/numkong/include/numkong/spatials/sierra.h +96 -0
  355. package/numkong/include/numkong/spatials/skylake.h +184 -0
  356. package/numkong/include/numkong/spatials/sme.h +1927 -0
  357. package/numkong/include/numkong/spatials/smef64.h +483 -0
  358. package/numkong/include/numkong/spatials/v128relaxed.h +240 -0
  359. package/numkong/include/numkong/spatials.h +3374 -0
  360. package/numkong/include/numkong/spatials.hpp +509 -0
  361. package/numkong/include/numkong/tensor.hpp +1981 -0
  362. package/numkong/include/numkong/trigonometry/README.md +184 -0
  363. package/numkong/include/numkong/trigonometry/haswell.h +653 -0
  364. package/numkong/include/numkong/trigonometry/neon.h +638 -0
  365. package/numkong/include/numkong/trigonometry/rvv.h +700 -0
  366. package/numkong/include/numkong/trigonometry/serial.h +703 -0
  367. package/numkong/include/numkong/trigonometry/skylake.h +725 -0
  368. package/numkong/include/numkong/trigonometry/v128relaxed.h +667 -0
  369. package/numkong/include/numkong/trigonometry.h +467 -0
  370. package/numkong/include/numkong/trigonometry.hpp +166 -0
  371. package/numkong/include/numkong/types.h +1695 -0
  372. package/numkong/include/numkong/types.hpp +6027 -0
  373. package/numkong/include/numkong/vector.hpp +766 -0
  374. package/numkong/javascript/@numkong-darwin-arm64/package.json +26 -0
  375. package/numkong/javascript/@numkong-darwin-x64/package.json +26 -0
  376. package/numkong/javascript/@numkong-linux-arm64/package.json +25 -0
  377. package/numkong/javascript/@numkong-linux-x64/package.json +25 -0
  378. package/numkong/javascript/@numkong-win32-arm64/package.json +25 -0
  379. package/numkong/javascript/@numkong-win32-x64/package.json +25 -0
  380. package/numkong/javascript/README.md +254 -0
  381. package/numkong/javascript/node-gyp-build.d.ts +4 -0
  382. package/numkong/javascript/numkong-browser.ts +40 -0
  383. package/numkong/javascript/numkong-wasm.ts +750 -0
  384. package/numkong/javascript/numkong.c +712 -0
  385. package/numkong/javascript/numkong.ts +613 -0
  386. package/{simsimd → numkong}/javascript/tsconfig-base.json +6 -3
  387. package/numkong/javascript/tsconfig-cjs.json +13 -0
  388. package/{simsimd → numkong}/javascript/tsconfig-esm.json +1 -1
  389. package/numkong/javascript/types.ts +784 -0
  390. package/numkong/numkong.gypi +104 -0
  391. package/numkong/package.json +108 -0
  392. package/numkong/probes/arm_neon.c +8 -0
  393. package/numkong/probes/arm_neon_bfdot.c +9 -0
  394. package/numkong/probes/arm_neon_fhm.c +9 -0
  395. package/numkong/probes/arm_neon_half.c +8 -0
  396. package/numkong/probes/arm_neon_sdot.c +9 -0
  397. package/numkong/probes/arm_neonfp8.c +9 -0
  398. package/numkong/probes/arm_sme.c +16 -0
  399. package/numkong/probes/arm_sme2.c +16 -0
  400. package/numkong/probes/arm_sme2p1.c +16 -0
  401. package/numkong/probes/arm_sme_bf16.c +16 -0
  402. package/numkong/probes/arm_sme_bi32.c +16 -0
  403. package/numkong/probes/arm_sme_f64.c +16 -0
  404. package/numkong/probes/arm_sme_fa64.c +14 -0
  405. package/numkong/probes/arm_sme_half.c +16 -0
  406. package/numkong/probes/arm_sme_lut2.c +15 -0
  407. package/numkong/probes/arm_sve.c +18 -0
  408. package/numkong/probes/arm_sve2.c +20 -0
  409. package/numkong/probes/arm_sve2p1.c +18 -0
  410. package/numkong/probes/arm_sve_bfdot.c +20 -0
  411. package/numkong/probes/arm_sve_half.c +18 -0
  412. package/numkong/probes/arm_sve_sdot.c +21 -0
  413. package/numkong/probes/loongarch_lasx.c +12 -0
  414. package/numkong/probes/power_vsx.c +12 -0
  415. package/numkong/probes/probe.js +127 -0
  416. package/numkong/probes/riscv_rvv.c +14 -0
  417. package/numkong/probes/riscv_rvv_bb.c +15 -0
  418. package/numkong/probes/riscv_rvv_bf16.c +17 -0
  419. package/numkong/probes/riscv_rvv_half.c +14 -0
  420. package/numkong/probes/wasm_v128relaxed.c +11 -0
  421. package/numkong/probes/x86_alder.c +17 -0
  422. package/numkong/probes/x86_diamond.c +17 -0
  423. package/numkong/probes/x86_genoa.c +17 -0
  424. package/numkong/probes/x86_graniteamx.c +19 -0
  425. package/numkong/probes/x86_haswell.c +11 -0
  426. package/numkong/probes/x86_icelake.c +17 -0
  427. package/numkong/probes/x86_sapphire.c +16 -0
  428. package/numkong/probes/x86_sapphireamx.c +18 -0
  429. package/numkong/probes/x86_sierra.c +17 -0
  430. package/numkong/probes/x86_skylake.c +15 -0
  431. package/numkong/probes/x86_turin.c +17 -0
  432. package/numkong/rust/README.md +698 -0
  433. package/numkong/rust/capabilities.rs +96 -0
  434. package/numkong/rust/cast.rs +314 -0
  435. package/numkong/rust/curved.rs +391 -0
  436. package/numkong/rust/each.rs +2721 -0
  437. package/numkong/rust/geospatial.rs +343 -0
  438. package/numkong/rust/matrix.rs +5424 -0
  439. package/numkong/rust/maxsim.rs +540 -0
  440. package/numkong/rust/mesh.rs +837 -0
  441. package/numkong/rust/numkong.rs +409 -0
  442. package/numkong/rust/probability.rs +272 -0
  443. package/numkong/rust/reduce.rs +1249 -0
  444. package/numkong/rust/set.rs +194 -0
  445. package/numkong/rust/sparse.rs +513 -0
  446. package/numkong/rust/spatial.rs +1815 -0
  447. package/numkong/rust/tensor.rs +7565 -0
  448. package/numkong/rust/types.rs +3666 -0
  449. package/numkong/rust/vector.rs +1899 -0
  450. package/numkong/rustfmt.toml +2 -0
  451. package/numkong/swift/Matrix.swift +1388 -0
  452. package/numkong/swift/MaxSim.swift +151 -0
  453. package/numkong/swift/NumKong.swift +283 -0
  454. package/numkong/swift/Numerics.swift +329 -0
  455. package/numkong/swift/README.md +433 -0
  456. package/numkong/swift/Scalar.swift +741 -0
  457. package/numkong/swift/Tensor.swift +209 -0
  458. package/numkong/test/README.md +315 -0
  459. package/numkong/test/playwright.config.ts +16 -0
  460. package/numkong/test/swift/Test.swift +534 -0
  461. package/numkong/test/test-browser-bundle-runner.mjs +36 -0
  462. package/numkong/test/test-browser-bundle.html +188 -0
  463. package/numkong/test/test-browser-runner.mjs +43 -0
  464. package/numkong/test/test-browser.html +305 -0
  465. package/numkong/test/test-dtypes.mjs +453 -0
  466. package/numkong/test/test-wasm.mjs +267 -0
  467. package/numkong/test/test.cpp +442 -0
  468. package/numkong/test/test.hpp +580 -0
  469. package/numkong/test/test.mjs +363 -0
  470. package/numkong/test/test_base.py +1041 -0
  471. package/numkong/test/test_cast.cpp +242 -0
  472. package/numkong/test/test_cross.hpp +551 -0
  473. package/numkong/test/test_cross.py +467 -0
  474. package/numkong/test/test_cross_amx.cpp +50 -0
  475. package/numkong/test/test_cross_arm.cpp +225 -0
  476. package/numkong/test/test_cross_blas.cpp +354 -0
  477. package/numkong/test/test_cross_loongarch.cpp +90 -0
  478. package/numkong/test/test_cross_power.cpp +73 -0
  479. package/numkong/test/test_cross_rvv.cpp +109 -0
  480. package/numkong/test/test_cross_serial.cpp +181 -0
  481. package/numkong/test/test_cross_sme.cpp +148 -0
  482. package/numkong/test/test_cross_wasm.cpp +141 -0
  483. package/numkong/test/test_cross_x86.cpp +442 -0
  484. package/numkong/test/test_curved.cpp +182 -0
  485. package/numkong/test/test_curved.py +207 -0
  486. package/numkong/test/test_dot.cpp +353 -0
  487. package/numkong/test/test_dot.py +296 -0
  488. package/numkong/test/test_each.cpp +437 -0
  489. package/numkong/test/test_each.py +756 -0
  490. package/numkong/test/test_geospatial.cpp +155 -0
  491. package/numkong/test/test_geospatial.py +241 -0
  492. package/numkong/test/test_maxsim.cpp +138 -0
  493. package/numkong/test/test_maxsim.py +209 -0
  494. package/numkong/test/test_mesh.cpp +203 -0
  495. package/numkong/test/test_mesh.py +394 -0
  496. package/numkong/test/test_probability.cpp +136 -0
  497. package/numkong/test/test_probability.py +166 -0
  498. package/numkong/test/test_reduce.cpp +563 -0
  499. package/numkong/test/test_reduce.py +781 -0
  500. package/numkong/test/test_set.cpp +151 -0
  501. package/numkong/test/test_set.py +120 -0
  502. package/numkong/test/test_similarities.py +579 -0
  503. package/numkong/test/test_sparse.cpp +121 -0
  504. package/numkong/test/test_sparse.py +118 -0
  505. package/numkong/test/test_spatial.cpp +518 -0
  506. package/numkong/test/test_spatial.py +269 -0
  507. package/numkong/test/test_tensor.cpp +884 -0
  508. package/numkong/test/test_tensor.py +1417 -0
  509. package/numkong/test/test_trigonometry.cpp +156 -0
  510. package/numkong/test/test_trigonometry.py +180 -0
  511. package/package.json +7 -8
  512. package/prebuilds/darwin-arm64+x64/usearch.node +0 -0
  513. package/prebuilds/linux-arm64/usearch.node +0 -0
  514. package/prebuilds/linux-x64/usearch.node +0 -0
  515. package/fp16/CMakeLists.txt +0 -176
  516. package/fp16/LICENSE +0 -11
  517. package/fp16/README.md +0 -20
  518. package/fp16/bench/alt-element.cc +0 -89
  519. package/fp16/bench/from-alt-array.cc +0 -175
  520. package/fp16/bench/from-ieee-array.cc +0 -399
  521. package/fp16/bench/ieee-element.cc +0 -272
  522. package/fp16/bench/to-alt-array.cc +0 -91
  523. package/fp16/bench/to-ieee-array.cc +0 -303
  524. package/fp16/cmake/DownloadGoogleBenchmark.cmake +0 -15
  525. package/fp16/cmake/DownloadGoogleTest.cmake +0 -15
  526. package/fp16/cmake/DownloadPSimd.cmake +0 -15
  527. package/fp16/configure.py +0 -65
  528. package/fp16/confu.yaml +0 -8
  529. package/fp16/include/fp16/__init__.py +0 -0
  530. package/fp16/include/fp16/avx.py +0 -50
  531. package/fp16/include/fp16/avx2.py +0 -53
  532. package/fp16/include/fp16/bitcasts.h +0 -92
  533. package/fp16/include/fp16/fp16.h +0 -451
  534. package/fp16/include/fp16/psimd.h +0 -131
  535. package/fp16/include/fp16.h +0 -11
  536. package/fp16/jni/Android.mk +0 -6
  537. package/fp16/jni/Application.mk +0 -4
  538. package/fp16/test/alt-from-fp32-value.cc +0 -498
  539. package/fp16/test/alt-to-fp32-bits.cc +0 -263
  540. package/fp16/test/alt-to-fp32-psimd.cc +0 -145
  541. package/fp16/test/alt-to-fp32-value.cc +0 -348
  542. package/fp16/test/alt-to-fp32x2-psimd.cc +0 -245
  543. package/fp16/test/bitcasts.cc +0 -56
  544. package/fp16/test/ieee-from-fp32-value.cc +0 -523
  545. package/fp16/test/ieee-to-fp32-bits.cc +0 -333
  546. package/fp16/test/ieee-to-fp32-psimd.cc +0 -312
  547. package/fp16/test/ieee-to-fp32-value.cc +0 -420
  548. package/fp16/test/ieee-to-fp32x2-psimd.cc +0 -541
  549. package/fp16/test/peachpy/alt-xmm-to-fp32-xmm-avx.cc +0 -96
  550. package/fp16/test/peachpy/alt-xmm-to-fp32-ymm-avx2.cc +0 -96
  551. package/fp16/test/peachpy/stubs.py +0 -38
  552. package/fp16/test/tables.cc +0 -530
  553. package/fp16/test/tables.h +0 -13
  554. package/fp16/third-party/THHalf.h +0 -92
  555. package/fp16/third-party/eigen-half.h +0 -170
  556. package/fp16/third-party/float16-compressor.h +0 -80
  557. package/fp16/third-party/half.hpp +0 -2916
  558. package/fp16/third-party/npy-halffloat.h +0 -328
  559. package/simsimd/.git-blame-ignore-revs +0 -2
  560. package/simsimd/CONTRIBUTING.md +0 -321
  561. package/simsimd/Cargo.toml +0 -49
  562. package/simsimd/MANIFEST.in +0 -4
  563. package/simsimd/Package.swift +0 -28
  564. package/simsimd/README.md +0 -1493
  565. package/simsimd/binding.gyp +0 -35
  566. package/simsimd/build.rs +0 -70
  567. package/simsimd/c/lib.c +0 -374
  568. package/simsimd/include/module.modulemap +0 -4
  569. package/simsimd/include/simsimd/binary.h +0 -486
  570. package/simsimd/include/simsimd/curved.h +0 -1541
  571. package/simsimd/include/simsimd/dot.h +0 -1853
  572. package/simsimd/include/simsimd/elementwise.h +0 -2465
  573. package/simsimd/include/simsimd/geospatial.h +0 -43
  574. package/simsimd/include/simsimd/mesh.h +0 -69
  575. package/simsimd/include/simsimd/probability.h +0 -606
  576. package/simsimd/include/simsimd/simsimd.h +0 -2567
  577. package/simsimd/include/simsimd/sparse.h +0 -1384
  578. package/simsimd/include/simsimd/spatial.h +0 -2335
  579. package/simsimd/include/simsimd/types.h +0 -666
  580. package/simsimd/javascript/fallback.ts +0 -233
  581. package/simsimd/javascript/lib.c +0 -125
  582. package/simsimd/javascript/node-gyp-build.d.ts +0 -1
  583. package/simsimd/javascript/simsimd.ts +0 -179
  584. package/simsimd/javascript/tsconfig-cjs.json +0 -8
  585. package/simsimd/package-lock.json +0 -1761
  586. package/simsimd/package.json +0 -61
  587. package/simsimd/rust/lib.rs +0 -1821
  588. package/simsimd/scripts/bench.cxx +0 -1170
  589. package/simsimd/scripts/bench.ipynb +0 -187
  590. package/simsimd/scripts/bench.js +0 -127
  591. package/simsimd/scripts/bench.rs +0 -876
  592. package/simsimd/scripts/bench_vectors.py +0 -734
  593. package/simsimd/scripts/bench_vectors_live.py +0 -213
  594. package/simsimd/scripts/test.c +0 -187
  595. package/simsimd/scripts/test.mjs +0 -220
  596. package/simsimd/scripts/test.py +0 -1505
  597. package/simsimd/swift/SimSIMD.swift +0 -149
  598. package/simsimd/swift/Test.swift +0 -128
  599. /package/{simsimd → numkong}/CODE_OF_CONDUCT.md +0 -0
  600. /package/{simsimd → numkong}/LICENSE +0 -0
  601. /package/{simsimd → numkong}/javascript/dist-package-cjs.json +0 -0
  602. /package/{simsimd → numkong}/javascript/dist-package-esm.json +0 -0
@@ -0,0 +1,636 @@
1
+ /**
2
+ * @brief Alder Lake (AVX2+VNNI) implementations for the redesigned reduction API (moments).
3
+ * @file include/numkong/reduce/alder.h
4
+ * @author Ash Vardanian
5
+ * @date March 4, 2026
6
+ *
7
+ * @sa include/numkong/reduce.h
8
+ *
9
+ * Uses AVX-VNNI (256-bit) for efficient widening dot-products:
10
+ * - `_mm256_dpwssd_epi32`: i16 × i16 → i32 accumulation (AVXVNNI, used for i16 and e3m2)
11
+ * - `_mm256_sad_epu8` + `_mm256_madd_epi16`: pure AVX2 SAD/MADD (used for u8)
12
+ * - `_mm256_cvtepu16_epi32` + `_mm256_mullo_epi32`: pure AVX2 (used for u16)
13
+ */
14
+ #ifndef NK_REDUCE_ALDER_H
15
+ #define NK_REDUCE_ALDER_H
16
+
17
+ #if NK_TARGET_X8664_
18
+ #if NK_TARGET_ALDER
19
+
20
+ #include "numkong/types.h"
21
+ #include "numkong/dot/alder.h" // VEX compat macros (_mm256_dpwssd_avx_epi32)
22
+ #include "numkong/reduce/serial.h"
23
+ #include "numkong/reduce/haswell.h" // `nk_reduce_add_i32x8_haswell_`
24
+
25
+ #if defined(__cplusplus)
26
+ extern "C" {
27
+ #endif
28
+
29
+ #if defined(__clang__)
30
+ #pragma clang attribute push(__attribute__((target("avx2,f16c,fma,bmi,bmi2,avxvnni"))), apply_to = function)
31
+ #elif defined(__GNUC__)
32
+ #pragma GCC push_options
33
+ #pragma GCC target("avx2", "f16c", "fma", "bmi", "bmi2", "avxvnni")
34
+ #endif
35
+
36
+ NK_INTERNAL void nk_reduce_moments_u8_alder_contiguous_( //
37
+ nk_u8_t const *data, nk_size_t count, //
38
+ nk_u64_t *sum_ptr, nk_u64_t *sumsq_ptr) {
39
+ __m256i zero_u8x32 = _mm256_setzero_si256();
40
+ __m256i sum_u64x4 = _mm256_setzero_si256();
41
+ __m256i sumsq_low_i32x8 = _mm256_setzero_si256();
42
+ __m256i sumsq_high_i32x8 = _mm256_setzero_si256();
43
+ nk_size_t idx = 0;
44
+ for (; idx + 32 <= count; idx += 32) {
45
+ __m256i data_u8x32 = _mm256_loadu_si256((__m256i const *)(data + idx));
46
+ sum_u64x4 = _mm256_add_epi64(sum_u64x4, _mm256_sad_epu8(data_u8x32, zero_u8x32));
47
+ __m256i low_u16x16 = _mm256_cvtepu8_epi16(_mm256_castsi256_si128(data_u8x32));
48
+ __m256i high_u16x16 = _mm256_cvtepu8_epi16(_mm256_extracti128_si256(data_u8x32, 1));
49
+ sumsq_low_i32x8 = _mm256_add_epi32(sumsq_low_i32x8, _mm256_madd_epi16(low_u16x16, low_u16x16));
50
+ sumsq_high_i32x8 = _mm256_add_epi32(sumsq_high_i32x8, _mm256_madd_epi16(high_u16x16, high_u16x16));
51
+ }
52
+
53
+ // Handle tail with partial load
54
+ nk_size_t remaining = count - idx;
55
+ if (remaining > 0) {
56
+ nk_b256_vec_t tail_vec;
57
+ nk_partial_load_b8x32_serial_(data + idx, &tail_vec, remaining);
58
+ __m256i data_u8x32 = tail_vec.ymm;
59
+ sum_u64x4 = _mm256_add_epi64(sum_u64x4, _mm256_sad_epu8(data_u8x32, zero_u8x32));
60
+ __m256i low_u16x16 = _mm256_cvtepu8_epi16(_mm256_castsi256_si128(data_u8x32));
61
+ __m256i high_u16x16 = _mm256_cvtepu8_epi16(_mm256_extracti128_si256(data_u8x32, 1));
62
+ sumsq_low_i32x8 = _mm256_add_epi32(sumsq_low_i32x8, _mm256_madd_epi16(low_u16x16, low_u16x16));
63
+ sumsq_high_i32x8 = _mm256_add_epi32(sumsq_high_i32x8, _mm256_madd_epi16(high_u16x16, high_u16x16));
64
+ }
65
+
66
+ sumsq_low_i32x8 = _mm256_add_epi32(sumsq_low_i32x8, sumsq_high_i32x8);
67
+ __m256i sumsq_u64x4 = _mm256_cvtepu32_epi64(_mm256_castsi256_si128(sumsq_low_i32x8));
68
+ sumsq_u64x4 = _mm256_add_epi64(sumsq_u64x4, _mm256_cvtepu32_epi64(_mm256_extracti128_si256(sumsq_low_i32x8, 1)));
69
+ *sum_ptr = (nk_u64_t)nk_reduce_add_i64x4_haswell_(sum_u64x4);
70
+ *sumsq_ptr = (nk_u64_t)nk_reduce_add_i64x4_haswell_(sumsq_u64x4);
71
+ }
72
+
73
+ NK_INTERNAL void nk_reduce_moments_u8_alder_strided_( //
74
+ nk_u8_t const *data, nk_size_t count, nk_size_t stride_elements, //
75
+ nk_u64_t *sum_ptr, nk_u64_t *sumsq_ptr) {
76
+ __m256i stride_mask_u8x32 = nk_stride_blend_u1x32_(stride_elements);
77
+ __m256i zero_u8x32 = _mm256_setzero_si256();
78
+ __m256i sum_u64x4 = _mm256_setzero_si256();
79
+ __m256i sumsq_low_i32x8 = _mm256_setzero_si256();
80
+ __m256i sumsq_high_i32x8 = _mm256_setzero_si256();
81
+ nk_size_t idx_scalars = 0;
82
+ nk_size_t total_scalars = count * stride_elements;
83
+ nk_size_t step = nk_size_round_up_to_multiple_(32, stride_elements);
84
+ for (; idx_scalars + stride_elements + 31 <= total_scalars; idx_scalars += step) {
85
+ __m256i data_u8x32 = _mm256_loadu_si256((__m256i const *)(data + idx_scalars));
86
+ data_u8x32 = _mm256_and_si256(data_u8x32, stride_mask_u8x32);
87
+ sum_u64x4 = _mm256_add_epi64(sum_u64x4, _mm256_sad_epu8(data_u8x32, zero_u8x32));
88
+ __m256i low_u16x16 = _mm256_cvtepu8_epi16(_mm256_castsi256_si128(data_u8x32));
89
+ __m256i high_u16x16 = _mm256_cvtepu8_epi16(_mm256_extracti128_si256(data_u8x32, 1));
90
+ sumsq_low_i32x8 = _mm256_add_epi32(sumsq_low_i32x8, _mm256_madd_epi16(low_u16x16, low_u16x16));
91
+ sumsq_high_i32x8 = _mm256_add_epi32(sumsq_high_i32x8, _mm256_madd_epi16(high_u16x16, high_u16x16));
92
+ }
93
+
94
+ sumsq_low_i32x8 = _mm256_add_epi32(sumsq_low_i32x8, sumsq_high_i32x8);
95
+ __m256i sumsq_u64x4 = _mm256_cvtepu32_epi64(_mm256_castsi256_si128(sumsq_low_i32x8));
96
+ sumsq_u64x4 = _mm256_add_epi64(sumsq_u64x4, _mm256_cvtepu32_epi64(_mm256_extracti128_si256(sumsq_low_i32x8, 1)));
97
+ nk_u64_t sum = (nk_u64_t)nk_reduce_add_i64x4_haswell_(sum_u64x4);
98
+ nk_u64_t sumsq = (nk_u64_t)nk_reduce_add_i64x4_haswell_(sumsq_u64x4);
99
+
100
+ // Scalar tail for remaining elements
101
+ nk_u8_t const *ptr = data + idx_scalars;
102
+ nk_size_t remaining_elements = count - idx_scalars / stride_elements;
103
+ for (nk_size_t i = 0; i < remaining_elements; ++i, ptr += stride_elements) {
104
+ nk_u64_t val = (nk_u64_t)*ptr;
105
+ sum += val, sumsq += val * val;
106
+ }
107
+ *sum_ptr = sum, *sumsq_ptr = sumsq;
108
+ }
109
+
110
+ NK_PUBLIC void nk_reduce_moments_u8_alder( //
111
+ nk_u8_t const *data, nk_size_t count, nk_size_t stride_bytes, //
112
+ nk_u64_t *sum_ptr, nk_u64_t *sumsq_ptr) {
113
+ nk_size_t stride_elements = stride_bytes / sizeof(nk_u8_t);
114
+ int aligned = (stride_bytes % sizeof(nk_u8_t) == 0);
115
+ if (count == 0) *sum_ptr = 0, *sumsq_ptr = 0;
116
+ else if (!aligned) nk_reduce_moments_u8_serial(data, count, stride_bytes, sum_ptr, sumsq_ptr);
117
+ else if (count > (nk_size_t)16384 * 32) {
118
+ nk_size_t left_count = count / 2;
119
+ nk_u64_t left_sum, left_sumsq, right_sum, right_sumsq;
120
+ nk_reduce_moments_u8_alder(data, left_count, stride_bytes, &left_sum, &left_sumsq);
121
+ nk_reduce_moments_u8_alder(data + left_count * stride_elements, count - left_count, stride_bytes, &right_sum,
122
+ &right_sumsq);
123
+ *sum_ptr = nk_u64_saturating_add_serial(left_sum, right_sum);
124
+ *sumsq_ptr = nk_u64_saturating_add_serial(left_sumsq, right_sumsq);
125
+ }
126
+ else if (stride_elements == 1) nk_reduce_moments_u8_alder_contiguous_(data, count, sum_ptr, sumsq_ptr);
127
+ else if (stride_elements <= 8)
128
+ nk_reduce_moments_u8_alder_strided_(data, count, stride_elements, sum_ptr, sumsq_ptr);
129
+ else nk_reduce_moments_u8_serial(data, count, stride_bytes, sum_ptr, sumsq_ptr);
130
+ }
131
+
132
+ NK_INTERNAL void nk_reduce_moments_i16_alder_contiguous_( //
133
+ nk_i16_t const *data, nk_size_t count, //
134
+ nk_i64_t *sum_ptr, nk_u64_t *sumsq_ptr) {
135
+ __m256i ones_i16x16 = _mm256_set1_epi16(1);
136
+ __m256i sum_i64x4 = _mm256_setzero_si256();
137
+ __m256i sumsq_i64x4 = _mm256_setzero_si256();
138
+ nk_size_t idx = 0;
139
+ for (; idx + 16 <= count; idx += 16) {
140
+ __m256i data_i16x16 = _mm256_loadu_si256((__m256i const *)(data + idx));
141
+ __m256i sum_i32x8 = _mm256_dpwssd_avx_epi32(_mm256_setzero_si256(), data_i16x16, ones_i16x16);
142
+ sum_i64x4 = _mm256_add_epi64(sum_i64x4, _mm256_cvtepi32_epi64(_mm256_castsi256_si128(sum_i32x8)));
143
+ sum_i64x4 = _mm256_add_epi64(sum_i64x4, _mm256_cvtepi32_epi64(_mm256_extracti128_si256(sum_i32x8, 1)));
144
+ __m256i sq_i32x8 = _mm256_dpwssd_avx_epi32(_mm256_setzero_si256(), data_i16x16, data_i16x16);
145
+ sumsq_i64x4 = _mm256_add_epi64(sumsq_i64x4, _mm256_cvtepi32_epi64(_mm256_castsi256_si128(sq_i32x8)));
146
+ sumsq_i64x4 = _mm256_add_epi64(sumsq_i64x4, _mm256_cvtepi32_epi64(_mm256_extracti128_si256(sq_i32x8, 1)));
147
+ }
148
+ nk_size_t remaining = count - idx;
149
+ if (remaining > 0) {
150
+ nk_b256_vec_t tail_vec;
151
+ nk_partial_load_b16x16_serial_(data + idx, &tail_vec, remaining);
152
+ __m256i data_i16x16 = tail_vec.ymm;
153
+ __m256i sum_i32x8 = _mm256_dpwssd_avx_epi32(_mm256_setzero_si256(), data_i16x16, ones_i16x16);
154
+ sum_i64x4 = _mm256_add_epi64(sum_i64x4, _mm256_cvtepi32_epi64(_mm256_castsi256_si128(sum_i32x8)));
155
+ sum_i64x4 = _mm256_add_epi64(sum_i64x4, _mm256_cvtepi32_epi64(_mm256_extracti128_si256(sum_i32x8, 1)));
156
+ __m256i sq_i32x8 = _mm256_dpwssd_avx_epi32(_mm256_setzero_si256(), data_i16x16, data_i16x16);
157
+ sumsq_i64x4 = _mm256_add_epi64(sumsq_i64x4, _mm256_cvtepi32_epi64(_mm256_castsi256_si128(sq_i32x8)));
158
+ sumsq_i64x4 = _mm256_add_epi64(sumsq_i64x4, _mm256_cvtepi32_epi64(_mm256_extracti128_si256(sq_i32x8, 1)));
159
+ }
160
+ *sum_ptr = (nk_i64_t)nk_reduce_add_i64x4_haswell_(sum_i64x4);
161
+ *sumsq_ptr = (nk_u64_t)nk_reduce_add_i64x4_haswell_(sumsq_i64x4);
162
+ }
163
+
164
+ NK_INTERNAL void nk_reduce_moments_i16_alder_strided_( //
165
+ nk_i16_t const *data, nk_size_t count, nk_size_t stride_elements, //
166
+ nk_i64_t *sum_ptr, nk_u64_t *sumsq_ptr) {
167
+ __m256i stride_mask_i16x16 = nk_stride_blend_b16x16_(stride_elements);
168
+ __m256i ones_i16x16 = _mm256_set1_epi16(1);
169
+ __m256i sum_i64x4 = _mm256_setzero_si256();
170
+ __m256i sumsq_i64x4 = _mm256_setzero_si256();
171
+ nk_size_t idx_scalars = 0;
172
+ nk_size_t total_scalars = count * stride_elements;
173
+ nk_size_t step = nk_size_round_up_to_multiple_(16, stride_elements);
174
+ for (; idx_scalars + stride_elements + 15 <= total_scalars; idx_scalars += step) {
175
+ __m256i data_i16x16 = _mm256_loadu_si256((__m256i const *)(data + idx_scalars));
176
+ data_i16x16 = _mm256_and_si256(data_i16x16, stride_mask_i16x16);
177
+ __m256i sum_i32x8 = _mm256_dpwssd_avx_epi32(_mm256_setzero_si256(), data_i16x16, ones_i16x16);
178
+ sum_i64x4 = _mm256_add_epi64(sum_i64x4, _mm256_cvtepi32_epi64(_mm256_castsi256_si128(sum_i32x8)));
179
+ sum_i64x4 = _mm256_add_epi64(sum_i64x4, _mm256_cvtepi32_epi64(_mm256_extracti128_si256(sum_i32x8, 1)));
180
+ __m256i sq_i32x8 = _mm256_dpwssd_avx_epi32(_mm256_setzero_si256(), data_i16x16, data_i16x16);
181
+ sumsq_i64x4 = _mm256_add_epi64(sumsq_i64x4, _mm256_cvtepi32_epi64(_mm256_castsi256_si128(sq_i32x8)));
182
+ sumsq_i64x4 = _mm256_add_epi64(sumsq_i64x4, _mm256_cvtepi32_epi64(_mm256_extracti128_si256(sq_i32x8, 1)));
183
+ }
184
+ nk_i64_t sum = (nk_i64_t)nk_reduce_add_i64x4_haswell_(sum_i64x4);
185
+ nk_u64_t sumsq = (nk_u64_t)nk_reduce_add_i64x4_haswell_(sumsq_i64x4);
186
+ nk_i16_t const *ptr = data + idx_scalars;
187
+ nk_size_t remaining = count - idx_scalars / stride_elements;
188
+ for (nk_size_t i = 0; i < remaining; ++i, ptr += stride_elements) {
189
+ nk_i64_t val = (nk_i64_t)*ptr;
190
+ sum += val, sumsq += (nk_u64_t)(val * val);
191
+ }
192
+ *sum_ptr = sum, *sumsq_ptr = sumsq;
193
+ }
194
+
195
+ NK_PUBLIC void nk_reduce_moments_i16_alder( //
196
+ nk_i16_t const *data, nk_size_t count, nk_size_t stride_bytes, //
197
+ nk_i64_t *sum_ptr, nk_u64_t *sumsq_ptr) {
198
+ nk_size_t stride_elements = stride_bytes / sizeof(nk_i16_t);
199
+ int aligned = (stride_bytes % sizeof(nk_i16_t) == 0);
200
+ if (count == 0) *sum_ptr = 0, *sumsq_ptr = 0;
201
+ else if (!aligned) nk_reduce_moments_i16_serial(data, count, stride_bytes, sum_ptr, sumsq_ptr);
202
+ else if (count > (nk_size_t)(NK_U16_MAX + 1) * 16) {
203
+ nk_size_t left_count = count / 2;
204
+ nk_i64_t left_sum, right_sum;
205
+ nk_u64_t left_sumsq, right_sumsq;
206
+ nk_reduce_moments_i16_alder(data, left_count, stride_bytes, &left_sum, &left_sumsq);
207
+ nk_reduce_moments_i16_alder(data + left_count * stride_elements, count - left_count, stride_bytes, &right_sum,
208
+ &right_sumsq);
209
+ *sum_ptr = nk_i64_saturating_add_serial(left_sum, right_sum);
210
+ *sumsq_ptr = nk_u64_saturating_add_serial(left_sumsq, right_sumsq);
211
+ }
212
+ else if (stride_elements == 1) nk_reduce_moments_i16_alder_contiguous_(data, count, sum_ptr, sumsq_ptr);
213
+ else if (stride_elements <= 8)
214
+ nk_reduce_moments_i16_alder_strided_(data, count, stride_elements, sum_ptr, sumsq_ptr);
215
+ else nk_reduce_moments_i16_serial(data, count, stride_bytes, sum_ptr, sumsq_ptr);
216
+ }
217
+
218
+ NK_INTERNAL void nk_reduce_moments_u16_alder_contiguous_( //
219
+ nk_u16_t const *data, nk_size_t count, //
220
+ nk_u64_t *sum_ptr, nk_u64_t *sumsq_ptr) {
221
+ __m256i sum_u32x8 = _mm256_setzero_si256();
222
+ __m256i sumsq_u64x4 = _mm256_setzero_si256();
223
+ nk_size_t idx = 0;
224
+ for (; idx + 8 <= count; idx += 8) {
225
+ __m256i data_u32x8 = _mm256_cvtepu16_epi32(_mm_loadu_si128((__m128i const *)(data + idx)));
226
+ sum_u32x8 = _mm256_add_epi32(sum_u32x8, data_u32x8);
227
+ __m256i sq_u32x8 = _mm256_mullo_epi32(data_u32x8, data_u32x8);
228
+ sumsq_u64x4 = _mm256_add_epi64(sumsq_u64x4, _mm256_cvtepu32_epi64(_mm256_castsi256_si128(sq_u32x8)));
229
+ sumsq_u64x4 = _mm256_add_epi64(sumsq_u64x4, _mm256_cvtepu32_epi64(_mm256_extracti128_si256(sq_u32x8, 1)));
230
+ }
231
+
232
+ // Handle tail with partial load
233
+ nk_size_t remaining = count - idx;
234
+ if (remaining > 0) {
235
+ nk_b256_vec_t tail_vec;
236
+ nk_partial_load_b16x16_serial_(data + idx, &tail_vec, remaining);
237
+ __m256i data_u32x8 = _mm256_cvtepu16_epi32(_mm256_castsi256_si128(tail_vec.ymm));
238
+ sum_u32x8 = _mm256_add_epi32(sum_u32x8, data_u32x8);
239
+ __m256i sq_u32x8 = _mm256_mullo_epi32(data_u32x8, data_u32x8);
240
+ sumsq_u64x4 = _mm256_add_epi64(sumsq_u64x4, _mm256_cvtepu32_epi64(_mm256_castsi256_si128(sq_u32x8)));
241
+ sumsq_u64x4 = _mm256_add_epi64(sumsq_u64x4, _mm256_cvtepu32_epi64(_mm256_extracti128_si256(sq_u32x8, 1)));
242
+ }
243
+
244
+ __m256i sum_u64x4 = _mm256_add_epi64( //
245
+ _mm256_cvtepu32_epi64(_mm256_castsi256_si128(sum_u32x8)), //
246
+ _mm256_cvtepu32_epi64(_mm256_extracti128_si256(sum_u32x8, 1))); //
247
+ *sum_ptr = (nk_u64_t)nk_reduce_add_i64x4_haswell_(sum_u64x4);
248
+ *sumsq_ptr = (nk_u64_t)nk_reduce_add_i64x4_haswell_(sumsq_u64x4);
249
+ }
250
+
251
+ NK_INTERNAL void nk_reduce_moments_u16_alder_strided_( //
252
+ nk_u16_t const *data, nk_size_t count, nk_size_t stride_elements, //
253
+ nk_u64_t *sum_ptr, nk_u64_t *sumsq_ptr) {
254
+ __m256i stride_mask_i16x16 = nk_stride_blend_b16x16_(stride_elements);
255
+ __m256i sum_u32x8 = _mm256_setzero_si256();
256
+ __m256i sumsq_u64x4 = _mm256_setzero_si256();
257
+ nk_size_t idx_scalars = 0;
258
+ nk_size_t total_scalars = count * stride_elements;
259
+ nk_size_t step = nk_size_round_up_to_multiple_(16, stride_elements);
260
+ for (; idx_scalars + stride_elements + 15 <= total_scalars; idx_scalars += step) {
261
+ __m256i data_u16x16 = _mm256_loadu_si256((__m256i const *)(data + idx_scalars));
262
+ data_u16x16 = _mm256_and_si256(data_u16x16, stride_mask_i16x16);
263
+ __m256i low_u32x8 = _mm256_cvtepu16_epi32(_mm256_castsi256_si128(data_u16x16));
264
+ __m256i high_u32x8 = _mm256_cvtepu16_epi32(_mm256_extracti128_si256(data_u16x16, 1));
265
+ sum_u32x8 = _mm256_add_epi32(sum_u32x8, low_u32x8);
266
+ sum_u32x8 = _mm256_add_epi32(sum_u32x8, high_u32x8);
267
+ __m256i low_sq_u32x8 = _mm256_mullo_epi32(low_u32x8, low_u32x8);
268
+ __m256i high_sq_u32x8 = _mm256_mullo_epi32(high_u32x8, high_u32x8);
269
+ sumsq_u64x4 = _mm256_add_epi64(sumsq_u64x4, _mm256_cvtepu32_epi64(_mm256_castsi256_si128(low_sq_u32x8)));
270
+ sumsq_u64x4 = _mm256_add_epi64(sumsq_u64x4, _mm256_cvtepu32_epi64(_mm256_extracti128_si256(low_sq_u32x8, 1)));
271
+ sumsq_u64x4 = _mm256_add_epi64(sumsq_u64x4, _mm256_cvtepu32_epi64(_mm256_castsi256_si128(high_sq_u32x8)));
272
+ sumsq_u64x4 = _mm256_add_epi64(sumsq_u64x4, _mm256_cvtepu32_epi64(_mm256_extracti128_si256(high_sq_u32x8, 1)));
273
+ }
274
+
275
+ __m256i sum_u64x4 = _mm256_add_epi64( //
276
+ _mm256_cvtepu32_epi64(_mm256_castsi256_si128(sum_u32x8)), //
277
+ _mm256_cvtepu32_epi64(_mm256_extracti128_si256(sum_u32x8, 1))); //
278
+ nk_u64_t sum = (nk_u64_t)nk_reduce_add_i64x4_haswell_(sum_u64x4);
279
+ nk_u64_t sumsq = (nk_u64_t)nk_reduce_add_i64x4_haswell_(sumsq_u64x4);
280
+
281
+ // Scalar tail for remaining elements
282
+ nk_u16_t const *ptr = data + idx_scalars;
283
+ nk_size_t remaining = count - idx_scalars / stride_elements;
284
+ for (nk_size_t i = 0; i < remaining; ++i, ptr += stride_elements) {
285
+ nk_u64_t val = (nk_u64_t)*ptr;
286
+ sum += val, sumsq += val * val;
287
+ }
288
+ *sum_ptr = sum, *sumsq_ptr = sumsq;
289
+ }
290
+
291
+ NK_PUBLIC void nk_reduce_moments_u16_alder( //
292
+ nk_u16_t const *data, nk_size_t count, nk_size_t stride_bytes, //
293
+ nk_u64_t *sum_ptr, nk_u64_t *sumsq_ptr) {
294
+ nk_size_t stride_elements = stride_bytes / sizeof(nk_u16_t);
295
+ int aligned = (stride_bytes % sizeof(nk_u16_t) == 0);
296
+ if (count == 0) *sum_ptr = 0, *sumsq_ptr = 0;
297
+ else if (!aligned) nk_reduce_moments_u16_serial(data, count, stride_bytes, sum_ptr, sumsq_ptr);
298
+ else if (count > (nk_size_t)(NK_U16_MAX + 1) * 8) {
299
+ nk_size_t left_count = count / 2;
300
+ nk_u64_t left_sum, left_sumsq, right_sum, right_sumsq;
301
+ nk_reduce_moments_u16_alder(data, left_count, stride_bytes, &left_sum, &left_sumsq);
302
+ nk_reduce_moments_u16_alder(data + left_count * stride_elements, count - left_count, stride_bytes, &right_sum,
303
+ &right_sumsq);
304
+ *sum_ptr = nk_u64_saturating_add_serial(left_sum, right_sum);
305
+ *sumsq_ptr = nk_u64_saturating_add_serial(left_sumsq, right_sumsq);
306
+ }
307
+ else if (stride_elements == 1) nk_reduce_moments_u16_alder_contiguous_(data, count, sum_ptr, sumsq_ptr);
308
+ else if (stride_elements <= 8)
309
+ nk_reduce_moments_u16_alder_strided_(data, count, stride_elements, sum_ptr, sumsq_ptr);
310
+ else nk_reduce_moments_u16_serial(data, count, stride_bytes, sum_ptr, sumsq_ptr);
311
+ }
312
+
313
+ /**
314
+ * @section e3m2 moments via integer VNNI (dpwssd)
315
+ *
316
+ * Every e3m2 value × 16 is an exact integer in [-448, +448] (i16 range).
317
+ * We use dual-VPSHUFB for the low byte + threshold compare for the high byte,
318
+ * then UNPACKLO/HI to form unsigned i16, apply sign via `_mm256_sign_epi16`,
319
+ * and accumulate with `_mm256_dpwssd_epi32` (signed i16 × signed i16 → i32).
320
+ * Final: sum = i32_sum / 16, sumsq = i32_sumsq / 256.
321
+ */
322
+ NK_INTERNAL void nk_reduce_moments_e3m2_alder_contiguous_( //
323
+ nk_e3m2_t const *data, nk_size_t count, //
324
+ nk_f32_t *sum_ptr, nk_f32_t *sumsq_ptr) {
325
+ __m256i const lut_low_byte_first_u8x32 = _mm256_set_epi8( //
326
+ 28, 24, 20, 16, 14, 12, 10, 8, 7, 6, 5, 4, 3, 2, 1, 0, //
327
+ 28, 24, 20, 16, 14, 12, 10, 8, 7, 6, 5, 4, 3, 2, 1, 0); //
328
+ __m256i const lut_low_byte_second_u8x32 = _mm256_set_epi8( //
329
+ (char)192, (char)128, 64, 0, (char)224, (char)192, (char)160, (char)128, 112, 96, 80, 64, 56, 48, 40, 32, //
330
+ (char)192, (char)128, 64, 0, (char)224, (char)192, (char)160, (char)128, 112, 96, 80, 64, 56, 48, 40, 32); //
331
+ __m256i const nibble_mask_u8x32 = _mm256_set1_epi8(0x0F);
332
+ __m256i const magnitude_mask_u8x32 = _mm256_set1_epi8(0x1F);
333
+ __m256i const half_select_u8x32 = _mm256_set1_epi8(0x10);
334
+ __m256i const sign_mask_u8x32 = _mm256_set1_epi8(0x20);
335
+ __m256i const high_threshold_u8x32 = _mm256_set1_epi8(27);
336
+ __m256i const ones_u8x32 = _mm256_set1_epi8(1);
337
+ __m256i const ones_i16x16 = _mm256_set1_epi16(1);
338
+ __m256i sum_i32x8 = _mm256_setzero_si256();
339
+ __m256i sumsq_i32x8 = _mm256_setzero_si256();
340
+ nk_size_t idx = 0;
341
+ for (; idx + 32 <= count; idx += 32) {
342
+ __m256i data_u8x32 = _mm256_loadu_si256((__m256i const *)(data + idx));
343
+ __m256i magnitude_u8x32 = _mm256_and_si256(data_u8x32, magnitude_mask_u8x32);
344
+ __m256i shuffle_idx_u8x32 = _mm256_and_si256(magnitude_u8x32, nibble_mask_u8x32);
345
+ __m256i upper_select_u8x32 = _mm256_cmpeq_epi8(_mm256_and_si256(magnitude_u8x32, half_select_u8x32),
346
+ half_select_u8x32);
347
+ __m256i low_bytes_u8x32 = _mm256_blendv_epi8(_mm256_shuffle_epi8(lut_low_byte_first_u8x32, shuffle_idx_u8x32),
348
+ _mm256_shuffle_epi8(lut_low_byte_second_u8x32, shuffle_idx_u8x32),
349
+ upper_select_u8x32);
350
+ __m256i high_bytes_u8x32 = _mm256_and_si256(_mm256_cmpgt_epi8(magnitude_u8x32, high_threshold_u8x32),
351
+ ones_u8x32);
352
+ __m256i unsigned_low_i16x16 = _mm256_unpacklo_epi8(low_bytes_u8x32, high_bytes_u8x32);
353
+ __m256i unsigned_high_i16x16 = _mm256_unpackhi_epi8(low_bytes_u8x32, high_bytes_u8x32);
354
+ // Sign handling: extract sign bit, widen to i16, create +1/-1, apply via VPSIGNW
355
+ __m256i negate_mask_u8x32 = _mm256_cmpeq_epi8(_mm256_and_si256(data_u8x32, sign_mask_u8x32), sign_mask_u8x32);
356
+ __m256i negate_low_i16x16 = _mm256_unpacklo_epi8(negate_mask_u8x32, negate_mask_u8x32);
357
+ __m256i negate_high_i16x16 = _mm256_unpackhi_epi8(negate_mask_u8x32, negate_mask_u8x32);
358
+ __m256i signed_low_i16x16 = _mm256_sign_epi16(unsigned_low_i16x16,
359
+ _mm256_or_si256(negate_low_i16x16, ones_i16x16));
360
+ __m256i signed_high_i16x16 = _mm256_sign_epi16(unsigned_high_i16x16,
361
+ _mm256_or_si256(negate_high_i16x16, ones_i16x16));
362
+ // VNNI accumulation: dpwssd (signed i16 × signed i16 → i32)
363
+ sum_i32x8 = _mm256_dpwssd_avx_epi32(sum_i32x8, signed_low_i16x16, ones_i16x16);
364
+ sum_i32x8 = _mm256_dpwssd_avx_epi32(sum_i32x8, signed_high_i16x16, ones_i16x16);
365
+ sumsq_i32x8 = _mm256_dpwssd_avx_epi32(sumsq_i32x8, signed_low_i16x16, signed_low_i16x16);
366
+ sumsq_i32x8 = _mm256_dpwssd_avx_epi32(sumsq_i32x8, signed_high_i16x16, signed_high_i16x16);
367
+ }
368
+ nk_i32_t sum = nk_reduce_add_i32x8_haswell_(sum_i32x8);
369
+ nk_i32_t sumsq = nk_reduce_add_i32x8_haswell_(sumsq_i32x8);
370
+ nk_size_t remaining = count - idx;
371
+ if (remaining > 0) {
372
+ nk_b256_vec_t tail_vec;
373
+ nk_partial_load_b8x32_serial_(data + idx, &tail_vec, remaining);
374
+ __m256i data_u8x32 = tail_vec.ymm;
375
+ __m256i magnitude_u8x32 = _mm256_and_si256(data_u8x32, magnitude_mask_u8x32);
376
+ __m256i shuffle_idx_u8x32 = _mm256_and_si256(magnitude_u8x32, nibble_mask_u8x32);
377
+ __m256i upper_select_u8x32 = _mm256_cmpeq_epi8(_mm256_and_si256(magnitude_u8x32, half_select_u8x32),
378
+ half_select_u8x32);
379
+ __m256i low_bytes_u8x32 = _mm256_blendv_epi8(_mm256_shuffle_epi8(lut_low_byte_first_u8x32, shuffle_idx_u8x32),
380
+ _mm256_shuffle_epi8(lut_low_byte_second_u8x32, shuffle_idx_u8x32),
381
+ upper_select_u8x32);
382
+ __m256i high_bytes_u8x32 = _mm256_and_si256(_mm256_cmpgt_epi8(magnitude_u8x32, high_threshold_u8x32),
383
+ ones_u8x32);
384
+ __m256i unsigned_low_i16x16 = _mm256_unpacklo_epi8(low_bytes_u8x32, high_bytes_u8x32);
385
+ __m256i unsigned_high_i16x16 = _mm256_unpackhi_epi8(low_bytes_u8x32, high_bytes_u8x32);
386
+ __m256i negate_mask_u8x32 = _mm256_cmpeq_epi8(_mm256_and_si256(data_u8x32, sign_mask_u8x32), sign_mask_u8x32);
387
+ __m256i negate_low_i16x16 = _mm256_unpacklo_epi8(negate_mask_u8x32, negate_mask_u8x32);
388
+ __m256i negate_high_i16x16 = _mm256_unpackhi_epi8(negate_mask_u8x32, negate_mask_u8x32);
389
+ __m256i signed_low_i16x16 = _mm256_sign_epi16(unsigned_low_i16x16,
390
+ _mm256_or_si256(negate_low_i16x16, ones_i16x16));
391
+ __m256i signed_high_i16x16 = _mm256_sign_epi16(unsigned_high_i16x16,
392
+ _mm256_or_si256(negate_high_i16x16, ones_i16x16));
393
+ __m256i tail_sum_i32x8 = _mm256_dpwssd_avx_epi32(_mm256_setzero_si256(), signed_low_i16x16, ones_i16x16);
394
+ tail_sum_i32x8 = _mm256_dpwssd_avx_epi32(tail_sum_i32x8, signed_high_i16x16, ones_i16x16);
395
+ __m256i tail_sumsq_i32x8 = _mm256_dpwssd_avx_epi32(_mm256_setzero_si256(), signed_low_i16x16,
396
+ signed_low_i16x16);
397
+ tail_sumsq_i32x8 = _mm256_dpwssd_avx_epi32(tail_sumsq_i32x8, signed_high_i16x16, signed_high_i16x16);
398
+ sum += nk_reduce_add_i32x8_haswell_(tail_sum_i32x8);
399
+ sumsq += nk_reduce_add_i32x8_haswell_(tail_sumsq_i32x8);
400
+ }
401
+ *sum_ptr = (nk_f32_t)sum / 16.0f;
402
+ *sumsq_ptr = (nk_f32_t)sumsq / 256.0f;
403
+ }
404
+
405
+ NK_INTERNAL void nk_reduce_moments_e3m2_alder_strided_( //
406
+ nk_e3m2_t const *data, nk_size_t count, nk_size_t stride_elements, //
407
+ nk_f32_t *sum_ptr, nk_f32_t *sumsq_ptr) {
408
+ __m256i stride_mask_u8x32 = nk_stride_blend_u1x32_(stride_elements);
409
+ __m256i const lut_low_byte_first_u8x32 = _mm256_set_epi8( //
410
+ 28, 24, 20, 16, 14, 12, 10, 8, 7, 6, 5, 4, 3, 2, 1, 0, //
411
+ 28, 24, 20, 16, 14, 12, 10, 8, 7, 6, 5, 4, 3, 2, 1, 0); //
412
+ __m256i const lut_low_byte_second_u8x32 = _mm256_set_epi8( //
413
+ (char)192, (char)128, 64, 0, (char)224, (char)192, (char)160, (char)128, 112, 96, 80, 64, 56, 48, 40, 32, //
414
+ (char)192, (char)128, 64, 0, (char)224, (char)192, (char)160, (char)128, 112, 96, 80, 64, 56, 48, 40, 32); //
415
+ __m256i const nibble_mask_u8x32 = _mm256_set1_epi8(0x0F);
416
+ __m256i const magnitude_mask_u8x32 = _mm256_set1_epi8(0x1F);
417
+ __m256i const half_select_u8x32 = _mm256_set1_epi8(0x10);
418
+ __m256i const sign_mask_u8x32 = _mm256_set1_epi8(0x20);
419
+ __m256i const high_threshold_u8x32 = _mm256_set1_epi8(27);
420
+ __m256i const ones_u8x32 = _mm256_set1_epi8(1);
421
+ __m256i const ones_i16x16 = _mm256_set1_epi16(1);
422
+ __m256i sum_i32x8 = _mm256_setzero_si256();
423
+ __m256i sumsq_i32x8 = _mm256_setzero_si256();
424
+ nk_size_t idx_scalars = 0;
425
+ nk_size_t total_scalars = count * stride_elements;
426
+ nk_size_t step = nk_size_round_up_to_multiple_(32, stride_elements);
427
+ for (; idx_scalars + stride_elements + 31 <= total_scalars; idx_scalars += step) {
428
+ __m256i data_u8x32 = _mm256_loadu_si256((__m256i const *)(data + idx_scalars));
429
+ data_u8x32 = _mm256_and_si256(data_u8x32, stride_mask_u8x32);
430
+ __m256i magnitude_u8x32 = _mm256_and_si256(data_u8x32, magnitude_mask_u8x32);
431
+ __m256i shuffle_idx_u8x32 = _mm256_and_si256(magnitude_u8x32, nibble_mask_u8x32);
432
+ __m256i upper_select_u8x32 = _mm256_cmpeq_epi8(_mm256_and_si256(magnitude_u8x32, half_select_u8x32),
433
+ half_select_u8x32);
434
+ __m256i low_bytes_u8x32 = _mm256_blendv_epi8(_mm256_shuffle_epi8(lut_low_byte_first_u8x32, shuffle_idx_u8x32),
435
+ _mm256_shuffle_epi8(lut_low_byte_second_u8x32, shuffle_idx_u8x32),
436
+ upper_select_u8x32);
437
+ __m256i high_bytes_u8x32 = _mm256_and_si256(_mm256_cmpgt_epi8(magnitude_u8x32, high_threshold_u8x32),
438
+ ones_u8x32);
439
+ __m256i unsigned_low_i16x16 = _mm256_unpacklo_epi8(low_bytes_u8x32, high_bytes_u8x32);
440
+ __m256i unsigned_high_i16x16 = _mm256_unpackhi_epi8(low_bytes_u8x32, high_bytes_u8x32);
441
+ __m256i negate_mask_u8x32 = _mm256_cmpeq_epi8(_mm256_and_si256(data_u8x32, sign_mask_u8x32), sign_mask_u8x32);
442
+ __m256i negate_low_i16x16 = _mm256_unpacklo_epi8(negate_mask_u8x32, negate_mask_u8x32);
443
+ __m256i negate_high_i16x16 = _mm256_unpackhi_epi8(negate_mask_u8x32, negate_mask_u8x32);
444
+ __m256i signed_low_i16x16 = _mm256_sign_epi16(unsigned_low_i16x16,
445
+ _mm256_or_si256(negate_low_i16x16, ones_i16x16));
446
+ __m256i signed_high_i16x16 = _mm256_sign_epi16(unsigned_high_i16x16,
447
+ _mm256_or_si256(negate_high_i16x16, ones_i16x16));
448
+ sum_i32x8 = _mm256_dpwssd_avx_epi32(sum_i32x8, signed_low_i16x16, ones_i16x16);
449
+ sum_i32x8 = _mm256_dpwssd_avx_epi32(sum_i32x8, signed_high_i16x16, ones_i16x16);
450
+ sumsq_i32x8 = _mm256_dpwssd_avx_epi32(sumsq_i32x8, signed_low_i16x16, signed_low_i16x16);
451
+ sumsq_i32x8 = _mm256_dpwssd_avx_epi32(sumsq_i32x8, signed_high_i16x16, signed_high_i16x16);
452
+ }
453
+ nk_i32_t sum = nk_reduce_add_i32x8_haswell_(sum_i32x8);
454
+ nk_i32_t sumsq = nk_reduce_add_i32x8_haswell_(sumsq_i32x8);
455
+ nk_e3m2_t const *ptr = data + idx_scalars;
456
+ nk_size_t remaining = count - idx_scalars / stride_elements;
457
+ for (nk_size_t i = 0; i < remaining; ++i, ptr += stride_elements) {
458
+ nk_f32_t val;
459
+ nk_e3m2_to_f32_serial(ptr, &val);
460
+ nk_i32_t ival = (nk_i32_t)(val * 16.0f);
461
+ sum += ival;
462
+ sumsq += ival * ival;
463
+ }
464
+ *sum_ptr = (nk_f32_t)sum / 16.0f;
465
+ *sumsq_ptr = (nk_f32_t)sumsq / 256.0f;
466
+ }
467
+
468
+ NK_PUBLIC void nk_reduce_moments_e3m2_alder( //
469
+ nk_e3m2_t const *data, nk_size_t count, nk_size_t stride_bytes, //
470
+ nk_f32_t *sum, nk_f32_t *sumsq) {
471
+ nk_size_t stride_elements = stride_bytes / sizeof(nk_e3m2_t);
472
+ int aligned = (stride_bytes % sizeof(nk_e3m2_t) == 0);
473
+ if (count == 0) *sum = 0, *sumsq = 0;
474
+ else if (!aligned) nk_reduce_moments_e3m2_serial(data, count, stride_bytes, sum, sumsq);
475
+ else if (count > (nk_size_t)2048 * 32) {
476
+ nk_size_t left_count = count / 2;
477
+ nk_f32_t left_sum, left_sumsq, right_sum, right_sumsq;
478
+ nk_reduce_moments_e3m2_alder(data, left_count, stride_bytes, &left_sum, &left_sumsq);
479
+ nk_reduce_moments_e3m2_alder(data + left_count * stride_elements, count - left_count, stride_bytes, &right_sum,
480
+ &right_sumsq);
481
+ *sum = left_sum + right_sum, *sumsq = left_sumsq + right_sumsq;
482
+ }
483
+ else if (stride_elements == 1) nk_reduce_moments_e3m2_alder_contiguous_(data, count, sum, sumsq);
484
+ else if (stride_elements <= 8) nk_reduce_moments_e3m2_alder_strided_(data, count, stride_elements, sum, sumsq);
485
+ else nk_reduce_moments_e3m2_serial(data, count, stride_bytes, sum, sumsq);
486
+ }
487
+
488
+ /**
489
+ * @section e2m3 moments via integer VNNI (dpbusd)
490
+ *
491
+ * Every e2m3 value × 16 is an exact integer in [-120, +120] (i8 range).
492
+ * We use a dual-VPSHUFB LUT to map 5-bit magnitude → unsigned i8, create a
493
+ * sign vector (+1/-1), then accumulate with `_mm256_dpbusd_avx_epi32` (u8 × i8 → i32).
494
+ * For sumsq, magnitude ≤ 120 < 128 so it's safe as both u8 and i8.
495
+ * Final: sum = i32_sum / 16, sumsq = i32_sumsq / 256.
496
+ */
497
+ NK_INTERNAL void nk_reduce_moments_e2m3_alder_contiguous_( //
498
+ nk_e2m3_t const *data, nk_size_t count, //
499
+ nk_f32_t *sum_ptr, nk_f32_t *sumsq_ptr) {
500
+ __m256i const lut_low_u8x32 = _mm256_set_epi8(30, 28, 26, 24, 22, 20, 18, 16, 14, 12, 10, 8, 6, 4, 2, 0, //
501
+ 30, 28, 26, 24, 22, 20, 18, 16, 14, 12, 10, 8, 6, 4, 2, 0);
502
+ __m256i const lut_high_u8x32 = _mm256_set_epi8(120, 112, 104, 96, 88, 80, 72, 64, 60, 56, 52, 48, 44, 40, 36, 32,
503
+ 120, 112, 104, 96, 88, 80, 72, 64, 60, 56, 52, 48, 44, 40, 36, 32);
504
+ __m256i const nibble_mask_u8x32 = _mm256_set1_epi8(0x0F);
505
+ __m256i const magnitude_mask_u8x32 = _mm256_set1_epi8(0x1F);
506
+ __m256i const half_select_u8x32 = _mm256_set1_epi8(0x10);
507
+ __m256i const sign_mask_u8x32 = _mm256_set1_epi8(0x20);
508
+ __m256i const ones_i8x32 = _mm256_set1_epi8(1);
509
+ __m256i const neg_ones_i8x32 = _mm256_set1_epi8(-1);
510
+ __m256i sum_i32x8 = _mm256_setzero_si256();
511
+ __m256i sumsq_i32x8 = _mm256_setzero_si256();
512
+ nk_size_t idx = 0;
513
+ for (; idx + 32 <= count; idx += 32) {
514
+ __m256i data_u8x32 = _mm256_loadu_si256((__m256i const *)(data + idx));
515
+ __m256i magnitude_u8x32 = _mm256_and_si256(data_u8x32, magnitude_mask_u8x32);
516
+ __m256i shuffle_idx_u8x32 = _mm256_and_si256(magnitude_u8x32, nibble_mask_u8x32);
517
+ __m256i upper_select_u8x32 = _mm256_cmpeq_epi8(_mm256_and_si256(magnitude_u8x32, half_select_u8x32),
518
+ half_select_u8x32);
519
+ __m256i unsigned_u8x32 = _mm256_blendv_epi8(_mm256_shuffle_epi8(lut_low_u8x32, shuffle_idx_u8x32),
520
+ _mm256_shuffle_epi8(lut_high_u8x32, shuffle_idx_u8x32),
521
+ upper_select_u8x32);
522
+ // Sign vector: +1 for positive, -1 for negative (i8)
523
+ __m256i negate_mask_u8x32 = _mm256_cmpeq_epi8(_mm256_and_si256(data_u8x32, sign_mask_u8x32), sign_mask_u8x32);
524
+ __m256i sign_i8x32 = _mm256_blendv_epi8(ones_i8x32, neg_ones_i8x32, negate_mask_u8x32);
525
+ // DPBUSD: unsigned_magnitude (u8) × sign (+1/-1 i8) → signed sum
526
+ sum_i32x8 = _mm256_dpbusd_avx_epi32(sum_i32x8, unsigned_u8x32, sign_i8x32);
527
+ // DPBUSD: unsigned_magnitude (u8) × unsigned_magnitude (as i8, safe since ≤120) → sumsq
528
+ sumsq_i32x8 = _mm256_dpbusd_avx_epi32(sumsq_i32x8, unsigned_u8x32, unsigned_u8x32);
529
+ }
530
+ nk_i32_t sum = nk_reduce_add_i32x8_haswell_(sum_i32x8);
531
+ nk_i32_t sumsq = nk_reduce_add_i32x8_haswell_(sumsq_i32x8);
532
+ nk_size_t remaining = count - idx;
533
+ if (remaining > 0) {
534
+ nk_b256_vec_t tail_vec;
535
+ nk_partial_load_b8x32_serial_(data + idx, &tail_vec, remaining);
536
+ __m256i data_u8x32 = tail_vec.ymm;
537
+ __m256i magnitude_u8x32 = _mm256_and_si256(data_u8x32, magnitude_mask_u8x32);
538
+ __m256i shuffle_idx_u8x32 = _mm256_and_si256(magnitude_u8x32, nibble_mask_u8x32);
539
+ __m256i upper_select_u8x32 = _mm256_cmpeq_epi8(_mm256_and_si256(magnitude_u8x32, half_select_u8x32),
540
+ half_select_u8x32);
541
+ __m256i unsigned_u8x32 = _mm256_blendv_epi8(_mm256_shuffle_epi8(lut_low_u8x32, shuffle_idx_u8x32),
542
+ _mm256_shuffle_epi8(lut_high_u8x32, shuffle_idx_u8x32),
543
+ upper_select_u8x32);
544
+ __m256i negate_mask_u8x32 = _mm256_cmpeq_epi8(_mm256_and_si256(data_u8x32, sign_mask_u8x32), sign_mask_u8x32);
545
+ __m256i sign_i8x32 = _mm256_blendv_epi8(ones_i8x32, neg_ones_i8x32, negate_mask_u8x32);
546
+ sum += nk_reduce_add_i32x8_haswell_(
547
+ _mm256_dpbusd_avx_epi32(_mm256_setzero_si256(), unsigned_u8x32, sign_i8x32));
548
+ sumsq += nk_reduce_add_i32x8_haswell_(
549
+ _mm256_dpbusd_avx_epi32(_mm256_setzero_si256(), unsigned_u8x32, unsigned_u8x32));
550
+ }
551
+ *sum_ptr = (nk_f32_t)sum / 16.0f;
552
+ *sumsq_ptr = (nk_f32_t)sumsq / 256.0f;
553
+ }
554
+
555
+ NK_INTERNAL void nk_reduce_moments_e2m3_alder_strided_( //
556
+ nk_e2m3_t const *data, nk_size_t count, nk_size_t stride_elements, //
557
+ nk_f32_t *sum_ptr, nk_f32_t *sumsq_ptr) {
558
+ __m256i stride_mask_u8x32 = nk_stride_blend_u1x32_(stride_elements);
559
+ __m256i const lut_low_u8x32 = _mm256_set_epi8(30, 28, 26, 24, 22, 20, 18, 16, 14, 12, 10, 8, 6, 4, 2, 0, //
560
+ 30, 28, 26, 24, 22, 20, 18, 16, 14, 12, 10, 8, 6, 4, 2, 0);
561
+ __m256i const lut_high_u8x32 = _mm256_set_epi8(120, 112, 104, 96, 88, 80, 72, 64, 60, 56, 52, 48, 44, 40, 36, 32,
562
+ 120, 112, 104, 96, 88, 80, 72, 64, 60, 56, 52, 48, 44, 40, 36, 32);
563
+ __m256i const nibble_mask_u8x32 = _mm256_set1_epi8(0x0F);
564
+ __m256i const magnitude_mask_u8x32 = _mm256_set1_epi8(0x1F);
565
+ __m256i const half_select_u8x32 = _mm256_set1_epi8(0x10);
566
+ __m256i const sign_mask_u8x32 = _mm256_set1_epi8(0x20);
567
+ __m256i const ones_i8x32 = _mm256_set1_epi8(1);
568
+ __m256i const neg_ones_i8x32 = _mm256_set1_epi8(-1);
569
+ __m256i sum_i32x8 = _mm256_setzero_si256();
570
+ __m256i sumsq_i32x8 = _mm256_setzero_si256();
571
+ nk_size_t idx_scalars = 0;
572
+ nk_size_t total_scalars = count * stride_elements;
573
+ nk_size_t step = nk_size_round_up_to_multiple_(32, stride_elements);
574
+ for (; idx_scalars + stride_elements + 31 <= total_scalars; idx_scalars += step) {
575
+ __m256i data_u8x32 = _mm256_loadu_si256((__m256i const *)(data + idx_scalars));
576
+ data_u8x32 = _mm256_and_si256(data_u8x32, stride_mask_u8x32);
577
+ __m256i magnitude_u8x32 = _mm256_and_si256(data_u8x32, magnitude_mask_u8x32);
578
+ __m256i shuffle_idx_u8x32 = _mm256_and_si256(magnitude_u8x32, nibble_mask_u8x32);
579
+ __m256i upper_select_u8x32 = _mm256_cmpeq_epi8(_mm256_and_si256(magnitude_u8x32, half_select_u8x32),
580
+ half_select_u8x32);
581
+ __m256i unsigned_u8x32 = _mm256_blendv_epi8(_mm256_shuffle_epi8(lut_low_u8x32, shuffle_idx_u8x32),
582
+ _mm256_shuffle_epi8(lut_high_u8x32, shuffle_idx_u8x32),
583
+ upper_select_u8x32);
584
+ __m256i negate_mask_u8x32 = _mm256_cmpeq_epi8(_mm256_and_si256(data_u8x32, sign_mask_u8x32), sign_mask_u8x32);
585
+ __m256i sign_i8x32 = _mm256_blendv_epi8(ones_i8x32, neg_ones_i8x32, negate_mask_u8x32);
586
+ sum_i32x8 = _mm256_dpbusd_avx_epi32(sum_i32x8, unsigned_u8x32, sign_i8x32);
587
+ sumsq_i32x8 = _mm256_dpbusd_avx_epi32(sumsq_i32x8, unsigned_u8x32, unsigned_u8x32);
588
+ }
589
+ nk_i32_t sum = nk_reduce_add_i32x8_haswell_(sum_i32x8);
590
+ nk_i32_t sumsq = nk_reduce_add_i32x8_haswell_(sumsq_i32x8);
591
+ nk_e2m3_t const *ptr = data + idx_scalars;
592
+ nk_size_t remaining = count - idx_scalars / stride_elements;
593
+ for (nk_size_t i = 0; i < remaining; ++i, ptr += stride_elements) {
594
+ nk_f32_t val;
595
+ nk_e2m3_to_f32_serial(ptr, &val);
596
+ nk_i32_t ival = (nk_i32_t)(val * 16.0f);
597
+ sum += ival;
598
+ sumsq += ival * ival;
599
+ }
600
+ *sum_ptr = (nk_f32_t)sum / 16.0f;
601
+ *sumsq_ptr = (nk_f32_t)sumsq / 256.0f;
602
+ }
603
+
604
+ NK_PUBLIC void nk_reduce_moments_e2m3_alder( //
605
+ nk_e2m3_t const *data, nk_size_t count, nk_size_t stride_bytes, //
606
+ nk_f32_t *sum, nk_f32_t *sumsq) {
607
+ nk_size_t stride_elements = stride_bytes / sizeof(nk_e2m3_t);
608
+ int aligned = (stride_bytes % sizeof(nk_e2m3_t) == 0);
609
+ if (count == 0) *sum = 0, *sumsq = 0;
610
+ else if (!aligned) nk_reduce_moments_e2m3_serial(data, count, stride_bytes, sum, sumsq);
611
+ else if (count > (nk_size_t)(NK_I16_MAX + 1) * 32) {
612
+ nk_size_t left_count = count / 2;
613
+ nk_f32_t left_sum, left_sumsq, right_sum, right_sumsq;
614
+ nk_reduce_moments_e2m3_alder(data, left_count, stride_bytes, &left_sum, &left_sumsq);
615
+ nk_reduce_moments_e2m3_alder(data + left_count * stride_elements, count - left_count, stride_bytes, &right_sum,
616
+ &right_sumsq);
617
+ *sum = left_sum + right_sum, *sumsq = left_sumsq + right_sumsq;
618
+ }
619
+ else if (stride_elements == 1) nk_reduce_moments_e2m3_alder_contiguous_(data, count, sum, sumsq);
620
+ else if (stride_elements <= 8) nk_reduce_moments_e2m3_alder_strided_(data, count, stride_elements, sum, sumsq);
621
+ else nk_reduce_moments_e2m3_serial(data, count, stride_bytes, sum, sumsq);
622
+ }
623
+
624
+ #if defined(__clang__)
625
+ #pragma clang attribute pop
626
+ #elif defined(__GNUC__)
627
+ #pragma GCC pop_options
628
+ #endif
629
+
630
+ #if defined(__cplusplus)
631
+ } // extern "C"
632
+ #endif
633
+
634
+ #endif // NK_TARGET_ALDER
635
+ #endif // NK_TARGET_X8664_
636
+ #endif // NK_REDUCE_ALDER_H