Skip to content

docs: contributors + complete Cholesky decomposition scaffolding#52

Merged
erfanjazebnikoo merged 2 commits into
devfrom
docs/contributors-and-cholesky-scaffolding
Jul 9, 2026
Merged

docs: contributors + complete Cholesky decomposition scaffolding#52
erfanjazebnikoo merged 2 commits into
devfrom
docs/contributors-and-cholesky-scaffolding

Conversation

@erfanjazebnikoo

Copy link
Copy Markdown
Member

Summary

On the validation

Only ARM64/Apple M4 Pro is covered so far (ASan/UBSan clean, both float32 and float64, strict -Wall -Wextra -Werror clean). Flagged clearly in the validation doc that the full platform sweep (Windows, Raspberry Pi, ESP32-S3, Linux x86-64) is still needed before this carries the same weight as the rest of linalg. Recommend not promoting to main / cutting a release until that's done.

Test plan

  • Clean build, 335/335 tests pass (329 + 6 Cholesky)
  • ASan + UBSan clean
  • Strict C99 compile clean in both float32 and float64

Adds a CONTRIBUTORS.md crediting Amir Ab Khoshk (hardware validation
lead), Sepand Haghighi (reviewed and merged the project's original 2021
integration prototype, later archived under archive/legacy_integral/ and
used as the algorithmic basis for Phase 1's integrate module), and Erfan
Esmaeili (Cholesky decomposition, #51). Linked from README.md.
Adds the pieces every other function in this library has, on top of the
implementation and tests from #51 (Erfan Esmaeili):

- docs/algorithms/linalg.md: math formulation, complexity row, when
  to/not to use (including the symmetry-not-checked caveat)
- validation/c/val_runner.c: benchmark + correctness check, same textbook
  matrix as the unit tests
- validation/results/linalg/cholesky_decompose.md: first validation pass
  (ARM64/Apple M4 Pro, ASan/UBSan clean, both precisions), flagged as
  needing the full platform sweep before it matches the rest of linalg
- README.md and CHANGELOG.md updated to mention the function

Verified before committing: clean build, 335/335 tests (329 base + 6
Cholesky), ASan/UBSan clean, strict -Wall -Wextra -Werror clean in both
float32 and float64.
@erfanjazebnikoo
erfanjazebnikoo merged commit 5a712ae into dev Jul 9, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant