mathjs 7.2.0 → 7.5.1

package/es/function/algebra/solver/utils/solveValidation.js

@@ -1,4 +1,4 @@
-import { isArray, isDenseMatrix, isMatrix } from '../../../../utils/is';
+import { isArray, isMatrix, isDenseMatrix, isSparseMatrix } from '../../../../utils/is';
 import { arraySize } from '../../../../utils/array';
 import { format } from '../../../../utils/string';
 export function createSolveValidation(_ref) {
@@ -14,135 +14,101 @@ export function createSolveValidation(_ref) {
    * @return {DenseMatrix}        Dense column vector b
    */
   return function solveValidation(m, b, copy) {
-    // matrix size
-    var size = m.size(); // validate matrix dimensions
-
-    if (size.length !== 2) {
-      throw new RangeError('Matrix must be two dimensional (size: ' + format(size) + ')');
-    } // rows & columns
+    var mSize = m.size();
 
+    if (mSize.length !== 2) {
+      throw new RangeError('Matrix must be two dimensional (size: ' + format(mSize) + ')');
+    }
 
-    var rows = size[0];
-    var columns = size[1]; // validate rows & columns
+    var rows = mSize[0];
+    var columns = mSize[1];
 
     if (rows !== columns) {
-      throw new RangeError('Matrix must be square (size: ' + format(size) + ')');
-    } // vars
-
+      throw new RangeError('Matrix must be square (size: ' + format(mSize) + ')');
+    }
 
-    var data, i, bdata; // check b is matrix
+    var data = [];
 
     if (isMatrix(b)) {
-      // matrix size
-      var msize = b.size(); // vector
+      var bSize = b.size();
+      var bdata = b._data; // 1-dim vector
 
-      if (msize.length === 1) {
-        // check vector length
-        if (msize[0] !== rows) {
+      if (bSize.length === 1) {
+        if (bSize[0] !== rows) {
           throw new RangeError('Dimension mismatch. Matrix columns must match vector length.');
-        } // create data array
-
+        }
 
-        data = []; // matrix data (DenseMatrix)
-
-        bdata = b._data; // loop b data
-
-        for (i = 0; i < rows; i++) {
-          // row array
+        for (var i = 0; i < rows; i++) {
           data[i] = [bdata[i]];
-        } // return Dense Matrix
-
+        }
 
         return new DenseMatrix({
           data: data,
           size: [rows, 1],
           datatype: b._datatype
         });
-      } // two dimensions
+      } // 2-dim column
 
 
-      if (msize.length === 2) {
-        // array must be a column vector
-        if (msize[0] !== rows || msize[1] !== 1) {
+      if (bSize.length === 2) {
+        if (bSize[0] !== rows || bSize[1] !== 1) {
           throw new RangeError('Dimension mismatch. Matrix columns must match vector length.');
-        } // check matrix type
-
+        }
 
         if (isDenseMatrix(b)) {
-          // check a copy is needed
           if (copy) {
-            // create data array
-            data = []; // matrix data (DenseMatrix)
-
-            bdata = b._data; // loop b data
-
-            for (i = 0; i < rows; i++) {
-              // row array
-              data[i] = [bdata[i][0]];
-            } // return Dense Matrix
+            data = [];
 
+            for (var _i = 0; _i < rows; _i++) {
+              data[_i] = [bdata[_i][0]];
+            }
 
             return new DenseMatrix({
               data: data,
               size: [rows, 1],
               datatype: b._datatype
             });
-          } // b is already a column vector
-
+          }
 
           return b;
-        } // create data array
-
-
-        data = [];
-
-        for (i = 0; i < rows; i++) {
-          data[i] = [0];
-        } // sparse matrix arrays
-
-
-        var values = b._values;
-        var index = b._index;
-        var ptr = b._ptr; // loop values in column 0
-
-        for (var k1 = ptr[1], k = ptr[0]; k < k1; k++) {
-          // row
-          i = index[k]; // add to data
-
-          data[i][0] = values[k];
-        } // return Dense Matrix
-
-
-        return new DenseMatrix({
-          data: data,
-          size: [rows, 1],
-          datatype: b._datatype
-        });
-      } // throw error
-
-
-      throw new RangeError('Dimension mismatch. Matrix columns must match vector length.');
-    } // check b is array
+        }
+
+        if (isSparseMatrix(b)) {
+          for (var _i2 = 0; _i2 < rows; _i2++) {
+            data[_i2] = [0];
+          }
+
+          var values = b._values;
+          var index = b._index;
+          var ptr = b._ptr;
+
+          for (var k1 = ptr[1], k = ptr[0]; k < k1; k++) {
+            var _i3 = index[k];
+            data[_i3][0] = values[k];
+          }
+
+          return new DenseMatrix({
+            data: data,
+            size: [rows, 1],
+            datatype: b._datatype
+          });
+        }
+      }
 
+      throw new RangeError('Dimension mismatch. The right side has to be either 1- or 2-dimensional vector.');
+    }
 
     if (isArray(b)) {
-      // size
-      var asize = arraySize(b); // check matrix dimensions, vector
+      var bsize = arraySize(b);
 
-      if (asize.length === 1) {
-        // check vector length
-        if (asize[0] !== rows) {
+      if (bsize.length === 1) {
+        if (bsize[0] !== rows) {
           throw new RangeError('Dimension mismatch. Matrix columns must match vector length.');
-        } // create data array
-
-
-        data = []; // loop b
-
-        for (i = 0; i < rows; i++) {
-          // row array
-          data[i] = [b[i]];
-        } // return Dense Matrix
+        }
 
+        for (var _i4 = 0; _i4 < rows; _i4++) {
+          data[_i4] = [b[_i4]];
+        }
 
         return new DenseMatrix({
           data: data,
@@ -150,29 +116,22 @@ export function createSolveValidation(_ref) {
         });
       }
 
-      if (asize.length === 2) {
-        // array must be a column vector
-        if (asize[0] !== rows || asize[1] !== 1) {
+      if (bsize.length === 2) {
+        if (bsize[0] !== rows || bsize[1] !== 1) {
           throw new RangeError('Dimension mismatch. Matrix columns must match vector length.');
-        } // create data array
-
-
-        data = []; // loop b data
-
-        for (i = 0; i < rows; i++) {
-          // row array
-          data[i] = [b[i][0]];
-        } // return Dense Matrix
+        }
 
+        for (var _i5 = 0; _i5 < rows; _i5++) {
+          data[_i5] = [b[_i5][0]];
+        }
 
         return new DenseMatrix({
           data: data,
           size: [rows, 1]
         });
-      } // throw error
-
+      }
 
-      throw new RangeError('Dimension mismatch. Matrix columns must match vector length.');
+      throw new RangeError('Dimension mismatch. The right side has to be either 1- or 2-dimensional vector.');
     }
   };
 }

package/es/function/arithmetic/ceil.js

@@ -1,15 +1,38 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+
+function _iterableToArrayLimit(arr, i) { if (typeof Symbol === "undefined" || !(Symbol.iterator in Object(arr))) return; var _arr = []; var _n = true; var _d = false; var _e = undefined; try { for (var _i = arr[Symbol.iterator](), _s; !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
+
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+
+import { Decimal } from 'decimal.js';
 import { factory } from '../../utils/factory';
 import { deepMap } from '../../utils/collection';
 import { nearlyEqual } from '../../utils/number';
 import { nearlyEqual as bigNearlyEqual } from '../../utils/bignumber/nearlyEqual';
 import { ceilNumber } from '../../plain/number';
+import { createAlgorithm11 } from '../../type/matrix/utils/algorithm11';
+import { createAlgorithm14 } from '../../type/matrix/utils/algorithm14';
 var name = 'ceil';
-var dependencies = ['typed', 'config', 'round'];
+var dependencies = ['typed', 'config', 'round', 'matrix', 'equalScalar'];
 export var createCeil = /* #__PURE__ */factory(name, dependencies, function (_ref) {
   var typed = _ref.typed,
       config = _ref.config,
-      round = _ref.round;
-
+      round = _ref.round,
+      matrix = _ref.matrix,
+      equalScalar = _ref.equalScalar;
+  var algorithm11 = createAlgorithm11({
+    typed: typed,
+    equalScalar: equalScalar
+  });
+  var algorithm14 = createAlgorithm14({
+    typed: typed
+  });
   /**
    * Round a value towards plus infinity
    * If `x` is complex, both real and imaginary part are rounded towards plus infinity.
@@ -18,6 +41,7 @@ export var createCeil = /* #__PURE__ */factory(name, dependencies, function (_re
    * Syntax:
    *
    *    math.ceil(x)
+   *    math.ceil(x, n)
    *
    * Examples:
    *
@@ -26,18 +50,27 @@ export var createCeil = /* #__PURE__ */factory(name, dependencies, function (_re
    *    math.ceil(-4.2)              // returns number -4
    *    math.ceil(-4.7)              // returns number -4
    *
-   *    const c = math.complex(3.2, -2.7)
+   *    math.ceil(3.212, 2)          // returns number 3.22
+   *    math.ceil(3.288, 2)          // returns number 3.29
+   *    math.ceil(-4.212, 2)         // returns number -4.21
+   *    math.ceil(-4.782, 2)         // returns number -4.78
+   *
+   *    const c = math.complex(3.24, -2.71)
    *    math.ceil(c)                 // returns Complex 4 - 2i
+   *    math.ceil(c, 1)              // returns Complex 3.3 - 2.7i
    *
    *    math.ceil([3.2, 3.8, -4.7])  // returns Array [4, 4, -4]
+   *    math.ceil([3.21, 3.82, -4.71], 1)  // returns Array [3.3, 3.9, -4.7]
    *
    * See also:
    *
    *    floor, fix, round
    *
    * @param  {number | BigNumber | Fraction | Complex | Array | Matrix} x  Number to be rounded
+   * @param  {number | BigNumber | Array} [n=0]                            Number of decimals
    * @return {number | BigNumber | Fraction | Complex | Array | Matrix} Rounded value
    */
+
   return typed('ceil', {
     number: function number(x) {
       if (nearlyEqual(x, round(x), config.epsilon)) {
@@ -46,9 +79,32 @@ export var createCeil = /* #__PURE__ */factory(name, dependencies, function (_re
         return ceilNumber(x);
       }
     },
+    'number, number': function numberNumber(x, n) {
+      if (nearlyEqual(x, round(x, n), config.epsilon)) {
+        return round(x, n);
+      } else {
+        var _$split = "".concat(x, "e").split('e'),
+            _$split2 = _slicedToArray(_$split, 2),
+            number = _$split2[0],
+            exponent = _$split2[1];
+
+        var result = Math.ceil(Number("".concat(number, "e").concat(Number(exponent) + n)));
+
+        var _$split3 = "".concat(result, "e").split('e');
+
+        var _$split4 = _slicedToArray(_$split3, 2);
+
+        number = _$split4[0];
+        exponent = _$split4[1];
+        return Number("".concat(number, "e").concat(Number(exponent) - n));
+      }
+    },
     Complex: function Complex(x) {
       return x.ceil();
     },
+    'Complex, number': function ComplexNumber(x, n) {
+      return x.ceil(n);
+    },
     BigNumber: function BigNumber(x) {
       if (bigNearlyEqual(x, round(x), config.epsilon)) {
         return round(x);
@@ -56,12 +112,40 @@ export var createCeil = /* #__PURE__ */factory(name, dependencies, function (_re
         return x.ceil();
       }
     },
+    'BigNumber, BigNumber': function BigNumberBigNumber(x, n) {
+      if (bigNearlyEqual(x, round(x, n), config.epsilon)) {
+        return round(x, n);
+      } else {
+        return x.toDecimalPlaces(n.toNumber(), Decimal.ROUND_CEIL);
+      }
+    },
     Fraction: function Fraction(x) {
       return x.ceil();
     },
+    'Fraction, number': function FractionNumber(x, n) {
+      return x.ceil(n);
+    },
     'Array | Matrix': function ArrayMatrix(x) {
       // deep map collection, skip zeros since ceil(0) = 0
       return deepMap(x, this, true);
+    },
+    'Array | Matrix, number': function ArrayMatrixNumber(x, n) {
+      var _this = this;
+
+      // deep map collection, skip zeros since ceil(0) = 0
+      return deepMap(x, function (i) {
+        return _this(i, n);
+      }, true);
+    },
+    'SparseMatrix, number | BigNumber': function SparseMatrixNumberBigNumber(x, y) {
+      return algorithm11(x, y, this, false);
+    },
+    'DenseMatrix, number | BigNumber': function DenseMatrixNumberBigNumber(x, y) {
+      return algorithm14(x, y, this, false);
+    },
+    'number | Complex | BigNumber, Array': function numberComplexBigNumberArray(x, y) {
+      // use matrix implementation
+      return algorithm14(matrix(y), x, this, true).valueOf();
     }
   });
 });

package/es/function/arithmetic/fix.js

@@ -1,13 +1,17 @@
 import { factory } from '../../utils/factory';
 import { deepMap } from '../../utils/collection';
+import { createAlgorithm14 } from '../../type/matrix/utils/algorithm14';
 var name = 'fix';
-var dependencies = ['typed', 'Complex', 'ceil', 'floor'];
+var dependencies = ['typed', 'Complex', 'matrix', 'ceil', 'floor'];
 export var createFix = /* #__PURE__ */factory(name, dependencies, function (_ref) {
   var typed = _ref.typed,
       _Complex = _ref.Complex,
+      matrix = _ref.matrix,
       ceil = _ref.ceil,
       floor = _ref.floor;
-
+  var algorithm14 = createAlgorithm14({
+    typed: typed
+  });
   /**
    * Round a value towards zero.
    * For matrices, the function is evaluated element wise.
@@ -23,34 +27,67 @@ export var createFix = /* #__PURE__ */factory(name, dependencies, function (_ref
    *    math.fix(-4.2)               // returns number -4
    *    math.fix(-4.7)               // returns number -4
    *
-   *    const c = math.complex(3.2, -2.7)
+   *    math.fix(3.12, 1)                // returns number 3.1
+   *    math.fix(3.18, 1)                // returns number 3.1
+   *    math.fix(-4.12, 1)               // returns number -4.1
+   *    math.fix(-4.17, 1)               // returns number -4.1
+   *
+   *    const c = math.complex(3.22, -2.78)
    *    math.fix(c)                  // returns Complex 3 - 2i
+   *    math.fix(c, 1)               // returns Complex 3.2 - 2.7i
    *
-   *    math.fix([3.2, 3.8, -4.7])   // returns Array [3, 3, -4]
+   *    math.fix([3.2, 3.8, -4.7])      // returns Array [3, 3, -4]
+   *    math.fix([3.2, 3.8, -4.7], 1)   // returns Array [3.2, 3.8, -4.7]
    *
    * See also:
    *
    *    ceil, floor, round
    *
-   * @param {number | BigNumber | Fraction | Complex | Array | Matrix} x Number to be rounded
-   * @return {number | BigNumber | Fraction | Complex | Array | Matrix}            Rounded value
+   * @param  {number | BigNumber | Fraction | Complex | Array | Matrix} x    Number to be rounded
+   * @param  {number | BigNumber | Array} [n=0]                             Number of decimals
+   * @return {number | BigNumber | Fraction | Complex | Array | Matrix}     Rounded value
    */
+
   return typed('fix', {
     number: function number(x) {
       return x > 0 ? floor(x) : ceil(x);
     },
+    'number, number | BigNumber': function numberNumberBigNumber(x, n) {
+      return x > 0 ? floor(x, n) : ceil(x, n);
+    },
     Complex: function Complex(x) {
       return new _Complex(x.re > 0 ? Math.floor(x.re) : Math.ceil(x.re), x.im > 0 ? Math.floor(x.im) : Math.ceil(x.im));
     },
+    'Complex, number | BigNumber': function ComplexNumberBigNumber(x, n) {
+      return new _Complex(x.re > 0 ? floor(x.re, n) : ceil(x.re, n), x.im > 0 ? floor(x.im, n) : ceil(x.im, n));
+    },
     BigNumber: function BigNumber(x) {
       return x.isNegative() ? ceil(x) : floor(x);
     },
+    'BigNumber, number | BigNumber': function BigNumberNumberBigNumber(x, n) {
+      return x.isNegative() ? ceil(x, n) : floor(x, n);
+    },
     Fraction: function Fraction(x) {
       return x.s < 0 ? x.ceil() : x.floor();
     },
+    'Fraction, number | BigNumber': function FractionNumberBigNumber(x, n) {
+      return x.s < 0 ? x.ceil(n) : x.floor(n);
+    },
     'Array | Matrix': function ArrayMatrix(x) {
       // deep map collection, skip zeros since fix(0) = 0
       return deepMap(x, this, true);
+    },
+    'Array | Matrix, number | BigNumber': function ArrayMatrixNumberBigNumber(x, n) {
+      var _this = this;
+
+      // deep map collection, skip zeros since fix(0) = 0
+      return deepMap(x, function (i) {
+        return _this(i, n);
+      }, true);
+    },
+    'number | Complex | BigNumber, Array': function numberComplexBigNumberArray(x, y) {
+      // use matrix implementation
+      return algorithm14(matrix(y), x, this, true).valueOf();
     }
   });
 });

package/es/function/arithmetic/floor.js

@@ -1,14 +1,37 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
+
+function _iterableToArrayLimit(arr, i) { if (typeof Symbol === "undefined" || !(Symbol.iterator in Object(arr))) return; var _arr = []; var _n = true; var _d = false; var _e = undefined; try { for (var _i = arr[Symbol.iterator](), _s; !(_n = (_s = _i.next()).done); _n = true) { _arr.push(_s.value); if (i && _arr.length === i) break; } } catch (err) { _d = true; _e = err; } finally { try { if (!_n && _i["return"] != null) _i["return"](); } finally { if (_d) throw _e; } } return _arr; }
+
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+
+import { Decimal } from 'decimal.js';
 import { factory } from '../../utils/factory';
 import { deepMap } from '../../utils/collection';
 import { nearlyEqual } from '../../utils/number';
 import { nearlyEqual as bigNearlyEqual } from '../../utils/bignumber/nearlyEqual';
+import { createAlgorithm11 } from '../../type/matrix/utils/algorithm11';
+import { createAlgorithm14 } from '../../type/matrix/utils/algorithm14';
 var name = 'floor';
-var dependencies = ['typed', 'config', 'round'];
+var dependencies = ['typed', 'config', 'round', 'matrix', 'equalScalar'];
 export var createFloor = /* #__PURE__ */factory(name, dependencies, function (_ref) {
   var typed = _ref.typed,
       config = _ref.config,
-      round = _ref.round;
-
+      round = _ref.round,
+      matrix = _ref.matrix,
+      equalScalar = _ref.equalScalar;
+  var algorithm11 = createAlgorithm11({
+    typed: typed,
+    equalScalar: equalScalar
+  });
+  var algorithm14 = createAlgorithm14({
+    typed: typed
+  });
   /**
    * Round a value towards minus infinity.
    * For matrices, the function is evaluated element wise.
@@ -16,6 +39,7 @@ export var createFloor = /* #__PURE__ */factory(name, dependencies, function (_r
    * Syntax:
    *
    *    math.floor(x)
+   *    math.floor(x, n)
    *
    * Examples:
    *
@@ -24,18 +48,27 @@ export var createFloor = /* #__PURE__ */factory(name, dependencies, function (_r
    *    math.floor(-4.2)             // returns number -5
    *    math.floor(-4.7)             // returns number -5
    *
-   *    const c = math.complex(3.2, -2.7)
-   *    math.floor(c)                // returns Complex 3 - 3i
+   *    math.floor(3.212, 2)          // returns number 3.21
+   *    math.floor(3.288, 2)          // returns number 3.28
+   *    math.floor(-4.212, 2)         // returns number -4.22
+   *    math.floor(-4.782, 2)         // returns number -4.79
    *
-   *    math.floor([3.2, 3.8, -4.7]) // returns Array [3, 3, -5]
+   *    const c = math.complex(3.24, -2.71)
+   *    math.floor(c)                 // returns Complex 3 - 3i
+   *    math.floor(c, 1)              // returns Complex 3.2 - 2.8i
+   *
+   *    math.floor([3.2, 3.8, -4.7])       // returns Array [3, 3, -5]
+   *    math.floor([3.21, 3.82, -4.71], 1)  // returns Array [3.2, 3.8, -4.8]
    *
    * See also:
    *
    *    ceil, fix, round
    *
    * @param  {number | BigNumber | Fraction | Complex | Array | Matrix} x  Number to be rounded
+   * @param  {number | BigNumber | Array} [n=0]                            Number of decimals
    * @return {number | BigNumber | Fraction | Complex | Array | Matrix} Rounded value
    */
+
   return typed('floor', {
     number: function number(x) {
       if (nearlyEqual(x, round(x), config.epsilon)) {
@@ -44,9 +77,32 @@ export var createFloor = /* #__PURE__ */factory(name, dependencies, function (_r
         return Math.floor(x);
       }
     },
+    'number, number': function numberNumber(x, n) {
+      if (nearlyEqual(x, round(x, n), config.epsilon)) {
+        return round(x, n);
+      } else {
+        var _$split = "".concat(x, "e").split('e'),
+            _$split2 = _slicedToArray(_$split, 2),
+            number = _$split2[0],
+            exponent = _$split2[1];
+
+        var result = Math.floor(Number("".concat(number, "e").concat(Number(exponent) + n)));
+
+        var _$split3 = "".concat(result, "e").split('e');
+
+        var _$split4 = _slicedToArray(_$split3, 2);
+
+        number = _$split4[0];
+        exponent = _$split4[1];
+        return Number("".concat(number, "e").concat(Number(exponent) - n));
+      }
+    },
     Complex: function Complex(x) {
       return x.floor();
     },
+    'Complex, number': function ComplexNumber(x, n) {
+      return x.floor(n);
+    },
     BigNumber: function BigNumber(x) {
       if (bigNearlyEqual(x, round(x), config.epsilon)) {
         return round(x);
@@ -54,12 +110,40 @@ export var createFloor = /* #__PURE__ */factory(name, dependencies, function (_r
         return x.floor();
       }
     },
+    'BigNumber, BigNumber': function BigNumberBigNumber(x, n) {
+      if (bigNearlyEqual(x, round(x, n), config.epsilon)) {
+        return round(x, n);
+      } else {
+        return x.toDecimalPlaces(n.toNumber(), Decimal.ROUND_FLOOR);
+      }
+    },
     Fraction: function Fraction(x) {
       return x.floor();
     },
+    'Fraction, number': function FractionNumber(x, n) {
+      return x.floor(n);
+    },
     'Array | Matrix': function ArrayMatrix(x) {
       // deep map collection, skip zeros since floor(0) = 0
       return deepMap(x, this, true);
+    },
+    'Array | Matrix, number': function ArrayMatrixNumber(x, n) {
+      var _this = this;
+
+      // deep map collection, skip zeros since ceil(0) = 0
+      return deepMap(x, function (i) {
+        return _this(i, n);
+      }, true);
+    },
+    'SparseMatrix, number | BigNumber': function SparseMatrixNumberBigNumber(x, y) {
+      return algorithm11(x, y, this, false);
+    },
+    'DenseMatrix, number | BigNumber': function DenseMatrixNumberBigNumber(x, y) {
+      return algorithm14(x, y, this, false);
+    },
+    'number | Complex | BigNumber, Array': function numberComplexBigNumberArray(x, y) {
+      // use matrix implementation
+      return algorithm14(matrix(y), x, this, true).valueOf();
     }
   });
 });

package/es/function/arithmetic/mod.js

@@ -78,10 +78,19 @@ export var createMod = /* #__PURE__ */factory(name, dependencies, function (_ref
   return typed(name, {
     'number, number': modNumber,
     'BigNumber, BigNumber': function BigNumberBigNumber(x, y) {
+      if (y.isNeg()) {
+        throw new Error('Cannot calculate mod for a negative divisor');
+      }
+
       return y.isZero() ? x : x.mod(y);
     },
     'Fraction, Fraction': function FractionFraction(x, y) {
-      return x.mod(y);
+      if (y.compare(0) < 0) {
+        throw new Error('Cannot calculate mod for a negative divisor');
+      } // Workaround suggested in Fraction.js library to calculate correct modulo for negative dividend
+
+
+      return x.compare(0) >= 0 ? x.mod(y) : x.mod(y).add(y).mod(y);
     },
     'SparseMatrix, SparseMatrix': function SparseMatrixSparseMatrix(x, y) {
       return algorithm05(x, y, this, false);

package/es/function/arithmetic/round.js

@@ -43,10 +43,14 @@ export var createRound = /* #__PURE__ */factory(name, dependencies, function (_r
    *
    * Examples:
    *
-   *    math.round(3.2)              // returns number 3
-   *    math.round(3.8)              // returns number 4
+   *    math.round(3.22)             // returns number 3
+   *    math.round(3.82)             // returns number 4
    *    math.round(-4.2)             // returns number -4
    *    math.round(-4.7)             // returns number -5
+   *    math.round(3.22, 1)          // returns number 3.2
+   *    math.round(3.88, 1)          // returns number 3.8
+   *    math.round(-4.21, 1)         // returns number -4.2
+   *    math.round(-4.71, 1)         // returns number -4.7
    *    math.round(math.pi, 3)       // returns number 3.142
    *    math.round(123.45678, 2)     // returns number 123.46
    *