mirror of
https://github.com/josdejong/mathjs.git
synced 2026-01-18 14:59:29 +00:00
119 lines
3.4 KiB
JavaScript
119 lines
3.4 KiB
JavaScript
'use strict';
|
|
|
|
function factory (type, config, load, typed) {
|
|
|
|
var matrix = load(require('../../type/matrix/function/matrix'));
|
|
|
|
var algorithm02 = load(require('../../type/matrix/utils/algorithm02'));
|
|
var algorithm03 = load(require('../../type/matrix/utils/algorithm03'));
|
|
var algorithm09 = load(require('../../type/matrix/utils/algorithm09'));
|
|
var algorithm11 = load(require('../../type/matrix/utils/algorithm11'));
|
|
var algorithm12 = load(require('../../type/matrix/utils/algorithm12'));
|
|
var algorithm13 = load(require('../../type/matrix/utils/algorithm13'));
|
|
var algorithm14 = load(require('../../type/matrix/utils/algorithm14'));
|
|
|
|
/**
|
|
* Calculate the inverse tangent function with two arguments, y/x.
|
|
* By providing two arguments, the right quadrant of the computed angle can be
|
|
* determined.
|
|
*
|
|
* For matrices, the function is evaluated element wise.
|
|
*
|
|
* Syntax:
|
|
*
|
|
* math.atan2(y, x)
|
|
*
|
|
* Examples:
|
|
*
|
|
* math.atan2(2, 2) / math.pi; // returns number 0.25
|
|
*
|
|
* var angle = math.unit(60, 'deg'); // returns Unit 60 deg
|
|
* var x = math.cos(angle);
|
|
* var y = math.sin(angle);
|
|
*
|
|
* math.atan(2); // returns Complex 1.5707963267948966 -1.3169578969248166 i
|
|
*
|
|
* See also:
|
|
*
|
|
* tan, atan, sin, cos
|
|
*
|
|
* @param {number | Array | Matrix} y Second dimension
|
|
* @param {number | Array | Matrix} x First dimension
|
|
* @return {number | Array | Matrix} Four-quadrant inverse tangent
|
|
*/
|
|
var atan2 = typed('atan2', {
|
|
|
|
'number, number': Math.atan2,
|
|
|
|
// Complex numbers doesn't seem to have a reasonable implementation of
|
|
// atan2(). Even Matlab removed the support, after they only calculated
|
|
// the atan only on base of the real part of the numbers and ignored the imaginary.
|
|
|
|
'BigNumber, BigNumber': function (y, x) {
|
|
return type.BigNumber.atan2(y, x);
|
|
},
|
|
|
|
'SparseMatrix, SparseMatrix': function (x, y) {
|
|
return algorithm09(x, y, atan2, false);
|
|
},
|
|
|
|
'SparseMatrix, DenseMatrix': function (x, y) {
|
|
// mind the order of y and x!
|
|
return algorithm02(y, x, atan2, true);
|
|
},
|
|
|
|
'DenseMatrix, SparseMatrix': function (x, y) {
|
|
return algorithm03(x, y, atan2, false);
|
|
},
|
|
|
|
'DenseMatrix, DenseMatrix': function (x, y) {
|
|
return algorithm13(x, y, atan2);
|
|
},
|
|
|
|
'Array, Array': function (x, y) {
|
|
return atan2(matrix(x), matrix(y)).valueOf();
|
|
},
|
|
|
|
'Array, Matrix': function (x, y) {
|
|
return atan2(matrix(x), y);
|
|
},
|
|
|
|
'Matrix, Array': function (x, y) {
|
|
return atan2(x, matrix(y));
|
|
},
|
|
|
|
'SparseMatrix, number | BigNumber': function (x, y) {
|
|
return algorithm11(x, y, atan2, false);
|
|
},
|
|
|
|
'DenseMatrix, number | BigNumber': function (x, y) {
|
|
return algorithm14(x, y, atan2, false);
|
|
},
|
|
|
|
'number | BigNumber, SparseMatrix': function (x, y) {
|
|
// mind the order of y and x
|
|
return algorithm12(y, x, atan2, true);
|
|
},
|
|
|
|
'number | BigNumber, DenseMatrix': function (x, y) {
|
|
// mind the order of y and x
|
|
return algorithm14(y, x, atan2, true);
|
|
},
|
|
|
|
'Array, number | BigNumber': function (x, y) {
|
|
return algorithm14(matrix(x), y, atan2, false).valueOf();
|
|
},
|
|
|
|
'number | BigNumber, Array': function (x, y) {
|
|
return algorithm14(matrix(y), x, atan2, true).valueOf();
|
|
}
|
|
});
|
|
|
|
atan2.toTex = {2: '\\mathrm{atan2}\\left(${args}\\right)'};
|
|
|
|
return atan2;
|
|
}
|
|
|
|
exports.name = 'atan2';
|
|
exports.factory = factory;
|