usearch 2.21.4 → 2.25.1

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 (604) hide show
  1. package/README.md +65 -69
  2. package/binding.gyp +15 -37
  3. package/c/CMakeLists.txt +4 -5
  4. package/c/README.md +8 -8
  5. package/c/lib.cpp +32 -14
  6. package/c/test.c +124 -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 +224 -48
  13. package/include/usearch/index_dense.hpp +105 -40
  14. package/include/usearch/index_plugins.hpp +1387 -204
  15. package/javascript/README.md +1 -1
  16. package/javascript/dist/cjs/usearch.d.ts +8 -3
  17. package/javascript/dist/cjs/usearch.js +12 -4
  18. package/javascript/dist/esm/usearch.d.ts +8 -3
  19. package/javascript/dist/esm/usearch.js +12 -4
  20. package/javascript/lib.cpp +17 -0
  21. package/javascript/usearch.test.js +117 -94
  22. package/javascript/usearch.ts +14 -6
  23. package/numkong/.clang-tidy +30 -0
  24. package/{simsimd → numkong}/.cmake-format.py +18 -0
  25. package/numkong/.editorconfig +12 -0
  26. package/numkong/.git-blame-ignore-revs +123 -0
  27. package/numkong/.mailmap +15 -0
  28. package/numkong/.spi.yml +11 -0
  29. package/numkong/.swift-format +14 -0
  30. package/numkong/CITATION.cff +81 -0
  31. package/numkong/CONTRIBUTING.md +500 -0
  32. package/numkong/Cargo.toml +54 -0
  33. package/numkong/MANIFEST.in +8 -0
  34. package/numkong/Package.swift +84 -0
  35. package/numkong/README.md +569 -0
  36. package/numkong/bench/README.md +217 -0
  37. package/numkong/bench/bench-browser.html +323 -0
  38. package/numkong/bench/bench.cpp +344 -0
  39. package/numkong/bench/bench.hpp +816 -0
  40. package/numkong/bench/bench.js +148 -0
  41. package/numkong/bench/bench.mjs +616 -0
  42. package/numkong/bench/bench_attention.cpp +113 -0
  43. package/numkong/bench/bench_cast.cpp +264 -0
  44. package/numkong/bench/bench_cross_amx.cpp +62 -0
  45. package/numkong/bench/bench_cross_arm.cpp +245 -0
  46. package/numkong/bench/bench_cross_blas.cpp +309 -0
  47. package/numkong/bench/bench_cross_loongarch.cpp +106 -0
  48. package/numkong/bench/bench_cross_power.cpp +84 -0
  49. package/numkong/bench/bench_cross_rvv.cpp +121 -0
  50. package/numkong/bench/bench_cross_serial.cpp +151 -0
  51. package/numkong/bench/bench_cross_sme.cpp +163 -0
  52. package/numkong/bench/bench_cross_wasm.cpp +142 -0
  53. package/numkong/bench/bench_cross_x86.cpp +455 -0
  54. package/numkong/bench/bench_curved.cpp +210 -0
  55. package/numkong/bench/bench_dot.cpp +315 -0
  56. package/numkong/bench/bench_each.cpp +503 -0
  57. package/numkong/bench/bench_geospatial.cpp +112 -0
  58. package/numkong/bench/bench_maxsim.cpp +154 -0
  59. package/numkong/bench/bench_mesh.cpp +148 -0
  60. package/numkong/bench/bench_probability.cpp +60 -0
  61. package/numkong/bench/bench_reduce.cpp +371 -0
  62. package/numkong/bench/bench_set.cpp +73 -0
  63. package/numkong/bench/bench_sparse.cpp +198 -0
  64. package/numkong/bench/bench_spatial.cpp +347 -0
  65. package/numkong/bench/bench_trigonometry.cpp +137 -0
  66. package/numkong/bench/swift/Bench.swift +506 -0
  67. package/numkong/binding.gyp +169 -0
  68. package/numkong/build.rs +484 -0
  69. package/numkong/c/dispatch.h +512 -0
  70. package/numkong/c/dispatch_bf16.c +447 -0
  71. package/numkong/c/dispatch_bf16c.c +52 -0
  72. package/numkong/c/dispatch_e2m3.c +296 -0
  73. package/numkong/c/dispatch_e3m2.c +284 -0
  74. package/numkong/c/dispatch_e4m3.c +318 -0
  75. package/numkong/c/dispatch_e5m2.c +316 -0
  76. package/numkong/c/dispatch_f16.c +452 -0
  77. package/numkong/c/dispatch_f16c.c +58 -0
  78. package/numkong/c/dispatch_f32.c +434 -0
  79. package/numkong/c/dispatch_f32c.c +99 -0
  80. package/numkong/c/dispatch_f64.c +348 -0
  81. package/numkong/c/dispatch_f64c.c +98 -0
  82. package/numkong/c/dispatch_i16.c +96 -0
  83. package/numkong/c/dispatch_i32.c +89 -0
  84. package/numkong/c/dispatch_i4.c +153 -0
  85. package/numkong/c/dispatch_i64.c +86 -0
  86. package/numkong/c/dispatch_i8.c +348 -0
  87. package/numkong/c/dispatch_other.c +348 -0
  88. package/numkong/c/dispatch_u1.c +193 -0
  89. package/numkong/c/dispatch_u16.c +124 -0
  90. package/numkong/c/dispatch_u32.c +118 -0
  91. package/numkong/c/dispatch_u4.c +153 -0
  92. package/numkong/c/dispatch_u64.c +102 -0
  93. package/numkong/c/dispatch_u8.c +364 -0
  94. package/numkong/c/numkong.c +940 -0
  95. package/numkong/cmake/nk_arm_isa_probes.cmake +61 -0
  96. package/numkong/cmake/nk_isa_probe.cmake +90 -0
  97. package/numkong/cmake/nk_loongarch_isa_probes.cmake +15 -0
  98. package/numkong/cmake/nk_math_lib.cmake +46 -0
  99. package/numkong/cmake/nk_power_isa_probes.cmake +15 -0
  100. package/numkong/cmake/nk_riscv_isa_probes.cmake +19 -0
  101. package/numkong/cmake/nk_x86_isa_probes.cmake +35 -0
  102. package/numkong/cmake/toolchain-aarch64-gnu.cmake +86 -0
  103. package/numkong/cmake/toolchain-android-arm64.cmake +25 -0
  104. package/numkong/cmake/toolchain-android-armv7.cmake +25 -0
  105. package/numkong/cmake/toolchain-loongarch64-gnu.cmake +68 -0
  106. package/numkong/cmake/toolchain-ppc64le-gnu.cmake +74 -0
  107. package/numkong/cmake/toolchain-riscv64-gnu.cmake +107 -0
  108. package/numkong/cmake/toolchain-riscv64-llvm.cmake +114 -0
  109. package/numkong/cmake/toolchain-wasi.cmake +77 -0
  110. package/numkong/cmake/toolchain-wasm.cmake +70 -0
  111. package/numkong/cmake/toolchain-wasm64.cmake +62 -0
  112. package/numkong/cmake/toolchain-x86_64-llvm.cmake +47 -0
  113. package/numkong/include/README.md +643 -0
  114. package/numkong/include/module.modulemap +129 -0
  115. package/numkong/include/numkong/attention/sapphireamx.h +1363 -0
  116. package/numkong/include/numkong/attention/sme.h +2075 -0
  117. package/numkong/include/numkong/attention.h +49 -0
  118. package/numkong/include/numkong/capabilities.h +930 -0
  119. package/numkong/include/numkong/cast/README.md +262 -0
  120. package/numkong/include/numkong/cast/diamond.h +64 -0
  121. package/numkong/include/numkong/cast/haswell.h +823 -0
  122. package/numkong/include/numkong/cast/icelake.h +475 -0
  123. package/numkong/include/numkong/cast/loongsonasx.h +252 -0
  124. package/numkong/include/numkong/cast/neon.h +1174 -0
  125. package/numkong/include/numkong/cast/powervsx.h +449 -0
  126. package/numkong/include/numkong/cast/rvv.h +970 -0
  127. package/numkong/include/numkong/cast/sapphire.h +262 -0
  128. package/numkong/include/numkong/cast/serial.h +2336 -0
  129. package/numkong/include/numkong/cast/skylake.h +915 -0
  130. package/numkong/include/numkong/cast/v128relaxed.h +537 -0
  131. package/numkong/include/numkong/cast.h +254 -0
  132. package/numkong/include/numkong/cast.hpp +44 -0
  133. package/numkong/include/numkong/curved/README.md +223 -0
  134. package/numkong/include/numkong/curved/genoa.h +182 -0
  135. package/numkong/include/numkong/curved/haswell.h +276 -0
  136. package/numkong/include/numkong/curved/neon.h +329 -0
  137. package/numkong/include/numkong/curved/neonbfdot.h +211 -0
  138. package/numkong/include/numkong/curved/rvv.h +305 -0
  139. package/numkong/include/numkong/curved/serial.h +207 -0
  140. package/numkong/include/numkong/curved/skylake.h +457 -0
  141. package/numkong/include/numkong/curved/smef64.h +530 -0
  142. package/numkong/include/numkong/curved.h +513 -0
  143. package/numkong/include/numkong/curved.hpp +144 -0
  144. package/numkong/include/numkong/dot/README.md +442 -0
  145. package/numkong/include/numkong/dot/alder.h +563 -0
  146. package/numkong/include/numkong/dot/diamond.h +158 -0
  147. package/numkong/include/numkong/dot/genoa.h +289 -0
  148. package/numkong/include/numkong/dot/haswell.h +1723 -0
  149. package/numkong/include/numkong/dot/icelake.h +997 -0
  150. package/numkong/include/numkong/dot/loongsonasx.h +671 -0
  151. package/numkong/include/numkong/dot/neon.h +869 -0
  152. package/numkong/include/numkong/dot/neonbfdot.h +243 -0
  153. package/numkong/include/numkong/dot/neonfhm.h +358 -0
  154. package/numkong/include/numkong/dot/neonfp8.h +323 -0
  155. package/numkong/include/numkong/dot/neonsdot.h +622 -0
  156. package/numkong/include/numkong/dot/powervsx.h +752 -0
  157. package/numkong/include/numkong/dot/rvv.h +722 -0
  158. package/numkong/include/numkong/dot/rvvbb.h +72 -0
  159. package/numkong/include/numkong/dot/rvvbf16.h +123 -0
  160. package/numkong/include/numkong/dot/rvvhalf.h +129 -0
  161. package/numkong/include/numkong/dot/sapphire.h +141 -0
  162. package/numkong/include/numkong/dot/serial.h +874 -0
  163. package/numkong/include/numkong/dot/sierra.h +405 -0
  164. package/numkong/include/numkong/dot/skylake.h +1116 -0
  165. package/numkong/include/numkong/dot/sve.h +420 -0
  166. package/numkong/include/numkong/dot/svebfdot.h +75 -0
  167. package/numkong/include/numkong/dot/svehalf.h +168 -0
  168. package/numkong/include/numkong/dot/svesdot.h +90 -0
  169. package/numkong/include/numkong/dot/v128relaxed.h +1293 -0
  170. package/numkong/include/numkong/dot.h +1136 -0
  171. package/numkong/include/numkong/dot.hpp +94 -0
  172. package/numkong/include/numkong/dots/README.md +496 -0
  173. package/numkong/include/numkong/dots/alder.h +117 -0
  174. package/numkong/include/numkong/dots/diamond.h +86 -0
  175. package/numkong/include/numkong/dots/genoa.h +100 -0
  176. package/numkong/include/numkong/dots/graniteamx.h +733 -0
  177. package/numkong/include/numkong/dots/haswell.h +310 -0
  178. package/numkong/include/numkong/dots/icelake.h +180 -0
  179. package/numkong/include/numkong/dots/loongsonasx.h +176 -0
  180. package/numkong/include/numkong/dots/neon.h +123 -0
  181. package/numkong/include/numkong/dots/neonbfdot.h +59 -0
  182. package/numkong/include/numkong/dots/neonfhm.h +96 -0
  183. package/numkong/include/numkong/dots/neonfp8.h +99 -0
  184. package/numkong/include/numkong/dots/neonsdot.h +144 -0
  185. package/numkong/include/numkong/dots/powervsx.h +194 -0
  186. package/numkong/include/numkong/dots/rvv.h +2593 -0
  187. package/numkong/include/numkong/dots/sapphireamx.h +4017 -0
  188. package/numkong/include/numkong/dots/serial.h +2867 -0
  189. package/numkong/include/numkong/dots/sierra.h +100 -0
  190. package/numkong/include/numkong/dots/skylake.h +207 -0
  191. package/numkong/include/numkong/dots/sme.h +5041 -0
  192. package/numkong/include/numkong/dots/smebi32.h +477 -0
  193. package/numkong/include/numkong/dots/smef64.h +1328 -0
  194. package/numkong/include/numkong/dots/smehalf.h +47 -0
  195. package/numkong/include/numkong/dots/v128relaxed.h +317 -0
  196. package/numkong/include/numkong/dots.h +3110 -0
  197. package/numkong/include/numkong/dots.hpp +641 -0
  198. package/numkong/include/numkong/each/README.md +465 -0
  199. package/numkong/include/numkong/each/haswell.h +1658 -0
  200. package/numkong/include/numkong/each/icelake.h +272 -0
  201. package/numkong/include/numkong/each/neon.h +1138 -0
  202. package/numkong/include/numkong/each/neonbfdot.h +211 -0
  203. package/numkong/include/numkong/each/neonhalf.h +318 -0
  204. package/numkong/include/numkong/each/rvv.h +1121 -0
  205. package/numkong/include/numkong/each/sapphire.h +343 -0
  206. package/numkong/include/numkong/each/serial.h +282 -0
  207. package/numkong/include/numkong/each/skylake.h +1562 -0
  208. package/numkong/include/numkong/each/v128relaxed.h +562 -0
  209. package/numkong/include/numkong/each.h +2232 -0
  210. package/numkong/include/numkong/each.hpp +434 -0
  211. package/numkong/include/numkong/geospatial/README.md +147 -0
  212. package/numkong/include/numkong/geospatial/haswell.h +633 -0
  213. package/numkong/include/numkong/geospatial/neon.h +615 -0
  214. package/numkong/include/numkong/geospatial/rvv.h +701 -0
  215. package/numkong/include/numkong/geospatial/serial.h +309 -0
  216. package/numkong/include/numkong/geospatial/skylake.h +613 -0
  217. package/numkong/include/numkong/geospatial/v128relaxed.h +652 -0
  218. package/numkong/include/numkong/geospatial.h +453 -0
  219. package/numkong/include/numkong/geospatial.hpp +235 -0
  220. package/numkong/include/numkong/matrix.hpp +336 -0
  221. package/numkong/include/numkong/maxsim/README.md +187 -0
  222. package/numkong/include/numkong/maxsim/alder.h +511 -0
  223. package/numkong/include/numkong/maxsim/genoa.h +115 -0
  224. package/numkong/include/numkong/maxsim/haswell.h +553 -0
  225. package/numkong/include/numkong/maxsim/icelake.h +480 -0
  226. package/numkong/include/numkong/maxsim/neonsdot.h +394 -0
  227. package/numkong/include/numkong/maxsim/sapphireamx.h +877 -0
  228. package/numkong/include/numkong/maxsim/serial.h +490 -0
  229. package/numkong/include/numkong/maxsim/sme.h +993 -0
  230. package/numkong/include/numkong/maxsim/v128relaxed.h +280 -0
  231. package/numkong/include/numkong/maxsim.h +571 -0
  232. package/numkong/include/numkong/maxsim.hpp +133 -0
  233. package/numkong/include/numkong/mesh/README.md +219 -0
  234. package/numkong/include/numkong/mesh/haswell.h +2013 -0
  235. package/numkong/include/numkong/mesh/neon.h +1821 -0
  236. package/numkong/include/numkong/mesh/neonbfdot.h +771 -0
  237. package/numkong/include/numkong/mesh/rvv.h +936 -0
  238. package/numkong/include/numkong/mesh/serial.h +721 -0
  239. package/numkong/include/numkong/mesh/skylake.h +2344 -0
  240. package/numkong/include/numkong/mesh/v128relaxed.h +1081 -0
  241. package/numkong/include/numkong/mesh.h +666 -0
  242. package/numkong/include/numkong/mesh.hpp +701 -0
  243. package/numkong/include/numkong/numkong.h +78 -0
  244. package/numkong/include/numkong/numkong.hpp +58 -0
  245. package/numkong/include/numkong/probability/README.md +177 -0
  246. package/numkong/include/numkong/probability/haswell.h +267 -0
  247. package/numkong/include/numkong/probability/neon.h +255 -0
  248. package/numkong/include/numkong/probability/rvv.h +414 -0
  249. package/numkong/include/numkong/probability/serial.h +181 -0
  250. package/numkong/include/numkong/probability/skylake.h +324 -0
  251. package/numkong/include/numkong/probability.h +380 -0
  252. package/numkong/include/numkong/probability.hpp +120 -0
  253. package/numkong/include/numkong/random.h +50 -0
  254. package/numkong/include/numkong/random.hpp +285 -0
  255. package/numkong/include/numkong/reduce/README.md +552 -0
  256. package/numkong/include/numkong/reduce/alder.h +636 -0
  257. package/numkong/include/numkong/reduce/genoa.h +201 -0
  258. package/numkong/include/numkong/reduce/haswell.h +3785 -0
  259. package/numkong/include/numkong/reduce/icelake.h +549 -0
  260. package/numkong/include/numkong/reduce/neon.h +3980 -0
  261. package/numkong/include/numkong/reduce/neonbfdot.h +142 -0
  262. package/numkong/include/numkong/reduce/neonfhm.h +293 -0
  263. package/numkong/include/numkong/reduce/neonsdot.h +357 -0
  264. package/numkong/include/numkong/reduce/rvv.h +3533 -0
  265. package/numkong/include/numkong/reduce/serial.h +753 -0
  266. package/numkong/include/numkong/reduce/sierra.h +338 -0
  267. package/numkong/include/numkong/reduce/skylake.h +3794 -0
  268. package/numkong/include/numkong/reduce/sve.h +52 -0
  269. package/numkong/include/numkong/reduce/v128relaxed.h +2302 -0
  270. package/numkong/include/numkong/reduce.h +1582 -0
  271. package/numkong/include/numkong/reduce.hpp +778 -0
  272. package/numkong/include/numkong/scalar/README.md +89 -0
  273. package/numkong/include/numkong/scalar/haswell.h +122 -0
  274. package/numkong/include/numkong/scalar/loongsonasx.h +74 -0
  275. package/numkong/include/numkong/scalar/neon.h +122 -0
  276. package/numkong/include/numkong/scalar/neonhalf.h +70 -0
  277. package/numkong/include/numkong/scalar/powervsx.h +96 -0
  278. package/numkong/include/numkong/scalar/rvv.h +211 -0
  279. package/numkong/include/numkong/scalar/sapphire.h +74 -0
  280. package/numkong/include/numkong/scalar/serial.h +332 -0
  281. package/numkong/include/numkong/scalar/v128relaxed.h +56 -0
  282. package/numkong/include/numkong/scalar.h +696 -0
  283. package/numkong/include/numkong/set/README.md +179 -0
  284. package/numkong/include/numkong/set/haswell.h +334 -0
  285. package/numkong/include/numkong/set/icelake.h +485 -0
  286. package/numkong/include/numkong/set/loongsonasx.h +181 -0
  287. package/numkong/include/numkong/set/neon.h +363 -0
  288. package/numkong/include/numkong/set/powervsx.h +326 -0
  289. package/numkong/include/numkong/set/rvv.h +226 -0
  290. package/numkong/include/numkong/set/rvvbb.h +117 -0
  291. package/numkong/include/numkong/set/serial.h +174 -0
  292. package/numkong/include/numkong/set/sve.h +187 -0
  293. package/numkong/include/numkong/set/v128relaxed.h +240 -0
  294. package/numkong/include/numkong/set.h +471 -0
  295. package/numkong/include/numkong/set.hpp +114 -0
  296. package/numkong/include/numkong/sets/README.md +149 -0
  297. package/numkong/include/numkong/sets/haswell.h +63 -0
  298. package/numkong/include/numkong/sets/icelake.h +66 -0
  299. package/numkong/include/numkong/sets/loongsonasx.h +52 -0
  300. package/numkong/include/numkong/sets/neon.h +61 -0
  301. package/numkong/include/numkong/sets/powervsx.h +65 -0
  302. package/numkong/include/numkong/sets/serial.h +43 -0
  303. package/numkong/include/numkong/sets/smebi32.h +1135 -0
  304. package/numkong/include/numkong/sets/v128relaxed.h +58 -0
  305. package/numkong/include/numkong/sets.h +382 -0
  306. package/numkong/include/numkong/sparse/README.md +156 -0
  307. package/numkong/include/numkong/sparse/icelake.h +463 -0
  308. package/numkong/include/numkong/sparse/neon.h +288 -0
  309. package/numkong/include/numkong/sparse/serial.h +117 -0
  310. package/numkong/include/numkong/sparse/sve2.h +504 -0
  311. package/numkong/include/numkong/sparse/turin.h +322 -0
  312. package/numkong/include/numkong/sparse.h +363 -0
  313. package/numkong/include/numkong/sparse.hpp +113 -0
  314. package/numkong/include/numkong/spatial/README.md +439 -0
  315. package/numkong/include/numkong/spatial/alder.h +604 -0
  316. package/numkong/include/numkong/spatial/diamond.h +240 -0
  317. package/numkong/include/numkong/spatial/genoa.h +222 -0
  318. package/numkong/include/numkong/spatial/haswell.h +979 -0
  319. package/numkong/include/numkong/spatial/icelake.h +1067 -0
  320. package/numkong/include/numkong/spatial/loongsonasx.h +483 -0
  321. package/numkong/include/numkong/spatial/neon.h +846 -0
  322. package/numkong/include/numkong/spatial/neonbfdot.h +164 -0
  323. package/numkong/include/numkong/spatial/neonfp8.h +258 -0
  324. package/numkong/include/numkong/spatial/neonsdot.h +429 -0
  325. package/numkong/include/numkong/spatial/powervsx.h +738 -0
  326. package/numkong/include/numkong/spatial/rvv.h +991 -0
  327. package/numkong/include/numkong/spatial/rvvbf16.h +128 -0
  328. package/numkong/include/numkong/spatial/rvvhalf.h +120 -0
  329. package/numkong/include/numkong/spatial/serial.h +347 -0
  330. package/numkong/include/numkong/spatial/sierra.h +516 -0
  331. package/numkong/include/numkong/spatial/skylake.h +605 -0
  332. package/numkong/include/numkong/spatial/sve.h +246 -0
  333. package/numkong/include/numkong/spatial/svebfdot.h +125 -0
  334. package/numkong/include/numkong/spatial/svehalf.h +136 -0
  335. package/numkong/include/numkong/spatial/svesdot.h +143 -0
  336. package/numkong/include/numkong/spatial/v128relaxed.h +969 -0
  337. package/numkong/include/numkong/spatial.h +1681 -0
  338. package/numkong/include/numkong/spatial.hpp +183 -0
  339. package/numkong/include/numkong/spatials/README.md +580 -0
  340. package/numkong/include/numkong/spatials/alder.h +94 -0
  341. package/numkong/include/numkong/spatials/diamond.h +82 -0
  342. package/numkong/include/numkong/spatials/genoa.h +94 -0
  343. package/numkong/include/numkong/spatials/graniteamx.h +173 -0
  344. package/numkong/include/numkong/spatials/haswell.h +219 -0
  345. package/numkong/include/numkong/spatials/icelake.h +113 -0
  346. package/numkong/include/numkong/spatials/loongsonasx.h +153 -0
  347. package/numkong/include/numkong/spatials/neon.h +109 -0
  348. package/numkong/include/numkong/spatials/neonbfdot.h +60 -0
  349. package/numkong/include/numkong/spatials/neonfhm.h +92 -0
  350. package/numkong/include/numkong/spatials/neonfp8.h +111 -0
  351. package/numkong/include/numkong/spatials/neonsdot.h +143 -0
  352. package/numkong/include/numkong/spatials/powervsx.h +153 -0
  353. package/numkong/include/numkong/spatials/rvv.h +1976 -0
  354. package/numkong/include/numkong/spatials/sapphireamx.h +1149 -0
  355. package/numkong/include/numkong/spatials/serial.h +248 -0
  356. package/numkong/include/numkong/spatials/sierra.h +96 -0
  357. package/numkong/include/numkong/spatials/skylake.h +184 -0
  358. package/numkong/include/numkong/spatials/sme.h +1927 -0
  359. package/numkong/include/numkong/spatials/smef64.h +483 -0
  360. package/numkong/include/numkong/spatials/v128relaxed.h +240 -0
  361. package/numkong/include/numkong/spatials.h +3374 -0
  362. package/numkong/include/numkong/spatials.hpp +509 -0
  363. package/numkong/include/numkong/tensor.hpp +1981 -0
  364. package/numkong/include/numkong/trigonometry/README.md +184 -0
  365. package/numkong/include/numkong/trigonometry/haswell.h +653 -0
  366. package/numkong/include/numkong/trigonometry/neon.h +638 -0
  367. package/numkong/include/numkong/trigonometry/rvv.h +700 -0
  368. package/numkong/include/numkong/trigonometry/serial.h +703 -0
  369. package/numkong/include/numkong/trigonometry/skylake.h +725 -0
  370. package/numkong/include/numkong/trigonometry/v128relaxed.h +667 -0
  371. package/numkong/include/numkong/trigonometry.h +467 -0
  372. package/numkong/include/numkong/trigonometry.hpp +166 -0
  373. package/numkong/include/numkong/types.h +1695 -0
  374. package/numkong/include/numkong/types.hpp +6027 -0
  375. package/numkong/include/numkong/vector.hpp +766 -0
  376. package/numkong/javascript/@numkong-darwin-arm64/package.json +26 -0
  377. package/numkong/javascript/@numkong-darwin-x64/package.json +26 -0
  378. package/numkong/javascript/@numkong-linux-arm64/package.json +25 -0
  379. package/numkong/javascript/@numkong-linux-x64/package.json +25 -0
  380. package/numkong/javascript/@numkong-win32-arm64/package.json +25 -0
  381. package/numkong/javascript/@numkong-win32-x64/package.json +25 -0
  382. package/numkong/javascript/README.md +254 -0
  383. package/numkong/javascript/node-gyp-build.d.ts +4 -0
  384. package/numkong/javascript/numkong-browser.ts +40 -0
  385. package/numkong/javascript/numkong-wasm.ts +750 -0
  386. package/numkong/javascript/numkong.c +712 -0
  387. package/numkong/javascript/numkong.ts +613 -0
  388. package/{simsimd → numkong}/javascript/tsconfig-base.json +6 -3
  389. package/numkong/javascript/tsconfig-cjs.json +13 -0
  390. package/{simsimd → numkong}/javascript/tsconfig-esm.json +1 -1
  391. package/numkong/javascript/types.ts +784 -0
  392. package/numkong/numkong.gypi +104 -0
  393. package/numkong/package.json +108 -0
  394. package/numkong/probes/arm_neon.c +8 -0
  395. package/numkong/probes/arm_neon_bfdot.c +9 -0
  396. package/numkong/probes/arm_neon_fhm.c +9 -0
  397. package/numkong/probes/arm_neon_half.c +8 -0
  398. package/numkong/probes/arm_neon_sdot.c +9 -0
  399. package/numkong/probes/arm_neonfp8.c +9 -0
  400. package/numkong/probes/arm_sme.c +16 -0
  401. package/numkong/probes/arm_sme2.c +16 -0
  402. package/numkong/probes/arm_sme2p1.c +16 -0
  403. package/numkong/probes/arm_sme_bf16.c +16 -0
  404. package/numkong/probes/arm_sme_bi32.c +16 -0
  405. package/numkong/probes/arm_sme_f64.c +16 -0
  406. package/numkong/probes/arm_sme_fa64.c +14 -0
  407. package/numkong/probes/arm_sme_half.c +16 -0
  408. package/numkong/probes/arm_sme_lut2.c +15 -0
  409. package/numkong/probes/arm_sve.c +18 -0
  410. package/numkong/probes/arm_sve2.c +20 -0
  411. package/numkong/probes/arm_sve2p1.c +18 -0
  412. package/numkong/probes/arm_sve_bfdot.c +20 -0
  413. package/numkong/probes/arm_sve_half.c +18 -0
  414. package/numkong/probes/arm_sve_sdot.c +21 -0
  415. package/numkong/probes/loongarch_lasx.c +12 -0
  416. package/numkong/probes/power_vsx.c +12 -0
  417. package/numkong/probes/probe.js +127 -0
  418. package/numkong/probes/riscv_rvv.c +14 -0
  419. package/numkong/probes/riscv_rvv_bb.c +15 -0
  420. package/numkong/probes/riscv_rvv_bf16.c +17 -0
  421. package/numkong/probes/riscv_rvv_half.c +14 -0
  422. package/numkong/probes/wasm_v128relaxed.c +11 -0
  423. package/numkong/probes/x86_alder.c +17 -0
  424. package/numkong/probes/x86_diamond.c +17 -0
  425. package/numkong/probes/x86_genoa.c +17 -0
  426. package/numkong/probes/x86_graniteamx.c +19 -0
  427. package/numkong/probes/x86_haswell.c +11 -0
  428. package/numkong/probes/x86_icelake.c +17 -0
  429. package/numkong/probes/x86_sapphire.c +16 -0
  430. package/numkong/probes/x86_sapphireamx.c +18 -0
  431. package/numkong/probes/x86_sierra.c +17 -0
  432. package/numkong/probes/x86_skylake.c +15 -0
  433. package/numkong/probes/x86_turin.c +17 -0
  434. package/numkong/rust/README.md +698 -0
  435. package/numkong/rust/capabilities.rs +96 -0
  436. package/numkong/rust/cast.rs +314 -0
  437. package/numkong/rust/curved.rs +391 -0
  438. package/numkong/rust/each.rs +2721 -0
  439. package/numkong/rust/geospatial.rs +343 -0
  440. package/numkong/rust/matrix.rs +5424 -0
  441. package/numkong/rust/maxsim.rs +540 -0
  442. package/numkong/rust/mesh.rs +837 -0
  443. package/numkong/rust/numkong.rs +409 -0
  444. package/numkong/rust/probability.rs +272 -0
  445. package/numkong/rust/reduce.rs +1249 -0
  446. package/numkong/rust/set.rs +194 -0
  447. package/numkong/rust/sparse.rs +513 -0
  448. package/numkong/rust/spatial.rs +1815 -0
  449. package/numkong/rust/tensor.rs +7565 -0
  450. package/numkong/rust/types.rs +3666 -0
  451. package/numkong/rust/vector.rs +1899 -0
  452. package/numkong/rustfmt.toml +2 -0
  453. package/numkong/swift/Matrix.swift +1388 -0
  454. package/numkong/swift/MaxSim.swift +151 -0
  455. package/numkong/swift/NumKong.swift +283 -0
  456. package/numkong/swift/Numerics.swift +329 -0
  457. package/numkong/swift/README.md +433 -0
  458. package/numkong/swift/Scalar.swift +741 -0
  459. package/numkong/swift/Tensor.swift +209 -0
  460. package/numkong/test/README.md +315 -0
  461. package/numkong/test/playwright.config.ts +16 -0
  462. package/numkong/test/swift/Test.swift +534 -0
  463. package/numkong/test/test-browser-bundle-runner.mjs +36 -0
  464. package/numkong/test/test-browser-bundle.html +188 -0
  465. package/numkong/test/test-browser-runner.mjs +43 -0
  466. package/numkong/test/test-browser.html +305 -0
  467. package/numkong/test/test-dtypes.mjs +453 -0
  468. package/numkong/test/test-wasm.mjs +267 -0
  469. package/numkong/test/test.cpp +442 -0
  470. package/numkong/test/test.hpp +580 -0
  471. package/numkong/test/test.mjs +363 -0
  472. package/numkong/test/test_base.py +1041 -0
  473. package/numkong/test/test_cast.cpp +242 -0
  474. package/numkong/test/test_cross.hpp +551 -0
  475. package/numkong/test/test_cross.py +467 -0
  476. package/numkong/test/test_cross_amx.cpp +50 -0
  477. package/numkong/test/test_cross_arm.cpp +225 -0
  478. package/numkong/test/test_cross_blas.cpp +354 -0
  479. package/numkong/test/test_cross_loongarch.cpp +90 -0
  480. package/numkong/test/test_cross_power.cpp +73 -0
  481. package/numkong/test/test_cross_rvv.cpp +109 -0
  482. package/numkong/test/test_cross_serial.cpp +181 -0
  483. package/numkong/test/test_cross_sme.cpp +148 -0
  484. package/numkong/test/test_cross_wasm.cpp +141 -0
  485. package/numkong/test/test_cross_x86.cpp +442 -0
  486. package/numkong/test/test_curved.cpp +182 -0
  487. package/numkong/test/test_curved.py +207 -0
  488. package/numkong/test/test_dot.cpp +353 -0
  489. package/numkong/test/test_dot.py +296 -0
  490. package/numkong/test/test_each.cpp +437 -0
  491. package/numkong/test/test_each.py +756 -0
  492. package/numkong/test/test_geospatial.cpp +155 -0
  493. package/numkong/test/test_geospatial.py +241 -0
  494. package/numkong/test/test_maxsim.cpp +138 -0
  495. package/numkong/test/test_maxsim.py +209 -0
  496. package/numkong/test/test_mesh.cpp +203 -0
  497. package/numkong/test/test_mesh.py +394 -0
  498. package/numkong/test/test_probability.cpp +136 -0
  499. package/numkong/test/test_probability.py +166 -0
  500. package/numkong/test/test_reduce.cpp +563 -0
  501. package/numkong/test/test_reduce.py +781 -0
  502. package/numkong/test/test_set.cpp +151 -0
  503. package/numkong/test/test_set.py +120 -0
  504. package/numkong/test/test_similarities.py +579 -0
  505. package/numkong/test/test_sparse.cpp +121 -0
  506. package/numkong/test/test_sparse.py +118 -0
  507. package/numkong/test/test_spatial.cpp +518 -0
  508. package/numkong/test/test_spatial.py +269 -0
  509. package/numkong/test/test_tensor.cpp +884 -0
  510. package/numkong/test/test_tensor.py +1417 -0
  511. package/numkong/test/test_trigonometry.cpp +156 -0
  512. package/numkong/test/test_trigonometry.py +180 -0
  513. package/package.json +7 -8
  514. package/prebuilds/darwin-arm64+x64/usearch.node +0 -0
  515. package/prebuilds/linux-arm64/usearch.node +0 -0
  516. package/prebuilds/linux-x64/usearch.node +0 -0
  517. package/fp16/CMakeLists.txt +0 -176
  518. package/fp16/LICENSE +0 -11
  519. package/fp16/README.md +0 -20
  520. package/fp16/bench/alt-element.cc +0 -89
  521. package/fp16/bench/from-alt-array.cc +0 -175
  522. package/fp16/bench/from-ieee-array.cc +0 -399
  523. package/fp16/bench/ieee-element.cc +0 -272
  524. package/fp16/bench/to-alt-array.cc +0 -91
  525. package/fp16/bench/to-ieee-array.cc +0 -303
  526. package/fp16/cmake/DownloadGoogleBenchmark.cmake +0 -15
  527. package/fp16/cmake/DownloadGoogleTest.cmake +0 -15
  528. package/fp16/cmake/DownloadPSimd.cmake +0 -15
  529. package/fp16/configure.py +0 -65
  530. package/fp16/confu.yaml +0 -8
  531. package/fp16/include/fp16/__init__.py +0 -0
  532. package/fp16/include/fp16/avx.py +0 -50
  533. package/fp16/include/fp16/avx2.py +0 -53
  534. package/fp16/include/fp16/bitcasts.h +0 -92
  535. package/fp16/include/fp16/fp16.h +0 -451
  536. package/fp16/include/fp16/psimd.h +0 -131
  537. package/fp16/include/fp16.h +0 -11
  538. package/fp16/jni/Android.mk +0 -6
  539. package/fp16/jni/Application.mk +0 -4
  540. package/fp16/test/alt-from-fp32-value.cc +0 -498
  541. package/fp16/test/alt-to-fp32-bits.cc +0 -263
  542. package/fp16/test/alt-to-fp32-psimd.cc +0 -145
  543. package/fp16/test/alt-to-fp32-value.cc +0 -348
  544. package/fp16/test/alt-to-fp32x2-psimd.cc +0 -245
  545. package/fp16/test/bitcasts.cc +0 -56
  546. package/fp16/test/ieee-from-fp32-value.cc +0 -523
  547. package/fp16/test/ieee-to-fp32-bits.cc +0 -333
  548. package/fp16/test/ieee-to-fp32-psimd.cc +0 -312
  549. package/fp16/test/ieee-to-fp32-value.cc +0 -420
  550. package/fp16/test/ieee-to-fp32x2-psimd.cc +0 -541
  551. package/fp16/test/peachpy/alt-xmm-to-fp32-xmm-avx.cc +0 -96
  552. package/fp16/test/peachpy/alt-xmm-to-fp32-ymm-avx2.cc +0 -96
  553. package/fp16/test/peachpy/stubs.py +0 -38
  554. package/fp16/test/tables.cc +0 -530
  555. package/fp16/test/tables.h +0 -13
  556. package/fp16/third-party/THHalf.h +0 -92
  557. package/fp16/third-party/eigen-half.h +0 -170
  558. package/fp16/third-party/float16-compressor.h +0 -80
  559. package/fp16/third-party/half.hpp +0 -2916
  560. package/fp16/third-party/npy-halffloat.h +0 -328
  561. package/simsimd/.git-blame-ignore-revs +0 -2
  562. package/simsimd/CONTRIBUTING.md +0 -321
  563. package/simsimd/Cargo.toml +0 -49
  564. package/simsimd/MANIFEST.in +0 -4
  565. package/simsimd/Package.swift +0 -28
  566. package/simsimd/README.md +0 -1493
  567. package/simsimd/binding.gyp +0 -35
  568. package/simsimd/build.rs +0 -70
  569. package/simsimd/c/lib.c +0 -374
  570. package/simsimd/include/module.modulemap +0 -4
  571. package/simsimd/include/simsimd/binary.h +0 -486
  572. package/simsimd/include/simsimd/curved.h +0 -1541
  573. package/simsimd/include/simsimd/dot.h +0 -1853
  574. package/simsimd/include/simsimd/elementwise.h +0 -2465
  575. package/simsimd/include/simsimd/geospatial.h +0 -43
  576. package/simsimd/include/simsimd/mesh.h +0 -69
  577. package/simsimd/include/simsimd/probability.h +0 -606
  578. package/simsimd/include/simsimd/simsimd.h +0 -2567
  579. package/simsimd/include/simsimd/sparse.h +0 -1384
  580. package/simsimd/include/simsimd/spatial.h +0 -2335
  581. package/simsimd/include/simsimd/types.h +0 -666
  582. package/simsimd/javascript/fallback.ts +0 -233
  583. package/simsimd/javascript/lib.c +0 -125
  584. package/simsimd/javascript/node-gyp-build.d.ts +0 -1
  585. package/simsimd/javascript/simsimd.ts +0 -179
  586. package/simsimd/javascript/tsconfig-cjs.json +0 -8
  587. package/simsimd/package-lock.json +0 -1761
  588. package/simsimd/package.json +0 -61
  589. package/simsimd/rust/lib.rs +0 -1821
  590. package/simsimd/scripts/bench.cxx +0 -1170
  591. package/simsimd/scripts/bench.ipynb +0 -187
  592. package/simsimd/scripts/bench.js +0 -127
  593. package/simsimd/scripts/bench.rs +0 -876
  594. package/simsimd/scripts/bench_vectors.py +0 -734
  595. package/simsimd/scripts/bench_vectors_live.py +0 -213
  596. package/simsimd/scripts/test.c +0 -187
  597. package/simsimd/scripts/test.mjs +0 -220
  598. package/simsimd/scripts/test.py +0 -1505
  599. package/simsimd/swift/SimSIMD.swift +0 -149
  600. package/simsimd/swift/Test.swift +0 -128
  601. /package/{simsimd → numkong}/CODE_OF_CONDUCT.md +0 -0
  602. /package/{simsimd → numkong}/LICENSE +0 -0
  603. /package/{simsimd → numkong}/javascript/dist-package-cjs.json +0 -0
  604. /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