Calculate the variance of a strided array. 

kgryte

planeshifter

rreusser

stdlib-bot

@stdlib/stats-base-variance

  "description": "Calculate the variance of a strided array.",

    "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"

    "url": "git://github.com/stdlib-js/stats-base-variance.git"

    "url": "https://github.com/stdlib-js/stdlib/issues"

    "@stdlib/stats-base-variancepn": "^0.2.0",

    "@stdlib/utils-define-nonenumerable-read-only-property": "^0.2.0"

    "@stdlib/stats-base-variancepn": "^0.2.1",

    "@stdlib/utils-define-nonenumerable-read-only-property": "^0.2.1"

    "@stdlib/math-base-assert-is-nan": "^0.1.1",

    "@stdlib/math-base-special-floor": "^0.1.1",

    "@stdlib/math-base-special-pow": "^0.1.0",

    "@stdlib/math-base-special-round": "^0.1.1",

    "@stdlib/random-base-randu": "^0.1.0",

    "tape": "git+https://github.com/kgryte/tape.git#fix/globby",

    "tap-min": "git+https://github.com/Planeshifter/tap-min.git",

    "url": "https://opencollective.com/stdlib"

Licensed under the Apache License, Version 2.0 (the "License");

you may not use this file except in compliance with the License.

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software

distributed under the License is distributed on an "AS IS" BASIS,

WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

See the License for the specific language governing permissions and

  <p>We believe in a future in which the web is a preferred environment for numerical computation. To help realize this future, we've built stdlib. stdlib is a standard library, with an emphasis on numerical and scientific computation, written in JavaScript (and C) for execution in browsers and in Node.js.</p>

  <p>The library is fully decomposable, being architected in such a way that you can swap out and mix and match APIs and functionality to cater to your exact preferences and use cases.</p>

  <p>When you use stdlib, you can be absolutely certain that you are using the most thorough, rigorous, well-written, studied, documented, tested, measured, and high-quality code out there.</p>

  <p>To join us in bringing numerical computing to the web, get started by checking us out on <a href="https://github.com/stdlib-js/stdlib">GitHub</a>, and please consider <a href="https://opencollective.com/stdlib">financially supporting stdlib</a>. We greatly appreciate your continued support!</p>

[![NPM version][npm-image]][npm-url] [![Build Status][test-image]][test-url] [![Coverage Status][coverage-image]][coverage-url]

> Calculate the [variance][variance] of a strided array.

The population [variance][variance] of a finite size population of size `N` is given by

<!-- <div class="equation" align="center" data-raw-text="\mu = \frac{1}{N} \sum_{i=0}^{N-1} x_i" data-equation="eq:population_mean">

Often in the analysis of data, the true population [variance][variance] is not known _a priori_ and must be estimated from a sample drawn from the population distribution. If one attempts to use the formula for the population [variance][variance], the result is biased and yields a **biased sample variance**. To compute an **unbiased sample variance** for a sample of size `n`,

<!-- <div class="equation" align="center" data-raw-text="s^2 = \frac{1}{n-1} \sum_{i=0}^{n-1} (x_i - \bar{x})^2" data-equation="eq:unbiased_sample_variance">

<!-- <div class="equation" align="center" data-raw-text="\bar{x} = \frac{1}{n} \sum_{i=0}^{n-1} x_i" data-equation="eq:sample_mean">

The use of the term `n-1` is commonly referred to as Bessel's correction. Note, however, that applying Bessel's correction can increase the mean squared error between the sample variance and population variance. Depending on the characteristics of the population distribution, other correction factors (e.g., `n-1.5`, `n+1`, etc) can yield better estimators.

[test-image]: https://github.com/stdlib-js/stats-base-variance/actions/workflows/test.yml/badge.svg?branch=v0.2.0

[test-url]: https://github.com/stdlib-js/stats-base-variance/actions/workflows/test.yml?query=branch:v0.2.0

[test-image]: https://github.com/stdlib-js/stats-base-variance/actions/workflows/test.yml/badge.svg?branch=v0.2.1

[test-url]: https://github.com/stdlib-js/stats-base-variance/actions/workflows/test.yml?query=branch:v0.2.1

[coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/stats-base-variance/main.svg

[coverage-url]: https://codecov.io/github/stdlib-js/stats-base-variance?branch=main

[dependencies-image]: https://img.shields.io/david/stdlib-js/stats-base-variance.svg

[dependencies-url]: https://david-dm.org/stdlib-js/stats-base-variance/main

[chat-image]: https://img.shields.io/gitter/room/stdlib-js/stdlib.svg

[chat-url]: https://app.gitter.im/#/room/#stdlib-js_stdlib:gitter.im

[stdlib]: https://github.com/stdlib-js/stdlib

[stdlib-authors]: https://github.com/stdlib-js/stdlib/graphs/contributors

[es-module]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules

[deno-url]: https://github.com/stdlib-js/stats-base-variance/tree/deno

[deno-readme]: https://github.com/stdlib-js/stats-base-variance/blob/deno/README.md

[umd-url]: https://github.com/stdlib-js/stats-base-variance/tree/umd

[umd-readme]: https://github.com/stdlib-js/stats-base-variance/blob/umd/README.md

[esm-url]: https://github.com/stdlib-js/stats-base-variance/tree/esm

[esm-readme]: https://github.com/stdlib-js/stats-base-variance/blob/esm/README.md

[branches-url]: https://github.com/stdlib-js/stats-base-variance/blob/main/branches.md

[stdlib-license]: https://raw.githubusercontent.com/stdlib-js/stats-base-variance/main/LICENSE

[variance]: https://en.wikipedia.org/wiki/Variance

[mdn-array]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array

[mdn-typed-array]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray

[@stdlib/stats/base/dvariance]: https://www.npmjs.com/package/@stdlib/stats-base-dvariance

[@stdlib/stats/base/nanvariance]: https://www.npmjs.com/package/@stdlib/stats-base-nanvariance

[@stdlib/stats/base/stdev]: https://www.npmjs.com/package/@stdlib/stats-base-stdev

[@stdlib/stats/base/svariance]: https://www.npmjs.com/package/@stdlib/stats-base-svariance

		{
		"name": "@stdlib/stats-base-variance",
		"version": "0.2.0",
		"version": "0.2.1",
		"description": "Calculate the variance of a strided array.",
		@@ -18,15 +18,8 @@ "license": "Apache-2.0",
		"directories": {
		"benchmark": "./benchmark",
		"doc": "./docs",
		"example": "./examples",
		"lib": "./lib",
		"test": "./test"
		"dist": "./dist"
		},
		"types": "./docs/types",
		"scripts": {
		"test": "make test",
		"test-cov": "make test-cov",
		"examples": "make examples",
		"benchmark": "make benchmark"
		},
		"scripts": {},
		"homepage": "https://stdlib.io",
		@@ -41,19 +34,6 @@ "repository": {
		"dependencies": {
		"@stdlib/stats-base-variancepn": "^0.2.0",
		"@stdlib/types": "^0.3.1",
		"@stdlib/utils-define-nonenumerable-read-only-property": "^0.2.0"
		"@stdlib/stats-base-variancepn": "^0.2.1",
		"@stdlib/utils-define-nonenumerable-read-only-property": "^0.2.1"
		},
		"devDependencies": {
		"@stdlib/array-float64": "^0.1.1",
		"@stdlib/math-base-assert-is-nan": "^0.1.1",
		"@stdlib/math-base-special-floor": "^0.1.1",
		"@stdlib/math-base-special-pow": "^0.1.0",
		"@stdlib/math-base-special-round": "^0.1.1",
		"@stdlib/random-base-randu": "^0.1.0",
		"tape": "git+https://github.com/kgryte/tape.git#fix/globby",
		"istanbul": "^0.4.1",
		"tap-min": "git+https://github.com/Planeshifter/tap-min.git",
		"@stdlib/bench-harness": "^0.2.0",
		"@stdlib/bench": "^0.3.1"
		},
		"devDependencies": {},
		"engines": {
		@@ -60,0 +40,0 @@ "node": ">=0.10.0",

Improved metrics

Worsened metrics

Dependency changes

		@@ -291,4 +291,4 @@ <!--

		[test-image]: https://github.com/stdlib-js/stats-base-variance/actions/workflows/test.yml/badge.svg?branch=v0.2.0
		[test-url]: https://github.com/stdlib-js/stats-base-variance/actions/workflows/test.yml?query=branch:v0.2.0
		[test-image]: https://github.com/stdlib-js/stats-base-variance/actions/workflows/test.yml/badge.svg?branch=v0.2.1
		[test-url]: https://github.com/stdlib-js/stats-base-variance/actions/workflows/test.yml?query=branch:v0.2.1

		@@ -295,0 +295,0 @@ [coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/stats-base-variance/main.svg