ootk

/** * @author @thkruz Theodore Kruczek * @description Orbital Object ToolKit (ootk) is a collection of tools for working * with satellites and other orbital objects. * @license AGPL-3.0-or-later * @copyright (c) 2025 Kruczek Labs LLC * * Many of the classes are based off of the work of @david-rc-dayton and his * Pious Squid library (https://github.com/david-rc-dayton/pious_squid) which * is licensed under the MIT license. * * Orbital Object ToolKit is free software: you can redistribute it and/or modify it under the * terms of the GNU Affero General Public License as published by the Free Software * Foundation, either version 3 of the License, or (at your option) any later version. * * Orbital Object ToolKit is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. * See the GNU Affero General Public License for more details. * * You should have received a copy of the GNU Affero General Public License along with * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>. */ import { Vector3D, Vector, Radians } from '../main.js'; /** * A matrix is a rectangular array of numbers or other mathematical objects for * which operations such as addition and multiplication are defined. */ export declare class Matrix { elements: number[][]; readonly rows: number; readonly columns: number; constructor(elements: number[][]); /** * Creates a matrix with all elements set to zero. * @param rows - The number of rows in the matrix. * @param columns - The number of columns in the matrix. * @returns A matrix with all elements set to zero. */ static allZeros(rows: number, columns: number): Matrix; /** * Creates a new Matrix with the specified number of rows and columns, filled * with the specified value. * @param rows The number of rows in the matrix. * @param columns The number of columns in the matrix. * @param value The value to fill the matrix with. Default is 0.0. * @returns A new Matrix filled with the specified value. */ static fill(rows: number, columns: number, value?: number): Matrix; /** * Creates a rotation matrix around the X-axis. * @param theta - The angle of rotation in radians. * @returns The rotation matrix. */ static rotX(theta: Radians): Matrix; /** * Creates a rotation matrix around the y-axis. * @param theta - The angle of rotation in radians. * @returns The rotation matrix. */ static rotY(theta: Radians): Matrix; /** * Creates a rotation matrix around the Z-axis. * @param theta The angle of rotation in radians. * @returns The rotation matrix. */ static rotZ(theta: Radians): Matrix; /** * Creates a zero matrix with the specified number of rows and columns. * @param rows The number of rows in the matrix. * @param columns The number of columns in the matrix. * @returns A new Matrix object representing the zero matrix. */ static zero(rows: number, columns: number): Matrix; /** * Creates an identity matrix of the specified dimension. * @param dimension The dimension of the identity matrix. * @returns The identity matrix. */ static identity(dimension: number): Matrix; /** * Creates a diagonal matrix with the given diagonal elements. * @param d - An array of diagonal elements. * @returns A new Matrix object representing the diagonal matrix. */ static diagonal(d: number[]): Matrix; /** * Adds the elements of another matrix to this matrix and returns the result. * @param m - The matrix to be added. * @returns The resulting matrix after addition. */ add(m: Matrix): Matrix; /** * Subtracts the elements of another matrix from this matrix. * @param m - The matrix to subtract. * @returns A new matrix containing the result of the subtraction. */ subtract(m: Matrix): Matrix; /** * Scales the matrix by multiplying each element by a scalar value. * @param n - The scalar value to multiply each element by. * @returns A new Matrix object representing the scaled matrix. */ scale(n: number): Matrix; /** * Negates the matrix by scaling it by -1. * @returns The negated matrix. */ negate(): Matrix; /** * Multiplies this matrix with another matrix. * @param m The matrix to multiply with. * @returns The resulting matrix. */ multiply(m: Matrix): Matrix; /** * Computes the outer product of this matrix with another matrix. * @param m - The matrix to compute the outer product with. * @returns The resulting matrix. */ outerProduct(m: Matrix): Matrix; /** * Multiplies the matrix by a vector. * @param v The vector to multiply by. * @returns A new vector representing the result of the multiplication. */ multiplyVector(v: Vector): Vector; /** * Multiplies a 3D vector by the matrix. * @template T - The type of the vector elements. * @param v - The 3D vector to multiply. * @returns The resulting 3D vector after multiplication. */ multiplyVector3D<T extends number>(v: Vector3D<T>): Vector3D<T>; /** * Returns a new Matrix object where each element is the reciprocal of the * corresponding element in the current matrix. If an element in the current * matrix is zero, the corresponding element in the output matrix will also be * zero. * @returns A new Matrix object representing the reciprocal of the current * matrix. */ reciprocal(): Matrix; /** * Transposes the matrix by swapping rows with columns. * @returns A new Matrix object representing the transposed matrix. */ transpose(): Matrix; /** * Performs the Cholesky decomposition on the matrix. * @returns A new Matrix object representing the Cholesky decomposition of the * original matrix. */ cholesky(): Matrix; /** * Swaps two rows in the matrix. * @param i - The index of the first row. * @param j - The index of the second row. */ private _swapRows; /** * Converts the matrix to reduced row echelon form using the Gaussian * elimination method. This method modifies the matrix in-place. */ private toReducedRowEchelonForm_; /** * Calculates the inverse of the matrix. * @returns The inverse of the matrix. */ inverse(): Matrix; }