feat: add stats/base/ndarray/dcovarmtk

[gururaj1512]

---

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

Resolves None

Description

What is the purpose of this pull request?

This pull request:

• feat: add stats/base/ndarray/dcovarmtk

Related Issues

Does this pull request have any related issues?

This pull request:

• resolves 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.

---

@stdlib-js/reviewers

[stdlib-bot]

Coverage Report

Package	Statements	Branches	Functions	Lines
stats/base/ndarray/dcovarmtk	$\color{green}148/148$ $\color{green}+100.00\%$	$\color{green}3/3$ $\color{green}+100.00\%$	$\color{green}1/1$ $\color{green}+100.00\%$	$\color{green}148/148$ $\color{green}+100.00\%$

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

[kgryte]

Suggested change

	4. a zero-dimensional ndarray specifying mean of the first one-dimensional ndarray.
	5. a zero-dimensional ndarray specifying mean of the second one-dimensional ndarray.
	4. a zero-dimensional ndarray specifying the mean of the first one-dimensional ndarray.
	5. a zero-dimensional ndarray specifying the mean of the second one-dimensional ndarray.

[kgryte]

Suggested change

3. a zero-dimensional ndarray specifying degrees of freedom adjustment. Setting this parameter to a value other than `0` has the effect of adjusting the divisor during the calculation of the [covariance][covariance] according to `N-c` where `c` corresponds to the provided degrees of freedom adjustment. When computing the population [covariance][covariance], setting this parameter to `0` is the standard choice (i.e., the provided arrays contain data constituting entire populations). When computing the unbiased sample [covariance][covariance], setting this parameter to `1` is the standard choice (i.e., the provided arrays contain data sampled from larger populations; this is commonly referred to as Bessel's correction).

3. a zero-dimensional ndarray specifying the degrees of freedom adjustment. Setting this parameter to a value other than `0` has the effect of adjusting the divisor during the calculation of the [covariance][covariance] according to `N-c` where `c` corresponds to the provided degrees of freedom adjustment and `N` corresponds to the number of elements in each input ndarray. When computing the population [covariance][covariance], setting this parameter to `0` is the standard choice (i.e., the provided arrays contain data constituting entire populations). When computing the unbiased sample [covariance][covariance], setting this parameter to `1` is the standard choice (i.e., the provided arrays contain data sampled from larger populations; this is commonly referred to as Bessel's correction).

[kgryte]

Suggested change

	- If provided an empty one-dimensional ndarray, the function returns `NaN`.
	- Both input ndarrays should have the same number of elements.
	- If provided empty one-dimensional ndarrays, the function returns `NaN`.

[kgryte]

Suggested change

	// Create first one-dimensional ndarray containing pseudorandom integers drawn from a discrete uniform distribution:
	var xbuf = discreteUniform( 10, -50, 50, opts );
	var x = new ndarray( opts.dtype, xbuf, [ xbuf.length ], [ 1 ], 0, 'row-major' );
	console.log( ndarray2array( x ) );
	// Create second one-dimensional ndarray containing pseudorandom integers drawn from a discrete uniform distribution:
	// Create one-dimensional ndarrays containing pseudorandom numbers:
	var xbuf = discreteUniform( 10, -50, 50, opts );
	var x = new ndarray( opts.dtype, xbuf, [ xbuf.length ], [ 1 ], 0, 'row-major' );
	console.log( ndarray2array( x ) );

[kgryte]

Suggested change

	Computes the covariance of two one-dimensional double-precision
	floating-point ndarrays provided known means and using a one-pass textbook
	algorithm.
	Computes the covariance of two one-dimensional double-precision floating-
	point ndarrays provided known means and using a one-pass textbook algorithm.

[kgryte]

Should update to match README notes.

[kgryte]

Should be updated to match README suggestion.

[kgryte]

Suggested change

	- a zero-dimensional ndarray specifying mean of the first
	one-dimensional ndarray.
	- a zero-dimensional ndarray specifying mean of the second
	one-dimensional ndarray.
	- a zero-dimensional ndarray specifying the mean of the first one-
	dimensional ndarray.
	- a zero-dimensional ndarray specifying the mean of the second one-
	dimensional ndarray.

[kgryte]

Should update to match README suggestion.

[kgryte]

Suggested change

	* - a zero-dimensional ndarray specifying mean of the first one-dimensional ndarray.
	* - a zero-dimensional ndarray specifying mean of the second one-dimensional ndarray.
	* - a zero-dimensional ndarray specifying the mean of the first one-dimensional ndarray.
	* - a zero-dimensional ndarray specifying the mean of the second one-dimensional ndarray.

[kgryte]

Same changes as README.

[kgryte]

Should update to match README suggestion.

[kgryte]

Suggested change

	* - a zero-dimensional ndarray specifying mean of the first one-dimensional ndarray.
	* - a zero-dimensional ndarray specifying mean of the second one-dimensional ndarray.
	* - a zero-dimensional ndarray specifying the mean of the first one-dimensional ndarray.
	* - a zero-dimensional ndarray specifying the mean of the second one-dimensional ndarray.

[kgryte]

Suggested change

	"description": "Computes the covariance of two one-dimensional double-precision floating-point ndarrays provided known means and using a one-pass textbook algorithm.",
	"description": "Compute the covariance of two one-dimensional double-precision floating-point ndarrays provided known means and using a one-pass textbook algorithm.",

[kgryte]

Left a few nits. Once addressed, should be ready.