# summary

> Takes an array of numbers and calculates some descriptive statistics

Latest version **2.1.0** (published 2020-09-04) · MIT license · 0 weekly downloads

## Install

```sh
npm install summary
pnpm add summary
yarn add summary
bun add summary
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.1.0 |
| Published | 2020-09-04 |
| First published | 2013-07-01 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 13.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 16 |
| Author | Andreas Madsen |
| Maintainers | andreasmadsen |
| Keywords | summary, sort, size, mode, mean, quartile, median, variance, sd |

## Links

- npm: https://www.npmjs.com/package/summary
- Repository: https://github.com/AndreasMadsen/summary
- Homepage: https://github.com/AndreasMadsen/summary#readme
- Issues: https://github.com/AndreasMadsen/summary/issues
- npm.io page: https://npm.io/package/summary

## Alternatives

- [@tsparticles/shape-image](https://npm.io/package/@tsparticles/shape-image.md) — 303.7K weekly downloads
- [@tsparticles/shape-line](https://npm.io/package/@tsparticles/shape-line.md) — 233.7K weekly downloads
- [stringify-attributes](https://npm.io/package/stringify-attributes.md) — 58.6K weekly downloads
- [mobile-drag-drop](https://npm.io/package/mobile-drag-drop.md) — 46.3K weekly downloads
- [@comunica/actor-rdf-parse-html](https://npm.io/package/@comunica/actor-rdf-parse-html.md) — 29.2K weekly downloads

## Recent versions

- 2.1.0 (latest) — 2020-09-04
- 2.0.0 — 2020-08-13
- 1.0.0 — 2017-10-18
- 0.3.2 — 2015-02-25
- 0.3.1 — 2014-09-08
- 0.3.0 — 2013-07-24
- 0.2.0 — 2013-07-01

## README

# summary

> Takes an array of numbers and calculates some descriptive statistics

## Installation

```sheel
npm install summary
```

## Example

```javascript
var summary = require('summary');

var data = summary([-1, 0, 1], true /* sorted */);
console.log(data.variance()); // 1
console.log(data.mean()); // 0
```

## Documentation

The `summary` constructor, takes a required `data` array and and optional
boolean indication whether or not the `data` is `sorted` from small to big,
by default `sorted` is `false`.

```javascript
// Data is sorted from small to big
var data = summary([-1, 0, 1], true);

// Data is sorted, but summary dosn't know. Works fine just a bit slower.
var data = summary([-1, 0, 1] /*, default false */);

// Data is sorted in reverse order
var data = summary([1, 0, -1] /*, default false */);

// Data isn't sorted
var data = summary([0, 1, -1] /*, default false */);
```

The data object has the following metods, note that almost all values is lazy
calculated and then cached.

```javascript
data.data(); // Returns the original array

data.sort(); // Returns the sorted array

data.size(); // Returns the data length

data.sum(); // Returns the data sum

data.mode(); // Returns mode

data.mean(); // Returns the mean

data.quartile(0.25); // Returns 25% quartile

data.median(); // Returns the median

data.variance(); // Returns the variance

data.sd(); // Returns the standard deviation

data.max(); // Returns the maximum value
data.min(); // Returns the minimum value
```

## License

**The software is license under "MIT"**

> Copyright (c) 2013 Andreas Madsen
>
> Permission is hereby granted, free of charge, to any person obtaining a copy
> of this software and associated documentation files (the "Software"), to deal
> in the Software without restriction, including without limitation the rights
> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
> copies of the Software, and to permit persons to whom the Software is
> furnished to do so, subject to the following conditions:
>
> The above copyright notice and this permission notice shall be included in
> all copies or substantial portions of the Software.
>
> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
> THE SOFTWARE.

---
_Source: https://npm.io/package/summary · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._