Matician: (/məˈtiSH(ə)n/) Shorthand for a specialist or expert in mathematics.

🔧 Installation

npm install matician

or with yarn:

yarn add matician

✨ Features

➕ Basic Arithmetic & Algebraic Operators

Useful helpers for:

• Addition, subtraction, multiplication, division
• Powers, roots, modulo, absolute value
• Other algebraic operations

📊 Statistics

Robust functions for descriptive statistics:

• Mean, median, mode, variance, standard deviation
• Percentiles, range, interquartile range

🧮 Combinatorics

Combinatorial calculations:

• Permutations and combinations (with or without replacement)
• Factorials, binomial coefficients, and more

🎲 Probability Distributions

Discrete and continuous probability distributions:

• Discrete: Bernoulli, Binomial, Poisson, Geometric, Negative Binomial, Discrete Uniform, and more
• Continuous: Normal, Log-normal, Exponential, Continuous Uniform, and more
• All distributions include PDF/PMF, CDF, mean, variance, and sampling methods

🎲 Random Number Generators

Simple random number generators for various use cases:

• Uniform integers and floats
• Gaussian (normal) sampling

💰 Financial & Actuarial Math

Annuity functions with support for:

• Present and future values
• Immediate and due annuities

🧪 Tested & Typed

• 100% TypeScript — fully typed for better editor support and safety
• Exhaustively tested using Jest
• JSDoc for inline IDE documentation

Run Tests

git clone https://github.com/kevindmorris/matician.git
npm install
npm test # Run the entire test suite
npm test -- add.test.ts # Run an individual test suite

Contributors

Open an issue to address bugs or suggest new modules!