Source: swcad-js-calcs/src/math/index.js

"use strict"

/**
 * Various math functions
 * @memberof calcs
 * @namespace math
 */

/**
 * Collection of all possible ordered pairs (a, b) such that the first element a belongs to set A and the second element b belongs to set B.
 * @memberof calcs.math
 * @param {number[]} a - first set
 * @param {number[]} b - second set
 * @returns Set of coordinates, pairing all members of the first set and the second set
 */
const arrayCartesianProduct = (a, b) => a.reduce((acc, x) => [...acc, ...b.map(y => [x, y])], []);

const mathUtils = ({ jscad, swcadJs }) => {
    const {
        INCHES_MM_FACTOR
    } = swcadJs.data.constants;

    return {
        /**
         * Checks if a given integer is even
         * @param {number} n - an integer
         * @returns true if even, false if not
         * @memberof calcs.math
         */
        isEven: (n) => {
            return n % 2 == 0;
        },
        /**
         * Checks if a given integer is odd
         * @memberof calcs.math
         * @param {number} n - an integer
         * @returns true if odd, false if not
         */
        isOdd: (n) => {
            return Math.abs(n % 2) == 1;
        },
        arrayCartesianProduct,
        /**
         * Converts distance in inches to mm
         * @memberof calcs.math
         * @param {*} numInches 
         * @returns distance in mm
         */
        inchesToMm: (numInches) => numInches * INCHES_MM_FACTOR,
        /**
         * Converts distance in mm to inches
         * @memberof calcs.math
         * @param {number} numInches 
         * @returns distance in inches
         */
        mmToInches: (numMils) => numMils / INCHES_MM_FACTOR,
        /**
         * ...
         * @memberof calcs.math
         * @param {*} numInches 
         * @returns ...
         */
        factorize: (num) => {
            const int1 = Math.floor(Math.sqrt(num));
            const rem = num % int1
            if (rem === 0) {
                return [int1, int1]
            }
            const int2 = (num - rem) / int1
            return [int1, int2 + 1]
        },
        getRandomInt: (min, max) => {
            const minCeiled = Math.ceil(min);
            const maxFloored = Math.floor(max);
            // The maximum is exclusive and the minimum is inclusive
            return Math.floor(Math.random() * (maxFloored - minCeiled) + minCeiled);
        },
    }
}


module.exports = { init: mathUtils };