mathjs 7.3.0 → 7.6.0

package/es/function/matrix/rotationMatrix.js

@@ -0,0 +1,176 @@
+import { isBigNumber } from '../../utils/is';
+import { factory } from '../../utils/factory';
+var name = 'rotationMatrix';
+var dependencies = ['typed', 'config', 'multiplyScalar', 'addScalar', 'unaryMinus', 'norm', 'matrix', 'BigNumber', 'DenseMatrix', 'SparseMatrix', 'cos', 'sin'];
+export var createRotationMatrix = /* #__PURE__ */factory(name, dependencies, function (_ref) {
+  var typed = _ref.typed,
+      config = _ref.config,
+      multiplyScalar = _ref.multiplyScalar,
+      addScalar = _ref.addScalar,
+      unaryMinus = _ref.unaryMinus,
+      norm = _ref.norm,
+      BigNumber = _ref.BigNumber,
+      matrix = _ref.matrix,
+      DenseMatrix = _ref.DenseMatrix,
+      SparseMatrix = _ref.SparseMatrix,
+      cos = _ref.cos,
+      sin = _ref.sin;
+
+  /**
+   * Create a 2-dimensional counter-clockwise rotation matrix (2x2) for a given angle (expressed in radians).
+   * Create a 2-dimensional counter-clockwise rotation matrix (3x3) by a given angle (expressed in radians) around a given axis (1x3).
+   *
+   * Syntax:
+   *
+   *    math.rotationMatrix(theta)
+   *    math.rotationMatrix(theta, format)
+   *    math.rotationMatrix(theta, [v])
+   *    math.rotationMatrix(theta, [v], format)
+   *
+   * Examples:
+   *
+   *    math.rotationMatrix(math.pi / 2)                      // returns [[0, -1], [1, 0]]
+   *    math.rotationMatrix(math.bignumber(1))                // returns [[bignumber(cos(1)), bignumber(-sin(1))], [bignumber(sin(1)), bignumber(cos(1))]]
+   *    math.rotationMatrix(math.complex(1 + i))              // returns [[cos(1 + i), -sin(1 + i)], [sin(1 + i), cos(1 + i)]]
+   *    math.rotationMatrix(math.unit('1rad'))                // returns [[cos(1), -sin(1)], [sin(1), cos(1)]]
+   *
+   *    math.rotationMatrix(math.pi / 2, [0, 1, 0])           // returns [[0, 0, 1], [0, 1, 0], [-1, 0, 0]]
+   *    math.rotationMatrix(math.pi / 2, matrix([0, 1, 0]))   // returns matrix([[0, 0, 1], [0, 1, 0], [-1, 0, 0]])
+   *
+   *
+   * See also:
+   *
+   *    matrix, cos, sin
+   *
+   *
+   * @param {number | BigNumber | Complex | Unit} theta    Rotation angle
+   * @param {Array | Matrix} [v]                           Rotation axis
+   * @param {string} [format]                              Result Matrix storage format
+   * @return {Array | Matrix}                              Rotation matrix
+   */
+  return typed(name, {
+    '': function _() {
+      return config.matrix === 'Matrix' ? matrix([]) : [];
+    },
+    string: function string(format) {
+      return matrix(format);
+    },
+    'number | BigNumber | Complex | Unit': function numberBigNumberComplexUnit(theta) {
+      return _rotationMatrix2x2(theta, config.matrix === 'Matrix' ? 'dense' : undefined);
+    },
+    'number | BigNumber | Complex | Unit, string': function numberBigNumberComplexUnitString(theta, format) {
+      return _rotationMatrix2x2(theta, format);
+    },
+    'number | BigNumber | Complex | Unit, Array': function numberBigNumberComplexUnitArray(theta, v) {
+      var matrixV = matrix(v);
+
+      _validateVector(matrixV);
+
+      return _rotationMatrix3x3(theta, matrixV, undefined);
+    },
+    'number | BigNumber | Complex | Unit, Matrix': function numberBigNumberComplexUnitMatrix(theta, v) {
+      _validateVector(v);
+
+      var storageType = v.storage() || (config.matrix === 'Matrix' ? 'dense' : undefined);
+      return _rotationMatrix3x3(theta, v, storageType);
+    },
+    'number | BigNumber | Complex | Unit, Array, string': function numberBigNumberComplexUnitArrayString(theta, v, format) {
+      var matrixV = matrix(v);
+
+      _validateVector(matrixV);
+
+      return _rotationMatrix3x3(theta, matrixV, format);
+    },
+    'number | BigNumber | Complex | Unit, Matrix, string': function numberBigNumberComplexUnitMatrixString(theta, v, format) {
+      _validateVector(v);
+
+      return _rotationMatrix3x3(theta, v, format);
+    }
+  });
+  /**
+   * Returns 2x2 matrix of 2D rotation of angle theta
+   *
+   * @param {number | BigNumber | Complex | Unit} theta  The rotation angle
+   * @param {string} format                              The result Matrix storage format
+   * @returns {Matrix}
+   * @private
+   */
+
+  function _rotationMatrix2x2(theta, format) {
+    var Big = isBigNumber(theta);
+    var minusOne = Big ? new BigNumber(-1) : -1;
+    var cosTheta = cos(theta);
+    var sinTheta = sin(theta);
+    var data = [[cosTheta, multiplyScalar(minusOne, sinTheta)], [sinTheta, cosTheta]];
+    return _convertToFormat(data, format);
+  }
+
+  function _validateVector(v) {
+    var size = v.size();
+
+    if (size.length < 1 || size[0] !== 3) {
+      throw new RangeError('Vector must be of dimensions 1x3');
+    }
+  }
+
+  function _mul(array) {
+    return array.reduce(function (p, curr) {
+      return multiplyScalar(p, curr);
+    });
+  }
+
+  function _convertToFormat(data, format) {
+    if (format) {
+      if (format === 'sparse') {
+        return new SparseMatrix(data);
+      }
+
+      if (format === 'dense') {
+        return new DenseMatrix(data);
+      }
+
+      throw new TypeError("Unknown matrix type \"".concat(format, "\""));
+    }
+
+    return data;
+  }
+  /**
+   * Returns a 3x3 matrix of rotation of angle theta around vector v
+   *
+   * @param {number | BigNumber | Complex | Unit} theta The rotation angle
+   * @param {Matrix} v                                  The rotation axis vector
+   * @param {string} format                             The storage format of the resulting matrix
+   * @returns {Matrix}
+   * @private
+   */
+
+
+  function _rotationMatrix3x3(theta, v, format) {
+    var normV = norm(v);
+
+    if (normV === 0) {
+      throw new RangeError('Rotation around zero vector');
+    }
+
+    var Big = isBigNumber(theta) ? BigNumber : null;
+    var one = Big ? new Big(1) : 1;
+    var minusOne = Big ? new Big(-1) : -1;
+    var vx = Big ? new Big(v.get([0]) / normV) : v.get([0]) / normV;
+    var vy = Big ? new Big(v.get([1]) / normV) : v.get([1]) / normV;
+    var vz = Big ? new Big(v.get([2]) / normV) : v.get([2]) / normV;
+    var c = cos(theta);
+    var oneMinusC = addScalar(one, unaryMinus(c));
+    var s = sin(theta);
+    var r11 = addScalar(c, _mul([vx, vx, oneMinusC]));
+    var r12 = addScalar(_mul([vx, vy, oneMinusC]), _mul([minusOne, vz, s]));
+    var r13 = addScalar(_mul([vx, vz, oneMinusC]), _mul([vy, s]));
+    var r21 = addScalar(_mul([vx, vy, oneMinusC]), _mul([vz, s]));
+    var r22 = addScalar(c, _mul([vy, vy, oneMinusC]));
+    var r23 = addScalar(_mul([vy, vz, oneMinusC]), _mul([minusOne, vx, s]));
+    var r31 = addScalar(_mul([vx, vz, oneMinusC]), _mul([minusOne, vy, s]));
+    var r32 = addScalar(_mul([vy, vz, oneMinusC]), _mul([vx, s]));
+    var r33 = addScalar(c, _mul([vz, vz, oneMinusC]));
+    var data = [[r11, r12, r13], [r21, r22, r23], [r31, r32, r33]];
+    return _convertToFormat(data, format);
+  }
+});

package/es/function/matrix/sqrtm.js

@@ -94,6 +94,10 @@ export var createSqrtm = /* #__PURE__ */factory(name, dependencies, function (_r
               throw new RangeError('Matrix must be square ' + '(size: ' + format(size) + ')');
             }
           }
+
+        default:
+          // Multi dimensional array
+          throw new RangeError('Matrix must be at most two dimensional ' + '(size: ' + format(size) + ')');
       }
     }
   });

package/es/function/probability/pickRandom.js

@@ -1,7 +1,7 @@
 import { factory } from '../../utils/factory';
 import { isNumber } from '../../utils/is';
-import { arraySize } from '../../utils/array';
 import { createRng } from './util/seededRNG';
+import { flatten } from '../../utils/array';
 var name = 'pickRandom';
 var dependencies = ['typed', 'config', '?on'];
 export var createPickRandom = /* #__PURE__ */factory(name, dependencies, function (_ref) {
@@ -75,16 +75,12 @@ export var createPickRandom = /* #__PURE__ */factory(name, dependencies, functio
       number = 1;
     }
 
-    possibles = possibles.valueOf(); // get Array
+    possibles = flatten(possibles.valueOf()).valueOf(); // get Array
 
     if (weights) {
       weights = weights.valueOf(); // get Array
     }
 
-    if (arraySize(possibles).length > 1) {
-      throw new Error('Only one dimensional vectors supported');
-    }
-
     var totalWeights = 0;
 
     if (typeof weights !== 'undefined') {

package/es/function/special/erf.js

@@ -1,3 +1,4 @@
+/* eslint-disable no-loss-of-precision */
 import { deepMap } from '../../utils/collection';
 import { sign } from '../../utils/number';
 import { factory } from '../../utils/factory';

package/es/plain/number/constants.js

@@ -1,4 +1,4 @@
 export var pi = Math.PI;
 export var tau = 2 * Math.PI;
 export var e = Math.E;
-export var phi = 1.61803398874989484820458683436563811772030917980576286213545;
+export var phi = 1.6180339887498948; // eslint-disable-line no-loss-of-precision

package/es/plain/number/probability.js

@@ -1,3 +1,4 @@
+/* eslint-disable no-loss-of-precision */
 import { isInteger } from '../../utils/number';
 import { product } from '../../utils/product';
 export function gammaNumber(n) {

package/es/type/unit/Unit.js

@@ -207,19 +207,16 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, function
   function parseUnit() {
     var unitName = ''; // Alphanumeric characters only; matches [a-zA-Z0-9]
 
-    var code = text.charCodeAt(index);
-
-    while (code >= 48 && code <= 57 || code >= 65 && code <= 90 || code >= 97 && code <= 122) {
+    while (isDigit(c) || Unit.isValidAlpha(c)) {
       unitName += c;
       next();
-      code = text.charCodeAt(index);
     } // Must begin with [a-zA-Z]
 
 
-    code = unitName.charCodeAt(0);
+    var firstC = unitName.charAt(0);
 
-    if (code >= 65 && code <= 90 || code >= 97 && code <= 122) {
-      return unitName || null;
+    if (Unit.isValidAlpha(firstC)) {
+      return unitName;
     } else {
       return null;
     }
@@ -3674,24 +3671,26 @@ export var createUnitClass = /* #__PURE__ */factory(name, dependencies, function
       UNITS[_name2] = alias;
     }
   }
+  /**
+   * Checks if a character is a valid latin letter (upper or lower case).
+   * Note that this function can be overridden, for example to allow support of other alphabets.
+   * @param {string} c Tested character
+   */
 
-  function assertUnitNameIsValid(name) {
-    for (var i = 0; i < name.length; i++) {
-      var _c = name.charAt(i);
 
-      var isValidAlpha = function isValidAlpha(p) {
-        return /^[a-zA-Z]$/.test(p);
-      };
+  Unit.isValidAlpha = function isValidAlpha(c) {
+    return /^[a-zA-Z]$/.test(c);
+  };
 
-      var _isDigit = function _isDigit(c) {
-        return c >= '0' && c <= '9';
-      };
+  function assertUnitNameIsValid(name) {
+    for (var i = 0; i < name.length; i++) {
+      c = name.charAt(i);
 
-      if (i === 0 && !isValidAlpha(_c)) {
+      if (i === 0 && !Unit.isValidAlpha(c)) {
         throw new Error('Invalid unit name (must begin with alpha character): "' + name + '"');
       }
 
-      if (i > 0 && !(isValidAlpha(_c) || _isDigit(_c))) {
+      if (i > 0 && !(Unit.isValidAlpha(c) || isDigit(c))) {
         throw new Error('Invalid unit name (only alphanumeric characters are allowed): "' + name + '"');
       }
     }

package/es/utils/object.js

@@ -89,7 +89,9 @@ export function deepExtend(a, b) {
   }
 
   for (var prop in b) {
-    if (hasOwnProperty(b, prop)) {
+    // We check against prop not being in Object.prototype or Function.prototype
+    // to prevent polluting for example Object.__proto__.
+    if (hasOwnProperty(b, prop) && !(prop in Object.prototype) && !(prop in Function.prototype)) {
       if (b[prop] && b[prop].constructor === Object) {
         if (a[prop] === undefined) {
           a[prop] = {};

package/es/version.js

@@ -1,2 +1,2 @@
-export var version = '7.3.0'; // Note: This file is automatically generated when building math.js.
+export var version = '7.6.0'; // Note: This file is automatically generated when building math.js.
 // Changes made in this file will be overwritten.

package/examples/bignumbers.js

@@ -1,3 +1,5 @@
+/* eslint-disable no-loss-of-precision */
+
 // BigNumbers
 
 const { create, all } = require('..')

package/lib/entry/dependenciesAny/dependenciesCeil.generated.js

@@ -5,6 +5,10 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.ceilDependencies = void 0;
 
+var _dependenciesEqualScalar = require("./dependenciesEqualScalar.generated");
+
+var _dependenciesMatrix = require("./dependenciesMatrix.generated");
+
 var _dependenciesRound = require("./dependenciesRound.generated");
 
 var _dependenciesTyped = require("./dependenciesTyped.generated");
@@ -16,6 +20,8 @@ var _factoriesAny = require("../../factoriesAny.js");
  * DON'T MAKE CHANGES HERE
  */
 var ceilDependencies = {
+  equalScalarDependencies: _dependenciesEqualScalar.equalScalarDependencies,
+  matrixDependencies: _dependenciesMatrix.matrixDependencies,
   roundDependencies: _dependenciesRound.roundDependencies,
   typedDependencies: _dependenciesTyped.typedDependencies,
   createCeil: _factoriesAny.createCeil

package/lib/entry/dependenciesAny/dependenciesFix.generated.js

@@ -11,6 +11,8 @@ var _dependenciesCeil = require("./dependenciesCeil.generated");
 
 var _dependenciesFloor = require("./dependenciesFloor.generated");
 
+var _dependenciesMatrix = require("./dependenciesMatrix.generated");
+
 var _dependenciesTyped = require("./dependenciesTyped.generated");
 
 var _factoriesAny = require("../../factoriesAny.js");
@@ -23,6 +25,7 @@ var fixDependencies = {
   ComplexDependencies: _dependenciesComplexClass.ComplexDependencies,
   ceilDependencies: _dependenciesCeil.ceilDependencies,
   floorDependencies: _dependenciesFloor.floorDependencies,
+  matrixDependencies: _dependenciesMatrix.matrixDependencies,
   typedDependencies: _dependenciesTyped.typedDependencies,
   createFix: _factoriesAny.createFix
 };

package/lib/entry/dependenciesAny/dependenciesFloor.generated.js

@@ -5,6 +5,10 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.floorDependencies = void 0;
 
+var _dependenciesEqualScalar = require("./dependenciesEqualScalar.generated");
+
+var _dependenciesMatrix = require("./dependenciesMatrix.generated");
+
 var _dependenciesRound = require("./dependenciesRound.generated");
 
 var _dependenciesTyped = require("./dependenciesTyped.generated");
@@ -16,6 +20,8 @@ var _factoriesAny = require("../../factoriesAny.js");
  * DON'T MAKE CHANGES HERE
  */
 var floorDependencies = {
+  equalScalarDependencies: _dependenciesEqualScalar.equalScalarDependencies,
+  matrixDependencies: _dependenciesMatrix.matrixDependencies,
   roundDependencies: _dependenciesRound.roundDependencies,
   typedDependencies: _dependenciesTyped.typedDependencies,
   createFloor: _factoriesAny.createFloor

package/lib/entry/dependenciesAny/dependenciesRotate.generated.js

@@ -0,0 +1,26 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.rotateDependencies = void 0;
+
+var _dependenciesMultiply = require("./dependenciesMultiply.generated");
+
+var _dependenciesRotationMatrix = require("./dependenciesRotationMatrix.generated");
+
+var _dependenciesTyped = require("./dependenciesTyped.generated");
+
+var _factoriesAny = require("../../factoriesAny.js");
+
+/**
+ * THIS FILE IS AUTO-GENERATED
+ * DON'T MAKE CHANGES HERE
+ */
+var rotateDependencies = {
+  multiplyDependencies: _dependenciesMultiply.multiplyDependencies,
+  rotationMatrixDependencies: _dependenciesRotationMatrix.rotationMatrixDependencies,
+  typedDependencies: _dependenciesTyped.typedDependencies,
+  createRotate: _factoriesAny.createRotate
+};
+exports.rotateDependencies = rotateDependencies;

package/lib/entry/dependenciesAny/dependenciesRotationMatrix.generated.js

@@ -0,0 +1,50 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.rotationMatrixDependencies = void 0;
+
+var _dependenciesBigNumberClass = require("./dependenciesBigNumberClass.generated");
+
+var _dependenciesDenseMatrixClass = require("./dependenciesDenseMatrixClass.generated");
+
+var _dependenciesSparseMatrixClass = require("./dependenciesSparseMatrixClass.generated");
+
+var _dependenciesAddScalar = require("./dependenciesAddScalar.generated");
+
+var _dependenciesCos = require("./dependenciesCos.generated");
+
+var _dependenciesMatrix = require("./dependenciesMatrix.generated");
+
+var _dependenciesMultiplyScalar = require("./dependenciesMultiplyScalar.generated");
+
+var _dependenciesNorm = require("./dependenciesNorm.generated");
+
+var _dependenciesSin = require("./dependenciesSin.generated");
+
+var _dependenciesTyped = require("./dependenciesTyped.generated");
+
+var _dependenciesUnaryMinus = require("./dependenciesUnaryMinus.generated");
+
+var _factoriesAny = require("../../factoriesAny.js");
+
+/**
+ * THIS FILE IS AUTO-GENERATED
+ * DON'T MAKE CHANGES HERE
+ */
+var rotationMatrixDependencies = {
+  BigNumberDependencies: _dependenciesBigNumberClass.BigNumberDependencies,
+  DenseMatrixDependencies: _dependenciesDenseMatrixClass.DenseMatrixDependencies,
+  SparseMatrixDependencies: _dependenciesSparseMatrixClass.SparseMatrixDependencies,
+  addScalarDependencies: _dependenciesAddScalar.addScalarDependencies,
+  cosDependencies: _dependenciesCos.cosDependencies,
+  matrixDependencies: _dependenciesMatrix.matrixDependencies,
+  multiplyScalarDependencies: _dependenciesMultiplyScalar.multiplyScalarDependencies,
+  normDependencies: _dependenciesNorm.normDependencies,
+  sinDependencies: _dependenciesSin.sinDependencies,
+  typedDependencies: _dependenciesTyped.typedDependencies,
+  unaryMinusDependencies: _dependenciesUnaryMinus.unaryMinusDependencies,
+  createRotationMatrix: _factoriesAny.createRotationMatrix
+};
+exports.rotationMatrixDependencies = rotationMatrixDependencies;

package/lib/entry/dependenciesAny.generated.js

@@ -483,6 +483,18 @@ Object.defineProperty(exports, "resizeDependencies", {
     return _dependenciesResize.resizeDependencies;
   }
 });
+Object.defineProperty(exports, "rotateDependencies", {
+  enumerable: true,
+  get: function get() {
+    return _dependenciesRotate.rotateDependencies;
+  }
+});
+Object.defineProperty(exports, "rotationMatrixDependencies", {
+  enumerable: true,
+  get: function get() {
+    return _dependenciesRotationMatrix.rotationMatrixDependencies;
+  }
+});
 Object.defineProperty(exports, "rowDependencies", {
   enumerable: true,
   get: function get() {
@@ -2132,6 +2144,10 @@ var _dependenciesReshape = require("./dependenciesAny/dependenciesReshape.genera
 
 var _dependenciesResize = require("./dependenciesAny/dependenciesResize.generated");
 
+var _dependenciesRotate = require("./dependenciesAny/dependenciesRotate.generated");
+
+var _dependenciesRotationMatrix = require("./dependenciesAny/dependenciesRotationMatrix.generated");
+
 var _dependenciesRow = require("./dependenciesAny/dependenciesRow.generated");
 
 var _dependenciesSize = require("./dependenciesAny/dependenciesSize.generated");