Installation

For Node.js run the following command:

npm i array-means

For Yarn run the following command:

yarn add array-means

Browser environment

Download the latest version of array-means here.

Usage

Node.js environment

const {
  arithmetic,
  cubic,
  geometric,
  harmonic,
  quadratic,
  median,
} = require("array-means");

Arithmetic mean

Wikipedia article of Arithmetic mean

var amean = arithmetic([10, 25, 50]);
// amean => 28.333333333333332

Quadratic mean

Wikipedia article of Quadratic mean

var qmean = quadratic([10, 25, 50]);
// qmean => 32.78719262151

Harmonic mean

Wikipedia article of Harmonic mean

var hmean = harmonic([10, 25, 50]);
// hmean => 18.75

Geometric mean

Wikipedia article of Geometric mean

var gmean = geometric([10, 25, 50]);
// gmean => 23.20794417

Cubic mean

Wikipedia article of Cubic mean

var cmean = cubic([10, 25, 50]);
// cmean => 36.14150411

Median

Wikipedia article of Median

var medianResult = median([10, 25, 50]);
// medianResult => 25

Benchmarks

| Algorithm | Operations per second | Tolerance | | :--------- | :-------------------- | :-------- | | arithmetic | 90,273,949 ops/sec | ±0.40% | | quadratic | 45,955,194 ops/sec | ±1.35% | | harmonic | 142,704,156 ops/sec | ±0.33% | | geometric | 116,823,047 ops/sec | ±0.20% | | cubic | 786,168 ops/sec | ±0.12% | | median | 3,392,087 ops/sec | ±0.21% |

Tested on an AMD Ryzen 7 5800X using Node.js v16.13.2 on Windows 10 (21H1)

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

• Bikossor
• Dergeraetwirdniemuede

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see here for more details.