@interstellar-tools/equations 1.1.0 → 1.3.0

package/dist/categories/orbits/hyperbolic-semi-major-axis.js

@@ -0,0 +1,66 @@
+/**
+ * Compute the **semi-major axis of a hyperbola** from the hyperbolic excess speed.
+ *
+ * $$
+ * a = -\frac{\mu}{v_\infty^2}
+ * $$
+ *
+ * Where:
+ * - $ v_\infty $ is the hyperbolic excess speed: the speed left over far from the body (m/s)
+ * - $ \mu $ is the body's gravitational parameter (m³/s²)
+ *
+ * **Units**
+ * - Inputs: `vInfinity` in **m/s**, `mu` in **m³/s²**.
+ * - Output: $ a $ in **m**, negative.
+ *
+ * ::: info Notes
+ *
+ * - Negative by convention, so that vis-viva $ v^2 = \mu(2/r - 1/a) $ holds for hyperbolas too.
+ * - $ v_\infty $ comes from a speed $ v $ at distance $ r $ by energy: $ v_\infty^2 = v^2 - 2\mu/r $, or from {@link characteristicEnergyC3} as $ \sqrt{C_3} $.
+ *
+ * :::
+ *
+ * ::: practice Apollo 11, arriving at the Moon
+ *
+ * **−4 203 km**
+ *
+ * _Approach hyperbola, with 1.08 km/s left over far from the Moon_
+ *
+ * ```ts
+ * hyperbolicSemiMajorAxis(1080, 4.902800118e12); // ≈ -4 203 361 m
+ * ```
+ *
+ * :::
+ *
+ * @param vInfinity - Hyperbolic excess speed $ v_\infty $ in **m/s** (finite, > 0).
+ * @param mu - Gravitational parameter $ \mu $ in **m³/s²** (finite, > 0).
+ * @returns Semi-major axis $ a $ in **m** (negative).
+ * @throws {TypeError} If any input is not a finite number.
+ * @throws {RangeError} If `vInfinity <= 0` or `mu <= 0`.
+ * @group Orbits
+ *
+ * @example
+ * ```ts
+ * // Leaving Earth for Mars with v∞ ≈ 2.95 km/s
+ * const a = hyperbolicSemiMajorAxis(2950, 3.986004418e14);
+ * // a ≈ -45 803 km
+ * ```
+ *
+ * @see {@link hyperbolicEccentricity}
+ * @see {@link hyperbolicPeriapsisSpeed}
+ */
+export const hyperbolicSemiMajorAxis = (vInfinity, mu) => {
+    for (const [name, x] of [
+        ['vInfinity', vInfinity],
+        ['mu', mu]
+    ]) {
+        if (!Number.isFinite(x))
+            throw new TypeError(`${name} must be a finite number. Received: ${x}`);
+    }
+    if (vInfinity <= 0)
+        throw new RangeError(`vInfinity must be > 0. Received: ${vInfinity}`);
+    if (mu <= 0)
+        throw new RangeError(`mu must be > 0. Received: ${mu}`);
+    return -mu / (vInfinity * vInfinity);
+};
+//# sourceMappingURL=hyperbolic-semi-major-axis.js.map

package/dist/categories/orbits/hyperbolic-semi-major-axis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperbolic-semi-major-axis.js","sourceRoot":"","sources":["../../../src/categories/orbits/hyperbolic-semi-major-axis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,SAAiB,EACjB,EAAU,EACF,EAAE;IACV,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI;QACtB,CAAC,WAAW,EAAE,SAAS,CAAC;QACxB,CAAC,IAAI,EAAE,EAAE,CAAC;KACF,EAAE,CAAC;QACX,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YACrB,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,uCAAuC,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,SAAS,IAAI,CAAC;QAChB,MAAM,IAAI,UAAU,CAAC,oCAAoC,SAAS,EAAE,CAAC,CAAC;IAExE,IAAI,EAAE,IAAI,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;IAErE,OAAO,CAAC,EAAE,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC;AACvC,CAAC,CAAC"}

package/dist/categories/orbits/hyperbolic-time-of-flight.d.ts

@@ -0,0 +1,64 @@
+import type { Radians } from '@interstellar-tools/types';
+/**
+ * Compute the **time of flight between two points on a hyperbola**, given by their true anomalies.
+ *
+ * $$
+ * t_2 - t_1 = \sqrt{\frac{-a^3}{\mu}}\,\Big[(e\sinh F_2 - F_2) - (e\sinh F_1 - F_1)\Big]
+ * $$
+ *
+ * with each hyperbolic anomaly $ F $ from {@link trueToHyperbolicAnomaly}.
+ *
+ * **Units**
+ * - Inputs: `nu1`, `nu2` in **radians**, `e` dimensionless, `a` in **m** (negative), `mu` in **m³/s²**.
+ * - Output: time in **s**, negative if `nu2` comes before `nu1`.
+ *
+ * ::: info Notes
+ *
+ * - Both points must lie inside the asymptotes. The incoming branch can be given as negative angles or just below 2π.
+ * - Crossing periapsis needs no special handling: $ F $ changes sign there.
+ * - To go from a time to a position, solve $ M_h = e\sinh F - F $ with {@link solveKeplerHyperbolic}, then use {@link hyperbolicToTrueAnomaly}.
+ *
+ * :::
+ *
+ * ::: practice Apollo 11, falling towards the Moon
+ *
+ * **13.8 h**
+ *
+ * _From the edge of the Moon's sphere of influence, 62 640 km out, to closest approach_
+ *
+ * The flight took 14 h 10 min from crossing into the sphere to lighting the engine for lunar orbit insertion. Patched conics leave out Earth's pull inside the sphere, one reason the two differ.
+ *
+ * ```ts
+ * const e = 1.44; // approach hyperbola
+ * const a = -4_203_000; // m
+ * const p = a * (1 - e * e);
+ * const nuSoi = -Math.acos((p / 62_640_000 - 1) / e) as Radians; // incoming
+ * hyperbolicTimeOfFlight(nuSoi, 0 as Radians, e, a, 4.902800118e12); // ≈ 49 600 s
+ * ```
+ *
+ * :::
+ *
+ * @param nu1 - True anomaly at the start $ \nu_1 $ in **radians** (finite, inside the asymptotes).
+ * @param nu2 - True anomaly at the end $ \nu_2 $ in **radians** (finite, inside the asymptotes).
+ * @param e - Eccentricity $ e $ (finite, > 1).
+ * @param a - Semi-major axis $ a $ in **m** (finite, < 0).
+ * @param mu - Gravitational parameter $ \mu $ in **m³/s²** (finite, > 0).
+ * @returns Time of flight in **s** from `nu1` to `nu2`.
+ * @throws {TypeError} If any input is not a finite number.
+ * @throws {RangeError} If `e <= 1`, `a >= 0`, `mu <= 0`, or either true anomaly is at or beyond the asymptotes.
+ * @group Orbits
+ *
+ * @example
+ * ```ts
+ * import type { Radians } from '@interstellar-tools/types';
+ *
+ * // From periapsis to 90° on a hyperbola with e = 2, a = -10 000 km, around Earth
+ * const t = hyperbolicTimeOfFlight(0 as Radians, (Math.PI / 2) as Radians, 2, -10_000e3, 3.986004418e14);
+ * // t ≈ 3 401 s
+ * ```
+ *
+ * @see {@link solveKeplerHyperbolic}
+ * @see https://en.wikipedia.org/wiki/Hyperbolic_trajectory Hyperbolic trajectory
+ */
+export declare const hyperbolicTimeOfFlight: (nu1: Radians, nu2: Radians, e: number, a: number, mu: number) => number;
+//# sourceMappingURL=hyperbolic-time-of-flight.d.ts.map

package/dist/categories/orbits/hyperbolic-time-of-flight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperbolic-time-of-flight.d.ts","sourceRoot":"","sources":["../../../src/categories/orbits/hyperbolic-time-of-flight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAIzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,eAAO,MAAM,sBAAsB,GACjC,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,GAAG,MAAM,EACT,GAAG,MAAM,EACT,IAAI,MAAM,KACT,MA0BF,CAAC"}

package/dist/categories/orbits/hyperbolic-time-of-flight.js

@@ -0,0 +1,86 @@
+import { trueToHyperbolicAnomaly } from '../anomalies/true-to-hyperbolic-anomaly.js';
+/**
+ * Compute the **time of flight between two points on a hyperbola**, given by their true anomalies.
+ *
+ * $$
+ * t_2 - t_1 = \sqrt{\frac{-a^3}{\mu}}\,\Big[(e\sinh F_2 - F_2) - (e\sinh F_1 - F_1)\Big]
+ * $$
+ *
+ * with each hyperbolic anomaly $ F $ from {@link trueToHyperbolicAnomaly}.
+ *
+ * **Units**
+ * - Inputs: `nu1`, `nu2` in **radians**, `e` dimensionless, `a` in **m** (negative), `mu` in **m³/s²**.
+ * - Output: time in **s**, negative if `nu2` comes before `nu1`.
+ *
+ * ::: info Notes
+ *
+ * - Both points must lie inside the asymptotes. The incoming branch can be given as negative angles or just below 2π.
+ * - Crossing periapsis needs no special handling: $ F $ changes sign there.
+ * - To go from a time to a position, solve $ M_h = e\sinh F - F $ with {@link solveKeplerHyperbolic}, then use {@link hyperbolicToTrueAnomaly}.
+ *
+ * :::
+ *
+ * ::: practice Apollo 11, falling towards the Moon
+ *
+ * **13.8 h**
+ *
+ * _From the edge of the Moon's sphere of influence, 62 640 km out, to closest approach_
+ *
+ * The flight took 14 h 10 min from crossing into the sphere to lighting the engine for lunar orbit insertion. Patched conics leave out Earth's pull inside the sphere, one reason the two differ.
+ *
+ * ```ts
+ * const e = 1.44; // approach hyperbola
+ * const a = -4_203_000; // m
+ * const p = a * (1 - e * e);
+ * const nuSoi = -Math.acos((p / 62_640_000 - 1) / e) as Radians; // incoming
+ * hyperbolicTimeOfFlight(nuSoi, 0 as Radians, e, a, 4.902800118e12); // ≈ 49 600 s
+ * ```
+ *
+ * :::
+ *
+ * @param nu1 - True anomaly at the start $ \nu_1 $ in **radians** (finite, inside the asymptotes).
+ * @param nu2 - True anomaly at the end $ \nu_2 $ in **radians** (finite, inside the asymptotes).
+ * @param e - Eccentricity $ e $ (finite, > 1).
+ * @param a - Semi-major axis $ a $ in **m** (finite, < 0).
+ * @param mu - Gravitational parameter $ \mu $ in **m³/s²** (finite, > 0).
+ * @returns Time of flight in **s** from `nu1` to `nu2`.
+ * @throws {TypeError} If any input is not a finite number.
+ * @throws {RangeError} If `e <= 1`, `a >= 0`, `mu <= 0`, or either true anomaly is at or beyond the asymptotes.
+ * @group Orbits
+ *
+ * @example
+ * ```ts
+ * import type { Radians } from '@interstellar-tools/types';
+ *
+ * // From periapsis to 90° on a hyperbola with e = 2, a = -10 000 km, around Earth
+ * const t = hyperbolicTimeOfFlight(0 as Radians, (Math.PI / 2) as Radians, 2, -10_000e3, 3.986004418e14);
+ * // t ≈ 3 401 s
+ * ```
+ *
+ * @see {@link solveKeplerHyperbolic}
+ * @see https://en.wikipedia.org/wiki/Hyperbolic_trajectory Hyperbolic trajectory
+ */
+export const hyperbolicTimeOfFlight = (nu1, nu2, e, a, mu) => {
+    for (const [name, x] of [
+        ['nu1', nu1],
+        ['nu2', nu2],
+        ['e', e],
+        ['a', a],
+        ['mu', mu]
+    ]) {
+        if (!Number.isFinite(x))
+            throw new TypeError(`${name} must be a finite number. Received: ${x}`);
+    }
+    if (e <= 1)
+        throw new RangeError(`e must be > 1. Received: ${e}`);
+    if (a >= 0)
+        throw new RangeError(`a must be < 0 for a hyperbola. Received: ${a}`);
+    if (mu <= 0)
+        throw new RangeError(`mu must be > 0. Received: ${mu}`);
+    const meanAnomaly = (nu) => {
+        const F = trueToHyperbolicAnomaly(nu, e);
+        return e * Math.sinh(F) - F;
+    };
+    return Math.sqrt((-a * a * a) / mu) * (meanAnomaly(nu2) - meanAnomaly(nu1));
+};
+//# sourceMappingURL=hyperbolic-time-of-flight.js.map

package/dist/categories/orbits/hyperbolic-time-of-flight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperbolic-time-of-flight.js","sourceRoot":"","sources":["../../../src/categories/orbits/hyperbolic-time-of-flight.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,GAAY,EACZ,GAAY,EACZ,CAAS,EACT,CAAS,EACT,EAAU,EACF,EAAE;IACV,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI;QACtB,CAAC,KAAK,EAAE,GAAG,CAAC;QACZ,CAAC,KAAK,EAAE,GAAG,CAAC;QACZ,CAAC,GAAG,EAAE,CAAC,CAAC;QACR,CAAC,GAAG,EAAE,CAAC,CAAC;QACR,CAAC,IAAI,EAAE,EAAE,CAAC;KACF,EAAE,CAAC;QACX,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YACrB,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,uCAAuC,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,4BAA4B,CAAC,EAAE,CAAC,CAAC;IAElE,IAAI,CAAC,IAAI,CAAC;QACR,MAAM,IAAI,UAAU,CAAC,4CAA4C,CAAC,EAAE,CAAC,CAAC;IAExE,IAAI,EAAE,IAAI,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,6BAA6B,EAAE,EAAE,CAAC,CAAC;IAErE,MAAM,WAAW,GAAG,CAAC,EAAW,EAAE,EAAE;QAClC,MAAM,CAAC,GAAG,uBAAuB,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAEzC,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC,CAAC;IAEF,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;AAC9E,CAAC,CAAC"}

package/dist/categories/orbits/synodic-period.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Compute the **synodic period** of two bodies on circular orbits: the time between two alignments.
+ *
+ * $$
+ * T_\text{syn} = \frac{2\pi}{\lvert n_1 - n_2 \rvert}
+ * $$
+ *
+ * Where:
+ * - $ n_1 $, $ n_2 $ are the two mean motions (rad/s)
+ *
+ * **Units**
+ * - Inputs: `n1`, `n2` in **rad/s**.
+ * - Output: $ T_\text{syn} $ in **s**.
+ *
+ * ::: info Notes
+ *
+ * - The faster body gains $ 2\pi $ on the slower one every synodic period.
+ * - The closer the two orbits, the longer it takes: a chaser that's slightly lower gains only a little each orbit.
+ * - For planets, the same formula gives the time between launch windows, e.g. about 26 months for Earth and Mars.
+ *
+ * :::
+ *
+ * ::: practice Apollo 11, after lunar liftoff
+ *
+ * **41.8 h**
+ *
+ * _The LM in its 9.4 × 48.0 n mi orbit against the CSM in 56 × 62 n mi_
+ *
+ * The LM gained only about 16° on the CSM each orbit, so it had to lift off at the right moment: the whole rendezvous took 3 h 41 min.
+ *
+ * ```ts
+ * const nLM = meanMotion(1_790_552, 4.902800118e12);
+ * const nCSM = meanMotion(1_846_668, 4.902800118e12);
+ * synodicPeriod(nLM, nCSM) / 3600; // ≈ 41.8 h
+ * ```
+ *
+ * :::
+ *
+ * @param n1 - Mean motion of the first body in **rad/s** (finite, > 0).
+ * @param n2 - Mean motion of the second body in **rad/s** (finite, > 0, not equal to `n1`).
+ * @returns Synodic period in **s**.
+ * @throws {TypeError} If any input is not a finite number.
+ * @throws {RangeError} If `n1 <= 0`, `n2 <= 0`, or `n1 = n2` (the bodies never realign).
+ * @group Orbits
+ *
+ * @example
+ * ```ts
+ * // Earth and Mars, from their periods in days
+ * const day = 86_400;
+ * const t = synodicPeriod((2 * Math.PI) / (365.256 * day), (2 * Math.PI) / (686.98 * day));
+ * // t / day ≈ 780 days
+ * ```
+ *
+ * @see {@link phasingWaitTime}
+ * @see {@link meanMotion}
+ * @see https://en.wikipedia.org/wiki/Orbital_period#Synodic_period Synodic period
+ */
+export declare const synodicPeriod: (n1: number, n2: number) => number;
+//# sourceMappingURL=synodic-period.d.ts.map

package/dist/categories/orbits/synodic-period.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synodic-period.d.ts","sourceRoot":"","sources":["../../../src/categories/orbits/synodic-period.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,eAAO,MAAM,aAAa,GAAI,IAAI,MAAM,EAAE,IAAI,MAAM,KAAG,MAiBtD,CAAC"}

package/dist/categories/orbits/synodic-period.js

@@ -0,0 +1,72 @@
+/**
+ * Compute the **synodic period** of two bodies on circular orbits: the time between two alignments.
+ *
+ * $$
+ * T_\text{syn} = \frac{2\pi}{\lvert n_1 - n_2 \rvert}
+ * $$
+ *
+ * Where:
+ * - $ n_1 $, $ n_2 $ are the two mean motions (rad/s)
+ *
+ * **Units**
+ * - Inputs: `n1`, `n2` in **rad/s**.
+ * - Output: $ T_\text{syn} $ in **s**.
+ *
+ * ::: info Notes
+ *
+ * - The faster body gains $ 2\pi $ on the slower one every synodic period.
+ * - The closer the two orbits, the longer it takes: a chaser that's slightly lower gains only a little each orbit.
+ * - For planets, the same formula gives the time between launch windows, e.g. about 26 months for Earth and Mars.
+ *
+ * :::
+ *
+ * ::: practice Apollo 11, after lunar liftoff
+ *
+ * **41.8 h**
+ *
+ * _The LM in its 9.4 × 48.0 n mi orbit against the CSM in 56 × 62 n mi_
+ *
+ * The LM gained only about 16° on the CSM each orbit, so it had to lift off at the right moment: the whole rendezvous took 3 h 41 min.
+ *
+ * ```ts
+ * const nLM = meanMotion(1_790_552, 4.902800118e12);
+ * const nCSM = meanMotion(1_846_668, 4.902800118e12);
+ * synodicPeriod(nLM, nCSM) / 3600; // ≈ 41.8 h
+ * ```
+ *
+ * :::
+ *
+ * @param n1 - Mean motion of the first body in **rad/s** (finite, > 0).
+ * @param n2 - Mean motion of the second body in **rad/s** (finite, > 0, not equal to `n1`).
+ * @returns Synodic period in **s**.
+ * @throws {TypeError} If any input is not a finite number.
+ * @throws {RangeError} If `n1 <= 0`, `n2 <= 0`, or `n1 = n2` (the bodies never realign).
+ * @group Orbits
+ *
+ * @example
+ * ```ts
+ * // Earth and Mars, from their periods in days
+ * const day = 86_400;
+ * const t = synodicPeriod((2 * Math.PI) / (365.256 * day), (2 * Math.PI) / (686.98 * day));
+ * // t / day ≈ 780 days
+ * ```
+ *
+ * @see {@link phasingWaitTime}
+ * @see {@link meanMotion}
+ * @see https://en.wikipedia.org/wiki/Orbital_period#Synodic_period Synodic period
+ */
+export const synodicPeriod = (n1, n2) => {
+    for (const [name, x] of [
+        ['n1', n1],
+        ['n2', n2]
+    ]) {
+        if (!Number.isFinite(x))
+            throw new TypeError(`${name} must be a finite number. Received: ${x}`);
+        if (x <= 0)
+            throw new RangeError(`${name} must be > 0. Received: ${x}`);
+    }
+    if (n1 === n2)
+        throw new RangeError(`n1 and n2 must differ: equal mean motions never realign. Received: ${n1}`);
+    return (2 * Math.PI) / Math.abs(n1 - n2);
+};
+//# sourceMappingURL=synodic-period.js.map

package/dist/categories/orbits/synodic-period.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synodic-period.js","sourceRoot":"","sources":["../../../src/categories/orbits/synodic-period.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAU,EAAE,EAAU,EAAU,EAAE;IAC9D,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI;QACtB,CAAC,IAAI,EAAE,EAAE,CAAC;QACV,CAAC,IAAI,EAAE,EAAE,CAAC;KACF,EAAE,CAAC;QACX,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YACrB,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,uCAAuC,CAAC,EAAE,CAAC,CAAC;QAEzE,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,2BAA2B,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,EAAE,KAAK,EAAE;QACX,MAAM,IAAI,UAAU,CAClB,sEAAsE,EAAE,EAAE,CAC3E,CAAC;IAEJ,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;AAC3C,CAAC,CAAC"}

package/dist/index.d.ts

@@ -23,10 +23,14 @@ export * from './categories/helpers/rot-3.js';
 export * from './categories/helpers/transpose-3.js';
 export * from './categories/anomalies/advance-mean-anomaly.js';
 export * from './categories/anomalies/anomaly-at.js';
+export * from './categories/anomalies/asymptote-true-anomaly.js';
 export * from './categories/anomalies/eccentric-to-true-anomaly.js';
+export * from './categories/anomalies/hyperbolic-to-true-anomaly.js';
 export * from './categories/anomalies/true-to-mean-anomaly.js';
+export * from './categories/anomalies/true-to-hyperbolic-anomaly.js';
 export * from './categories/kepler/solve-kepler-bisection.js';
 export * from './categories/kepler/solve-kepler-high-eccentricity.js';
+export * from './categories/kepler/solve-kepler-hyperbolic.js';
 export * from './categories/kepler/solve-kepler-newton-raphson.js';
 export * from './categories/kepler/solve-kepler.js';
 export * from './categories/gravity/acceleration-on1-by2.js';
@@ -37,10 +41,15 @@ export * from './categories/orbits/atmospheric-drag-acceleration.js';
 export * from './categories/orbits/characteristic-energy-c3.js';
 export * from './categories/orbits/circular-speed.js';
 export * from './categories/orbits/cw-hill-derivatives.js';
+export * from './categories/orbits/cw-propagate.js';
+export * from './categories/orbits/cw-state-transition.js';
 export * from './categories/orbits/elements-to-state.js';
 export * from './categories/orbits/escape-speed.js';
 export * from './categories/orbits/flight-path-angle-from-true-anomaly.js';
+export * from './categories/orbits/hyperbolic-eccentricity.js';
 export * from './categories/orbits/hyperbolic-periapsis-speed.js';
+export * from './categories/orbits/hyperbolic-semi-major-axis.js';
+export * from './categories/orbits/hyperbolic-time-of-flight.js';
 export * from './categories/orbits/inclination-from-launch-azimuth.js';
 export * from './categories/orbits/j2-argument-of-perigee-rate.js';
 export * from './categories/orbits/j2-nodal-precession-rate.js';
@@ -55,15 +64,18 @@ export * from './categories/orbits/specific-mechanical-energy.js';
 export * from './categories/orbits/sphere-of-influence-radius.js';
 export * from './categories/orbits/state-to-elements.js';
 export * from './categories/orbits/surface-rotation-speed.js';
+export * from './categories/orbits/synodic-period.js';
 export * from './categories/orbits/vis-viva-speed.js';
 export * from './categories/manoeuvres/burn-time.js';
 export * from './categories/manoeuvres/combine-burns-delta-v.js';
+export * from './categories/manoeuvres/cw-two-impulse-transfer.js';
 export * from './categories/manoeuvres/gravity-assist-turning-angle.js';
 export * from './categories/manoeuvres/gravity-loss.js';
 export * from './categories/manoeuvres/hohmann-transfer.js';
 export * from './categories/manoeuvres/initial-mass-for-delta-v.js';
 export * from './categories/manoeuvres/mass-flow-rate.js';
 export * from './categories/manoeuvres/oberth-energy-gain.js';
+export * from './categories/manoeuvres/phasing-wait-time.js';
 export * from './categories/manoeuvres/plane-change-delta-v.js';
 export * from './categories/manoeuvres/rocket-delta-v-from-isp.js';
 export * from './categories/manoeuvres/rocket-delta-v-from-ve.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,qCAAqC,CAAC;AAEpD,cAAc,kCAAkC,CAAC;AAIjD,cAAc,8DAA8D,CAAC;AAE7E,cAAc,kEAAkE,CAAC;AAEjF,cAAc,wDAAwD,CAAC;AAEvE,cAAc,8DAA8D,CAAC;AAE7E,cAAc,qDAAqD,CAAC;AAEpE,cAAc,4DAA4D,CAAC;AAI3E,cAAc,wCAAwC,CAAC;AAEvD,cAAc,+CAA+C,CAAC;AAE9D,cAAc,+BAA+B,CAAC;AAE9C,cAAc,kCAAkC,CAAC;AAEjD,cAAc,8BAA8B,CAAC;AAE7C,cAAc,iDAAiD,CAAC;AAEhE,cAAc,iCAAiC,CAAC;AAEhD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,+BAA+B,CAAC;AAE9C,cAAc,qCAAqC,CAAC;AAIpD,cAAc,gDAAgD,CAAC;AAE/D,cAAc,sCAAsC,CAAC;AAErD,cAAc,qDAAqD,CAAC;AAEpE,cAAc,gDAAgD,CAAC;AAI/D,cAAc,+CAA+C,CAAC;AAE9D,cAAc,uDAAuD,CAAC;AAEtE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,qCAAqC,CAAC;AAIpD,cAAc,8CAA8C,CAAC;AAE7D,cAAc,uCAAuC,CAAC;AAEtD,cAAc,6CAA6C,CAAC;AAE5D,cAAc,iDAAiD,CAAC;AAIhE,cAAc,sDAAsD,CAAC;AAErE,cAAc,iDAAiD,CAAC;AAEhE,cAAc,uCAAuC,CAAC;AAEtD,cAAc,4CAA4C,CAAC;AAE3D,cAAc,0CAA0C,CAAC;AAEzD,cAAc,qCAAqC,CAAC;AAEpD,cAAc,4DAA4D,CAAC;AAE3E,cAAc,mDAAmD,CAAC;AAElE,cAAc,wDAAwD,CAAC;AAEvE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,iDAAiD,CAAC;AAEhE,cAAc,sCAAsC,CAAC;AAErD,cAAc,uDAAuD,CAAC;AAEtE,cAAc,oCAAoC,CAAC;AAEnD,cAAc,4CAA4C,CAAC;AAE3D,cAAc,gDAAgD,CAAC;AAE/D,cAAc,gEAAgE,CAAC;AAE/E,cAAc,kDAAkD,CAAC;AAEjE,cAAc,mDAAmD,CAAC;AAElE,cAAc,mDAAmD,CAAC;AAElE,cAAc,0CAA0C,CAAC;AAEzD,cAAc,+CAA+C,CAAC;AAE9D,cAAc,uCAAuC,CAAC;AAItD,cAAc,sCAAsC,CAAC;AAErD,cAAc,kDAAkD,CAAC;AAEjE,cAAc,yDAAyD,CAAC;AAExE,cAAc,yCAAyC,CAAC;AAExD,cAAc,6CAA6C,CAAC;AAE5D,cAAc,qDAAqD,CAAC;AAEpE,cAAc,2CAA2C,CAAC;AAE1D,cAAc,+CAA+C,CAAC;AAE9D,cAAc,iDAAiD,CAAC;AAEhE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,mDAAmD,CAAC;AAElE,cAAc,0CAA0C,CAAC;AAEzD,cAAc,6CAA6C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,qCAAqC,CAAC;AAEpD,cAAc,kCAAkC,CAAC;AAIjD,cAAc,8DAA8D,CAAC;AAE7E,cAAc,kEAAkE,CAAC;AAEjF,cAAc,wDAAwD,CAAC;AAEvE,cAAc,8DAA8D,CAAC;AAE7E,cAAc,qDAAqD,CAAC;AAEpE,cAAc,4DAA4D,CAAC;AAI3E,cAAc,wCAAwC,CAAC;AAEvD,cAAc,+CAA+C,CAAC;AAE9D,cAAc,+BAA+B,CAAC;AAE9C,cAAc,kCAAkC,CAAC;AAEjD,cAAc,8BAA8B,CAAC;AAE7C,cAAc,iDAAiD,CAAC;AAEhE,cAAc,iCAAiC,CAAC;AAEhD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,+BAA+B,CAAC;AAE9C,cAAc,qCAAqC,CAAC;AAIpD,cAAc,gDAAgD,CAAC;AAE/D,cAAc,sCAAsC,CAAC;AAErD,cAAc,kDAAkD,CAAC;AAEjE,cAAc,qDAAqD,CAAC;AAEpE,cAAc,sDAAsD,CAAC;AAErE,cAAc,gDAAgD,CAAC;AAE/D,cAAc,sDAAsD,CAAC;AAIrE,cAAc,+CAA+C,CAAC;AAE9D,cAAc,uDAAuD,CAAC;AAEtE,cAAc,gDAAgD,CAAC;AAE/D,cAAc,oDAAoD,CAAC;AAEnE,cAAc,qCAAqC,CAAC;AAIpD,cAAc,8CAA8C,CAAC;AAE7D,cAAc,uCAAuC,CAAC;AAEtD,cAAc,6CAA6C,CAAC;AAE5D,cAAc,iDAAiD,CAAC;AAIhE,cAAc,sDAAsD,CAAC;AAErE,cAAc,iDAAiD,CAAC;AAEhE,cAAc,uCAAuC,CAAC;AAEtD,cAAc,4CAA4C,CAAC;AAE3D,cAAc,qCAAqC,CAAC;AAEpD,cAAc,4CAA4C,CAAC;AAE3D,cAAc,0CAA0C,CAAC;AAEzD,cAAc,qCAAqC,CAAC;AAEpD,cAAc,4DAA4D,CAAC;AAE3E,cAAc,gDAAgD,CAAC;AAE/D,cAAc,mDAAmD,CAAC;AAElE,cAAc,mDAAmD,CAAC;AAElE,cAAc,kDAAkD,CAAC;AAEjE,cAAc,wDAAwD,CAAC;AAEvE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,iDAAiD,CAAC;AAEhE,cAAc,sCAAsC,CAAC;AAErD,cAAc,uDAAuD,CAAC;AAEtE,cAAc,oCAAoC,CAAC;AAEnD,cAAc,4CAA4C,CAAC;AAE3D,cAAc,gDAAgD,CAAC;AAE/D,cAAc,gEAAgE,CAAC;AAE/E,cAAc,kDAAkD,CAAC;AAEjE,cAAc,mDAAmD,CAAC;AAElE,cAAc,mDAAmD,CAAC;AAElE,cAAc,0CAA0C,CAAC;AAEzD,cAAc,+CAA+C,CAAC;AAE9D,cAAc,uCAAuC,CAAC;AAEtD,cAAc,uCAAuC,CAAC;AAItD,cAAc,sCAAsC,CAAC;AAErD,cAAc,kDAAkD,CAAC;AAEjE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,yDAAyD,CAAC;AAExE,cAAc,yCAAyC,CAAC;AAExD,cAAc,6CAA6C,CAAC;AAE5D,cAAc,qDAAqD,CAAC;AAEpE,cAAc,2CAA2C,CAAC;AAE1D,cAAc,+CAA+C,CAAC;AAE9D,cAAc,8CAA8C,CAAC;AAE7D,cAAc,iDAAiD,CAAC;AAEhE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,mDAAmD,CAAC;AAElE,cAAc,0CAA0C,CAAC;AAEzD,cAAc,6CAA6C,CAAC"}

package/dist/index.js

@@ -27,11 +27,15 @@ export * from './categories/helpers/transpose-3.js';
 // categories/anomalies
 export * from './categories/anomalies/advance-mean-anomaly.js';
 export * from './categories/anomalies/anomaly-at.js';
+export * from './categories/anomalies/asymptote-true-anomaly.js';
 export * from './categories/anomalies/eccentric-to-true-anomaly.js';
+export * from './categories/anomalies/hyperbolic-to-true-anomaly.js';
 export * from './categories/anomalies/true-to-mean-anomaly.js';
+export * from './categories/anomalies/true-to-hyperbolic-anomaly.js';
 // categories/kepler (solvers)
 export * from './categories/kepler/solve-kepler-bisection.js';
 export * from './categories/kepler/solve-kepler-high-eccentricity.js';
+export * from './categories/kepler/solve-kepler-hyperbolic.js';
 export * from './categories/kepler/solve-kepler-newton-raphson.js';
 export * from './categories/kepler/solve-kepler.js';
 // categories/gravity
@@ -44,10 +48,15 @@ export * from './categories/orbits/atmospheric-drag-acceleration.js';
 export * from './categories/orbits/characteristic-energy-c3.js';
 export * from './categories/orbits/circular-speed.js';
 export * from './categories/orbits/cw-hill-derivatives.js';
+export * from './categories/orbits/cw-propagate.js';
+export * from './categories/orbits/cw-state-transition.js';
 export * from './categories/orbits/elements-to-state.js';
 export * from './categories/orbits/escape-speed.js';
 export * from './categories/orbits/flight-path-angle-from-true-anomaly.js';
+export * from './categories/orbits/hyperbolic-eccentricity.js';
 export * from './categories/orbits/hyperbolic-periapsis-speed.js';
+export * from './categories/orbits/hyperbolic-semi-major-axis.js';
+export * from './categories/orbits/hyperbolic-time-of-flight.js';
 export * from './categories/orbits/inclination-from-launch-azimuth.js';
 export * from './categories/orbits/j2-argument-of-perigee-rate.js';
 export * from './categories/orbits/j2-nodal-precession-rate.js';
@@ -62,16 +71,19 @@ export * from './categories/orbits/specific-mechanical-energy.js';
 export * from './categories/orbits/sphere-of-influence-radius.js';
 export * from './categories/orbits/state-to-elements.js';
 export * from './categories/orbits/surface-rotation-speed.js';
+export * from './categories/orbits/synodic-period.js';
 export * from './categories/orbits/vis-viva-speed.js';
 // categories/manoeuvres
 export * from './categories/manoeuvres/burn-time.js';
 export * from './categories/manoeuvres/combine-burns-delta-v.js';
+export * from './categories/manoeuvres/cw-two-impulse-transfer.js';
 export * from './categories/manoeuvres/gravity-assist-turning-angle.js';
 export * from './categories/manoeuvres/gravity-loss.js';
 export * from './categories/manoeuvres/hohmann-transfer.js';
 export * from './categories/manoeuvres/initial-mass-for-delta-v.js';
 export * from './categories/manoeuvres/mass-flow-rate.js';
 export * from './categories/manoeuvres/oberth-energy-gain.js';
+export * from './categories/manoeuvres/phasing-wait-time.js';
 export * from './categories/manoeuvres/plane-change-delta-v.js';
 export * from './categories/manoeuvres/rocket-delta-v-from-isp.js';
 export * from './categories/manoeuvres/rocket-delta-v-from-ve.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mBAAmB;AACnB,cAAc,qCAAqC,CAAC;AAEpD,cAAc,kCAAkC,CAAC;AAEjD,yBAAyB;AAEzB,cAAc,8DAA8D,CAAC;AAE7E,cAAc,kEAAkE,CAAC;AAEjF,cAAc,wDAAwD,CAAC;AAEvE,cAAc,8DAA8D,CAAC;AAE7E,cAAc,qDAAqD,CAAC;AAEpE,cAAc,4DAA4D,CAAC;AAE3E,qBAAqB;AAErB,cAAc,wCAAwC,CAAC;AAEvD,cAAc,+CAA+C,CAAC;AAE9D,cAAc,+BAA+B,CAAC;AAE9C,cAAc,kCAAkC,CAAC;AAEjD,cAAc,8BAA8B,CAAC;AAE7C,cAAc,iDAAiD,CAAC;AAEhE,cAAc,iCAAiC,CAAC;AAEhD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,+BAA+B,CAAC;AAE9C,cAAc,qCAAqC,CAAC;AAEpD,uBAAuB;AAEvB,cAAc,gDAAgD,CAAC;AAE/D,cAAc,sCAAsC,CAAC;AAErD,cAAc,qDAAqD,CAAC;AAEpE,cAAc,gDAAgD,CAAC;AAE/D,8BAA8B;AAE9B,cAAc,+CAA+C,CAAC;AAE9D,cAAc,uDAAuD,CAAC;AAEtE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,qCAAqC,CAAC;AAEpD,qBAAqB;AAErB,cAAc,8CAA8C,CAAC;AAE7D,cAAc,uCAAuC,CAAC;AAEtD,cAAc,6CAA6C,CAAC;AAE5D,cAAc,iDAAiD,CAAC;AAEhE,oBAAoB;AAEpB,cAAc,sDAAsD,CAAC;AAErE,cAAc,iDAAiD,CAAC;AAEhE,cAAc,uCAAuC,CAAC;AAEtD,cAAc,4CAA4C,CAAC;AAE3D,cAAc,0CAA0C,CAAC;AAEzD,cAAc,qCAAqC,CAAC;AAEpD,cAAc,4DAA4D,CAAC;AAE3E,cAAc,mDAAmD,CAAC;AAElE,cAAc,wDAAwD,CAAC;AAEvE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,iDAAiD,CAAC;AAEhE,cAAc,sCAAsC,CAAC;AAErD,cAAc,uDAAuD,CAAC;AAEtE,cAAc,oCAAoC,CAAC;AAEnD,cAAc,4CAA4C,CAAC;AAE3D,cAAc,gDAAgD,CAAC;AAE/D,cAAc,gEAAgE,CAAC;AAE/E,cAAc,kDAAkD,CAAC;AAEjE,cAAc,mDAAmD,CAAC;AAElE,cAAc,mDAAmD,CAAC;AAElE,cAAc,0CAA0C,CAAC;AAEzD,cAAc,+CAA+C,CAAC;AAE9D,cAAc,uCAAuC,CAAC;AAEtD,wBAAwB;AAExB,cAAc,sCAAsC,CAAC;AAErD,cAAc,kDAAkD,CAAC;AAEjE,cAAc,yDAAyD,CAAC;AAExE,cAAc,yCAAyC,CAAC;AAExD,cAAc,6CAA6C,CAAC;AAE5D,cAAc,qDAAqD,CAAC;AAEpE,cAAc,2CAA2C,CAAC;AAE1D,cAAc,+CAA+C,CAAC;AAE9D,cAAc,iDAAiD,CAAC;AAEhE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,mDAAmD,CAAC;AAElE,cAAc,0CAA0C,CAAC;AAEzD,cAAc,6CAA6C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mBAAmB;AACnB,cAAc,qCAAqC,CAAC;AAEpD,cAAc,kCAAkC,CAAC;AAEjD,yBAAyB;AAEzB,cAAc,8DAA8D,CAAC;AAE7E,cAAc,kEAAkE,CAAC;AAEjF,cAAc,wDAAwD,CAAC;AAEvE,cAAc,8DAA8D,CAAC;AAE7E,cAAc,qDAAqD,CAAC;AAEpE,cAAc,4DAA4D,CAAC;AAE3E,qBAAqB;AAErB,cAAc,wCAAwC,CAAC;AAEvD,cAAc,+CAA+C,CAAC;AAE9D,cAAc,+BAA+B,CAAC;AAE9C,cAAc,kCAAkC,CAAC;AAEjD,cAAc,8BAA8B,CAAC;AAE7C,cAAc,iDAAiD,CAAC;AAEhE,cAAc,iCAAiC,CAAC;AAEhD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,+BAA+B,CAAC;AAE9C,cAAc,qCAAqC,CAAC;AAEpD,uBAAuB;AAEvB,cAAc,gDAAgD,CAAC;AAE/D,cAAc,sCAAsC,CAAC;AAErD,cAAc,kDAAkD,CAAC;AAEjE,cAAc,qDAAqD,CAAC;AAEpE,cAAc,sDAAsD,CAAC;AAErE,cAAc,gDAAgD,CAAC;AAE/D,cAAc,sDAAsD,CAAC;AAErE,8BAA8B;AAE9B,cAAc,+CAA+C,CAAC;AAE9D,cAAc,uDAAuD,CAAC;AAEtE,cAAc,gDAAgD,CAAC;AAE/D,cAAc,oDAAoD,CAAC;AAEnE,cAAc,qCAAqC,CAAC;AAEpD,qBAAqB;AAErB,cAAc,8CAA8C,CAAC;AAE7D,cAAc,uCAAuC,CAAC;AAEtD,cAAc,6CAA6C,CAAC;AAE5D,cAAc,iDAAiD,CAAC;AAEhE,oBAAoB;AAEpB,cAAc,sDAAsD,CAAC;AAErE,cAAc,iDAAiD,CAAC;AAEhE,cAAc,uCAAuC,CAAC;AAEtD,cAAc,4CAA4C,CAAC;AAE3D,cAAc,qCAAqC,CAAC;AAEpD,cAAc,4CAA4C,CAAC;AAE3D,cAAc,0CAA0C,CAAC;AAEzD,cAAc,qCAAqC,CAAC;AAEpD,cAAc,4DAA4D,CAAC;AAE3E,cAAc,gDAAgD,CAAC;AAE/D,cAAc,mDAAmD,CAAC;AAElE,cAAc,mDAAmD,CAAC;AAElE,cAAc,kDAAkD,CAAC;AAEjE,cAAc,wDAAwD,CAAC;AAEvE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,iDAAiD,CAAC;AAEhE,cAAc,sCAAsC,CAAC;AAErD,cAAc,uDAAuD,CAAC;AAEtE,cAAc,oCAAoC,CAAC;AAEnD,cAAc,4CAA4C,CAAC;AAE3D,cAAc,gDAAgD,CAAC;AAE/D,cAAc,gEAAgE,CAAC;AAE/E,cAAc,kDAAkD,CAAC;AAEjE,cAAc,mDAAmD,CAAC;AAElE,cAAc,mDAAmD,CAAC;AAElE,cAAc,0CAA0C,CAAC;AAEzD,cAAc,+CAA+C,CAAC;AAE9D,cAAc,uCAAuC,CAAC;AAEtD,cAAc,uCAAuC,CAAC;AAEtD,wBAAwB;AAExB,cAAc,sCAAsC,CAAC;AAErD,cAAc,kDAAkD,CAAC;AAEjE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,yDAAyD,CAAC;AAExE,cAAc,yCAAyC,CAAC;AAExD,cAAc,6CAA6C,CAAC;AAE5D,cAAc,qDAAqD,CAAC;AAEpE,cAAc,2CAA2C,CAAC;AAE1D,cAAc,+CAA+C,CAAC;AAE9D,cAAc,8CAA8C,CAAC;AAE7D,cAAc,iDAAiD,CAAC;AAEhE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,mDAAmD,CAAC;AAElE,cAAc,0CAA0C,CAAC;AAEzD,cAAc,6CAA6C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@interstellar-tools/equations",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Curated, well-tested orbital mechanics and dynamics formulas (e.g., Newtonian gravity, vis-viva, Kepler's 3rd law, escape/circular speeds, specific energy, specific angular momentum, peri/apoapsis radii).",
   "keywords": [
     "interstellar",