feat: add stats/base/ndarray/stdev

[iampratik13]

Resolves none

Description

What is the purpose of this pull request?

This pull request:

feat: add stats/base/ndarray/stdev

Related Issues

Does this pull request have any related issues?

This pull request has the following related issues:

none

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.".

{{TODO: add disclosure if applicable}}

---

@stdlib-js/reviewers

[stdlib-bot]

Coverage Report

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

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

[kgryte]

This should be updated to match the README.

[kgryte]

Suggested change

	* @param arrays - array-like object containing an input ndarray and a correction ndarray
	* @param arrays - array-like object containing a one-dimensional input ndarray and a zero-dimensional ndarray specifying a degrees of freedom adjustment

[kgryte]

Suggested change

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

[kgryte]

Suggested change

	declare function stdev<T extends ndarray = ndarray>( arrays: [ T, ndarray ] ): number;
	declare function stdev<T extends typedndarray = typedndarray>( arrays: [ T, T ] ): number;

[kgryte]

Suggested change

	var correction = scalar2ndarray( 1.0, opts );
	console.log( ndarray2array( x ) );
	console.log( ndarray2array( x ) );
	var correction = scalar2ndarray( 1.0, opts );

[kgryte]

Match README.

[kgryte]

Suggested change

	* 'dtype': 'float64'
	* 'dtype': 'generic'

[kgryte]

Suggested change

	* @param {ArrayLikeObject<Object>} arrays - array-like object containing ndarrays
	* @param {ArrayLikeObject<Object>} arrays - array-like object containing a one-dimensional input ndarray and a zero-dimensional ndarray specifying a degrees of freedom adjustment

[kgryte]

Suggested change

	var x;
	var N;
	x = arrays[ 0 ];
	correction = ndarraylike2scalar( arrays[ 1 ] );
	N = numelDimension( x, 0 );
	stride = getStride( x, 0 );
	return strided( N, correction, getData( x ), stride, getOffset( x ) );
	var x;
	x = arrays[ 0 ];
	correction = ndarraylike2scalar( arrays[ 1 ] );
	return strided( numelDimension( x, 0 ), correction, getData( x ), getStride( x, 0 ), getOffset( x ) ); // eslint-disable-line max-len

Consistency with elsewhere.

[kgryte]

Suggested change

	"description": "Compute the standard deviation of one-dimensional ndarrays.",
	"description": "Compute the standard deviation of a one-dimensional ndarray.",

[kgryte]

I suggest sticking closer to the list of keywords in https://github.com/stdlib-js/stdlib/blob/develop/lib/node_modules/%40stdlib/stats/strided/stdev/package.json#L58.

[kgryte]

Left initial comments.