62 lines
1.8 KiB
JavaScript
62 lines
1.8 KiB
JavaScript
import { factory } from '../../utils/factory.js';
|
|
import { deepMap } from '../../utils/collection.js';
|
|
import { log10Number } from '../../plain/number/index.js';
|
|
var name = 'log10';
|
|
var dependencies = ['typed', 'config', 'Complex'];
|
|
export var createLog10 = /* #__PURE__ */factory(name, dependencies, _ref => {
|
|
var {
|
|
typed,
|
|
config,
|
|
Complex: _Complex
|
|
} = _ref;
|
|
|
|
/**
|
|
* Calculate the 10-base logarithm of a value. This is the same as calculating `log(x, 10)`.
|
|
*
|
|
* For matrices, the function is evaluated element wise.
|
|
*
|
|
* Syntax:
|
|
*
|
|
* math.log10(x)
|
|
*
|
|
* Examples:
|
|
*
|
|
* math.log10(0.00001) // returns -5
|
|
* math.log10(10000) // returns 4
|
|
* math.log(10000) / math.log(10) // returns 4
|
|
* math.pow(10, 4) // returns 10000
|
|
*
|
|
* See also:
|
|
*
|
|
* exp, log, log1p, log2
|
|
*
|
|
* @param {number | BigNumber | Complex | Array | Matrix} x
|
|
* Value for which to calculate the logarithm.
|
|
* @return {number | BigNumber | Complex | Array | Matrix}
|
|
* Returns the 10-base logarithm of `x`
|
|
*/
|
|
return typed(name, {
|
|
number: function number(x) {
|
|
if (x >= 0 || config.predictable) {
|
|
return log10Number(x);
|
|
} else {
|
|
// negative value -> complex value computation
|
|
return new _Complex(x, 0).log().div(Math.LN10);
|
|
}
|
|
},
|
|
Complex: function Complex(x) {
|
|
return new _Complex(x).log().div(Math.LN10);
|
|
},
|
|
BigNumber: function BigNumber(x) {
|
|
if (!x.isNegative() || config.predictable) {
|
|
return x.log();
|
|
} else {
|
|
// downgrade to number, return Complex valued result
|
|
return new _Complex(x.toNumber(), 0).log().div(Math.LN10);
|
|
}
|
|
},
|
|
'Array | Matrix': function ArrayMatrix(x) {
|
|
return deepMap(x, this);
|
|
}
|
|
});
|
|
}); |