From 2fd989063d1f6d27a8a7be4c90d10a0e372614db Mon Sep 17 00:00:00 2001 From: Philipp Burckhardt Date: Sun, 20 Sep 2026 23:46:46 -0500 Subject: [PATCH 1/2] feat: add C implementation for `math/base/special/betaincinv` This commit adds a C/native implementation for the inverse of the regularized incomplete beta function. The C implementation delegates to the kernel-betaincinv C implementation for numerical inversion. The following files are added or modified: - Public header (betaincinv.h) - C implementation (src/main.c) delegating to kernel_betaincinv - Native add-on (src/addon.c) - Build configuration (binding.gyp, include.gypi, manifest.json) - Native JavaScript wrapper (lib/native.js) - Native JavaScript benchmark (benchmark/benchmark.native.js) - C benchmark (benchmark/c/native/) - C example (examples/c/) - Native tests (test/test.native.js) - README C API documentation - Updated package.json with gypfile and native directories Co-Authored-By: Claude Opus 5 (1M context) --- type: pre_commit_static_analysis_report description: Results of running static analysis checks when committing changes. report: - task: lint_filenames status: passed - task: lint_editorconfig status: passed - task: lint_markdown_pkg_readmes status: passed - task: lint_markdown_docs status: na - task: lint_markdown status: na - task: lint_package_json status: passed - task: lint_repl_help status: na - task: lint_javascript_src status: passed - task: lint_javascript_cli status: na - task: lint_javascript_examples status: na - task: lint_javascript_tests status: passed - task: lint_javascript_benchmarks status: passed - task: lint_python status: na - task: lint_r status: na - task: lint_c_src status: passed - task: lint_c_examples status: passed - task: lint_c_benchmarks status: passed - task: lint_c_tests_fixtures status: na - task: lint_shell status: na - task: lint_typescript_declarations status: passed - task: lint_typescript_tests status: na - task: lint_license_headers status: passed --- --- .../math/base/special/betaincinv/README.md | 106 +++++++++++ .../betaincinv/benchmark/benchmark.native.js | 67 +++++++ .../betaincinv/benchmark/c/native/Makefile | 146 +++++++++++++++ .../betaincinv/benchmark/c/native/benchmark.c | 144 +++++++++++++++ .../math/base/special/betaincinv/binding.gyp | 170 +++++++++++++++++ .../special/betaincinv/examples/c/Makefile | 146 +++++++++++++++ .../special/betaincinv/examples/c/example.c | 43 +++++ .../math/base/special/betaincinv/include.gypi | 53 ++++++ .../stdlib/math/base/special/betaincinv.h | 40 ++++ .../base/special/betaincinv/lib/native.js | 56 ++++++ .../base/special/betaincinv/manifest.json | 79 ++++++++ .../math/base/special/betaincinv/package.json | 3 + .../math/base/special/betaincinv/src/Makefile | 70 +++++++ .../math/base/special/betaincinv/src/addon.c | 44 +++++ .../math/base/special/betaincinv/src/main.c | 60 ++++++ .../special/betaincinv/test/test.native.js | 171 ++++++++++++++++++ 16 files changed, 1398 insertions(+) create mode 100644 lib/node_modules/@stdlib/math/base/special/betaincinv/benchmark/benchmark.native.js create mode 100644 lib/node_modules/@stdlib/math/base/special/betaincinv/benchmark/c/native/Makefile create mode 100644 lib/node_modules/@stdlib/math/base/special/betaincinv/benchmark/c/native/benchmark.c create mode 100644 lib/node_modules/@stdlib/math/base/special/betaincinv/binding.gyp create mode 100644 lib/node_modules/@stdlib/math/base/special/betaincinv/examples/c/Makefile create mode 100644 lib/node_modules/@stdlib/math/base/special/betaincinv/examples/c/example.c create mode 100644 lib/node_modules/@stdlib/math/base/special/betaincinv/include.gypi create mode 100644 lib/node_modules/@stdlib/math/base/special/betaincinv/include/stdlib/math/base/special/betaincinv.h create mode 100644 lib/node_modules/@stdlib/math/base/special/betaincinv/lib/native.js create mode 100644 lib/node_modules/@stdlib/math/base/special/betaincinv/manifest.json create mode 100644 lib/node_modules/@stdlib/math/base/special/betaincinv/src/Makefile create mode 100644 lib/node_modules/@stdlib/math/base/special/betaincinv/src/addon.c create mode 100644 lib/node_modules/@stdlib/math/base/special/betaincinv/src/main.c create mode 100644 lib/node_modules/@stdlib/math/base/special/betaincinv/test/test.native.js diff --git a/lib/node_modules/@stdlib/math/base/special/betaincinv/README.md b/lib/node_modules/@stdlib/math/base/special/betaincinv/README.md index 52fa6937db7d..502758485ddd 100644 --- a/lib/node_modules/@stdlib/math/base/special/betaincinv/README.md +++ b/lib/node_modules/@stdlib/math/base/special/betaincinv/README.md @@ -144,6 +144,112 @@ logEachMap( 'p: %0.4f, \t a: %0.4f, \t b: %0.4f, \t f(p,a,b): %0.4f', p, a, b, b + + +* * * + +
+ +## C APIs + + + +
+ +
+ + + + + +
+ +### Usage + +```c +#include "stdlib/math/base/special/betaincinv.h" +``` + +#### stdlib_base_betaincinv( p, a, b, upper ) + +Inverts the regularized incomplete beta function. + +```c +double y = stdlib_base_betaincinv( 0.2, 3.0, 3.0, false ); +// returns ~0.327 + +y = stdlib_base_betaincinv( 0.4, 3.0, 3.0, false ); +// returns ~0.446 + +y = stdlib_base_betaincinv( 0.4, 3.0, 3.0, true ); +// returns ~0.554 +``` + +The function accepts the following arguments: + +- **p**: `[in] double` input probability. +- **a**: `[in] double` first shape parameter. +- **b**: `[in] double` second shape parameter. +- **upper**: `[in] bool` boolean indicating if the function should invert the upper tail of the incomplete beta function. + +```c +double stdlib_base_betaincinv( const double p, const double a, const double b, const bool upper ); +``` + +
+ + + + + +
+ +
+ + + + + +
+ +### Examples + +```c +#include "stdlib/math/base/special/betaincinv.h" +#include +#include +#include + +static double random_uniform( const double min, const double max ) { + double v = (double)rand() / ( (double)RAND_MAX + 1.0 ); + return min + ( v*(max-min) ); +} + +int main( void ) { + double p; + double a; + double b; + double y; + int i; + + for ( i = 0; i < 100; i++ ) { + p = random_uniform( 0.0, 1.0 ); + a = random_uniform( 0.0, 10.0 ); + b = random_uniform( 0.0, 10.0 ); + y = stdlib_base_betaincinv( p, a, b, false ); + printf( "p: %lf, a: %lf, b: %lf, y: %lf\n", p, a, b, y ); + } +} +``` + +
+ + + +
+ + +