ootk 4.0.9 → 5.1.0

package/dist/operations/Vector.js

@@ -0,0 +1,415 @@
+/**
+ * @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, Matrix } from '../main.js';
+/**
+ * A Vector is a mathematical object that has both magnitude and direction.
+ */
+export class Vector {
+    elements;
+    /**
+     * The length of the vector.
+     */
+    length;
+    /**
+     * Represents a 3-dimensional vector.
+     */
+    static origin3 = new Vector([0, 0, 0]);
+    /**
+     * Represents a vector with all elements set to zero.
+     */
+    static origin6 = new Vector([0, 0, 0, 0, 0, 0]);
+    /**
+     * Represents the x-axis vector.
+     */
+    static xAxis = new Vector([1, 0, 0]);
+    /**
+     * Represents the y-axis vector.
+     */
+    static yAxis = new Vector([0, 1, 0]);
+    /**
+     * Represents the z-axis vector.
+     */
+    static zAxis = new Vector([0, 0, 1]);
+    /**
+     * Represents a vector pointing along the negative x-axis.
+     */
+    static xAxisNeg = new Vector([-1, 0, 0]);
+    /**
+     * Represents a vector pointing along the negative y-axis.
+     */
+    static yAxisNeg = new Vector([0, -1, 0]);
+    /**
+     * Represents a vector pointing along the negative z-axis.
+     */
+    static zAxisNeg = new Vector([0, 0, -1]);
+    constructor(elements) {
+        this.elements = elements;
+        this.length = elements.length;
+    }
+    /**
+     * Creates a zero vector of the specified length.
+     * @param length The length of the vector.
+     * @returns A new Vector object representing the zero vector.
+     */
+    static zero(length) {
+        return new Vector(new Array(length).fill(0));
+    }
+    /**
+     * Creates a new Vector with the specified length, filled with the specified
+     * value.
+     * @param length The length of the new Vector.
+     * @param value The value to fill the Vector with.
+     * @returns A new Vector filled with the specified value.
+     */
+    static filled(length, value) {
+        return new Vector(new Array(length).fill(value));
+    }
+    /**
+     * Creates a new Vector instance from an array of elements.
+     * @param elements - The array of elements to create the Vector from.
+     * @returns A new Vector instance.
+     */
+    static fromList(elements) {
+        return new Vector(elements);
+    }
+    /**
+     * Returns a string representation of the vector.
+     * @param fixed - The number of digits to appear after the decimal point.
+     * Defaults to -1.
+     * @returns A string representation of the vector.
+     */
+    toString(fixed = -1) {
+        if (fixed < 0) {
+            return `[${this.elements.join(', ')}]`;
+        }
+        const output = this.elements.map((e) => e.toFixed(fixed));
+        return `[${output.join(', ')}]`;
+    }
+    /**
+     * Returns a string representation of the x value of the vector.
+     * @returns A string representation of the x value of the vector.
+     */
+    get x() {
+        return this.elements[0];
+    }
+    /**
+     * Returns a string representation of the y value of the vector.
+     * @returns A string representation of the y value of the vector.
+     */
+    get y() {
+        return this.elements[1];
+    }
+    /**
+     * Returns a string representation of the z value of the vector.
+     * @returns A string representation of the z value of the vector.
+     */
+    get z() {
+        return this.elements[2];
+    }
+    /**
+     * Converts the vector elements to an array.
+     * @returns An array containing the vector elements.
+     */
+    toList() {
+        return Array.from(this.elements);
+    }
+    /**
+     * Converts the vector to a Float64Array.
+     * @returns The vector as a Float64Array.
+     */
+    toArray() {
+        return new Float64Array(this.elements);
+    }
+    /**
+     * Calculates the magnitude of the vector.
+     * @returns The magnitude of the vector.
+     */
+    magnitude() {
+        let total = 0;
+        for (const x of this.elements) {
+            total += x * x;
+        }
+        return Math.sqrt(total);
+    }
+    /**
+     * Adds the elements of another vector to this vector and returns a new
+     * vector.
+     * @param v - The vector to add.
+     * @returns A new vector containing the sum of the elements.
+     */
+    add(v) {
+        const output = new Array(this.length);
+        for (let i = 0; i < this.length; i++) {
+            output[i] = this.elements[i] + (v.elements[i]);
+        }
+        return new Vector(output);
+    }
+    /**
+     * Subtracts a vector from the current vector.
+     * @param v The vector to subtract.
+     * @returns A new vector representing the result of the subtraction.
+     */
+    subtract(v) {
+        const output = new Array(this.length);
+        for (let i = 0; i < this.length; i++) {
+            output[i] = this.elements[i] - (v.elements[i]);
+        }
+        return new Vector(output);
+    }
+    /**
+     * Scales the vector by a given factor.
+     * @param n The scaling factor.
+     * @returns A new Vector object representing the scaled vector.
+     */
+    scale(n) {
+        const output = new Array(this.length);
+        for (let i = 0; i < this.length; i++) {
+            output[i] = this.elements[i] * n;
+        }
+        return new Vector(output);
+    }
+    /**
+     * Negates the vector by scaling it by -1.
+     * @returns A new Vector object representing the negated vector.
+     */
+    negate() {
+        return this.scale(-1);
+    }
+    /**
+     * Return the Euclidean distance between this and another Vector.
+     * @param v The vector to calculate the distance to.
+     * @returns The distance between the two vectors.
+     */
+    distance(v) {
+        return this.subtract(v).magnitude();
+    }
+    /**
+     * Normalizes the vector, making it a unit vector with the same direction but
+     * a magnitude of 1. If the vector has a magnitude of 0, it returns a zero
+     * vector of the same length.
+     * @returns The normalized vector.
+     */
+    normalize() {
+        const m = this.magnitude();
+        if (m === 0) {
+            return Vector.zero(this.length);
+        }
+        return this.scale(1.0 / m);
+    }
+    /**
+     * Calculates the dot product of this vector and another vector.
+     * @param v - The vector to calculate the dot product with.
+     * @returns The dot product of the two vectors.
+     */
+    dot(v) {
+        let total = 0;
+        for (let i = 0; i < this.length; i++) {
+            total += this.elements[i] * (v.elements[i]);
+        }
+        return total;
+    }
+    /**
+     * Calculates the outer product of this vector with another vector.
+     * @param v The vector to calculate the outer product with.
+     * @returns A matrix representing the outer product of the two vectors.
+     */
+    outer(v) {
+        const result = [];
+        for (let i = 0; i < this.length; i++) {
+            result[i] = [];
+            for (let j = 0; j < v.length; j++) {
+                (result[i])[j] = this.elements[i] * (v.elements[j]);
+            }
+        }
+        return new Matrix(result);
+    }
+    /**
+     * Calculates the cross product of this vector and the given vector.
+     * @param v - The vector to calculate the cross product with.
+     * @returns The resulting vector.
+     */
+    cross(v) {
+        const output = new Array(this.length);
+        for (let i = 0; i < this.length; i++) {
+            output[i] =
+                this.elements[(i + 1) % this.length] * (v.elements[(i + 2) % this.length]) -
+                    this.elements[(i + 2) % this.length] * (v.elements[(i + 1) % this.length]);
+        }
+        return new Vector(output);
+    }
+    /**
+     * Calculate the skew-symmetric matrix for this [Vector].
+     * @returns The skew-symmetric matrix.
+     * @throws [Error] if the vector is not of length 3.
+     */
+    skewSymmetric() {
+        if (this.length !== 3) {
+            throw new Error('Skew-symmetric matrix requires a vector of length 3.');
+        }
+        return new Matrix([
+            [0, -this.elements[2], this.elements[1]],
+            [this.elements[2], 0, -this.elements[0]],
+            [-this.elements[1], this.elements[0], 0],
+        ]);
+    }
+    /**
+     * Rotates the vector around the X-axis by the specified angle.
+     * @param theta The angle in radians.
+     * @returns The rotated vector.
+     */
+    rotX(theta) {
+        const cosT = Math.cos(theta);
+        const sinT = Math.sin(theta);
+        const output = new Array(3);
+        output[0] = this.elements[0];
+        output[1] = cosT * this.elements[1] + sinT * this.elements[2];
+        output[2] = -sinT * this.elements[1] + cosT * this.elements[2];
+        return new Vector(output);
+    }
+    /**
+     * Rotates the vector around the Y-axis by the specified angle.
+     * @param theta The angle of rotation in radians.
+     * @returns A new Vector representing the rotated vector.
+     */
+    rotY(theta) {
+        const cosT = Math.cos(theta);
+        const sinT = Math.sin(theta);
+        const output = new Array(3);
+        output[0] = cosT * this.elements[0] + -sinT * this.elements[2];
+        output[1] = this.elements[1];
+        output[2] = sinT * this.elements[0] + cosT * this.elements[2];
+        return new Vector(output);
+    }
+    /**
+     * Rotates the vector around the Z-axis by the specified angle.
+     * @param theta The angle of rotation in radians.
+     * @returns A new Vector representing the rotated vector.
+     */
+    rotZ(theta) {
+        const cosT = Math.cos(theta);
+        const sinT = Math.sin(theta);
+        const output = new Array(3);
+        output[0] = cosT * this.elements[0] + sinT * this.elements[1];
+        output[1] = -sinT * this.elements[0] + cosT * this.elements[1];
+        output[2] = this.elements[2];
+        return new Vector(output);
+    }
+    /**
+     * Calculates the angle between this vector and another vector.
+     * @param v The other vector.
+     * @returns The angle between the two vectors in radians.
+     */
+    angle(v) {
+        // better than acos for small angles
+        const theta = Math.atan2(this.cross(v).magnitude(), this.dot(v));
+        if (isNaN(theta)) {
+            return 0.0;
+        }
+        return theta;
+    }
+    /**
+     * Calculates the angle between this vector and another vector in degrees.
+     * @param v The other vector.
+     * @returns The angle between the two vectors in degrees.
+     */
+    angleDegrees(v) {
+        return (this.angle(v) * (180 / Math.PI));
+    }
+    /**
+     * Determines if there is line of sight between this vector and another vector
+     * within a given radius.
+     * @param v - The vector to check line of sight with.
+     * @param radius - The radius within which line of sight is considered.
+     * @returns True if there is line of sight, false otherwise.
+     */
+    sight(v, radius) {
+        const r1Mag2 = this.magnitude() ** 2;
+        const r2Mag2 = v.magnitude() ** 2;
+        const rDot = this.dot(v);
+        const tMin = (r1Mag2 - rDot) / (r1Mag2 + r2Mag2 - 2.0 * rDot);
+        let los = false;
+        if (tMin < 0 || tMin > 1) {
+            los = true;
+        }
+        else {
+            const c = (1.0 - tMin) * r1Mag2 + rDot * tMin;
+            if (c >= radius * radius) {
+                los = true;
+            }
+        }
+        return los;
+    }
+    /**
+     * Returns the bisect vector between this vector and the given vector. The
+     * bisect vector is calculated by scaling this vector's magnitude by the
+     * magnitude of the given vector, adding the result to the product of scaling
+     * the given vector's magnitude by this vector's magnitude, and then
+     * normalizing the resulting vector.
+     * @param v - The vector to calculate the bisect with.
+     * @returns The bisect vector.
+     */
+    bisect(v) {
+        return this.scale(v.magnitude()).add(v.scale(this.magnitude())).normalize();
+    }
+    /**
+     * Joins the current vector with another vector.
+     * @param v The vector to join with.
+     * @returns A new vector that contains the elements of both vectors.
+     */
+    join(v) {
+        return new Vector(this.toList().concat(v.toList()));
+    }
+    /**
+     * Returns a new Vector containing a portion of the elements from the
+     * specified start index to the specified end index
+     * @param start The start index of the slice (inclusive).
+     * @param end The end index of the slice (exclusive).
+     * @returns A new Vector containing the sliced elements.
+     */
+    slice(start, end) {
+        return new Vector(this.elements.slice(start, end));
+    }
+    /**
+     * Returns a new Matrix object representing the row vector.
+     * @returns The row vector as a Matrix object.
+     */
+    row() {
+        return new Matrix([this.toList()]);
+    }
+    /**
+     * Returns a new Matrix object representing the column vector of this Vector.
+     * @returns The column vector as a Matrix object.
+     */
+    column() {
+        return new Matrix(this.toList().map((e) => [e]));
+    }
+    /**
+     * Converts the elements at the specified index to a Vector3D object.
+     * @param index - The index of the elements to convert.
+     * @returns A new Vector3D object containing the converted elements.
+     */
+    toVector3D(index) {
+        return new Vector3D(this.elements[index], this.elements[index + 1], this.elements[index + 2]);
+    }
+}
+//# sourceMappingURL=Vector.js.map

package/dist/operations/Vector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Vector.js","sourceRoot":"","sources":["../../src/operations/Vector.ts"],"names":[],"mappings":"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"}

package/dist/operations/Vector3D.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @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 { Kilometers, KilometersPerSecond, Radians } from '../main.js';
+import { Matrix } from './Matrix.js';
+import { Vector } from './Vector.js';
+export declare class Vector3D<T extends number = number> {
+    x: T;
+    y: T;
+    z: T;
+    constructor(x: T, y: T, z: T);
+    /**
+     * Create a new Vector3D object from the first three elements of a Vector
+     * object.
+     * @param v The Vector object to convert.
+     * @returns A new Vector3D object.
+     */
+    static fromVector<U extends number>(v: Vector<U>): Vector3D<U>;
+    static readonly origin: Vector3D<number>;
+    static readonly xAxis: Vector3D<number>;
+    static readonly yAxis: Vector3D<number>;
+    static readonly zAxis: Vector3D<number>;
+    static readonly xAxisNeg: Vector3D<number>;
+    static readonly yAxisNeg: Vector3D<number>;
+    static readonly zAxisNeg: Vector3D<number>;
+    toList(): T[];
+    toArray(): Float64Array<ArrayBuffer>;
+    /**
+     * Return the Vector3D element at the provided index.
+     * @deprecated don't do this
+     * @param index The index of the element to return.
+     * @returns The element at the provided index.
+     */
+    getElement(index: number): number;
+    toVector(): Vector<T>;
+    toString(fixed?: number): string;
+    magnitude(): T;
+    add(v: Vector3D<T>): Vector3D<T>;
+    subtract(v: Vector3D<T>): Vector3D<T>;
+    scale<U extends number>(n: U): Vector3D<U>;
+    negate(): Vector3D<T>;
+    /**
+     * Return the Euclidean distance between this and another Vector3D.
+     * @param v The other Vector3D.
+     * @returns The distance between this and the other Vector3D.
+     */
+    distance(v: Vector3D<T>): T;
+    /**
+     * Convert this to a unit Vector3D.
+     * @returns A unit Vector3D.
+     */
+    normalize(): Vector3D<T>;
+    dot<T extends number>(v: Vector3D<T>): T;
+    outer(v: Vector3D): Matrix;
+    cross<U extends number>(v: Vector3D<U>): Vector3D<U>;
+    skewSymmetric(): Matrix;
+    rotX(theta: number): Vector3D;
+    rotY(theta: Radians): Vector3D<T>;
+    rotZ(theta: Radians): Vector3D<T>;
+    angle<U extends number>(v: Vector3D<U>): Radians;
+    angleDegrees(v: Vector3D<T>): number;
+    sight(v: Vector3D<KilometersPerSecond>, radius: Kilometers): boolean;
+    bisect(v: Vector3D<T>): Vector3D<T>;
+    row(): Matrix;
+    column(): Matrix;
+    join(v: Vector3D): Vector;
+}