54 lines
1.8 KiB
JavaScript
54 lines
1.8 KiB
JavaScript
import { factory } from '../../utils/factory.js';
|
|
import { expm1Number } from '../../plain/number/index.js';
|
|
var name = 'expm1';
|
|
var dependencies = ['typed', 'Complex'];
|
|
export var createExpm1 = /* #__PURE__ */factory(name, dependencies, _ref => {
|
|
var {
|
|
typed,
|
|
Complex: _Complex
|
|
} = _ref;
|
|
/**
|
|
* Calculate the value of subtracting 1 from the exponential value.
|
|
* This function is more accurate than `math.exp(x)-1` when `x` is near 0
|
|
* To avoid ambiguity with the matrix exponential `expm`, this function
|
|
* does not operate on matrices; if you wish to apply it elementwise, see
|
|
* the examples.
|
|
*
|
|
* Syntax:
|
|
*
|
|
* math.expm1(x)
|
|
*
|
|
* Examples:
|
|
*
|
|
* math.expm1(2) // returns number 6.38905609893065
|
|
* math.pow(math.e, 2) - 1 // returns number 6.3890560989306495
|
|
* math.expm1(1e-8) // returns number 1.0000000050000001e-8
|
|
* math.exp(1e-8) - 1 // returns number 9.9999999392253e-9
|
|
* math.log(math.expm1(2) + 1) // returns number 2
|
|
*
|
|
* math.map([1, 2, 3], math.expm1)
|
|
* // returns [1.718281828459045, 6.3890560989306495, 19.085536923187668]
|
|
*
|
|
* See also:
|
|
*
|
|
* exp, expm, log, pow
|
|
*
|
|
* History:
|
|
*
|
|
* v11 Don't apply elementwise, avoids confusion with matrix exponential
|
|
* v4.2 Created
|
|
*
|
|
* @param {number | BigNumber | Complex} x The number to exponentiate
|
|
* @return {number | BigNumber | Complex} Exponential of `x`, minus one
|
|
*/
|
|
return typed(name, {
|
|
number: expm1Number,
|
|
Complex: function Complex(x) {
|
|
var r = Math.exp(x.re);
|
|
return new _Complex(r * Math.cos(x.im) - 1, r * Math.sin(x.im));
|
|
},
|
|
BigNumber: function BigNumber(x) {
|
|
return x.exp().minus(1);
|
|
}
|
|
});
|
|
}); |