@basementuniverse/utils v1.7.0

utils

A small library of useful functions

Usage

Node:

const utils = require('@basementuniverse/utils');

Browser:

<script src="utils.js"></script>

Typescript:

import * as utils from '@basementuniverse/utils';

Contents

Functions

Typedefs

memoize(f) ⇒ function

Memoize a function

Kind: global function
Returns: function - A memoized version of the function

floatEquals(a, b, p) ⇒ boolean

Check if two numbers are approximately equal

Kind: global function
Returns: boolean - True if numbers a and b are approximately equal

clamp(a, min, max) ⇒ number

Clamp a number between min and max

Kind: global function
Returns: number - A clamped number

frac(a) ⇒ number

Get the fractional part of a number

Kind: global function
Returns: number - The fractional part of the number

round(n, d) ⇒ number

Round n to d decimal places

Kind: global function
Returns: number - A rounded number

lerp(a, b, i) ⇒ number

Do a linear interpolation between a and b

Kind: global function
Returns: number - An interpolated value in the interval a, b

unlerp(a, b, i) ⇒ number

Get the position of i between a and b

Kind: global function
Returns: number - The position of i between a and b

blerp(c00, c10, c01, c11, ix, iy) ⇒ number

Do a bilinear interpolation

Kind: global function
Returns: number - A bilinear interpolated value

remap(i, a1, a2, b1, b2) ⇒ number

Re-map a number i from range a1...a2 to b1...b2

Kind: global function

smoothstep(a, b, i) ⇒ number

Do a smooth interpolation between a and b

Kind: global function
Returns: number - An interpolated value in the interval a, b

radians(degrees) ⇒ number

Get an angle in radians

Kind: global function
Returns: number - The angle in radians

degrees(radians) ⇒ number

Get an angle in degrees

Kind: global function
Returns: number - The angle in degrees

randomBetween(min, max) ⇒ number

Get a random float in the interval [min, max)

Kind: global function
Returns: number - A random float in the interval [min, max)

randomIntBetween(min, max) ⇒ number

Get a random integer in the interval min, max

Kind: global function
Returns: number - A random integer in the interval min, max

cltRandom(mu, sigma, samples) ⇒ number

Get a normally-distributed random number

Kind: global function
Returns: number - A normally-distributed random number

cltRandomInt(min, max) ⇒ number

Get a normally-distributed random integer in the interval min, max

Kind: global function
Returns: number - A normally-distributed random integer

weightedRandom(w) ⇒ number

Return a weighted random integer

Kind: global function
Returns: number - An index from w

lerpArray(a, i, f) ⇒ number

Return an interpolated value from an array

Kind: global function
Returns: number - An interpolated value in the interval min(a), max(a)

dot(a, b) ⇒ number

Get the dot product of two vectors

Kind: global function
Returns: number - a ∙ b

factorial(a) ⇒ number

Get the factorial of a number

Kind: global function
Returns: number - a!

npr(n, r) ⇒ number

Get the number of permutations of r elements from a set of n elements

Kind: global function
Returns: number - nPr

ncr(n, r) ⇒ number

Get the number of combinations of r elements from a set of n elements

Kind: global function
Returns: number - nCr

permutations(a, r) ⇒ Array.<Array.<*>>

Generate all permutations of r elements from an array

Kind: global function
Returns: Array.<Array.<*>> - An array of permutation arrays

Example

permutations([1, 2, 3], 2);

Output:

[
  [1, 2],
  [1, 3],
  [2, 1],
  [2, 3],
  [3, 1],
  [3, 2]
]

combinations(a, r) ⇒ Array.<Array.<*>>

Generate all combinations of r elements from an array

Kind: global function
Returns: Array.<Array.<*>> - An array of combination arrays

Example

combinations([1, 2, 3], 2);

Output:

[
  [1, 2],
  [1, 3],
  [2, 3]
]

cartesian()

Get a cartesian product of arrays

Kind: global function
Example

cartesian([1, 2, 3], ['a', 'b']);

Output:

[
  [1, "a"],
  [1, "b"],
  [2, "a"],
  [2, "b"],
  [3, "a"],
  [3, "b"]
]

times(f, n) ⇒ Array.<*>

Return a new array with length n by calling function f(i) on each element

Kind: global function

range(n) ⇒ Array.<number>

Return an array containing numbers 0->(n - 1)

Kind: global function
Returns: Array.<number> - An array of integers 0->(n - 1)

zip(...a) ⇒ Array.<Array.<*>>

Zip multiple arrays together, i.e. (1, 2, 3, a, b, c) => [1, a, 2, b, 3, c]

Kind: global function

at(a, i) ⇒ *

Return arrayi with positive and negative wrapping

Kind: global function
Returns: * - An element from the array

peek(a) ⇒ *

Return the last element of an array without removing it

Kind: global function
Returns: * - The last element from the array

ind(x, y, w) ⇒ number

Return the index for a given position in an unrolled 2d array

Kind: global function
Returns: number - The index in the unrolled array

pos(i, w) ⇒ Array.<number>

Return the position for a given index in an unrolled 2d array

Kind: global function
Returns: Array.<number> - The position as a 2-tuple

chunk(a, n) ⇒ Array.<Array.<*>>

Chop an array into chunks of size n

Kind: global function
Returns: Array.<Array.<*>> - An array of array chunks

shuffle(a) ⇒ Array.<*>

Randomly shuffle a shallow copy of an array

Kind: global function
Returns: Array.<*> - The shuffled array

flat(o, concatenator) ⇒ object

Flatten an object

Kind: global function
Returns: object - A flattened object

unflat(o, concatenator) ⇒ object

Unflatten an object

Kind: global function
Returns: object - An un-flattened object

split(array, predicate) ⇒ Array.<Array.<*>>

Split an array into sub-arrays based on a predicate

Kind: global function
Returns: Array.<Array.<*>> - An array of arrays

pluck(o, ...keys) ⇒ object

Pluck keys from an object

Kind: global function
Returns: object - An object containing the plucked keys

exclude(o, ...keys) ⇒ object

Exclude keys from an object

Kind: global function
Returns: object - An object containing all keys except excluded keys

InterpolationFunction ⇒ number

An interpolation function

Kind: global typedef
Returns: number - The interpolated value in the interval a, b

TimesFunction ⇒ *

A function for generating array values

Kind: global typedef
Returns: * - The array value

SplitPredicate ⇒ boolean

A split predicate

Kind: global typedef
Returns: boolean - True if the array should split at this index