1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859 |
- 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': typed.referToSelf(self => x => deepMap(x, self))
- });
- });
|