mathjs 11.2.1 → 11.3.1

package/lib/cjs/function/matrix/subset.js

@@ -4,25 +4,17 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.createSubset = void 0;
-
 var _is = require("../../utils/is.js");
-
 var _object = require("../../utils/object.js");
-
 var _array = require("../../utils/array.js");
-
 var _customs = require("../../utils/customs.js");
-
 var _DimensionError = require("../../error/DimensionError.js");
-
 var _factory = require("../../utils/factory.js");
-
 var name = 'subset';
 var dependencies = ['typed', 'matrix'];
 var createSubset = /* #__PURE__ */(0, _factory.factory)(name, dependencies, function (_ref) {
   var typed = _ref.typed,
-      matrix = _ref.matrix;
-
+    matrix = _ref.matrix;
   /**
    * Get or set a subset of a matrix or string.
    *
@@ -72,9 +64,9 @@ var createSubset = /* #__PURE__ */(0, _factory.factory)(name, dependencies, func
     'Array, Index': function ArrayIndex(value, index) {
       var m = matrix(value);
       var subset = m.subset(index); // returns a Matrix
-
       return index.isScalar() ? subset : subset.valueOf(); // return an Array (like the input)
     },
+
     'Matrix, Index': function MatrixIndex(value, index) {
       return value.subset(index);
     },
@@ -98,6 +90,7 @@ var createSubset = /* #__PURE__ */(0, _factory.factory)(name, dependencies, func
     'Object, Index, any': _setObjectProperty
   });
 });
+
 /**
  * Retrieve a subset of a string
  * @param {string} str            string from which to get a substring
@@ -105,20 +98,17 @@ var createSubset = /* #__PURE__ */(0, _factory.factory)(name, dependencies, func
  * @returns {string} substring
  * @private
  */
-
 exports.createSubset = createSubset;
-
 function _getSubstring(str, index) {
   if (!(0, _is.isIndex)(index)) {
     // TODO: better error message
     throw new TypeError('Index expected');
   }
-
   if (index.size().length !== 1) {
     throw new _DimensionError.DimensionError(index.size().length, 1);
-  } // validate whether the range is out of range
-
+  }
 
+  // validate whether the range is out of range
   var strLen = str.length;
   (0, _array.validateIndex)(index.min()[0], strLen);
   (0, _array.validateIndex)(index.max()[0], strLen);
@@ -129,6 +119,7 @@ function _getSubstring(str, index) {
   });
   return substr;
 }
+
 /**
  * Replace a substring in a string
  * @param {string} str            string to be replaced
@@ -139,18 +130,14 @@ function _getSubstring(str, index) {
  * @returns {string} result
  * @private
  */
-
-
 function _setSubstring(str, index, replacement, defaultValue) {
   if (!index || index.isIndex !== true) {
     // TODO: better error message
     throw new TypeError('Index expected');
   }
-
   if (index.size().length !== 1) {
     throw new _DimensionError.DimensionError(index.size().length, 1);
   }
-
   if (defaultValue !== undefined) {
     if (typeof defaultValue !== 'string' || defaultValue.length !== 1) {
       throw new TypeError('Single character expected as defaultValue');
@@ -158,29 +145,27 @@ function _setSubstring(str, index, replacement, defaultValue) {
   } else {
     defaultValue = ' ';
   }
-
   var range = index.dimension(0);
   var len = range.size()[0];
-
   if (len !== replacement.length) {
     throw new _DimensionError.DimensionError(range.size()[0], replacement.length);
-  } // validate whether the range is out of range
-
+  }
 
+  // validate whether the range is out of range
   var strLen = str.length;
   (0, _array.validateIndex)(index.min()[0]);
-  (0, _array.validateIndex)(index.max()[0]); // copy the string into an array with characters
+  (0, _array.validateIndex)(index.max()[0]);
 
+  // copy the string into an array with characters
   var chars = [];
-
   for (var i = 0; i < strLen; i++) {
     chars[i] = str.charAt(i);
   }
-
   range.forEach(function (v, i) {
     chars[v] = replacement.charAt(i[0]);
-  }); // initialize undefined characters with a space
+  });
 
+  // initialize undefined characters with a space
   if (chars.length > strLen) {
     for (var _i = strLen - 1, _len = chars.length; _i < _len; _i++) {
       if (!chars[_i]) {
@@ -188,9 +173,9 @@ function _setSubstring(str, index, replacement, defaultValue) {
       }
     }
   }
-
   return chars.join('');
 }
+
 /**
  * Retrieve a property from an object
  * @param {Object} object
@@ -198,21 +183,17 @@ function _setSubstring(str, index, replacement, defaultValue) {
  * @return {*} Returns the value of the property
  * @private
  */
-
-
 function _getObjectProperty(object, index) {
   if (index.size().length !== 1) {
     throw new _DimensionError.DimensionError(index.size(), 1);
   }
-
   var key = index.dimension(0);
-
   if (typeof key !== 'string') {
     throw new TypeError('String expected as index to retrieve an object property');
   }
-
   return (0, _customs.getSafeProperty)(object, key);
 }
+
 /**
  * Set a property on an object
  * @param {Object} object
@@ -221,20 +202,16 @@ function _getObjectProperty(object, index) {
  * @return {*} Returns the updated object
  * @private
  */
-
-
 function _setObjectProperty(object, index, replacement) {
   if (index.size().length !== 1) {
     throw new _DimensionError.DimensionError(index.size(), 1);
   }
-
   var key = index.dimension(0);
-
   if (typeof key !== 'string') {
     throw new TypeError('String expected as index to retrieve an object property');
-  } // clone the object, and apply the property to the clone
-
+  }
 
+  // clone the object, and apply the property to the clone
   var updated = (0, _object.clone)(object);
   (0, _customs.setSafeProperty)(updated, key, replacement);
   return updated;

package/lib/cjs/function/matrix/trace.js

@@ -4,20 +4,15 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.createTrace = void 0;
-
 var _object = require("../../utils/object.js");
-
 var _string = require("../../utils/string.js");
-
 var _factory = require("../../utils/factory.js");
-
 var name = 'trace';
 var dependencies = ['typed', 'matrix', 'add'];
 var createTrace = /* #__PURE__ */(0, _factory.factory)(name, dependencies, function (_ref) {
   var typed = _ref.typed,
-      matrix = _ref.matrix,
-      add = _ref.add;
-
+    matrix = _ref.matrix,
+    add = _ref.add;
   /**
    * Calculate the trace of a matrix: the sum of the elements on the main
    * diagonal of a square matrix.
@@ -54,12 +49,12 @@ var createTrace = /* #__PURE__ */(0, _factory.factory)(name, dependencies, funct
     DenseMatrix: _denseTrace,
     any: _object.clone
   });
-
   function _denseTrace(m) {
     // matrix size & data
     var size = m._size;
-    var data = m._data; // process dimensions
+    var data = m._data;
 
+    // process dimensions
     switch (size.length) {
       case 1:
         // vector
@@ -67,80 +62,71 @@ var createTrace = /* #__PURE__ */(0, _factory.factory)(name, dependencies, funct
           // return data[0]
           return (0, _object.clone)(data[0]);
         }
-
         throw new RangeError('Matrix must be square (size: ' + (0, _string.format)(size) + ')');
-
       case 2:
         {
           // two dimensional
           var rows = size[0];
           var cols = size[1];
-
           if (rows === cols) {
             // calulate sum
-            var sum = 0; // loop diagonal
-
+            var sum = 0;
+            // loop diagonal
             for (var i = 0; i < rows; i++) {
               sum = add(sum, data[i][i]);
-            } // return trace
-
-
+            }
+            // return trace
             return sum;
           } else {
             throw new RangeError('Matrix must be square (size: ' + (0, _string.format)(size) + ')');
           }
         }
-
       default:
         // multi dimensional
         throw new RangeError('Matrix must be two dimensional (size: ' + (0, _string.format)(size) + ')');
     }
   }
-
   function _sparseTrace(m) {
     // matrix arrays
     var values = m._values;
     var index = m._index;
     var ptr = m._ptr;
-    var size = m._size; // check dimensions
-
+    var size = m._size;
+    // check dimensions
     var rows = size[0];
-    var columns = size[1]; // matrix must be square
-
+    var columns = size[1];
+    // matrix must be square
     if (rows === columns) {
       // calulate sum
-      var sum = 0; // check we have data (avoid looping columns)
-
+      var sum = 0;
+      // check we have data (avoid looping columns)
       if (values.length > 0) {
         // loop columns
         for (var j = 0; j < columns; j++) {
           // k0 <= k < k1 where k0 = _ptr[j] && k1 = _ptr[j+1]
           var k0 = ptr[j];
-          var k1 = ptr[j + 1]; // loop k within [k0, k1[
-
+          var k1 = ptr[j + 1];
+          // loop k within [k0, k1[
           for (var k = k0; k < k1; k++) {
             // row index
-            var i = index[k]; // check row
-
+            var i = index[k];
+            // check row
             if (i === j) {
               // accumulate value
-              sum = add(sum, values[k]); // exit loop
-
+              sum = add(sum, values[k]);
+              // exit loop
               break;
             }
-
             if (i > j) {
               // exit loop, no value on the diagonal for column j
               break;
             }
           }
         }
-      } // return trace
-
-
+      }
+      // return trace
       return sum;
     }
-
     throw new RangeError('Matrix must be square (size: ' + (0, _string.format)(size) + ')');
   }
 });

package/lib/cjs/function/matrix/transpose.js

@@ -4,19 +4,14 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.createTranspose = void 0;
-
 var _object = require("../../utils/object.js");
-
 var _string = require("../../utils/string.js");
-
 var _factory = require("../../utils/factory.js");
-
 var name = 'transpose';
 var dependencies = ['typed', 'matrix'];
 var createTranspose = /* #__PURE__ */(0, _factory.factory)(name, dependencies, function (_ref) {
   var typed = _ref.typed,
-      matrix = _ref.matrix;
-
+    matrix = _ref.matrix;
   /**
    * Transpose a matrix. All values of the matrix are reflected over its
    * main diagonal. Only applicable to two dimensional matrices containing
@@ -45,132 +40,122 @@ var createTranspose = /* #__PURE__ */(0, _factory.factory)(name, dependencies, f
     },
     Matrix: transposeMatrix,
     any: _object.clone // scalars
-
   });
 
   function transposeMatrix(x) {
     // matrix size
-    var size = x.size(); // result
+    var size = x.size();
 
-    var c; // process dimensions
+    // result
+    var c;
 
+    // process dimensions
     switch (size.length) {
       case 1:
         // vector
         c = x.clone();
         break;
-
       case 2:
         {
           // rows and columns
           var rows = size[0];
-          var columns = size[1]; // check columns
+          var columns = size[1];
 
+          // check columns
           if (columns === 0) {
             // throw exception
             throw new RangeError('Cannot transpose a 2D matrix with no columns (size: ' + (0, _string.format)(size) + ')');
-          } // process storage format
-
+          }
 
+          // process storage format
           switch (x.storage()) {
             case 'dense':
               c = _denseTranspose(x, rows, columns);
               break;
-
             case 'sparse':
               c = _sparseTranspose(x, rows, columns);
               break;
           }
         }
         break;
-
       default:
         // multi dimensional
         throw new RangeError('Matrix must be a vector or two dimensional (size: ' + (0, _string.format)(size) + ')');
     }
-
     return c;
   }
-
   function _denseTranspose(m, rows, columns) {
     // matrix array
-    var data = m._data; // transposed matrix data
-
+    var data = m._data;
+    // transposed matrix data
     var transposed = [];
-    var transposedRow; // loop columns
-
+    var transposedRow;
+    // loop columns
     for (var j = 0; j < columns; j++) {
       // initialize row
-      transposedRow = transposed[j] = []; // loop rows
-
+      transposedRow = transposed[j] = [];
+      // loop rows
       for (var i = 0; i < rows; i++) {
         // set data
         transposedRow[i] = (0, _object.clone)(data[i][j]);
       }
-    } // return matrix
-
-
+    }
+    // return matrix
     return m.createDenseMatrix({
       data: transposed,
       size: [columns, rows],
       datatype: m._datatype
     });
   }
-
   function _sparseTranspose(m, rows, columns) {
     // matrix arrays
     var values = m._values;
     var index = m._index;
-    var ptr = m._ptr; // result matrices
-
+    var ptr = m._ptr;
+    // result matrices
     var cvalues = values ? [] : undefined;
     var cindex = [];
-    var cptr = []; // row counts
-
+    var cptr = [];
+    // row counts
     var w = [];
-
     for (var x = 0; x < rows; x++) {
       w[x] = 0;
-    } // vars
-
-
-    var p, l, j; // loop values in matrix
-
+    }
+    // vars
+    var p, l, j;
+    // loop values in matrix
     for (p = 0, l = index.length; p < l; p++) {
       // number of values in row
       w[index[p]]++;
-    } // cumulative sum
-
-
-    var sum = 0; // initialize cptr with the cummulative sum of row counts
-
+    }
+    // cumulative sum
+    var sum = 0;
+    // initialize cptr with the cummulative sum of row counts
     for (var i = 0; i < rows; i++) {
       // update cptr
-      cptr.push(sum); // update sum
-
-      sum += w[i]; // update w
-
+      cptr.push(sum);
+      // update sum
+      sum += w[i];
+      // update w
       w[i] = cptr[i];
-    } // update cptr
-
-
-    cptr.push(sum); // loop columns
-
+    }
+    // update cptr
+    cptr.push(sum);
+    // loop columns
     for (j = 0; j < columns; j++) {
       // values & index in column
       for (var k0 = ptr[j], k1 = ptr[j + 1], k = k0; k < k1; k++) {
         // C values & index
-        var q = w[index[k]]++; // C[j, i] = A[i, j]
-
-        cindex[q] = j; // check we need to process values (pattern matrix)
-
+        var q = w[index[k]]++;
+        // C[j, i] = A[i, j]
+        cindex[q] = j;
+        // check we need to process values (pattern matrix)
         if (values) {
           cvalues[q] = (0, _object.clone)(values[k]);
         }
       }
-    } // return matrix
-
-
+    }
+    // return matrix
     return m.createSparseMatrix({
       values: cvalues,
       index: cindex,

package/lib/cjs/function/matrix/zeros.js

@@ -4,23 +4,17 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.createZeros = void 0;
-
 var _is = require("../../utils/is.js");
-
 var _number = require("../../utils/number.js");
-
 var _array = require("../../utils/array.js");
-
 var _factory = require("../../utils/factory.js");
-
 var name = 'zeros';
 var dependencies = ['typed', 'config', 'matrix', 'BigNumber'];
 var createZeros = /* #__PURE__ */(0, _factory.factory)(name, dependencies, function (_ref) {
   var typed = _ref.typed,
-      config = _ref.config,
-      matrix = _ref.matrix,
-      BigNumber = _ref.BigNumber;
-
+    config = _ref.config,
+    matrix = _ref.matrix,
+    BigNumber = _ref.BigNumber;
   /**
    * Create a matrix filled with zeros. The created matrix can have one or
    * multiple dimensions.
@@ -61,7 +55,6 @@ var createZeros = /* #__PURE__ */(0, _factory.factory)(name, dependencies, funct
     // TODO: more accurate signature '...number | BigNumber, string' as soon as typed-function supports this
     '...number | BigNumber | string': function numberBigNumberString(size) {
       var last = size[size.length - 1];
-
       if (typeof last === 'string') {
         var format = size.pop();
         return _zeros(size, format);
@@ -80,6 +73,7 @@ var createZeros = /* #__PURE__ */(0, _factory.factory)(name, dependencies, funct
       return _zeros(size.valueOf(), format);
     }
   });
+
   /**
    * Create an Array or Matrix with zeros
    * @param {Array} size
@@ -87,36 +81,28 @@ var createZeros = /* #__PURE__ */(0, _factory.factory)(name, dependencies, funct
    * @return {Array | Matrix}
    * @private
    */
-
   function _zeros(size, format) {
     var hasBigNumbers = _normalize(size);
-
     var defaultValue = hasBigNumbers ? new BigNumber(0) : 0;
-
     _validate(size);
-
     if (format) {
       // return a matrix
       var m = matrix(format);
-
       if (size.length > 0) {
         return m.resize(size, defaultValue);
       }
-
       return m;
     } else {
       // return an Array
       var arr = [];
-
       if (size.length > 0) {
         return (0, _array.resize)(arr, size, defaultValue);
       }
-
       return arr;
     }
-  } // replace BigNumbers with numbers, returns true if size contained BigNumbers
-
+  }
 
+  // replace BigNumbers with numbers, returns true if size contained BigNumbers
   function _normalize(size) {
     var hasBigNumbers = false;
     size.forEach(function (value, index, arr) {
@@ -126,9 +112,9 @@ var createZeros = /* #__PURE__ */(0, _factory.factory)(name, dependencies, funct
       }
     });
     return hasBigNumbers;
-  } // validate arguments
-
+  }
 
+  // validate arguments
   function _validate(size) {
     size.forEach(function (value) {
       if (typeof value !== 'number' || !(0, _number.isInteger)(value) || value < 0) {
@@ -136,6 +122,7 @@ var createZeros = /* #__PURE__ */(0, _factory.factory)(name, dependencies, funct
       }
     });
   }
-}); // TODO: zeros contains almost the same code as ones. Reuse this?
+});
 
+// TODO: zeros contains almost the same code as ones. Reuse this?
 exports.createZeros = createZeros;

package/lib/cjs/function/probability/combinations.js

@@ -4,16 +4,12 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.createCombinations = void 0;
-
 var _factory = require("../../utils/factory.js");
-
 var _combinations = require("../../plain/number/combinations.js");
-
 var name = 'combinations';
 var dependencies = ['typed'];
 var createCombinations = /* #__PURE__ */(0, _factory.factory)(name, dependencies, function (_ref) {
   var typed = _ref.typed;
-
   /**
    * Compute the number of ways of picking `k` unordered outcomes from `n`
    * possibilities.
@@ -44,17 +40,13 @@ var createCombinations = /* #__PURE__ */(0, _factory.factory)(name, dependencies
       var result, i;
       var nMinusk = n.minus(k);
       var one = new BigNumber(1);
-
       if (!isPositiveInteger(n) || !isPositiveInteger(k)) {
         throw new TypeError('Positive integer value expected in function combinations');
       }
-
       if (k.gt(n)) {
         throw new TypeError('k must be less than n in function combinations');
       }
-
       result = one;
-
       if (k.lt(nMinusk)) {
         for (i = one; i.lte(nMinusk); i = i.plus(one)) {
           result = result.times(k.plus(i)).dividedBy(i);
@@ -64,20 +56,19 @@ var createCombinations = /* #__PURE__ */(0, _factory.factory)(name, dependencies
           result = result.times(nMinusk.plus(i)).dividedBy(i);
         }
       }
-
       return result;
-    } // TODO: implement support for collection in combinations
+    }
 
+    // TODO: implement support for collection in combinations
   });
 });
+
 /**
  * Test whether BigNumber n is a positive integer
  * @param {BigNumber} n
  * @returns {boolean} isPositiveInteger
  */
-
 exports.createCombinations = createCombinations;
-
 function isPositiveInteger(n) {
   return n.isInteger() && n.gte(0);
 }