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,394 @@
1
+ #!/usr/bin/env python3
2
+ """Test mesh alignment: nk.kabsch, nk.umeyama, nk.rmsd.
3
+
4
+ Dtypes: float64, float32, float16, bfloat16.
5
+ Baselines: high-precision Decimal Jacobi SVD, SciPy procrustes, NumPy SVD.
6
+ Matches C++ suite: test_mesh.cpp.
7
+ """
8
+
9
+ import atexit
10
+ from collections.abc import Callable
11
+ from typing import TYPE_CHECKING
12
+
13
+ import pytest
14
+
15
+ if TYPE_CHECKING:
16
+ import numpy as np # static-analysis-only; the runtime try/except below is authoritative
17
+
18
+ try:
19
+ import numpy as np
20
+
21
+ numpy_available = True
22
+ except Exception:
23
+ numpy_available = False
24
+
25
+ import numkong as nk
26
+ from test_base import (
27
+ assert_allclose,
28
+ collect_errors,
29
+ create_stats,
30
+ dense_dimensions,
31
+ downcast_f32_to_dtype,
32
+ keep_one_capability,
33
+ make_nk,
34
+ mesh_points,
35
+ nk_seed, # noqa: F401 — pytest fixture
36
+ numpy_available,
37
+ possible_capabilities,
38
+ precise_decimal,
39
+ print_stats_report,
40
+ profile,
41
+ reduced_repetitions_count,
42
+ seed_rng, # noqa: F401 — pytest fixture (autouse)
43
+ tolerances_for_dtype,
44
+ )
45
+
46
+ stats = create_stats()
47
+ atexit.register(print_stats_report, stats)
48
+
49
+ try:
50
+ from scipy.spatial import procrustes as scipy_procrustes
51
+
52
+ def baseline_kabsch(source, target, dtype=None):
53
+ """Reference Kabsch via SciPy procrustes: returns disparity (should be ~0 for identical).
54
+ Returns None if SVD fails to converge (e.g., near-degenerate random point clouds).
55
+ """
56
+ try:
57
+ _, _, disparity = scipy_procrustes(source.astype(np.float64), target.astype(np.float64))
58
+ return disparity
59
+ except np.linalg.LinAlgError:
60
+ return None
61
+
62
+ except ImportError:
63
+ baseline_kabsch = None
64
+
65
+
66
+ def baseline_rmsd(source, target, dtype=None):
67
+ """NumPy reference RMSD: raw √(Σ‖aᵢ − bᵢ‖² / n), no centering."""
68
+ source = source.astype(np.float64)
69
+ target = target.astype(np.float64)
70
+ n_points = source.shape[0]
71
+ return np.sqrt(np.sum((source - target) ** 2) / n_points)
72
+
73
+
74
+ def baseline_umeyama(source, target, dtype=None):
75
+ """NumPy reference Umeyama: SVD-based similarity transform returning scale, rotation, RMSD."""
76
+ source = source.astype(np.float64)
77
+ target = target.astype(np.float64)
78
+ n_points = source.shape[0]
79
+ source_centroid = source.mean(axis=0)
80
+ target_centroid = target.mean(axis=0)
81
+ source_centered = source - source_centroid
82
+ target_centered = target - target_centroid
83
+ cross_covariance = source_centered.T @ target_centered / n_points
84
+ left_vectors, singular_values, right_vectors_transposed = np.linalg.svd(cross_covariance)
85
+ determinant = np.linalg.det(right_vectors_transposed.T @ left_vectors.T)
86
+ sign_vector = np.ones(3)
87
+ sign_vector[-1] = np.sign(determinant)
88
+ rotation = right_vectors_transposed.T @ np.diag(sign_vector) @ left_vectors.T
89
+ source_variance = np.sum(source_centered**2) / n_points
90
+ scale = np.sum(singular_values * sign_vector) / source_variance
91
+ transformed = scale * (source_centered @ rotation.T)
92
+ rmsd_valueue = np.sqrt(np.sum((transformed - target_centered) ** 2) / n_points)
93
+ return {
94
+ "rotation": rotation,
95
+ "scale": scale,
96
+ "rmsd": rmsd_valueue,
97
+ "a_centroid": source_centroid,
98
+ "b_centroid": target_centroid,
99
+ }
100
+
101
+
102
+ def _jacobi_svd_3x3(upcast, sqrt):
103
+ """Return a function that computes 3x3 SVD via Jacobi eigendecomposition.
104
+
105
+ Uses *upcast* and *sqrt* from ``precise_decimal()`` so the same code works
106
+ for both Decimal and float backends.
107
+ """
108
+
109
+ def svd(matrix):
110
+ symmetric = [[sum(matrix[k][i] * matrix[k][j] for k in range(3)) for j in range(3)] for i in range(3)]
111
+ right_vectors = [[upcast(1) if i == j else upcast(0) for j in range(3)] for i in range(3)]
112
+ epsilon = upcast(1e-80)
113
+
114
+ for _ in range(30):
115
+ for p in range(3):
116
+ for q in range(p + 1, 3):
117
+ if abs(symmetric[p][q]) < epsilon:
118
+ continue
119
+ difference = symmetric[q][q] - symmetric[p][p]
120
+ if abs(difference) < epsilon:
121
+ tangent = upcast(1)
122
+ else:
123
+ tau = difference / (2 * symmetric[p][q])
124
+ sign = upcast(1) if tau >= 0 else upcast(-1)
125
+ tangent = sign / (abs(tau) + sqrt(upcast(1) + tau * tau))
126
+ cosine = upcast(1) / sqrt(upcast(1) + tangent * tangent)
127
+ sine = tangent * cosine
128
+ rotated = [row[:] for row in symmetric]
129
+ rotated[p][p] = (
130
+ cosine**2 * symmetric[p][p] - 2 * sine * cosine * symmetric[p][q] + sine**2 * symmetric[q][q]
131
+ )
132
+ rotated[q][q] = (
133
+ sine**2 * symmetric[p][p] + 2 * sine * cosine * symmetric[p][q] + cosine**2 * symmetric[q][q]
134
+ )
135
+ rotated[p][q] = rotated[q][p] = upcast(0)
136
+ for r in range(3):
137
+ if r != p and r != q:
138
+ rotated[p][r] = rotated[r][p] = cosine * symmetric[p][r] - sine * symmetric[q][r]
139
+ rotated[q][r] = rotated[r][q] = sine * symmetric[p][r] + cosine * symmetric[q][r]
140
+ symmetric = rotated
141
+ for r in range(3):
142
+ old_p, old_q = right_vectors[r][p], right_vectors[r][q]
143
+ right_vectors[r][p] = cosine * old_p - sine * old_q
144
+ right_vectors[r][q] = sine * old_p + cosine * old_q
145
+
146
+ singular_values = [sqrt(symmetric[i][i]) if symmetric[i][i] > 0 else upcast(0) for i in range(3)]
147
+ order = sorted(range(3), key=lambda i: -singular_values[i])
148
+ singular_values = [singular_values[i] for i in order]
149
+ right_vectors = [[right_vectors[r][order[c]] for c in range(3)] for r in range(3)]
150
+
151
+ left_vectors = [[upcast(0)] * 3 for _ in range(3)]
152
+ for i in range(3):
153
+ if singular_values[i] > epsilon:
154
+ column = [sum(matrix[r][k] * right_vectors[k][i] for k in range(3)) for r in range(3)]
155
+ for r in range(3):
156
+ left_vectors[r][i] = column[r] / singular_values[i]
157
+
158
+ return left_vectors, singular_values, right_vectors
159
+
160
+ return svd
161
+
162
+
163
+ def _center_and_covariance(source, target, upcast):
164
+ """Convert points via *upcast*, center, and compute cross-covariance. Returns
165
+ (source_centered, target_centered, cross_covariance, n_points).
166
+ """
167
+ n_points = len(source)
168
+ source_precise = [[upcast(value) for value in row] for row in source]
169
+ target_precise = [[upcast(value) for value in row] for row in target]
170
+ source_centroid = [sum(source_precise[i][j] for i in range(n_points)) / n_points for j in range(3)]
171
+ target_centroid = [sum(target_precise[i][j] for i in range(n_points)) / n_points for j in range(3)]
172
+ source_centered = [[source_precise[i][j] - source_centroid[j] for j in range(3)] for i in range(n_points)]
173
+ target_centered = [[target_precise[i][j] - target_centroid[j] for j in range(3)] for i in range(n_points)]
174
+ cross_covariance = [
175
+ [sum(source_centered[k][i] * target_centered[k][j] for k in range(n_points)) for j in range(3)]
176
+ for i in range(3)
177
+ ]
178
+ return source_centered, target_centered, cross_covariance, n_points
179
+
180
+
181
+ def _determinant_3x3(matrix):
182
+ """Determinant of a 3x3 list-of-lists matrix."""
183
+ return (
184
+ matrix[0][0] * (matrix[1][1] * matrix[2][2] - matrix[1][2] * matrix[2][1])
185
+ - matrix[0][1] * (matrix[1][0] * matrix[2][2] - matrix[1][2] * matrix[2][0])
186
+ + matrix[0][2] * (matrix[1][0] * matrix[2][1] - matrix[1][1] * matrix[2][0])
187
+ )
188
+
189
+
190
+ def precise_rmsd(source, target, dtype=None):
191
+ """High-precision raw RMSD: √(Σ‖aᵢ − bᵢ‖² / n). No centering, no SVD."""
192
+ with precise_decimal(dtype) as (upcast, sqrt, _ln):
193
+ n_points = len(source)
194
+ total = upcast(0)
195
+ for i in range(n_points):
196
+ for j in range(3):
197
+ difference = upcast(source[i][j]) - upcast(target[i][j])
198
+ total += difference**2
199
+ return float(sqrt(total / n_points))
200
+
201
+
202
+ def precise_kabsch(source, target, dtype=None):
203
+ """High-precision Kabsch via Jacobi SVD. Returns RMSD after optimal rotation."""
204
+ with precise_decimal(dtype) as (upcast, sqrt, _ln):
205
+ source_centered, target_centered, cross_covariance, n_points = _center_and_covariance(source, target, upcast)
206
+ jacobi_svd = _jacobi_svd_3x3(upcast, sqrt)
207
+ left_vectors, _, right_vectors = jacobi_svd(cross_covariance)
208
+ # R = V Uᵀ, fix reflection if det(R) < 0
209
+ rotation = [
210
+ [sum(right_vectors[r][k] * left_vectors[c][k] for k in range(3)) for c in range(3)] for r in range(3)
211
+ ]
212
+ if _determinant_3x3(rotation) < 0:
213
+ for r in range(3):
214
+ right_vectors[r][2] = -right_vectors[r][2]
215
+ rotation = [
216
+ [sum(right_vectors[r][k] * left_vectors[c][k] for k in range(3)) for c in range(3)] for r in range(3)
217
+ ]
218
+ # RMSD after rotation
219
+ total = upcast(0)
220
+ for i in range(n_points):
221
+ rotated = [sum(rotation[r][k] * source_centered[i][k] for k in range(3)) for r in range(3)]
222
+ for j in range(3):
223
+ total += (rotated[j] - target_centered[i][j]) ** 2
224
+ return float(sqrt(total / n_points))
225
+
226
+
227
+ def precise_umeyama(source, target, dtype=None):
228
+ """High-precision Umeyama via Jacobi SVD. Returns scale factor."""
229
+ with precise_decimal(dtype) as (upcast, sqrt, _ln):
230
+ source_centered, target_centered, cross_covariance, n_points = _center_and_covariance(source, target, upcast)
231
+ jacobi_svd = _jacobi_svd_3x3(upcast, sqrt)
232
+ left_vectors, singular_values, right_vectors = jacobi_svd(cross_covariance)
233
+ rotation = [
234
+ [sum(right_vectors[r][k] * left_vectors[c][k] for k in range(3)) for c in range(3)] for r in range(3)
235
+ ]
236
+ determinant_sign = upcast(1) if _determinant_3x3(rotation) >= 0 else upcast(-1)
237
+ if determinant_sign < 0:
238
+ for r in range(3):
239
+ right_vectors[r][2] = -right_vectors[r][2]
240
+ rotation = [
241
+ [sum(right_vectors[r][k] * left_vectors[c][k] for k in range(3)) for c in range(3)] for r in range(3)
242
+ ]
243
+ source_variance = sum(source_centered[i][j] ** 2 for i in range(n_points) for j in range(3)) / n_points
244
+ scale = (singular_values[0] + singular_values[1] + determinant_sign * singular_values[2]) / (
245
+ n_points * source_variance
246
+ )
247
+ return float(scale)
248
+
249
+
250
+ KERNELS_MESH: dict[str, tuple[Callable | None, Callable, Callable]] = {
251
+ "kabsch": (baseline_kabsch, nk.kabsch, precise_kabsch),
252
+ "umeyama": (baseline_umeyama if numpy_available else None, nk.umeyama, precise_umeyama),
253
+ "rmsd": (baseline_rmsd if numpy_available else None, nk.rmsd, precise_rmsd),
254
+ }
255
+
256
+
257
+ def _make_point_pair(n_points, dtype):
258
+ """Create two distinct (n_points, 3) point clouds as (raw, baseline) pairs.
259
+
260
+ Returns (source_raw, source_baseline, target_raw, target_baseline).
261
+ """
262
+ source_f32 = np.random.randn(n_points, 3).astype(np.float32)
263
+ target_f32 = np.random.randn(n_points, 3).astype(np.float32)
264
+ source_raw, source_baseline = downcast_f32_to_dtype(source_f32, dtype)
265
+ target_raw, target_baseline = downcast_f32_to_dtype(target_f32, dtype)
266
+ return source_raw, source_baseline, target_raw, target_baseline
267
+
268
+
269
+ @pytest.mark.skipif(not numpy_available, reason="NumPy is not installed")
270
+ @pytest.mark.repeat(reduced_repetitions_count)
271
+ @pytest.mark.parametrize("n_points", [mesh_points])
272
+ @pytest.mark.parametrize("dtype", ["float64", "float32", "float16", "bfloat16"])
273
+ @pytest.mark.parametrize("capability", possible_capabilities)
274
+ def test_rmsd_accuracy(n_points: int, dtype: str, capability: str, nk_seed: int):
275
+ """RMSD of random point clouds against high-precision baseline."""
276
+ if n_points < 3:
277
+ pytest.skip("RMSD requires at least 3 points")
278
+
279
+ source_raw, source_baseline, target_raw, target_baseline = _make_point_pair(n_points, dtype)
280
+ atol, rtol = tolerances_for_dtype(dtype)
281
+
282
+ keep_one_capability(capability)
283
+ baseline_kernel, simd_kernel, precise_kernel = KERNELS_MESH["rmsd"]
284
+
285
+ # High-precision baseline
286
+ accurate_dt, accurate = profile(precise_kernel or baseline_kernel, source_baseline, target_baseline, dtype=dtype)
287
+
288
+ # Native-precision baseline
289
+ if baseline_kernel is not None:
290
+ expected_dt, expected = profile(baseline_kernel, source_baseline, target_baseline, dtype=dtype)
291
+ else:
292
+ expected_dt, expected = 0, None
293
+
294
+ # SIMD result
295
+ source_nk = make_nk(source_raw, dtype)
296
+ target_nk = make_nk(target_raw, dtype)
297
+ result_dt, result_obj = profile(simd_kernel, source_nk, target_nk)
298
+ result = float(np.array(result_obj.rmsd))
299
+
300
+ assert_allclose(result, accurate, atol=atol, rtol=rtol)
301
+ collect_errors("rmsd", n_points, dtype, accurate, accurate_dt, expected, expected_dt, result, result_dt, stats)
302
+
303
+
304
+ @pytest.mark.skipif(not numpy_available, reason="NumPy is not installed")
305
+ @pytest.mark.repeat(reduced_repetitions_count)
306
+ @pytest.mark.parametrize("n_points", [mesh_points])
307
+ @pytest.mark.parametrize("dtype", ["float64", "float32", "float16", "bfloat16"])
308
+ @pytest.mark.parametrize("capability", possible_capabilities)
309
+ def test_kabsch_accuracy(n_points: int, dtype: str, capability: str, nk_seed: int):
310
+ """Kabsch RMSD of random point clouds against high-precision Jacobi SVD baseline."""
311
+ if n_points < 3:
312
+ pytest.skip("Kabsch requires at least 3 non-degenerate points")
313
+
314
+ source_raw, source_baseline, target_raw, target_baseline = _make_point_pair(n_points, dtype)
315
+ atol, rtol = tolerances_for_dtype(dtype)
316
+
317
+ keep_one_capability(capability)
318
+ baseline_kernel, simd_kernel, precise_kernel = KERNELS_MESH["kabsch"]
319
+
320
+ # High-precision baseline → scalar RMSD after optimal rotation
321
+ accurate_dt, accurate = profile(precise_kernel or baseline_kernel, source_baseline, target_baseline, dtype=dtype)
322
+
323
+ # SIMD result
324
+ source_nk = make_nk(source_raw, dtype)
325
+ target_nk = make_nk(target_raw, dtype)
326
+ result_dt, result_obj = profile(simd_kernel, source_nk, target_nk)
327
+ result = float(np.array(result_obj.rmsd))
328
+
329
+ assert_allclose(result, accurate, atol=atol, rtol=rtol)
330
+ collect_errors("kabsch", n_points, dtype, accurate, accurate_dt, None, 0, result, result_dt, stats)
331
+
332
+
333
+ @pytest.mark.skipif(not numpy_available, reason="NumPy is not installed")
334
+ @pytest.mark.repeat(reduced_repetitions_count)
335
+ @pytest.mark.parametrize("n_points", [mesh_points])
336
+ @pytest.mark.parametrize("dtype", ["float64", "float32", "float16", "bfloat16"])
337
+ @pytest.mark.parametrize("capability", possible_capabilities)
338
+ def test_umeyama_accuracy(n_points: int, dtype: str, capability: str, nk_seed: int):
339
+ """Umeyama scale of random point clouds against high-precision baseline."""
340
+ if n_points < 3:
341
+ pytest.skip("Umeyama requires at least 3 non-degenerate points")
342
+
343
+ # Generate source and a scaled+noisy version so the scale is non-trivial
344
+ source_f32 = np.random.randn(n_points, 3).astype(np.float32)
345
+ scale_factor = 1.5 + np.random.rand() # random scale in [1.5, 2.5]
346
+ target_f32 = (source_f32 * scale_factor + np.random.randn(n_points, 3).astype(np.float32) * 0.01).astype(np.float32)
347
+ source_raw, source_baseline = downcast_f32_to_dtype(source_f32, dtype)
348
+ target_raw, target_baseline = downcast_f32_to_dtype(target_f32, dtype)
349
+ atol, rtol = tolerances_for_dtype(dtype)
350
+
351
+ keep_one_capability(capability)
352
+ baseline_kernel, simd_kernel, precise_kernel = KERNELS_MESH["umeyama"]
353
+
354
+ # High-precision baseline → scalar scale factor
355
+ accurate_dt, accurate = profile(precise_kernel or baseline_kernel, source_baseline, target_baseline, dtype=dtype)
356
+
357
+ # SIMD result
358
+ source_nk = make_nk(source_raw, dtype)
359
+ target_nk = make_nk(target_raw, dtype)
360
+ result_dt, result_obj = profile(simd_kernel, source_nk, target_nk)
361
+ result = float(np.array(result_obj.scale))
362
+
363
+ assert_allclose(result, accurate, atol=atol, rtol=rtol)
364
+ collect_errors("umeyama", n_points, dtype, accurate, accurate_dt, None, 0, result, result_dt, stats)
365
+
366
+
367
+ @pytest.mark.parametrize("n_points", dense_dimensions)
368
+ @pytest.mark.parametrize("capability", possible_capabilities)
369
+ def test_rmsd_self_zero(n_points: int, capability: str):
370
+ """rmsd(cloud, cloud).rmsd ~ 0 for identical point clouds."""
371
+ if n_points < 3:
372
+ pytest.skip("RMSD requires at least 3 points")
373
+ keep_one_capability(capability)
374
+ point_cloud = nk.ones((n_points, 3), dtype="float64")
375
+ result = nk.rmsd(point_cloud, point_cloud)
376
+ assert_allclose(float(result.rmsd), 0.0)
377
+
378
+
379
+ @pytest.mark.skipif(not numpy_available, reason="NumPy is not installed")
380
+ @pytest.mark.parametrize("n_points", dense_dimensions)
381
+ @pytest.mark.parametrize("dtype", ["float64", "float32"])
382
+ @pytest.mark.parametrize("capability", possible_capabilities)
383
+ def test_kabsch_identity(n_points: int, dtype: str, capability: str):
384
+ """Kabsch on identical points: expects RMSD~0 and scale~1."""
385
+ if n_points < 3:
386
+ pytest.skip("Kabsch requires at least 3 non-degenerate points")
387
+ points_f32 = np.random.randn(n_points, 3).astype(np.float32)
388
+ points_raw, _ = downcast_f32_to_dtype(points_f32, dtype)
389
+ point_cloud = make_nk(points_raw, dtype)
390
+ keep_one_capability(capability)
391
+ result = nk.kabsch(point_cloud, point_cloud)
392
+ atol, rtol = tolerances_for_dtype(dtype)
393
+ assert_allclose(float(np.array(result.rmsd)), 0.0, atol=atol, rtol=rtol)
394
+ assert_allclose(float(np.array(result.scale)), 1.0, atol=atol, rtol=rtol)
@@ -0,0 +1,136 @@
1
+ /**
2
+ * @brief KL-divergence and Jensen-Shannon distance tests.
3
+ * @file test/test_probability.cpp
4
+ * @author Ash Vardanian
5
+ * @date December 28, 2025
6
+ */
7
+
8
+ #include "test.hpp"
9
+ #include "numkong/probability.hpp" // `nk::kld`
10
+
11
+ /**
12
+ * @brief Template for KL divergence test.
13
+ * KLD requires probability distributions: all values > 0, sum to 1.
14
+ */
15
+ template <typename scalar_type_>
16
+ error_stats_t test_kld(typename scalar_type_::probability_kernel_t kernel) {
17
+ using scalar_t = scalar_type_;
18
+ using raw_t = typename scalar_t::raw_t;
19
+ using result_t = typename scalar_t::probability_result_t;
20
+ using reference_t = reference_for<scalar_t>;
21
+
22
+ error_stats_t stats(comparison_family_t::probability_k);
23
+ std::mt19937 generator(global_config.seed);
24
+ auto p = make_vector<scalar_t>(global_config.dense_dimensions),
25
+ q = make_vector<scalar_t>(global_config.dense_dimensions);
26
+
27
+ for (auto start = test_start_time(); within_time_budget(start);) {
28
+ nk::fill_probability(generator, p.values_data(), global_config.dense_dimensions);
29
+ nk::fill_probability(generator, q.values_data(), global_config.dense_dimensions);
30
+
31
+ result_t result;
32
+ kernel(p.raw_values_data(), q.raw_values_data(), global_config.dense_dimensions, &result.raw_);
33
+
34
+ reference_t reference;
35
+ nk::kld<scalar_t, reference_t, nk::no_simd_k>(p.values_data(), q.values_data(), global_config.dense_dimensions,
36
+ &reference);
37
+
38
+ stats.accumulate(result, reference);
39
+ }
40
+
41
+ return stats;
42
+ }
43
+
44
+ /**
45
+ * @brief Template for Jensen-Shannon distance test.
46
+ * JSD requires probability distributions: all values > 0, sum to 1.
47
+ */
48
+ template <typename scalar_type_>
49
+ error_stats_t test_jsd(typename scalar_type_::probability_kernel_t kernel) {
50
+ using scalar_t = scalar_type_;
51
+ using raw_t = typename scalar_t::raw_t;
52
+ using result_t = typename scalar_t::probability_result_t;
53
+ using reference_t = reference_for<scalar_t>;
54
+
55
+ error_stats_t stats(comparison_family_t::probability_k);
56
+ std::mt19937 generator(global_config.seed);
57
+ auto p = make_vector<scalar_t>(global_config.dense_dimensions),
58
+ q = make_vector<scalar_t>(global_config.dense_dimensions);
59
+
60
+ for (auto start = test_start_time(); within_time_budget(start);) {
61
+ nk::fill_probability(generator, p.values_data(), global_config.dense_dimensions);
62
+ nk::fill_probability(generator, q.values_data(), global_config.dense_dimensions);
63
+
64
+ result_t result;
65
+ kernel(p.raw_values_data(), q.raw_values_data(), global_config.dense_dimensions, &result.raw_);
66
+
67
+ reference_t reference;
68
+ nk::jsd<scalar_t, reference_t, nk::no_simd_k>(p.values_data(), q.values_data(), global_config.dense_dimensions,
69
+ &reference);
70
+
71
+ stats.accumulate(result, reference);
72
+ }
73
+
74
+ return stats;
75
+ }
76
+
77
+ void test_probability() {
78
+ error_stats_section_t check("Probability Divergences");
79
+
80
+ #if NK_DYNAMIC_DISPATCH
81
+ check("kld_f32", test_kld<f32_t>, nk_kld_f32);
82
+ check("kld_f64", test_kld<f64_t>, nk_kld_f64);
83
+ check("kld_f16", test_kld<f16_t>, nk_kld_f16);
84
+ check("kld_bf16", test_kld<bf16_t>, nk_kld_bf16);
85
+ check("jsd_f32", test_jsd<f32_t>, nk_jsd_f32);
86
+ check("jsd_f64", test_jsd<f64_t>, nk_jsd_f64);
87
+ check("jsd_f16", test_jsd<f16_t>, nk_jsd_f16);
88
+ check("jsd_bf16", test_jsd<bf16_t>, nk_jsd_bf16);
89
+ #else
90
+
91
+ #if NK_TARGET_NEON
92
+ check("kld_f32_neon", test_kld<f32_t>, nk_kld_f32_neon);
93
+ check("jsd_f32_neon", test_jsd<f32_t>, nk_jsd_f32_neon);
94
+ check("kld_f16_neon", test_kld<f16_t>, nk_kld_f16_neon);
95
+ check("jsd_f16_neon", test_jsd<f16_t>, nk_jsd_f16_neon);
96
+ #endif // NK_TARGET_NEON
97
+
98
+ #if NK_TARGET_HASWELL
99
+ check("kld_f16_haswell", test_kld<f16_t>, nk_kld_f16_haswell);
100
+ check("kld_f64_haswell", test_kld<f64_t>, nk_kld_f64_haswell);
101
+ check("jsd_f16_haswell", test_jsd<f16_t>, nk_jsd_f16_haswell);
102
+ check("jsd_f64_haswell", test_jsd<f64_t>, nk_jsd_f64_haswell);
103
+ #endif // NK_TARGET_HASWELL
104
+
105
+ #if NK_TARGET_SKYLAKE
106
+ check("kld_f32_skylake", test_kld<f32_t>, nk_kld_f32_skylake);
107
+ check("kld_f64_skylake", test_kld<f64_t>, nk_kld_f64_skylake);
108
+ check("jsd_f32_skylake", test_jsd<f32_t>, nk_jsd_f32_skylake);
109
+ check("jsd_f64_skylake", test_jsd<f64_t>, nk_jsd_f64_skylake);
110
+ check("kld_f16_skylake", test_kld<f16_t>, nk_kld_f16_skylake);
111
+ check("jsd_f16_skylake", test_jsd<f16_t>, nk_jsd_f16_skylake);
112
+ #endif // NK_TARGET_SKYLAKE
113
+
114
+ #if NK_TARGET_RVV
115
+ check("kld_f32_rvv", test_kld<f32_t>, nk_kld_f32_rvv);
116
+ check("kld_f64_rvv", test_kld<f64_t>, nk_kld_f64_rvv);
117
+ check("kld_f16_rvv", test_kld<f16_t>, nk_kld_f16_rvv);
118
+ check("kld_bf16_rvv", test_kld<bf16_t>, nk_kld_bf16_rvv);
119
+ check("jsd_f32_rvv", test_jsd<f32_t>, nk_jsd_f32_rvv);
120
+ check("jsd_f64_rvv", test_jsd<f64_t>, nk_jsd_f64_rvv);
121
+ check("jsd_f16_rvv", test_jsd<f16_t>, nk_jsd_f16_rvv);
122
+ check("jsd_bf16_rvv", test_jsd<bf16_t>, nk_jsd_bf16_rvv);
123
+ #endif // NK_TARGET_RVV
124
+
125
+ // Serial always runs - baseline test
126
+ check("kld_f32_serial", test_kld<f32_t>, nk_kld_f32_serial);
127
+ check("kld_f64_serial", test_kld<f64_t>, nk_kld_f64_serial);
128
+ check("kld_bf16_serial", test_kld<bf16_t>, nk_kld_bf16_serial);
129
+ check("kld_f16_serial", test_kld<f16_t>, nk_kld_f16_serial);
130
+ check("jsd_f32_serial", test_jsd<f32_t>, nk_jsd_f32_serial);
131
+ check("jsd_f64_serial", test_jsd<f64_t>, nk_jsd_f64_serial);
132
+ check("jsd_bf16_serial", test_jsd<bf16_t>, nk_jsd_bf16_serial);
133
+ check("jsd_f16_serial", test_jsd<f16_t>, nk_jsd_f16_serial);
134
+
135
+ #endif // NK_DYNAMIC_DISPATCH
136
+ }