feat: add `stats/base/ndarray/snanstdev` by aryan7071 · Pull Request #9656 · stdlib-js/stdlib

aryan7071 · 2026-01-09T19:04:07Z

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: passed
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 ---

Description

What is the purpose of this pull request?

This pull request:

add stats/base/ndarray/snanstdev

Related Issues

Does this pull request have any related issues?

This pull request has the following related issues:

#{{TODO: add related issue number}}

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

@stdlib-js/reviewers

--- 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: passed - 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 ---

aryan7071 · 2026-01-09T19:05:06Z

/stdlib update-copyright-years

--- 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: 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: 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: 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: na - task: lint_license_headers status: passed ---

stdlib-bot · 2026-01-09T19:31:37Z

Coverage Report

Package	Statements	Branches	Functions	Lines
stats/base/ndarray/snanstdev	$\color{green}110/110$ $\color{green}+0.00%$	$\color{green}3/3$ $\color{green}+0.00%$	$\color{green}1/1$ $\color{green}+0.00%$	$\color{green}110/110$ $\color{green}+0.00%$

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

Planeshifter

This PR currently has a critical bug.

aryan7071 · 2026-01-10T17:37:15Z

Understood. Updated snanstdev to accept a second zero-dimensional ndarray specifying the degrees of freedom adjustment (correction), and now pass it correctly to snanstdevpn.ndarray.

Updated JSDoc, TypeScript definitions, REPL docs, tests, and benchmarks to reflect the corrected API and verify the actual computed standard deviation values.

--- 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: 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: 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 ---

--- 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: passed - task: lint_javascript_cli status: na - task: lint_javascript_examples status: na - task: lint_javascript_tests status: na - task: lint_javascript_benchmarks status: na - 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: 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: na - 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: 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: passed - task: lint_javascript_cli status: na - task: lint_javascript_examples status: na - task: lint_javascript_tests status: na - 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: 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: 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: 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: passed - task: lint_javascript_tests status: na - task: lint_javascript_benchmarks status: na - 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: 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: passed - task: lint_javascript_cli status: na - task: lint_javascript_examples status: na - task: lint_javascript_tests status: na - task: lint_javascript_benchmarks status: na - 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 ---

--- 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: 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: 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: na - 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: na - task: lint_license_headers status: passed ---

kgryte · 2026-01-27T18:19:38Z

+
+<section class="intro">
+
+This package provides an ndarray interface for computing the standard deviation of a one-dimensional 


This is not the intro comment that we are looking for. See other packages.

kgryte · 2026-01-27T18:20:50Z

+var xbuf = new Float32Array( [ 1.0, 3.0, NaN, 2.0 ] );
+var x = new ndarray( 'float32', xbuf, [ 4 ], [ 1 ], 0, 'row-major' );
+
+var c = new ndarray( 'generic', [ 1 ], [], [ 0 ], 0, 'row-major' );


Look at other packages for their examples. Use scalar2ndarray.

kgryte · 2026-01-27T18:21:33Z

+-   **arrays**: array-like object containing:
+    -   a one-dimensional input ndarray
+    -   a zero-dimensional ndarray specifying a degrees of freedom adjustment


See other packages for how we describe the input arrays.

kgryte · 2026-01-27T18:24:10Z

+    > var correction =
+    ...   {{alias:@stdlib/ndarray/from-scalar}}( 1.0, opts );


Line break not necessary.

kgryte · 2026-01-27T18:24:27Z

+
+/// <reference types="@stdlib/types"/>
+
+import { float32ndarray, ndarray } from '@stdlib/types/ndarray';


Suggested change

import { float32ndarray, ndarray } from '@stdlib/types/ndarray';

import { float32ndarray, typedndarray } from '@stdlib/types/ndarray';

kgryte · 2026-01-27T18:24:37Z

+* var v = snanstdev( [ x, c ] );
+* // returns 1.0
+*/
+declare function snanstdev( arrays: [ float32ndarray, ndarray ] ): number;


Suggested change

declare function snanstdev( arrays: [ float32ndarray, ndarray ] ): number;

declare function snanstdev( arrays: [ float32ndarray, typedndarray<number> ] ): number;

kgryte · 2026-01-27T18:25:14Z

+var getStride = require( '@stdlib/ndarray/base/stride' );
+var getOffset = require( '@stdlib/ndarray/base/offset' );
+var getData = require( '@stdlib/ndarray/base/data-buffer' );
+var strided = require( '@stdlib/stats/base/snanstdevpn' ).ndarray;


Suggested change

var strided = require( '@stdlib/stats/base/snanstdevpn' ).ndarray;

var strided = require( '@stdlib/stats/base/snanstdev' ).ndarray;

kgryte · 2026-01-27T18:27:16Z

+	t.end();
+});
+
+tape( 'the function returns NaN for an empty ndarray', function test( t ) {


Suggestion: take a look at other stdev packages and emulate a bit more closely.

--- 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: na - task: lint_javascript_tests status: na - task: lint_javascript_benchmarks status: na - 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 added Statistics Issue or pull request related to statistical functionality. Needs Review A pull request which needs code review. labels Jan 9, 2026

stdlib-bot added the bot: In Progress Pull request is currently awaiting automation. label Jan 9, 2026

chore: update copyright years

c29e391

stdlib-bot removed the bot: In Progress Pull request is currently awaiting automation. label Jan 9, 2026

aryan7071 added 3 commits January 9, 2026 19:29

Planeshifter changed the title ~~feat: add stats/base/ndarray/snanstdev~~ feat: add stats/base/ndarray/snanstdev Jan 10, 2026

Planeshifter requested changes Jan 10, 2026

View reviewed changes

Planeshifter added Needs Changes Pull request which needs changes before being merged. and removed Needs Review A pull request which needs code review. labels Jan 10, 2026

aryan7071 added 6 commits January 10, 2026 17:59

aryan7071 requested a review from Planeshifter January 11, 2026 18:00

stdlib-bot added the Needs Review A pull request which needs code review. label Jan 11, 2026

Planeshifter requested changes Jan 12, 2026

View reviewed changes

Comment thread lib/node_modules/@stdlib/stats/base/ndarray/snanstdev/docs/types/test.ts Outdated

Comment thread lib/node_modules/@stdlib/stats/base/ndarray/snanstdev/docs/types/test.ts Outdated

Comment thread lib/node_modules/@stdlib/stats/base/ndarray/snanstdev/lib/main.js Outdated

aryan7071 requested a review from Planeshifter January 13, 2026 16:05

aryan7071 mentioned this pull request Jan 13, 2026

Office Hours (2026-01-13) stdlib-js/meetings#72

Closed

aryan7071 added 2 commits January 13, 2026 19:51

aryan7071 mentioned this pull request Jan 27, 2026

Office Hours (2026-01-27) stdlib-js/meetings#76

Closed

kgryte reviewed Jan 27, 2026

View reviewed changes

aryan7071 mentioned this pull request Mar 19, 2026

[RFC]: Provide APIs for computing Fast Fourier Transforms stdlib-js/google-summer-of-code#191

Open

7 tasks


		<section class="intro">

		This package provides an ndarray interface for computing the standard deviation of a one-dimensional

		> var correction =
		... {{alias:@stdlib/ndarray/from-scalar}}( 1.0, opts );


		/// <reference types="@stdlib/types"/>

		import { float32ndarray, ndarray } from '@stdlib/types/ndarray';

	import { float32ndarray, ndarray } from '@stdlib/types/ndarray';
	import { float32ndarray, typedndarray } from '@stdlib/types/ndarray';

	declare function snanstdev( arrays: [ float32ndarray, ndarray ] ): number;
	declare function snanstdev( arrays: [ float32ndarray, typedndarray<number> ] ): number;

	var strided = require( '@stdlib/stats/base/snanstdevpn' ).ndarray;
	var strided = require( '@stdlib/stats/base/snanstdev' ).ndarray;

Uh oh!

Conversation

aryan7071 commented Jan 9, 2026

Description

Related Issues

Questions

Other

Checklist

AI Assistance

Uh oh!

aryan7071 commented Jan 9, 2026

Uh oh!

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

Uh oh!

Coverage Report

Uh oh!

Planeshifter left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

aryan7071 commented Jan 10, 2026

Uh oh!

Uh oh!

Uh oh!

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!

4 participants

stdlib-bot commented Jan 9, 2026 •

edited

Loading

Planeshifter left a comment •

edited

Loading