12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576 |
- "use strict";
- Object.defineProperty(exports, "__esModule", {
- value: true
- });
- exports.createRotate = void 0;
- var _factory = require("../../utils/factory.js");
- var _array = require("../../utils/array.js");
- var name = 'rotate';
- var dependencies = ['typed', 'multiply', 'rotationMatrix'];
- var createRotate = /* #__PURE__ */(0, _factory.factory)(name, dependencies, function (_ref) {
- var typed = _ref.typed,
- multiply = _ref.multiply,
- rotationMatrix = _ref.rotationMatrix;
- /**
- * Rotate a vector of size 1x2 counter-clockwise by a given angle
- * Rotate a vector of size 1x3 counter-clockwise by a given angle around the given axis
- *
- * Syntax:
- *
- * math.rotate(w, theta)
- * math.rotate(w, theta, v)
- *
- * Examples:
- *
- * math.rotate([11, 12], math.pi / 2) // returns [-12, 11]
- * math.rotate(matrix([11, 12]), math.pi / 2) // returns [-12, 11]
- *
- * math.rotate([1, 0, 0], unit('90deg'), [0, 0, 1]) // returns [0, 1, 0]
- * math.rotate(matrix([1, 0, 0]), unit('90deg'), [0, 0, 1]) // returns Matrix [0, 1, 0]
- *
- * math.rotate([1, 0], math.complex(1 + i)) // returns [cos(1 + i) - sin(1 + i), sin(1 + i) + cos(1 + i)]
- *
- * See also:
- *
- * matrix, rotationMatrix
- *
- * @param {Array | Matrix} w Vector to rotate
- * @param {number | BigNumber | Complex | Unit} theta Rotation angle
- * @param {Array | Matrix} [v] Rotation axis
- * @return {Array | Matrix} Multiplication of the rotation matrix and w
- */
- return typed(name, {
- 'Array , number | BigNumber | Complex | Unit': function ArrayNumberBigNumberComplexUnit(w, theta) {
- _validateSize(w, 2);
- var matrixRes = multiply(rotationMatrix(theta), w);
- return matrixRes.toArray();
- },
- 'Matrix , number | BigNumber | Complex | Unit': function MatrixNumberBigNumberComplexUnit(w, theta) {
- _validateSize(w, 2);
- return multiply(rotationMatrix(theta), w);
- },
- 'Array, number | BigNumber | Complex | Unit, Array | Matrix': function ArrayNumberBigNumberComplexUnitArrayMatrix(w, theta, v) {
- _validateSize(w, 3);
- var matrixRes = multiply(rotationMatrix(theta, v), w);
- return matrixRes;
- },
- 'Matrix, number | BigNumber | Complex | Unit, Array | Matrix': function MatrixNumberBigNumberComplexUnitArrayMatrix(w, theta, v) {
- _validateSize(w, 3);
- return multiply(rotationMatrix(theta, v), w);
- }
- });
- function _validateSize(v, expectedSize) {
- var actualSize = Array.isArray(v) ? (0, _array.arraySize)(v) : v.size();
- if (actualSize.length > 2) {
- throw new RangeError("Vector must be of dimensions 1x".concat(expectedSize));
- }
- if (actualSize.length === 2 && actualSize[1] !== 1) {
- throw new RangeError("Vector must be of dimensions 1x".concat(expectedSize));
- }
- if (actualSize[0] !== expectedSize) {
- throw new RangeError("Vector must be of dimensions 1x".concat(expectedSize));
- }
- }
- });
- exports.createRotate = createRotate;
|