@neilberkman/sidereon 0.19.0 → 0.20.0

package/pkg-node/sidereon.d.ts

@@ -2042,6 +2042,43 @@ export class FrameStates {
     readonly velocityKmS: Float64Array;
 }
 
+/**
+ * Recorded fusion forward-pass history accepted by `smoothFusionRts`.
+ */
+export class FusionRtsHistory {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Number of recorded epochs.
+     */
+    readonly epochCount: number;
+    /**
+     * Recorded epochs in forward time order.
+     */
+    readonly epochs: any;
+}
+
+/**
+ * Builder for recording a fusion forward pass before RTS smoothing.
+ */
+export class FusionRtsHistoryBuilder {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Return a validated recorded history.
+     */
+    finish(): FusionRtsHistory;
+    /**
+     * Start a history from the filter's current checkpoint.
+     */
+    static fromFilter(filter: GnssInsFilter): FusionRtsHistoryBuilder;
+    /**
+     * Start an empty history for manual recording.
+     */
+    constructor();
+}
+
 /**
  * WGS84 geodesic input failure class exposed as a stable enum symbol.
  */
@@ -2351,6 +2388,10 @@ export class GnssInsFilter {
      * Propagate the filter with a JS array of IMU samples.
      */
     propagateBatch(samples: any): any;
+    /**
+     * Propagate and record the transition for later fusion RTS smoothing.
+     */
+    propagateRecorded(sample: any, history: FusionRtsHistoryBuilder): any;
     /**
      * Restore this filter from versioned fusion-state bytes.
      */
@@ -2371,6 +2412,10 @@ export class GnssInsFilter {
      * Apply a loose position or position-velocity GNSS fix at the current epoch.
      */
     updateLoose(measurement: any): any;
+    /**
+     * Apply a loose GNSS fix and record checkpoints for fusion RTS smoothing.
+     */
+    updateLooseRecorded(measurement: any, history: FusionRtsHistoryBuilder): any;
     /**
      * Apply a loose GNSS fix, replaying retained IMU checkpoints when it is late.
      */
@@ -2379,6 +2424,10 @@ export class GnssInsFilter {
      * Apply a tight raw-observation epoch against a broadcast ephemeris source.
      */
     updateTightBroadcast(broadcast: BroadcastEphemeris, epoch: any): any;
+    /**
+     * Apply a tight broadcast update and record checkpoints for fusion RTS smoothing.
+     */
+    updateTightBroadcastRecorded(broadcast: BroadcastEphemeris, epoch: any, history: FusionRtsHistoryBuilder): any;
     /**
      * Apply a tight broadcast update, replaying retained IMU checkpoints when it is late.
      */
@@ -2387,6 +2436,10 @@ export class GnssInsFilter {
      * Apply a tight raw-observation epoch against an SP3 source.
      */
     updateTightSp3(sp3: Sp3, epoch: any): any;
+    /**
+     * Apply a tight SP3 update and record checkpoints for fusion RTS smoothing.
+     */
+    updateTightSp3Recorded(sp3: Sp3, epoch: any, history: FusionRtsHistoryBuilder): any;
     /**
      * Apply a tight SP3 update, replaying retained IMU checkpoints when it is late.
      */
@@ -6070,6 +6123,23 @@ export class SmoothCodeResult {
     readonly window: number;
 }
 
+/**
+ * Smoothed fusion trajectory returned by fixed-interval RTS smoothing.
+ */
+export class SmoothedFusionTrajectory {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Number of smoothed epochs.
+     */
+    readonly epochCount: number;
+    /**
+     * Smoothed epochs in the same order as the recorded history.
+     */
+    readonly epochs: any;
+}
+
 export class SmoothedTrack {
     private constructor();
     free(): void;
@@ -7985,6 +8055,24 @@ export function betaAngleFromState(r: Float64Array, v: Float64Array, sun: Float6
  */
 export function boundedIlsSearch(float_cycles: Float64Array, covariance: any, radius: number, candidate_limit: number, ratio_threshold: number): any;
 
+/**
+ * Build dual-frequency RTK arc records from parsed RINEX OBS products.
+ *
+ * Defaults build the GPS `C1C`/`L1C` plus `C2W`/`L2W` arc used by the real
+ * WTZR/WTZZ fixtures.
+ */
+export function buildDualFrequencyRinexRtkArc(ephemeris: Sp3, base_obs: RinexObs, rover_obs: RinexObs, options?: any | null): any;
+
+/**
+ * Build single-frequency RTK arc records from parsed RINEX OBS products.
+ *
+ * `ephemeris` is an SP3 precise ephemeris handle, `baseObs` and `roverObs`
+ * are parsed RINEX observation files, and `options` may provide
+ * `{ signalPairs, maxEpochs, minCommonSatellites, includePredictionTime }`.
+ * Defaults build the GPS `C1C`/`L1C` arc used by the real WTZR/WTZZ fixtures.
+ */
+export function buildRinexRtkArc(ephemeris: Sp3, base_obs: RinexObs, rover_obs: RinexObs, options?: any | null): any;
+
 /**
  * One wrapping GPS C/A chip at a zero-based index.
  */
@@ -8460,6 +8548,11 @@ export function eq2rv(eq: any, mu_km3_s2: number): any;
  */
 export function errorEllipse2(covariance: Float64Array, confidence: number): ErrorEllipse2;
 
+/**
+ * Horizontal one-sigma ellipse from an ENU covariance in square metres.
+ */
+export function errorEllipseFromEnuM2(covariance_enu_m2: any): ErrorEllipse;
+
 export function estimateDecay(drag: DragForce, request: any): any;
 
 /**
@@ -8992,6 +9085,11 @@ export function hadamardDeviation(series: any, tau0_s: number, averaging_factors
  */
 export function hessianTrace(jacobian: Float64Array, m: number, n: number): number;
 
+/**
+ * Horizontal percentile circle radius from an ENU covariance.
+ */
+export function horizontalRadiusAt(covariance_enu_m2: any, probability: number): PercentileRadius;
+
 /**
  * Gauss angles-only orbit determination.
  *
@@ -9409,6 +9507,14 @@ export function metricsFromEnuCovarianceM2(covariance_enu_m2: any): PositionErro
  */
 export function metricsFromKinematicSolution(solution: any): PositionErrorMetrics;
 
+/**
+ * Compute position-error metrics from a position covariance object.
+ *
+ * The object must include `ecefM2` and `enuM2`, each a 3 by 3 covariance in
+ * square metres.
+ */
+export function metricsFromPositionCovariance(covariance: any): PositionErrorMetrics;
+
 /**
  * Modified Allan deviation for explicit averaging factors.
  *
@@ -10303,6 +10409,11 @@ export function slipReasonLabel(reason: SlipReason): string;
  */
 export function smoothCode(arc: any, options: any, hatch_window_cap?: number | null): SmoothCodeResult[];
 
+/**
+ * Apply fixed-interval RTS smoothing to recorded fusion history.
+ */
+export function smoothFusionRts(history: FusionRtsHistory): SmoothedFusionTrajectory;
+
 /**
  * Dual-frequency ionosphere-free Hatch carrier-smoothed code.
  */
@@ -10436,6 +10547,16 @@ export function solveSppSbas(broadcast: BroadcastEphemeris, store: SbasCorrectio
  */
 export function solveStatic(sp3: Sp3, epochs: any, options: any): StaticSolution;
 
+/**
+ * Solve one static RTK baseline directly from paired RINEX OBS plus SP3.
+ *
+ * `config.baseM` is the base antenna phase-center ECEF position in metres.
+ * Optional `config.arcOptions` controls RINEX signal extraction; other fields
+ * mirror `RtkStaticArcConfig` but the wavelength and offset maps are filled by
+ * the RINEX builder.
+ */
+export function solveStaticRinexRtkBaseline(ephemeris: Sp3, base_obs: RinexObs, rover_obs: RinexObs, config: any): any;
+
 /**
  * Solve a static RTK arc with one batch float solution and one validated fixed
  * solution over the whole arc.
@@ -10460,6 +10581,15 @@ export function solveVelocity(sp3: Sp3, observations: any, receiver_ecef_m: Floa
  */
 export function solveVelocityBroadcast(broadcast: BroadcastEphemeris, observations: any, receiver_ecef_m: Float64Array, t_rx_j2000_s: number, options: any): VelocitySolution;
 
+/**
+ * Solve a static dual-frequency wide-lane fixed RTK baseline from RINEX OBS.
+ *
+ * The function builds the dual-frequency RINEX arc, fixes wide-lane
+ * ambiguities, prepares ionosphere-free narrow-lane records, then runs the
+ * static fixed baseline solver.
+ */
+export function solveWideLaneFixedRinexRtkBaseline(ephemeris: Sp3, base_obs: RinexObs, rover_obs: RinexObs, config: any): any;
+
 /**
  * Solve a receiver position, preferring precise SP3 products and falling back to
  * broadcast ephemeris, reporting which source was used and how stale it is.
@@ -10524,6 +10654,11 @@ export function spectralSeparationCoefficientDbHz(desired: SignalAnalysisModulat
  */
 export function spectralSeparationCoefficientHz(desired: SignalAnalysisModulation, interference: SignalAnalysisModulation, receiver_bandwidth_hz: number): number;
 
+/**
+ * Three-dimensional percentile sphere radius from an ENU covariance.
+ */
+export function sphericalRadiusAt(covariance_enu_m2: any, probability: number): PercentileRadius;
+
 /**
  * Continuous seconds since J2000 for a split Julian date.
  */
@@ -10748,6 +10883,11 @@ export function validateAgainstSp3Ids(records: any, ids: any): any;
  */
 export function velocityMidas(series: any, options: any): any;
 
+/**
+ * Vertical one-dimensional percentile radius from an up variance.
+ */
+export function verticalRadiusAt(sigma_u_m2: number, probability: number): number;
+
 /**
  * Satellites visible above `minElevationDeg` from `station` at a single instant,
  * from already-initialized [`Tle`]s: the opsmode-preserving constellation