feat: add `math/base/special/boxcoxf` by navyansh007 · Pull Request #10150 · stdlib-js/stdlib

navyansh007 · 2026-02-07T15:07:31Z

Resolves #10149

Description

What is the purpose of this pull request?

This pull request:

Adds @stdlib/math/base/special/boxcoxf, a single-precision floating-point one-parameter Box-Cox transformation
Includes C implementation, JavaScript implementation, native addon bindings, tests, benchmarks, and documentation

Related Issues

Does this pull request have any related issues?

This pull request has the following related issues:

Questions

Any questions for reviewers of this pull request?

No.

Other

Any other information relevant to this pull request? This may include screenshots, references, and/or implementation notes.

No.

Checklist

Please ensure the following tasks are completed before submitting this pull request.

Read, understood, and followed the contributing guidelines.

AI Assistance

When authoring the changes proposed in this PR, did you use any kind of AI assistance?

Yes
No

If you answered "yes" above, how did you use AI assistance?

Code generation (e.g., when writing an implementation or fixing a bug)
Test/benchmark generation
Documentation (including examples)
Research and understanding

Disclosure

If you answered "yes" to using AI assistance, please provide a short disclosure indicating how you used AI assistance. This helps reviewers determine how much scrutiny to apply when reviewing your contribution. Example disclosures: "This PR was written primarily by Claude Code." or "I consulted ChatGPT to understand the codebase, but the proposed changes were fully authored manually by myself.".

@stdlib-js/reviewers

…files --- 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 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 ---

--- 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 status: na - task: lint_package_json status: na - task: lint_repl_help status: na - task: lint_javascript_src status: na - task: lint_javascript_cli status: na - task: lint_javascript_examples status: na - task: lint_javascript_tests status: passed - task: lint_javascript_benchmarks status: na - task: lint_python status: missing_dependencies - task: lint_r status: na - task: lint_c_src status: na - task: lint_c_examples status: na - task: lint_c_benchmarks status: na - 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 ---

…pecial/boxcoxf --- 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 status: passed - task: lint_package_json status: na - task: lint_repl_help status: passed - task: lint_javascript_src status: passed - task: lint_javascript_cli status: na - task: lint_javascript_examples status: passed - 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: na - task: lint_c_examples status: na - task: lint_c_benchmarks status: na - task: lint_c_tests_fixtures status: na - task: lint_shell status: na - task: lint_typescript_declarations status: passed - task: lint_typescript_tests status: passed - task: lint_license_headers status: passed ---

stdlib-bot · 2026-02-07T15:10:24Z

Coverage Report

Package	Statements	Branches	Functions	Lines
math/base/special/boxcoxf	$\color{green}205/205$ $\color{green}+0.00%$	$\color{green}13/13$ $\color{green}+0.00%$	$\color{green}2/2$ $\color{green}+0.00%$	$\color{green}205/205$ $\color{green}+0.00%$

The above coverage report was generated for the changes in this PR.

--- 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 status: passed - task: lint_package_json status: na - task: lint_repl_help status: na - task: lint_javascript_src status: passed - task: lint_javascript_cli status: na - task: lint_javascript_examples status: passed - task: lint_javascript_tests status: passed - task: lint_javascript_benchmarks status: passed - task: lint_python status: missing_dependencies - 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: passed - task: lint_license_headers status: passed ---

gunjjoshi · 2026-02-07T15:47:30Z

lib/node_modules/@stdlib/math/base/special/boxcoxf/lib/main.js

+var abs = require( '@stdlib/math/base/special/abs' );
+var isnan = require( '@stdlib/math/base/assert/is-nan' );
+var isPositiveZero = require( '@stdlib/math/base/assert/is-positive-zero' );
+var lnf = require( '@stdlib/math/base/special/lnf' );
+var expm1 = require( '@stdlib/math/base/special/expm1' );


@navyansh007 Any reasons to use double-precision functions here instead of single-precision ones?

Suggested change

var abs = require( '@stdlib/math/base/special/abs' );

var isnan = require( '@stdlib/math/base/assert/is-nan' );

var isPositiveZero = require( '@stdlib/math/base/assert/is-positive-zero' );

var lnf = require( '@stdlib/math/base/special/lnf' );

var expm1 = require( '@stdlib/math/base/special/expm1' );

var absf = require( '@stdlib/math/base/special/absf' );

var isnanf = require( '@stdlib/math/base/assert/is-nanf' );

var isPositiveZerof = require( '@stdlib/math/base/assert/is-positive-zerof' );

var lnf = require( '@stdlib/math/base/special/lnf' );

var expm1f = require( '@stdlib/math/base/special/expm1f' );

Thanks @gunjjoshi. My mistake- I copied the imports directly from math/base/special/boxcox/lib/main.js without switching them to the single-precision equivalents. I'll update abs, isnan, and isPositiveZero to absf, isnanf, and isPositiveZerof.
However, expm1f doesn't currently exist in stdlib, so I'm keeping the double-precision expm1 and casting the result to float32- this matches the approach used in the C implementation as well.

gunjjoshi · 2026-02-07T15:49:01Z

lib/node_modules/@stdlib/math/base/special/boxcoxf/lib/main.js

+// MAIN //
+
+/**
+* Computes a one-parameter Box-Cox transformation for single-precision floating-point number.


Suggested change

* Computes a one-parameter Box-Cox transformation for single-precision floating-point number.

* Computes a one-parameter Box-Cox transformation for a single-precision floating-point number.

gunjjoshi · 2026-02-07T15:51:17Z

lib/node_modules/@stdlib/math/base/special/boxcoxf/lib/main.js

+
+/**
+* Computes a one-parameter Box-Cox transformation for single-precision floating-point number.
+*


@navyansh007 We are missing the "Method" description here, which is present in boxcox

I intentionally left out the Method section because the one in boxcox is specifically a numerical analysis for double-precision (float64). It derives the threshold 1.0e-19 from the float64 epsilon and the range of ln for double-precision numbers. Copying it as-is didn't seem correct to me for boxcoxf, since float32 has a larger epsilon and a different log range, which is why the threshold here is 1.0e-10 instead. I'd be happy to add a Method section with the corresponding float32 analysis. Would you be able to point me in the right direction on how to best frame that, or should I follow the same derivation approach as boxcox but with single-precision constants?

gunjjoshi · 2026-02-07T15:53:42Z

lib/node_modules/@stdlib/math/base/special/boxcoxf/package.json

+{
+  "name": "@stdlib/math/base/special/boxcoxf",
+  "version": "0.0.0",
+  "description": "Compute a one-parameter Box-Cox transformation for single-precision floating-point number.",


Suggested change

"description": "Compute a one-parameter Box-Cox transformation for single-precision floating-point number.",

"description": "Compute a one-parameter Box-Cox transformation for a single-precision floating-point number.",

gunjjoshi · 2026-02-07T15:54:21Z

lib/node_modules/@stdlib/math/base/special/boxcoxf/README.md

+
+# boxcoxf
+
+> Compute a one-parameter [Box-Cox transformation][box-cox-transformation] for single-precision floating-point number.


Suggested change

> Compute a one-parameter [Box-Cox transformation][box-cox-transformation] for single-precision floating-point number.

> Compute a one-parameter [Box-Cox transformation][box-cox-transformation] for a single-precision floating-point number.

Let's use 'a' here and everywhere else in this PR too.

gunjjoshi · 2026-02-07T15:54:59Z

lib/node_modules/@stdlib/math/base/special/boxcoxf/benchmark/c/native/benchmark.c

+	float r;
+	double t;


Suggested change

float r;

double t;

double t;

float r;

navyansh007 added 3 commits February 7, 2026 12:13

stdlib-bot added Math Issue or pull request specific to math functionality. Needs Review A pull request which needs code review. labels Feb 7, 2026

gunjjoshi requested changes Feb 7, 2026

View reviewed changes

gunjjoshi added Needs Changes Pull request which needs changes before being merged. and removed Needs Review A pull request which needs code review. labels Feb 7, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: add `math/base/special/boxcoxf`#10150

feat: add `math/base/special/boxcoxf`#10150
navyansh007 wants to merge 4 commits intostdlib-js:developfrom
navyansh007:boxcoxf-c-implementation

navyansh007 commented Feb 7, 2026

Uh oh!

stdlib-bot commented Feb 7, 2026 •

edited

Loading

Uh oh!

gunjjoshi Feb 7, 2026

Uh oh!

navyansh007 Feb 7, 2026

Uh oh!

gunjjoshi Feb 7, 2026

Uh oh!

gunjjoshi Feb 7, 2026

Uh oh!

navyansh007 Feb 7, 2026

Uh oh!

gunjjoshi Feb 7, 2026

Uh oh!

gunjjoshi Feb 7, 2026

Uh oh!

gunjjoshi Feb 7, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

	* Computes a one-parameter Box-Cox transformation for single-precision floating-point number.
	* Computes a one-parameter Box-Cox transformation for a single-precision floating-point number.

	"description": "Compute a one-parameter Box-Cox transformation for single-precision floating-point number.",
	"description": "Compute a one-parameter Box-Cox transformation for a single-precision floating-point number.",


		# boxcoxf

		> Compute a one-parameter [Box-Cox transformation][box-cox-transformation] for single-precision floating-point number.

Uh oh!

Conversation

navyansh007 commented Feb 7, 2026

Description

Related Issues

Questions

Other

Checklist

AI Assistance

Disclosure

Uh oh!

stdlib-bot commented Feb 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Coverage Report

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

stdlib-bot commented Feb 7, 2026 •

edited

Loading