# Statistics
[![Build Status](https://travis-ci.org/msharp/elixir-statistics.svg?branch=master)](https://travis-ci.org/msharp/elixir-statistics)
[![hex.pm version](https://img.shields.io/hexpm/v/statistics.svg?style=flat)](https://hex.pm/packages/statistics)
Statistics functions for [Elixir](https://github.com/elixir-lang/elixir).
## Usage
Add Statistics as a dependency in your `mix.exs` file to install from [hex.pm](https://hex.pm).
```elixir
def deps do
[
{ :statistics, "~> 0.2.0"}
]
end
```
After you are done, run `mix deps.get` in your shell to fetch and compile Statistics.
To try it out, start an interactive Elixir shell with `iex -S mix`.
```iex
iex> alias Statistics, as: Stats
nil
iex> Stats.median([1,2,3])
2
iex> Stats.variance([1,2,3,4])
1.25
```
## Documentation
Elixir has great documentation tools using `ex_doc`.
The docs are hosted on [hexdocs.pm/statistics](http://hexdocs.pm/statistics/).
## Roadmap
This library is evolving to include more than just simple descriptive statistics.
I plan to add most common statistical tests and distributions.
## Contributing
I'd love to accept pull requests.
If you want to contribute, please create a topic branch with tests.
## License
Apache 2