ootk 4.0.9 → 5.0.0

package/src/coordinate/index.ts

@@ -1 +1,13 @@
+export * from './ClassicalElements.js';
+export * from './EquinoctialElements.js';
+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';
+export * from './TEME.js';
+export * from './Tle.js';
 export { Hill } from './Hill.js';

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

@@ -0,0 +1,47 @@
+/**
+ * @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:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * 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.
+ */
+
+/**
+ * Represents the format data of a TLE (Two-Line Element) set. This is used to
+ * make it easier to remember the starting and ending positions of the columns
+ * containing the TLE data.
+ */
+export class TleFormatData {
+  /** The starting position of the TLE data in the source string. */
+  start: number;
+  /** The ending position of the TLE data in the source string. */
+  stop: number;
+  /** The length of the TLE data in the source string. */
+  length: number;
+
+  /**
+   * Creates a new instance of TleFormatData.
+   * @param start The starting position of the TLE data in the source string.
+   * @param end The ending position of the TLE data in the source string.
+   */
+  constructor(start: number, end: number) {
+    this.start = start - 1;
+    this.stop = end;
+    this.length = this.stop - this.start;
+  }
+}

package/src/covariance/CovarianceSample.ts

@@ -27,7 +27,7 @@ import {
   RIC,
   Vector,
   Vector3D,
-} from 'ootk-core';
+} from '../main.js';
 import { ForceModel } from '../force/ForceModel.js';
 import { Thrust } from '../force/Thrust.js';
 import { RungeKutta89Propagator } from '../propagator/RungeKutta89Propagator.js';

package/src/covariance/StateCovariance.ts

@@ -15,7 +15,7 @@
  * Orbital Object ToolKit. If not, see <http://www.gnu.org/licenses/>.
  */
 
-import { Matrix, Vector } from 'ootk-core';
+import { Matrix, Vector } from '../main.js';
 
 /** Covariance Frame */
 export enum CovarianceFrame {

package/src/data/DataHandler.ts

@@ -0,0 +1,88 @@
+/**
+ * @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:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * 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.
+ */
+
+import { egm96Data, Egm96Entry } from './values/Egm96Data.js';
+import { hpAtmosphereData } from './values/HpAtmosphereData.js';
+import { HpAtmosphereResult } from './values/HpAtmosphereResult.js';
+import { iau1980Data, Iau1980Entry } from './values/Iau1980Data.js';
+import { leapSecondData } from './values/LeapSecondData.js';
+
+/**
+ * Astrodynamic data management singleton.
+ *
+ * This class provides access to the various data sets used by the library.
+ * It is a singleton class, and can be accessed via the static
+ * [getInstance] method.
+ */
+export class DataHandler {
+  private static readonly instance_ = new DataHandler();
+
+  private constructor() {
+    // Prevent instantiation.
+  }
+
+  /**
+   * Returns the singleton instance of the DataHandler class.
+   * @returns The singleton instance of the DataHandler class.
+   */
+  static getInstance(): DataHandler {
+    return DataHandler.instance_;
+  }
+
+  /**
+   * Retrieves the Egm96 coefficients for the given l and m values.
+   * @param l - The degree of the coefficient.
+   * @param m - The order of the coefficient.
+   * @returns The Egm96Entry object containing the coefficients.
+   */
+  getEgm96Coeffs(l: number, m: number): Egm96Entry {
+    return egm96Data.getCoeffs(l, m);
+  }
+
+  /**
+   * Retrieves the IAU 1980 coefficients for the specified row.
+   * @param row The row index of the coefficients to retrieve.
+   * @returns The IAU 1980 entry containing the coefficients.
+   */
+  getIau1980Coeffs(row: number): Iau1980Entry {
+    return iau1980Data.getCoeffs(row);
+  }
+
+  /**
+   * Retrieves the number of leap seconds for a given Julian date.
+   * @param jd The Julian date.
+   * @returns The number of leap seconds.
+   */
+  getLeapSeconds(jd: number): number {
+    return leapSecondData.getLeapSeconds(jd);
+  }
+
+  /**
+   * Retrieves the atmosphere data for a given height.
+   * @param height The height for which to retrieve the atmosphere data.
+   * @returns The atmosphere data for the given height, or null if no data is available.
+   */
+  getHpAtmosphere(height: number): HpAtmosphereResult | null {
+    return hpAtmosphereData.getAtmosphere(height);
+  }
+}

package/src/data/values/Egm96Data.ts

@@ -0,0 +1,75 @@
+/**
+ * @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:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * 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.
+ */
+
+import { factorial } from '../../utils/functions.js';
+import { egm96 } from './egm96.js';
+
+// / EGM-96 entry for l, m indexes and clm, slm values.
+export type Egm96Entry = [number, number, number, number];
+
+// / Container for EGM-96 data.
+export class Egm96Data {
+  private readonly coeffs_: Egm96Entry[];
+
+  // / Create a new [Egm96Data] object.
+  constructor(coeffs: Egm96Entry[]) {
+    this.coeffs_ = coeffs;
+  }
+
+  /**
+   * Create a new [Egm96Data] container given a list of EGM-96
+   * coefficient tuples [vals].
+   * @param vals List of EGM-96 coefficient tuples.
+   * @returns A new [Egm96Data] object.
+   */
+  static fromVals(vals: Egm96Entry[]): Egm96Data {
+    const output: Egm96Entry[] = [];
+
+    for (const v of vals) {
+      const [l, m, clm, slm] = v;
+      const k = m === 0 ? 1 : 2;
+      const a = factorial(l + m);
+      const b = factorial(l - m) * (k * (2 * l + 1));
+      const nFac = Math.sqrt(a / b);
+      const normalizedClm = clm / nFac;
+      const normalizedSlm = slm / nFac;
+
+      output.push([l, m, normalizedClm, normalizedSlm]);
+    }
+
+    return new Egm96Data(output);
+  }
+
+  // / 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 the EGM-96 index for a given [l] and [m] lookup.
+  private static index_(l: number, m: number): number {
+    return (((l - 2) * (l + 2) + l) >> 1) - 1 + m;
+  }
+}
+
+// / De-normalized EGM-96 data container.
+export const egm96Data = Egm96Data.fromVals(egm96);

package/src/data/values/HpAtmosphereData.ts

@@ -0,0 +1,76 @@
+/**
+ * @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:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * 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.
+ */
+
+import { hpAtmosphere } from './hpAtmosphere.js';
+import { HpAtmosphereResult } from './HpAtmosphereResult.js';
+
+// / Harris-Priester atmosphere entry for height, min, and max density values.
+export type HpAtmosphereEntry = [number, number, number];
+
+// / Container for Harris-Priester atmosphere data.
+export class HpAtmosphereData {
+  private readonly table_: HpAtmosphereEntry[];
+  private readonly hMin_: number;
+  private readonly hMax_: number;
+
+  constructor(table: HpAtmosphereEntry[]) {
+    this.table_ = table;
+    if (table.length === 0 || typeof table[0]?.[0] === 'undefined') {
+      throw new Error('Table must have at least one valid entry.');
+    }
+
+    this.hMin_ = table[0][0];
+    this.hMax_ = table[table.length - 1]?.[0] ?? 0;
+  }
+
+  static fromVals(vals: [number, number, number][]): HpAtmosphereData {
+    const output: HpAtmosphereEntry[] = [];
+
+    for (const v of vals) {
+      const [h, minD, maxD] = v;
+
+      output.push([h, minD, maxD]);
+    }
+
+    return new HpAtmosphereData(output);
+  }
+
+  getAtmosphere(height: number): HpAtmosphereResult | null {
+    if (height < this.hMin_ || height > this.hMax_) {
+      return null;
+    }
+    let index = 0;
+
+    while (index < this.table_.length - 2 && height > (this.table_[index + 1] as HpAtmosphereEntry)[0]) {
+      index++;
+    }
+
+    return new HpAtmosphereResult(
+      height,
+      (this.table_[index] as HpAtmosphereEntry),
+      (this.table_[index + 1] as HpAtmosphereEntry),
+    );
+  }
+}
+
+export const hpAtmosphereData = HpAtmosphereData.fromVals(hpAtmosphere);

package/src/data/values/HpAtmosphereResult.ts

@@ -0,0 +1,41 @@
+/**
+ * @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:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * 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.
+ */
+
+import { HpAtmosphereEntry } from './HpAtmosphereData.js';
+
+// / Harris-Priester atmospheric density bracket.
+export class HpAtmosphereResult {
+  // / Height above Earth's surface _(km)_.
+  height: number;
+  // / Lower bound for atmospheric parameters.
+  hp0: HpAtmosphereEntry;
+  // / Upper bound for atmospheric parameters.
+  hp1: HpAtmosphereEntry;
+
+  // / Create a new [HpAtmosphereResult] object.
+  constructor(height: number, hp0: HpAtmosphereEntry, hp1: HpAtmosphereEntry) {
+    this.height = height;
+    this.hp0 = hp0;
+    this.hp1 = hp1;
+  }
+}

package/src/data/values/Iau1980Data.ts

@@ -0,0 +1,63 @@
+/**
+ * @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:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * 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.
+ */
+
+import { iau1980 } from './iau1980.js';
+
+// / IAU a1, a2, a3, a4, a5, Ai, Bi, Ci, Di coefficients.
+export type Iau1980Entry = [number, number, number, number, number, number, number, number, number];
+
+// / Container for IAU-1980 data.
+export class Iau1980Data {
+  private readonly coeffs_: Iau1980Entry[];
+
+  // / Create a new [Iau1980Data] object.
+  constructor(coeffs: Iau1980Entry[]) {
+    this.coeffs_ = coeffs;
+  }
+
+  /**
+   * Create a new [Iau1980Data] container object from an array of IAU-1980
+   * coefficient tuples [coeffs].
+   * @param coeffs IAU-1980 coefficients.
+   * @returns A new [Iau1980Data] object.
+   */
+  static fromCoeffs(coeffs: Array<Iau1980Entry>): Iau1980Data {
+    const output: Iau1980Entry[] = [];
+
+    for (const c of coeffs) {
+      const [a1, a2, a3, a4, a5, ai, bi, ci, di] = c;
+
+      output.push([a1, a2, a3, a4, a5, ai, bi, ci, di]);
+    }
+
+    return new Iau1980Data(output);
+  }
+
+  // / Get IAU-1980 coefficients for a given row number.
+  getCoeffs(row: number): Iau1980Entry {
+    return this.coeffs_[row] as Iau1980Entry;
+  }
+}
+
+// / IAU-1980 data container.
+export const iau1980Data = Iau1980Data.fromCoeffs(iau1980);

package/src/data/values/LeapSecond.ts

@@ -0,0 +1,37 @@
+/**
+ * @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:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * 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.
+ */
+
+// / Leap second data.
+export class LeapSecond {
+  // / Julian date.
+  jd: number;
+
+  // / Offset seconds.
+  offset: number;
+
+  // / Create a new [LeapSecond] object.
+  constructor(jd: number, offset: number) {
+    this.jd = jd;
+    this.offset = offset;
+  }
+}

package/src/data/values/LeapSecondData.ts

@@ -0,0 +1,113 @@
+/**
+ * @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:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * 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.
+ */
+
+import { LeapSecond } from './LeapSecond.js';
+// / Leap second value tuples.
+const leapSeconds: Array<[number, number]> = [
+  [2441317.5, 10],
+  [2441499.5, 11],
+  [2441683.5, 12],
+  [2442048.5, 13],
+  [2442413.5, 14],
+  [2442778.5, 15],
+  [2443144.5, 16],
+  [2443509.5, 17],
+  [2443874.5, 18],
+  [2444239.5, 19],
+  [2444786.5, 20],
+  [2445151.5, 21],
+  [2445516.5, 22],
+  [2446247.5, 23],
+  [2447161.5, 24],
+  [2447892.5, 25],
+  [2448257.5, 26],
+  [2448804.5, 27],
+  [2449169.5, 28],
+  [2449534.5, 29],
+  [2450083.5, 30],
+  [2450630.5, 31],
+  [2451179.5, 32],
+  [2453736.5, 33],
+  [2454832.5, 34],
+  [2456109.5, 35],
+  [2457204.5, 36],
+  [2457754.5, 37],
+] as const;
+
+// / Leap second data container.
+class LeapSecondData {
+  private readonly offsets_: LeapSecond[];
+  private readonly jdFirst_: number;
+  private readonly jdLast_: number;
+  private readonly offsetFirst_: number;
+  private readonly offsetLast_: number;
+
+  constructor(offsets: LeapSecond[]) {
+    this.offsets_ = offsets;
+    this.jdFirst_ = (this.offsets_[0] as LeapSecond).jd;
+    this.jdLast_ = (this.offsets_[this.offsets_.length - 1] as LeapSecond).jd;
+    this.offsetFirst_ = (this.offsets_[0] as LeapSecond).offset;
+    this.offsetLast_ = (this.offsets_[this.offsets_.length - 1] as LeapSecond).offset;
+  }
+
+  /**
+   * Create a new [LeapSecondData] container given a list of leap second
+   * value tuples [vals].
+   * @param vals Leap second value tuples.
+   * @returns A new [LeapSecondData] container.
+   */
+  static fromVals(vals: [number, number][]): LeapSecondData {
+    const output: LeapSecond[] = [];
+
+    for (const v of vals) {
+      const [jd, offset] = v;
+
+      output.push(new LeapSecond(jd, offset));
+    }
+
+    return new LeapSecondData(output);
+  }
+
+  // / Return the number of leap seconds for a given Julian date [jd].
+  getLeapSeconds(jd: number): number {
+    if (jd >= this.jdLast_) {
+      return this.offsetLast_;
+    }
+    if (jd <= this.jdFirst_) {
+      return this.offsetFirst_;
+    }
+    for (let i = 0; i < this.offsets_.length - 2; i++) {
+      const currentLeapSecond = this.offsets_[i] as LeapSecond;
+      const nextLeapSecond = this.offsets_[i + 1] as LeapSecond;
+
+      if (jd >= currentLeapSecond.jd && jd < nextLeapSecond.jd) {
+        return currentLeapSecond.offset;
+      }
+    }
+
+    return 0;
+  }
+}
+
+// / Leap second data container.
+export const leapSecondData: LeapSecondData = LeapSecondData.fromVals(leapSeconds);