0.1.0 • Published 3 years ago

mathleet v0.1.0

Weekly downloads
-
License
MIT
Repository
github
Last release
3 years ago

🧮 mathleet

npm NPM npm

Library of helpful math utilities.

Install

Via npm

npm install mathleet

Via Yarn

yarn add mathleet

How to use

import { keySum } from 'mathleet'

const values = [
  { a: 0, b: 1},
  { a: 1, b: 2},
  { a: 2, b: 3},
]

const sumA = keySum(values, 'a')

console.log(sumA)  // Output: 3

const sumB = keySum(values, 'b')

console.log(sumB)  // Output: 6

Available methods

MethodParamsDescription
filterNumbers(items: any[])Accepts an array of inputs and converts them to numbers and filters out all NaN entries.
keySum(items: any[], key: string)Accepts an array of objects and calculates the sum value for provided key.
keyAvg(items: any[], key: string)Accepts an array of objects and calculates the avergage for the provided key.
numMin(items: any[])Takes an array of values and filters valid numbers, returning the Math.min.
numMax(items: any[])Takes an array of values and filters valid numbers, returning the Math.max.
sum(items: any[], offset: number = 0)Takes an array of values, and optional offset, and calculates sum of values with offset applied.
sumAvg(items: any[], offset: number = 0)Takes an array of values and calculates the average, with offset applied to sum before divided by items length.
rangeAvg(items: any[], rangeMin: number = 0, 'rangeMax: number = 1`) | Takes an array of values and calculates the average within a specified range.
within(value: number, target: number, offset: number = 0)Takes a value and target and returns a boolean if is within the target range with the provided offset.
outside(value: number, target: number, offset: number = 0)Takes a value and target and returns a boolean if values is outside the target range with the provided offset.
degrees(value: number)Convert value of radians to degrees.
radians(value: number)Convert value of degrees to radians.
angle(pointA: Point, pointB: Point, pointC: Point)Takes three Point ({ x: number, y: number }) values and calculates the angle between them.
velocity(distance: number, time: number)Takes a distance value and time and returns the calculated velocity.

License

MIT © Ryan Hefner