mathjs 10.6.3 → 11.0.1

package/lib/esm/function/relational/smallerEq.js

@@ -1,11 +1,11 @@
 import { nearlyEqual as bigNearlyEqual } from '../../utils/bignumber/nearlyEqual.js';
 import { nearlyEqual } from '../../utils/number.js';
 import { factory } from '../../utils/factory.js';
-import { createAlgorithm03 } from '../../type/matrix/utils/algorithm03.js';
-import { createAlgorithm07 } from '../../type/matrix/utils/algorithm07.js';
-import { createAlgorithm12 } from '../../type/matrix/utils/algorithm12.js';
-import { createAlgorithm14 } from '../../type/matrix/utils/algorithm14.js';
-import { createAlgorithm13 } from '../../type/matrix/utils/algorithm13.js';
+import { createMatAlgo03xDSf } from '../../type/matrix/utils/matAlgo03xDSf.js';
+import { createMatAlgo07xSSf } from '../../type/matrix/utils/matAlgo07xSSf.js';
+import { createMatAlgo12xSfs } from '../../type/matrix/utils/matAlgo12xSfs.js';
+import { createMatrixAlgorithmSuite } from '../../type/matrix/utils/matrixAlgorithmSuite.js';
+import { createCompareUnits } from './compareUnits.js';
 var name = 'smallerEq';
 var dependencies = ['typed', 'config', 'matrix', 'DenseMatrix'];
 export var createSmallerEq = /* #__PURE__ */factory(name, dependencies, _ref => {
@@ -15,21 +15,22 @@ export var createSmallerEq = /* #__PURE__ */factory(name, dependencies, _ref =>
     matrix,
     DenseMatrix
   } = _ref;
-  var algorithm03 = createAlgorithm03({
+  var matAlgo03xDSf = createMatAlgo03xDSf({
     typed
   });
-  var algorithm07 = createAlgorithm07({
+  var matAlgo07xSSf = createMatAlgo07xSSf({
     typed,
     DenseMatrix
   });
-  var algorithm12 = createAlgorithm12({
+  var matAlgo12xSfs = createMatAlgo12xSfs({
     typed,
     DenseMatrix
   });
-  var algorithm13 = createAlgorithm13({
-    typed
+  var matrixAlgorithmSuite = createMatrixAlgorithmSuite({
+    typed,
+    matrix
   });
-  var algorithm14 = createAlgorithm14({
+  var compareUnits = createCompareUnits({
     typed
   });
   /**
@@ -60,74 +61,23 @@ export var createSmallerEq = /* #__PURE__ */factory(name, dependencies, _ref =>
    * @return {boolean | Array | Matrix} Returns true when the x is smaller than y, else returns false
    */
 
-  return typed(name, {
-    'boolean, boolean': function booleanBoolean(x, y) {
-      return x <= y;
-    },
-    'number, number': function numberNumber(x, y) {
-      return x <= y || nearlyEqual(x, y, config.epsilon);
-    },
+  return typed(name, createSmallerEqNumber({
+    typed,
+    config
+  }), {
+    'boolean, boolean': (x, y) => x <= y,
     'BigNumber, BigNumber': function BigNumberBigNumber(x, y) {
       return x.lte(y) || bigNearlyEqual(x, y, config.epsilon);
     },
-    'Fraction, Fraction': function FractionFraction(x, y) {
-      return x.compare(y) !== 1;
-    },
+    'Fraction, Fraction': (x, y) => x.compare(y) !== 1,
     'Complex, Complex': function ComplexComplex() {
       throw new TypeError('No ordering relation is defined for complex numbers');
-    },
-    'Unit, Unit': function UnitUnit(x, y) {
-      if (!x.equalBase(y)) {
-        throw new Error('Cannot compare units with different base');
-      }
-
-      return this(x.value, y.value);
-    },
-    'SparseMatrix, SparseMatrix': function SparseMatrixSparseMatrix(x, y) {
-      return algorithm07(x, y, this);
-    },
-    'SparseMatrix, DenseMatrix': function SparseMatrixDenseMatrix(x, y) {
-      return algorithm03(y, x, this, true);
-    },
-    'DenseMatrix, SparseMatrix': function DenseMatrixSparseMatrix(x, y) {
-      return algorithm03(x, y, this, false);
-    },
-    'DenseMatrix, DenseMatrix': function DenseMatrixDenseMatrix(x, y) {
-      return algorithm13(x, y, this);
-    },
-    'Array, Array': function ArrayArray(x, y) {
-      // use matrix implementation
-      return this(matrix(x), matrix(y)).valueOf();
-    },
-    'Array, Matrix': function ArrayMatrix(x, y) {
-      // use matrix implementation
-      return this(matrix(x), y);
-    },
-    'Matrix, Array': function MatrixArray(x, y) {
-      // use matrix implementation
-      return this(x, matrix(y));
-    },
-    'SparseMatrix, any': function SparseMatrixAny(x, y) {
-      return algorithm12(x, y, this, false);
-    },
-    'DenseMatrix, any': function DenseMatrixAny(x, y) {
-      return algorithm14(x, y, this, false);
-    },
-    'any, SparseMatrix': function anySparseMatrix(x, y) {
-      return algorithm12(y, x, this, true);
-    },
-    'any, DenseMatrix': function anyDenseMatrix(x, y) {
-      return algorithm14(y, x, this, true);
-    },
-    'Array, any': function ArrayAny(x, y) {
-      // use matrix implementation
-      return algorithm14(matrix(x), y, this, false).valueOf();
-    },
-    'any, Array': function anyArray(x, y) {
-      // use matrix implementation
-      return algorithm14(matrix(y), x, this, true).valueOf();
     }
-  });
+  }, compareUnits, matrixAlgorithmSuite({
+    SS: matAlgo07xSSf,
+    DS: matAlgo03xDSf,
+    Ss: matAlgo12xSfs
+  }));
 });
 export var createSmallerEqNumber = /* #__PURE__ */factory(name, ['typed', 'config'], _ref2 => {
   var {

package/lib/esm/function/relational/unequal.js

@@ -1,9 +1,8 @@
 import { factory } from '../../utils/factory.js';
-import { createAlgorithm03 } from '../../type/matrix/utils/algorithm03.js';
-import { createAlgorithm07 } from '../../type/matrix/utils/algorithm07.js';
-import { createAlgorithm12 } from '../../type/matrix/utils/algorithm12.js';
-import { createAlgorithm14 } from '../../type/matrix/utils/algorithm14.js';
-import { createAlgorithm13 } from '../../type/matrix/utils/algorithm13.js';
+import { createMatAlgo03xDSf } from '../../type/matrix/utils/matAlgo03xDSf.js';
+import { createMatAlgo07xSSf } from '../../type/matrix/utils/matAlgo07xSSf.js';
+import { createMatAlgo12xSfs } from '../../type/matrix/utils/matAlgo12xSfs.js';
+import { createMatrixAlgorithmSuite } from '../../type/matrix/utils/matrixAlgorithmSuite.js';
 var name = 'unequal';
 var dependencies = ['typed', 'config', 'equalScalar', 'matrix', 'DenseMatrix'];
 export var createUnequal = /* #__PURE__ */factory(name, dependencies, _ref => {
@@ -14,22 +13,20 @@ export var createUnequal = /* #__PURE__ */factory(name, dependencies, _ref => {
     matrix,
     DenseMatrix
   } = _ref;
-  var algorithm03 = createAlgorithm03({
+  var matAlgo03xDSf = createMatAlgo03xDSf({
     typed
   });
-  var algorithm07 = createAlgorithm07({
+  var matAlgo07xSSf = createMatAlgo07xSSf({
     typed,
     DenseMatrix
   });
-  var algorithm12 = createAlgorithm12({
+  var matAlgo12xSfs = createMatAlgo12xSfs({
     typed,
     DenseMatrix
   });
-  var algorithm13 = createAlgorithm13({
-    typed
-  });
-  var algorithm14 = createAlgorithm14({
-    typed
+  var matrixAlgorithmSuite = createMatrixAlgorithmSuite({
+    typed,
+    matrix
   });
   /**
    * Test whether two values are unequal.
@@ -75,72 +72,15 @@ export var createUnequal = /* #__PURE__ */factory(name, dependencies, _ref => {
    * @return {boolean | Array | Matrix} Returns true when the compared values are unequal, else returns false
    */
 
-  return typed('unequal', {
-    'any, any': function anyAny(x, y) {
-      // strict equality for null and undefined?
-      if (x === null) {
-        return y !== null;
-      }
-
-      if (y === null) {
-        return x !== null;
-      }
-
-      if (x === undefined) {
-        return y !== undefined;
-      }
-
-      if (y === undefined) {
-        return x !== undefined;
-      }
-
-      return _unequal(x, y);
-    },
-    'SparseMatrix, SparseMatrix': function SparseMatrixSparseMatrix(x, y) {
-      return algorithm07(x, y, _unequal);
-    },
-    'SparseMatrix, DenseMatrix': function SparseMatrixDenseMatrix(x, y) {
-      return algorithm03(y, x, _unequal, true);
-    },
-    'DenseMatrix, SparseMatrix': function DenseMatrixSparseMatrix(x, y) {
-      return algorithm03(x, y, _unequal, false);
-    },
-    'DenseMatrix, DenseMatrix': function DenseMatrixDenseMatrix(x, y) {
-      return algorithm13(x, y, _unequal);
-    },
-    'Array, Array': function ArrayArray(x, y) {
-      // use matrix implementation
-      return this(matrix(x), matrix(y)).valueOf();
-    },
-    'Array, Matrix': function ArrayMatrix(x, y) {
-      // use matrix implementation
-      return this(matrix(x), y);
-    },
-    'Matrix, Array': function MatrixArray(x, y) {
-      // use matrix implementation
-      return this(x, matrix(y));
-    },
-    'SparseMatrix, any': function SparseMatrixAny(x, y) {
-      return algorithm12(x, y, _unequal, false);
-    },
-    'DenseMatrix, any': function DenseMatrixAny(x, y) {
-      return algorithm14(x, y, _unequal, false);
-    },
-    'any, SparseMatrix': function anySparseMatrix(x, y) {
-      return algorithm12(y, x, _unequal, true);
-    },
-    'any, DenseMatrix': function anyDenseMatrix(x, y) {
-      return algorithm14(y, x, _unequal, true);
-    },
-    'Array, any': function ArrayAny(x, y) {
-      // use matrix implementation
-      return algorithm14(matrix(x), y, _unequal, false).valueOf();
-    },
-    'any, Array': function anyArray(x, y) {
-      // use matrix implementation
-      return algorithm14(matrix(y), x, _unequal, true).valueOf();
-    }
-  });
+  return typed(name, createUnequalNumber({
+    typed,
+    equalScalar
+  }), matrixAlgorithmSuite({
+    elop: _unequal,
+    SS: matAlgo07xSSf,
+    DS: matAlgo03xDSf,
+    Ss: matAlgo12xSfs
+  }));
 
   function _unequal(x, y) {
     return !equalScalar(x, y);

package/lib/esm/function/special/erf.js

@@ -51,9 +51,7 @@ export var createErf = /* #__PURE__ */factory(name, dependencies, _ref => {
 
       return sign(x) * (1 - erfc3(y));
     },
-    'Array | Matrix': function ArrayMatrix(n) {
-      return deepMap(n, this);
-    } // TODO: For complex numbers, use the approximation for the Faddeeva function
+    'Array | Matrix': typed.referToSelf(self => n => deepMap(n, self)) // TODO: For complex numbers, use the approximation for the Faddeeva function
     //  from "More Efficient Computation of the Complex Error Function" (AMS)
 
   });

package/lib/esm/function/statistics/std.js

@@ -1,9 +1,11 @@
 import { factory } from '../../utils/factory.js';
+import { isCollection } from '../../utils/is.js';
 var name = 'std';
-var dependencies = ['typed', 'sqrt', 'variance'];
+var dependencies = ['typed', 'map', 'sqrt', 'variance'];
 export var createStd = /* #__PURE__ */factory(name, dependencies, _ref => {
   var {
     typed,
+    map,
     sqrt,
     variance
   } = _ref;
@@ -81,7 +83,13 @@ export var createStd = /* #__PURE__ */factory(name, dependencies, _ref => {
     }
 
     try {
-      return sqrt(variance.apply(null, arguments));
+      var v = variance.apply(null, arguments);
+
+      if (isCollection(v)) {
+        return map(v, sqrt);
+      } else {
+        return sqrt(v);
+      }
     } catch (err) {
       if (err instanceof TypeError && err.message.indexOf(' variance') !== -1) {
         throw new TypeError(err.message.replace(' variance', ' std'));

package/lib/esm/function/string/format.js

@@ -98,14 +98,14 @@ export var createFormat = /* #__PURE__ */factory(name, dependencies, _ref => {
    * Examples:
    *
    *    math.format(6.4)                                        // returns '6.4'
-   *    math.format(1240000)                                    // returns '1.24e6'
+   *    math.format(1240000)                                    // returns '1.24e+6'
    *    math.format(1/3)                                        // returns '0.3333333333333333'
    *    math.format(1/3, 3)                                     // returns '0.333'
    *    math.format(21385, 2)                                   // returns '21000'
    *    math.format(12e8, {notation: 'fixed'})                  // returns '1200000000'
    *    math.format(2.3,  {notation: 'fixed', precision: 4})    // returns '2.3000'
    *    math.format(52.8, {notation: 'exponential'})            // returns '5.28e+1'
-   *    math.format(12400,{notation: 'engineering'})            // returns '12.400e+3'
+   *    math.format(12400, {notation: 'engineering'})           // returns '12.4e+3'
    *    math.format(2000, {lowerExp: -2, upperExp: 2})          // returns '2e+3'
    *
    *    function formatCurrency(value) {

package/lib/esm/function/string/hex.js

@@ -10,8 +10,7 @@ var dependencies = ['typed', 'format'];
  *
  * Examples:
  *
- *    //the following outputs "0xF0"
- *    math.hex(240)
+ *    math.hex(240) // returns "0xF0"
  *
  * See also:
  *

package/lib/esm/function/trigonometry/acos.js

@@ -1,5 +1,4 @@
 import { factory } from '../../utils/factory.js';
-import { deepMap } from '../../utils/collection.js';
 var name = 'acos';
 var dependencies = ['typed', 'config', 'Complex'];
 export var createAcos = /* #__PURE__ */factory(name, dependencies, _ref => {
@@ -12,7 +11,8 @@ export var createAcos = /* #__PURE__ */factory(name, dependencies, _ref => {
   /**
    * Calculate the inverse cosine of a value.
    *
-   * For matrices, the function is evaluated element wise.
+   * To avoid confusion with the matrix arccosine, this function does not
+   * apply to matrices.
    *
    * Syntax:
    *
@@ -29,8 +29,8 @@ export var createAcos = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    *    cos, atan, asin
    *
-   * @param {number | BigNumber | Complex | Array | Matrix} x  Function input
-   * @return {number | BigNumber | Complex | Array | Matrix} The arc cosine of x
+   * @param {number | BigNumber | Complex} x  Function input
+   * @return {number | BigNumber | Complex} The arc cosine of x
    */
   return typed(name, {
     number: function number(x) {
@@ -45,9 +45,6 @@ export var createAcos = /* #__PURE__ */factory(name, dependencies, _ref => {
     },
     BigNumber: function BigNumber(x) {
       return x.acos();
-    },
-    'Array | Matrix': function ArrayMatrix(x) {
-      return deepMap(x, this);
     }
   });
 });

package/lib/esm/function/trigonometry/acosh.js

@@ -1,5 +1,4 @@
 import { factory } from '../../utils/factory.js';
-import { deepMap } from '../../utils/collection.js';
 import { acoshNumber } from '../../plain/number/index.js';
 var name = 'acosh';
 var dependencies = ['typed', 'config', 'Complex'];
@@ -28,8 +27,8 @@ export var createAcosh = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    *    cosh, asinh, atanh
    *
-   * @param {number | Complex | Unit | Array | Matrix} x  Function input
-   * @return {number | Complex | Array | Matrix} Hyperbolic arccosine of x
+   * @param {number | BigNumber | Complex} x  Function input
+   * @return {number | BigNumber | Complex} Hyperbolic arccosine of x
    */
   return typed(name, {
     number: function number(x) {
@@ -48,9 +47,6 @@ export var createAcosh = /* #__PURE__ */factory(name, dependencies, _ref => {
     },
     BigNumber: function BigNumber(x) {
       return x.acosh();
-    },
-    'Array | Matrix': function ArrayMatrix(x) {
-      return deepMap(x, this);
     }
   });
 });

package/lib/esm/function/trigonometry/acot.js

@@ -1,5 +1,4 @@
 import { factory } from '../../utils/factory.js';
-import { deepMap } from '../../utils/collection.js';
 import { acotNumber } from '../../plain/number/index.js';
 var name = 'acot';
 var dependencies = ['typed', 'BigNumber'];
@@ -12,7 +11,8 @@ export var createAcot = /* #__PURE__ */factory(name, dependencies, _ref => {
   /**
    * Calculate the inverse cotangent of a value, defined as `acot(x) = atan(1/x)`.
    *
-   * For matrices, the function is evaluated element wise.
+   * To avoid confusion with the matrix arccotanget, this function does not
+   * apply to matrices.
    *
    * Syntax:
    *
@@ -20,17 +20,16 @@ export var createAcot = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    * Examples:
    *
-   *    math.acot(0.5)           // returns number 0.4636476090008061
+   *    math.acot(0.5)           // returns number 1.1071487177940904
+   *    math.acot(2)             // returns number 0.4636476090008061
    *    math.acot(math.cot(1.5)) // returns number 1.5
    *
-   *    math.acot(2)             // returns Complex 1.5707963267948966 -1.3169578969248166 i
-   *
    * See also:
    *
    *    cot, atan
    *
-   * @param {number | Complex | Array | Matrix} x   Function input
-   * @return {number | Complex | Array | Matrix} The arc cotangent of x
+   * @param {number | BigNumber| Complex} x   Function input
+   * @return {number | BigNumber| Complex} The arc cotangent of x
    */
   return typed(name, {
     number: acotNumber,
@@ -39,9 +38,6 @@ export var createAcot = /* #__PURE__ */factory(name, dependencies, _ref => {
     },
     BigNumber: function BigNumber(x) {
       return new _BigNumber(1).div(x).atan();
-    },
-    'Array | Matrix': function ArrayMatrix(x) {
-      return deepMap(x, this);
     }
   });
 });

package/lib/esm/function/trigonometry/acoth.js

@@ -1,5 +1,4 @@
 import { factory } from '../../utils/factory.js';
-import { deepMap } from '../../utils/collection.js';
 import { acothNumber } from '../../plain/number/index.js';
 var name = 'acoth';
 var dependencies = ['typed', 'config', 'Complex', 'BigNumber'];
@@ -15,7 +14,8 @@ export var createAcoth = /* #__PURE__ */factory(name, dependencies, _ref => {
    * Calculate the hyperbolic arccotangent of a value,
    * defined as `acoth(x) = atanh(1/x) = (ln((x+1)/x) + ln(x/(x-1))) / 2`.
    *
-   * For matrices, the function is evaluated element wise.
+   * To avoid confusion with the matrix hyperbolic arccotangent, this
+   * function does not apply to matrices.
    *
    * Syntax:
    *
@@ -29,8 +29,8 @@ export var createAcoth = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    *    acsch, asech
    *
-   * @param {number | Complex | Array | Matrix} x  Function input
-   * @return {number | Complex | Array | Matrix} Hyperbolic arccotangent of x
+   * @param {number | BigNumber | Complex} x  Function input
+   * @return {number | BigNumber | Complex} Hyperbolic arccotangent of x
    */
   return typed(name, {
     number: function number(x) {
@@ -45,9 +45,6 @@ export var createAcoth = /* #__PURE__ */factory(name, dependencies, _ref => {
     },
     BigNumber: function BigNumber(x) {
       return new _BigNumber(1).div(x).atanh();
-    },
-    'Array | Matrix': function ArrayMatrix(x) {
-      return deepMap(x, this);
     }
   });
 });

package/lib/esm/function/trigonometry/acsc.js

@@ -1,5 +1,4 @@
 import { factory } from '../../utils/factory.js';
-import { deepMap } from '../../utils/collection.js';
 import { acscNumber } from '../../plain/number/index.js';
 var name = 'acsc';
 var dependencies = ['typed', 'config', 'Complex', 'BigNumber'];
@@ -14,7 +13,8 @@ export var createAcsc = /* #__PURE__ */factory(name, dependencies, _ref => {
   /**
    * Calculate the inverse cosecant of a value, defined as `acsc(x) = asin(1/x)`.
    *
-   * For matrices, the function is evaluated element wise.
+   * To avoid confusion with the matrix arccosecant, this function does not
+   * apply to matrices.
    *
    * Syntax:
    *
@@ -22,17 +22,16 @@ export var createAcsc = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    * Examples:
    *
-   *    math.acsc(0.5)           // returns number 0.5235987755982989
+   *    math.acsc(2)             // returns 0.5235987755982989
+   *    math.acsc(0.5)           // returns Complex 1.5707963267948966 -1.3169578969248166i
    *    math.acsc(math.csc(1.5)) // returns number ~1.5
    *
-   *    math.acsc(2)             // returns Complex 1.5707963267948966 -1.3169578969248166 i
-   *
    * See also:
    *
    *    csc, asin, asec
    *
-   * @param {number | Complex | Array | Matrix} x   Function input
-   * @return {number | Complex | Array | Matrix} The arc cosecant of x
+   * @param {number | BigNumber | Complex} x   Function input
+   * @return {number | BigNumber | Complex} The arc cosecant of x
    */
   return typed(name, {
     number: function number(x) {
@@ -47,9 +46,6 @@ export var createAcsc = /* #__PURE__ */factory(name, dependencies, _ref => {
     },
     BigNumber: function BigNumber(x) {
       return new _BigNumber(1).div(x).asin();
-    },
-    'Array | Matrix': function ArrayMatrix(x) {
-      return deepMap(x, this);
     }
   });
 });

package/lib/esm/function/trigonometry/acsch.js

@@ -1,5 +1,4 @@
 import { factory } from '../../utils/factory.js';
-import { deepMap } from '../../utils/collection.js';
 import { acschNumber } from '../../plain/number/index.js';
 var name = 'acsch';
 var dependencies = ['typed', 'BigNumber'];
@@ -13,7 +12,8 @@ export var createAcsch = /* #__PURE__ */factory(name, dependencies, _ref => {
    * Calculate the hyperbolic arccosecant of a value,
    * defined as `acsch(x) = asinh(1/x) = ln(1/x + sqrt(1/x^2 + 1))`.
    *
-   * For matrices, the function is evaluated element wise.
+   * To avoid confusion with the matrix hyperbolic arccosecant, this function
+   * does not apply to matrices.
    *
    * Syntax:
    *
@@ -27,8 +27,8 @@ export var createAcsch = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    *    asech, acoth
    *
-   * @param {number | Complex | Array | Matrix} x  Function input
-   * @return {number | Complex | Array | Matrix} Hyperbolic arccosecant of x
+   * @param {number | BigNumber | Complex} x  Function input
+   * @return {number | BigNumber | Complex} Hyperbolic arccosecant of x
    */
   return typed(name, {
     number: acschNumber,
@@ -37,9 +37,6 @@ export var createAcsch = /* #__PURE__ */factory(name, dependencies, _ref => {
     },
     BigNumber: function BigNumber(x) {
       return new _BigNumber(1).div(x).asinh();
-    },
-    'Array | Matrix': function ArrayMatrix(x) {
-      return deepMap(x, this);
     }
   });
 });

package/lib/esm/function/trigonometry/asec.js

@@ -1,5 +1,4 @@
 import { factory } from '../../utils/factory.js';
-import { deepMap } from '../../utils/collection.js';
 import { asecNumber } from '../../plain/number/index.js';
 var name = 'asec';
 var dependencies = ['typed', 'config', 'Complex', 'BigNumber'];
@@ -14,7 +13,8 @@ export var createAsec = /* #__PURE__ */factory(name, dependencies, _ref => {
   /**
    * Calculate the inverse secant of a value. Defined as `asec(x) = acos(1/x)`.
    *
-   * For matrices, the function is evaluated element wise.
+   * To avoid confusion with the matrix arcsecant, this function does not
+   * apply to matrices.
    *
    * Syntax:
    *
@@ -22,17 +22,17 @@ export var createAsec = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    * Examples:
    *
-   *    math.asec(0.5)           // returns 1.0471975511965979
+   *    math.asec(2)             // returns 1.0471975511965979
    *    math.asec(math.sec(1.5)) // returns 1.5
    *
-   *    math.asec(2)             // returns 0 + 1.3169578969248166 i
+   *    math.asec(0.5)           // returns Complex 0 + 1.3169578969248166i
    *
    * See also:
    *
    *    acos, acot, acsc
    *
-   * @param {number | Complex | Array | Matrix} x  Function input
-   * @return {number | Complex | Array | Matrix} The arc secant of x
+   * @param {number | BigNumber | Complex} x  Function input
+   * @return {number | BigNumber | Complex} The arc secant of x
    */
   return typed(name, {
     number: function number(x) {
@@ -47,9 +47,6 @@ export var createAsec = /* #__PURE__ */factory(name, dependencies, _ref => {
     },
     BigNumber: function BigNumber(x) {
       return new _BigNumber(1).div(x).acos();
-    },
-    'Array | Matrix': function ArrayMatrix(x) {
-      return deepMap(x, this);
     }
   });
 });

package/lib/esm/function/trigonometry/asech.js

@@ -1,5 +1,4 @@
 import { factory } from '../../utils/factory.js';
-import { deepMap } from '../../utils/collection.js';
 import { asechNumber } from '../../plain/number/index.js';
 var name = 'asech';
 var dependencies = ['typed', 'config', 'Complex', 'BigNumber'];
@@ -15,7 +14,8 @@ export var createAsech = /* #__PURE__ */factory(name, dependencies, _ref => {
    * Calculate the hyperbolic arcsecant of a value,
    * defined as `asech(x) = acosh(1/x) = ln(sqrt(1/x^2 - 1) + 1/x)`.
    *
-   * For matrices, the function is evaluated element wise.
+   * To avoid confusion with the matrix hyperbolic arcsecant, this function
+   * does not apply to matrices.
    *
    * Syntax:
    *
@@ -29,8 +29,8 @@ export var createAsech = /* #__PURE__ */factory(name, dependencies, _ref => {
    *
    *    acsch, acoth
    *
-   * @param {number | Complex | Array | Matrix} x  Function input
-   * @return {number | Complex | Array | Matrix} Hyperbolic arcsecant of x
+   * @param {number | BigNumber | Complex} x  Function input
+   * @return {number | BigNumber | Complex} Hyperbolic arcsecant of x
    */
   return typed(name, {
     number: function number(x) {
@@ -52,9 +52,6 @@ export var createAsech = /* #__PURE__ */factory(name, dependencies, _ref => {
     },
     BigNumber: function BigNumber(x) {
       return new _BigNumber(1).div(x).acosh();
-    },
-    'Array | Matrix': function ArrayMatrix(x) {
-      return deepMap(x, this);
     }
   });
 });