ootk 5.0.0 → 5.1.0

package/src/coordinate/RelativeState.ts

@@ -1,24 +1,24 @@
 /**
- * @author Theodore Kruczek.
- * @license MIT
- * @copyright (c) 2022-2025 Theodore Kruczek Permission is
- * hereby granted, free of charge, to any person obtaining a copy of this
- * software and associated documentation files (the "Software"), to deal in the
- * Software without restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
- * the Software, and to permit persons to whom the Software is furnished to do
- * so, subject to the following conditions:
+ * @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
  *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
+ * 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.
  *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
+ * 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 } from '../main.js';

package/src/coordinate/StateVector.ts

@@ -1,28 +1,29 @@
 /**
- * @author Theodore Kruczek.
- * @license MIT
- * @copyright (c) 2022-2025 Theodore Kruczek Permission is
- * hereby granted, free of charge, to any person obtaining a copy of this
- * software and associated documentation files (the "Software"), to deal in the
- * Software without restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
- * the Software, and to permit persons to whom the Software is furnished to do
- * so, subject to the following conditions:
+ * @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
  *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
+ * 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.
  *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
+ * 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 { ClassicalElements, TAU, Earth, Kilometers, KilometersPerSecond, Minutes, EpochUTC, Vector3D }
-  from '../main.js';
+import {
+  ClassicalElements, TAU, Earth, Kilometers, KilometersPerSecond, Minutes, EpochUTC, Vector3D,
+} from '../main.js';
 
 /**
  * A state vector is a set of coordinates used to specify the position and

package/src/coordinate/TEME.ts

@@ -1,24 +1,24 @@
 /**
- * @author Theodore Kruczek.
- * @license MIT
- * @copyright (c) 2022-2025 Theodore Kruczek Permission is
- * hereby granted, free of charge, to any person obtaining a copy of this
- * software and associated documentation files (the "Software"), to deal in the
- * Software without restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
- * the Software, and to permit persons to whom the Software is furnished to do
- * so, subject to the following conditions:
+ * @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
  *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
+ * 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.
  *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
+ * 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, Vector3D } from '../main.js';

package/src/coordinate/Tle.ts

@@ -1,30 +1,30 @@
 /* eslint-disable max-lines */
 /**
- * @author Theodore Kruczek.
- * @license MIT
- * @copyright (c) 2022-2025 Theodore Kruczek Permission is
- * hereby granted, free of charge, to any person obtaining a copy of this
- * software and associated documentation files (the "Software"), to deal in the
- * Software without restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
- * the Software, and to permit persons to whom the Software is furnished to do
- * so, subject to the following conditions:
+ * @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
  *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
+ * 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.
  *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
+ * 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 { ClassicalElements, FormatTle, TEME } from './index.js';
 import { Sgp4OpsMode } from '../enums/Sgp4OpsMode.js';
-import { Satellite, Sgp4, Vector3D } from '../main.js';
+import { Sgp4, Vector3D } from '../main.js';
 import { Sgp4GravConstants } from '../sgp4/sgp4.js';
 import { EpochUTC } from '../time/EpochUTC.js';
 import {
@@ -51,8 +51,8 @@ import { TleFormatData } from './tle-format-data.js';
  * Tle is a static class with a collection of methods for working with TLEs.
  */
 export class Tle {
-  line1: string;
-  line2: string;
+  line1: TleLine1;
+  line2: TleLine2;
   epoch: EpochUTC;
   satnum: number;
   private readonly satrec_: SatelliteRecord;
@@ -136,8 +136,8 @@ export class Tle {
     opsMode: Sgp4OpsMode = Sgp4OpsMode.AFSPC,
     gravConst: Sgp4GravConstants = Sgp4GravConstants.wgs72,
   ) {
-    this.line1 = line1;
-    this.line2 = line2;
+    this.line1 = line1 as TleLine1;
+    this.line2 = line2 as TleLine2;
     this.epoch = Tle.parseEpoch_(line1.substring(18, 32));
     this.satnum = parseInt(Tle.convertA5to6Digit(line1.substring(2, 7)));
     this.satrec_ = Sgp4.createSatrec(line1, line2, gravConst, opsMode);
@@ -228,7 +228,7 @@ export class Tle {
   }
 
   static calcElsetAge(
-    sat: Satellite,
+    tle1: TleLine1,
     nowInput?: Date,
     outputUnits: 'days' | 'hours' | 'minutes' | 'seconds' = 'days',
   ): number {
@@ -236,8 +236,8 @@ export class Tle {
     const currentYearFull = nowInput.getUTCFullYear();
     const currentYearShort = currentYearFull % 100;
 
-    const epochYearShort = parseInt(sat.tle1.substring(18, 20), 10);
-    const epochDayOfYear = parseFloat(sat.tle1.substring(20, 32));
+    const epochYearShort = parseInt(tle1.substring(18, 20), 10);
+    const epochDayOfYear = parseFloat(tle1.substring(20, 32));
 
     let epochYearFull: number;
 

package/src/coordinate/index.ts

@@ -4,7 +4,6 @@ export * from './FormatTle.js';
 export * from './Geodetic.js';
 export * from './ITRF.js';
 export * from './J2000.js';
-// export * from '../enums/OrbitRegime.js';
 export * from './RelativeState.js';
 export * from './RIC.js';
 export * from './StateVector.js';

package/src/coordinate/tle-format-data.ts

@@ -1,24 +1,24 @@
 /**
- * @author Theodore Kruczek.
- * @license MIT
- * @copyright (c) 2022-2025 Theodore Kruczek Permission is
- * hereby granted, free of charge, to any person obtaining a copy of this
- * software and associated documentation files (the "Software"), to deal in the
- * Software without restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
- * the Software, and to permit persons to whom the Software is furnished to do
- * so, subject to the following conditions:
+ * @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
  *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
+ * 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.
  *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
+ * 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/>.
  */
 
 /**

package/src/covariance/CovarianceSample.ts

@@ -1,7 +1,7 @@
 /**
  * @author @thkruz Theodore Kruczek
  * @license AGPL-3.0-or-later
- * @copyright (c) 2020-2024 Theodore Kruczek
+ * @copyright (c) 2025 Kruczek Labs LLC
  *
  * 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
@@ -23,8 +23,10 @@ import {
   Kilometers,
   KilometersPerSecond,
   Matrix,
+  OrbitRegime,
   RelativeState,
   RIC,
+  Tle, Vec3Flat,
   Vector,
   Vector3D,
 } from '../main.js';
@@ -35,9 +37,9 @@ import { CovarianceFrame, StateCovariance } from './StateCovariance.js';
 
 // / Sigma point covariance sample.
 export class CovarianceSample {
-  private _origin: RungeKutta89Propagator;
-  private _samples: RungeKutta89Propagator[] = [];
-  private matrix_ = Matrix.zero(6, 12);
+  private readonly origin_: RungeKutta89Propagator;
+  private readonly samples_: RungeKutta89Propagator[] = [];
+  private readonly matrix_ = Matrix.zero(6, 12);
 
   /**
    * Create a new [CovarianceSample] object from an inertial state, covariance
@@ -46,19 +48,45 @@ export class CovarianceSample {
    * Two-body physics will be used if a force model is not provided.
    * @param state The origin state.
    * @param covariance The covariance.
+   * @param tle The TLE object.
    * @param originForceModel The force model for the origin state.
    * @param sampleForceModel The force model for the samples.
    */
-  constructor(state: J2000, covariance: StateCovariance, originForceModel?: ForceModel, sampleForceModel?: ForceModel) {
+  constructor(
+    state: J2000, covariance: StateCovariance, tle?: Tle, originForceModel?: ForceModel, sampleForceModel?: ForceModel,
+  ) {
     originForceModel ??= new ForceModel().setGravity();
     sampleForceModel ??= new ForceModel().setGravity();
-    this._origin = new RungeKutta89Propagator(state, originForceModel);
+
+    // Scale covariance using TLE quality and regime aging factor if TLE info is provided
+    let scale = [1, 1, 1];
+
+    if (tle) {
+      const tleAgeDays = Tle.calcElsetAge(tle.line1, new Date(), 'days');
+
+      const quality = this.evaluateTleQuality(tle);
+      const aging = this.getRegimeAgingFactor(tle, tleAgeDays);
+
+      scale = [
+        quality[0] * aging[0],
+        quality[1] * aging[1],
+        quality[2] * aging[2],
+      ];
+    }
+
+    this.origin_ = new RungeKutta89Propagator(state, originForceModel);
     const s = covariance.matrix.cholesky().elements;
     const sqrt6 = Math.sqrt(6.0);
 
     for (let i = 0; i < 6; i++) {
       for (let j = 0; j < 6; j++) {
-        s[i][j] *= sqrt6;
+      /*
+       * Apply scale[0] to R, scale[1] to I, scale[2] to C (x, y, z)
+       * Position: i = 0,1,2; Velocity: i = 3,4,5
+       */
+        const scaleIdx = i % 3;
+
+        s[i][j] *= sqrt6 * scale[scaleIdx];
       }
     }
 
@@ -92,23 +120,23 @@ export class CovarianceSample {
       if (covariance.frame === CovarianceFrame.ECI) {
         const sample = new J2000(state.epoch, state.position.add(sampleR), state.velocity.add(sampleV));
 
-        this._samples.push(new RungeKutta89Propagator(sample, sampleForceModel));
+        this.samples_.push(new RungeKutta89Propagator(sample, sampleForceModel));
       } else if (covariance.frame === CovarianceFrame.RIC) {
         const sample = new RIC(sampleR, sampleV).toJ2000(state);
 
-        this._samples.push(new RungeKutta89Propagator(sample, sampleForceModel));
+        this.samples_.push(new RungeKutta89Propagator(sample, sampleForceModel));
       }
     }
   }
 
   // / Current covariance sample epoch.
   get epoch(): Epoch {
-    return this._origin.state.epoch;
+    return this.origin_.state.epoch;
   }
 
   // / Current covariance sample origin state.
   get state(): J2000 {
-    return this._origin.state;
+    return this.origin_.state;
   }
 
   // / Rebuild covariance from sigma points.
@@ -142,16 +170,16 @@ export class CovarianceSample {
 
   // / Propagate covariance to a new epoch.
   propagate(epoch: EpochUTC): void {
-    this._origin.propagate(epoch);
-    for (const sample of this._samples) {
+    this.origin_.propagate(epoch);
+    for (const sample of this.samples_) {
       sample.propagate(epoch);
     }
   }
 
   // / Apply a maneuver to this covariance.
   maneuver(maneuver: Thrust): void {
-    this._origin.maneuver(maneuver);
-    for (const sample of this._samples) {
+    this.origin_.maneuver(maneuver);
+    for (const sample of this.samples_) {
       sample.maneuver(maneuver);
     }
   }
@@ -159,7 +187,7 @@ export class CovarianceSample {
   // / Desample covariance in J2000 frame.
   desampleJ2000(): StateCovariance {
     for (let i = 0; i < 12; i++) {
-      const state = this._samples[i].state;
+      const state = this.samples_[i].state;
 
       this.matrix_.elements[0][i] = state.position.x;
       this.matrix_.elements[1][i] = state.position.y;
@@ -175,10 +203,10 @@ export class CovarianceSample {
 
   // / Desample covariance in RIC frame.
   desampleRIC(): StateCovariance {
-    const rot = RelativeState.createMatrix(this._origin.state.position, this._origin.state.velocity);
+    const rot = RelativeState.createMatrix(this.origin_.state.position, this.origin_.state.velocity);
 
     for (let i = 0; i < 12; i++) {
-      const state = RIC.fromJ2000Matrix(this._samples[i].state, this._origin.state, rot);
+      const state = RIC.fromJ2000Matrix(this.samples_[i].state, this.origin_.state, rot);
 
       this.matrix_.elements[0][i] = state.position.x;
       this.matrix_.elements[1][i] = state.position.y;
@@ -191,4 +219,74 @@ export class CovarianceSample {
 
     return new StateCovariance(matrix, CovarianceFrame.RIC);
   }
+
+  evaluateTleQuality(tle: Tle): Vec3Flat {
+    let c = 1,
+      i = 1,
+      r = 1; // start with nominal 120 / 1000 / 100 m
+
+    /* ---- Mean–motion first derivative (rev/day²) ---- */
+    const mm1 = Math.abs(Tle.meanMoDev1(tle.line1));
+
+    if (mm1 > 1e-3) { // clear manoeuvre or very low-drag orbit
+      i *= 3.0;
+      r *= 2.0;
+      c *= 1.2;
+    } else if (mm1 > 1e-5) { // high drag but likely passive
+      i *= 1.6;
+      r *= 1.3;
+    }
+
+    /* ---- BSTAR drag term ---- */
+    const bstar = Math.abs(Tle.bstar(tle.line1));
+
+    if (bstar > 5e-4) { // <≈400 km LEO
+      i *= 1.5;
+      r *= 1.5;
+      c *= 1.1;
+    } else if (bstar > 1e-4) { // 400–600 km
+      i *= 1.2;
+      r *= 1.2;
+    }
+
+    /* ---- Eccentricity ---- */
+    const e = tle.eccentricity;
+
+    if (e > 0.05) { // HEO, GTO, cubesat transfer, etc.
+      r *= 1 + 6 * e;
+      i *= 1 + 4 * e;
+      c *= 1 + 1 * e;
+    } else if (e > 0.02) { // mildly elliptical LEO/MEO
+      r *= 1 + 3 * e;
+      i *= 1 + 2 * e;
+    }
+
+    return [r, i, c];
+  }
+
+  getRegimeAgingFactor(tle: Tle, ageDays: number): Vec3Flat {
+    const regime = tle.state.toClassicalElements().getOrbitRegime();
+    const t = Math.max(ageDays, 0) ** 1.5; // non-linear growth
+
+    switch (regime) {
+
+      case OrbitRegime.LEO:
+      // Target ~×2 (R), ×3 (I), ×2.2 (C) after 1 day
+        return [1 + 1.0 * t, 1 + 2.0 * t, 1 + 1.2 * t];
+
+      case OrbitRegime.MEO:
+      // GNSS shells – slower growth
+        return [1 + 0.4 * t, 1 + 0.9 * t, 1 + 0.6 * t];
+
+      case OrbitRegime.GEO:
+        return [1 + 0.2 * t, 1 + 0.5 * t, 1 + 0.3 * t];
+
+      case OrbitRegime.HEO:
+      // Highly elliptical transfer or Molniya
+        return [1 + 1.2 * t, 1 + 2.4 * t, 1 + 1.4 * t];
+
+      default:
+        return [1 + 0.6 * t, 1 + 1.2 * t, 1 + 0.8 * t];
+    }
+  }
 }

package/src/covariance/StateCovariance.ts

@@ -1,7 +1,7 @@
 /**
  * @author @thkruz Theodore Kruczek
  * @license AGPL-3.0-or-later
- * @copyright (c) 2020-2024 Theodore Kruczek
+ * @copyright (c) 2025 Kruczek Labs LLC
  *
  * 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

package/src/covariance/index.ts

@@ -0,0 +1,2 @@
+export * from './CovarianceSample.js';
+export * from './StateCovariance.js';

package/src/data/DataHandler.ts

@@ -1,24 +1,24 @@
 /**
- * @author Theodore Kruczek.
- * @license MIT
- * @copyright (c) 2022-2025 Theodore Kruczek Permission is
- * hereby granted, free of charge, to any person obtaining a copy of this
- * software and associated documentation files (the "Software"), to deal in the
- * Software without restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
- * the Software, and to permit persons to whom the Software is furnished to do
- * so, subject to the following conditions:
+ * @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
  *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
+ * 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.
  *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
+ * 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 { egm96Data, Egm96Entry } from './values/Egm96Data.js';

package/src/data/values/Egm96Data.ts

@@ -1,24 +1,24 @@
 /**
- * @author Theodore Kruczek.
- * @license MIT
- * @copyright (c) 2022-2025 Theodore Kruczek Permission is
- * hereby granted, free of charge, to any person obtaining a copy of this
- * software and associated documentation files (the "Software"), to deal in the
- * Software without restriction, including without limitation the rights to use,
- * copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
- * the Software, and to permit persons to whom the Software is furnished to do
- * so, subject to the following conditions:
+ * @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
  *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
+ * 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.
  *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
+ * 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 { factorial } from '../../utils/functions.js';
@@ -62,7 +62,7 @@ export class Egm96Data {
 
   // / Return de-normalized EGM-96 coefficients for a given [l] and [m] index.
   getCoeffs(l: number, m: number): Egm96Entry {
-    return this.coeffs_[Egm96Data.index_(l, m)] as Egm96Entry;
+    return this.coeffs_[Egm96Data.index_(l, m)];
   }
 
   // / Return the EGM-96 index for a given [l] and [m] lookup.