@neilberkman/sidereon 0.17.0 → 0.19.0

package/pkg-node/sidereon.d.ts

@@ -1371,6 +1371,20 @@ export class DgnssSolution {
     readonly usedSats: string[];
 }
 
+/**
+ * Early-late DLL processing mode for thermal-noise jitter.
+ */
+export enum DllProcessing {
+    /**
+     * Coherent early-minus-late processing.
+     */
+    Coherent = 0,
+    /**
+     * Non-coherent early-minus-late power processing with squaring loss.
+     */
+    NonCoherent = 1,
+}
+
 /**
  * GNSS dilution-of-precision scalars.
  */
@@ -2307,6 +2321,78 @@ export class GlonassRecordJs {
     readonly velocityMS: Float64Array;
 }
 
+/**
+ * Stateful GNSS/INS filter resource.
+ */
+export class GnssInsFilter {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Replace retained-history capacities for later time-sync replay.
+     */
+    configureTimeSync(config: any): void;
+    /**
+     * Encode the current fusion state with the core versioned binary codec.
+     */
+    encodeState(): Uint8Array;
+    /**
+     * Build a filter, then restore its state from versioned fusion-state bytes.
+     */
+    static fromStateBytes(config: any, bytes: Uint8Array): GnssInsFilter;
+    /**
+     * Build a filter from a JS configuration object.
+     */
+    constructor(config: any);
+    /**
+     * Propagate the filter with one IMU rate or increment sample.
+     */
+    propagate(sample: any): any;
+    /**
+     * Propagate the filter with a JS array of IMU samples.
+     */
+    propagateBatch(samples: any): any;
+    /**
+     * Restore this filter from versioned fusion-state bytes.
+     */
+    restoreState(bytes: Uint8Array): void;
+    /**
+     * Current INS state, covariance, and last body-rate diagnostic.
+     */
+    state(): any;
+    /**
+     * Current tight-coupling receiver-clock state.
+     */
+    tightClockState(): any;
+    /**
+     * Current retained-history capacity and occupancy.
+     */
+    timeSyncStatus(): any;
+    /**
+     * Apply a loose position or position-velocity GNSS fix at the current epoch.
+     */
+    updateLoose(measurement: any): any;
+    /**
+     * Apply a loose GNSS fix, replaying retained IMU checkpoints when it is late.
+     */
+    updateLooseTimeSync(measurement: any): any;
+    /**
+     * Apply a tight raw-observation epoch against a broadcast ephemeris source.
+     */
+    updateTightBroadcast(broadcast: BroadcastEphemeris, epoch: any): any;
+    /**
+     * Apply a tight broadcast update, replaying retained IMU checkpoints when it is late.
+     */
+    updateTightBroadcastTimeSync(broadcast: BroadcastEphemeris, epoch: any): any;
+    /**
+     * Apply a tight raw-observation epoch against an SP3 source.
+     */
+    updateTightSp3(sp3: Sp3, epoch: any): any;
+    /**
+     * Apply a tight SP3 update, replaying retained IMU checkpoints when it is late.
+     */
+    updateTightSp3TimeSync(sp3: Sp3, epoch: any): any;
+}
+
 /**
  * One sampled rise/set/peak visibility pass, from `gnssPasses`.
  */
@@ -5809,6 +5895,87 @@ export class SbasSisError {
     readonly sigmaUireM: number;
 }
 
+/**
+ * Stable GNSS signal modulation used by the analysis functions.
+ */
+export class SignalAnalysisModulation {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Normalized in-band autocorrelation at a delay.
+     */
+    autocorrelation(delay_s: number, receiver_bandwidth_hz: number): number;
+    /**
+     * Build a BPSK(n) modulation, where the code rate is `n * 1.023 MHz`.
+     */
+    static bpsk(order: number): SignalAnalysisModulation;
+    /**
+     * Build Galileo E1 CBOC(6,1,1/11) with the minus chip-pulse convention.
+     */
+    static cboc611Over11Minus(): SignalAnalysisModulation;
+    /**
+     * Build Galileo E1 CBOC(6,1,1/11) with the plus chip-pulse convention.
+     */
+    static cboc611Over11Plus(): SignalAnalysisModulation;
+    /**
+     * Build a cosine-phased BOC(m,n) modulation.
+     */
+    static cosineBoc(m: number, n: number): SignalAnalysisModulation;
+    /**
+     * Published lower bound for DLL code-delay jitter.
+     */
+    dllLowerBound(options: any): any;
+    /**
+     * Early-late DLL thermal-noise jitter for this modulation.
+     */
+    dllThermalNoiseJitter(options: any, processing: DllProcessing): any;
+    /**
+     * Fraction of total signal power inside a two-sided receiver bandwidth.
+     */
+    fractionPowerInBand(receiver_bandwidth_hz: number): number;
+    /**
+     * Build the normalized MBOC(6,1,1/11) spectrum.
+     */
+    static mboc611Over11(): SignalAnalysisModulation;
+    /**
+     * One-path early-late multipath error envelope on a delay grid.
+     */
+    multipathErrorEnvelope(options: any, delay_chips: Float64Array): any;
+    /**
+     * Signal power inside a two-sided receiver bandwidth.
+     */
+    powerInBand(receiver_bandwidth_hz: number): number;
+    /**
+     * Normalized power spectral density at an offset frequency, in `1/Hz`.
+     */
+    psdHz(offset_hz: number): number;
+    /**
+     * RMS, or Gabor, bandwidth over a two-sided receiver bandwidth.
+     */
+    rmsBandwidthHz(receiver_bandwidth_hz: number): number;
+    /**
+     * Build a sine-phased BOC(m,n) modulation.
+     */
+    static sineBoc(m: number, n: number): SignalAnalysisModulation;
+    /**
+     * Build the GPS L1C pilot TMBOC(6,1,4/33) spectrum.
+     */
+    static tmboc614Over33(): SignalAnalysisModulation;
+    /**
+     * SSC against white interference normalized over the receiver bandwidth.
+     */
+    whiteNoiseSpectralSeparationHz(receiver_bandwidth_hz: number): number;
+    /**
+     * Code rate in hertz when the modulation has one unambiguous rate.
+     */
+    readonly codeRateHz: number;
+    /**
+     * Stable core label for this modulation.
+     */
+    readonly label: string;
+}
+
 /**
  * Per-constellation single-frequency pseudorange code-selection policy. Build
  * with `new SignalPolicy()` then chain `.withSystem(system, codes)`, or use
@@ -5903,6 +6070,14 @@ export class SmoothCodeResult {
     readonly window: number;
 }
 
+export class SmoothedTrack {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly epochCount: number;
+    readonly epochs: any;
+}
+
 /**
  * A receiver solution paired with the provenance of the ephemeris that produced
  * it. Returned by [`solveWithFallback`].
@@ -7406,6 +7581,71 @@ export class TlePropagation {
     readonly velocityKmS: Float64Array;
 }
 
+export class TrackFilter {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Build a filter from a position fix and uncertain zero initial velocity.
+     */
+    static fromPosition(config: any): TrackFilter;
+    /**
+     * Build a stateful no-IMU track filter from a `TrackFilterConfig`.
+     */
+    constructor(config: TrackFilterConfig);
+    positionInnovation(request: any): any;
+    predict(dt_s: number): any;
+    predictRecorded(dt_s: number, history: TrackRtsHistoryBuilder): any;
+    recordPredictionOnly(history: TrackRtsHistoryBuilder): void;
+    stateInnovation(request: any): any;
+    updatePosition(request: any): any;
+    updatePositionGated(request: any): any;
+    updatePositionGatedRecorded(request: any, history: TrackRtsHistoryBuilder): any;
+    updatePositionRecorded(request: any, history: TrackRtsHistoryBuilder): any;
+    updateState(request: any): any;
+    readonly accelerationVarianceSpectralDensityM2S3: number;
+    readonly dimension: number;
+    readonly state: any;
+}
+
+export class TrackFilterConfig {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Build a config from a position fix and uncertain zero initial velocity.
+     */
+    static fromPosition(config: any): TrackFilterConfig;
+    /**
+     * Build a no-IMU track filter config from a JS object.
+     */
+    constructor(config: any);
+    toObject(): any;
+    readonly dimension: number;
+    readonly frame: string;
+    readonly initialTS: number;
+}
+
+export class TrackRtsHistory {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    readonly epochCount: number;
+    readonly epochs: any;
+}
+
+export class TrackRtsHistoryBuilder {
+    free(): void;
+    [Symbol.dispose](): void;
+    finish(): TrackRtsHistory;
+    /**
+     * Start a history from the filter's current state.
+     */
+    static fromFilter(filter: TrackFilter): TrackRtsHistoryBuilder;
+    /**
+     * Start an empty history for manual recording.
+     */
+    constructor();
+}
+
 /**
  * Provenance and coverage of the embedded UT1-UTC / delta-T (EOP) table.
  */
@@ -7978,6 +8218,11 @@ export function decodeSsr(bytes: Uint8Array, framed?: boolean | null): any;
  */
 export function defaultPair(system: GnssSystem): CarrierPair | undefined;
 
+/**
+ * Default scenario seed as a hexadecimal string.
+ */
+export function defaultScenarioSeedHex(): string;
+
 /**
  * Single-frequency carrier used by the SPP ionosphere-scaling policy.
  */
@@ -8092,6 +8337,11 @@ export function ecefToGeodetic(position_km: Float64Array): Float64Array;
  */
 export function eclipseStatus(satellite_position_km: Float64Array, sun_position_km: Float64Array): string[];
 
+/**
+ * Effective C/N0 degradation for one finite-band interference term.
+ */
+export function effectiveCn0Degradation(desired: SignalAnalysisModulation, interference: SignalAnalysisModulation, cn0_db_hz: number, receiver_bandwidth_hz: number, power_ratio_to_carrier: number): any;
+
 /**
  * Ellipsoidal height `h = H + N` (metres above the WGS84 ellipsoid) from an
  * orthometric height and a geodetic position in radians, using the embedded
@@ -8498,6 +8748,11 @@ export function fromCelestrakJsonLenient(json: string, system?: string | null):
  */
 export function fspl(distance_km: number, frequency_mhz: number): number;
 
+/**
+ * Decode and re-encode fusion-state bytes through the core codec.
+ */
+export function fusionStateBytesRoundTrip(bytes: Uint8Array): Uint8Array;
+
 /**
  * Galileo NeQuick-G single-frequency ionospheric group delay (positive metres).
  *
@@ -9902,6 +10157,16 @@ export function sbasPrnToSat(broadcast_prn: number): any;
  */
 export function sbasProtectionLevels(geometry: any, model: SbasErrorModel, k: SbasKMultipliers): SbasProtection;
 
+/**
+ * Core scenario engine version string used in deterministic outputs.
+ */
+export function scenarioEngineVersion(): string;
+
+/**
+ * Core scenario schema version accepted by the binding.
+ */
+export function scenarioSchemaVersion(): number;
+
 /**
  * Screen a primary satellite against a secondary TLE catalog for threshold TCAs.
  *
@@ -9998,6 +10263,26 @@ export function siderealFilter(series: any, period_s: number, options: any): any
  */
 export function sigmas(entries: any, options: any): SatelliteVector;
 
+/**
+ * Simulate a scenario from a JS object or JSON string and return JS arrays.
+ */
+export function simulateScenario(value: any): any;
+
+/**
+ * Simulate a scenario from a JS object or JSON string and return deterministic JSON bytes.
+ */
+export function simulateScenarioBytes(value: any): Uint8Array;
+
+/**
+ * Simulate a scenario from JSON text and return JS arrays.
+ */
+export function simulateScenarioJson(text: string): any;
+
+/**
+ * Simulate a scenario from JSON text and return deterministic JSON bytes.
+ */
+export function simulateScenarioJsonBytes(text: string): Uint8Array;
+
 /**
  * Sample skewness of a residual set.
  *
@@ -10023,6 +10308,8 @@ export function smoothCode(arc: any, options: any, hatch_window_cap?: number | n
  */
 export function smoothIonoFreeCode(arc: any, options: any, hatch_window_cap?: number | null): IonoFreeSmoothResult[];
 
+export function smoothTrackRts(history: TrackRtsHistory): SmoothedTrack;
+
 /**
  * Post-correlation predetection SNR in decibels.
  */
@@ -10227,6 +10514,16 @@ export function sourceSolveModeToa(): string;
  */
 export function sp3PreciseEphemerisSamples(sp3: Sp3): any;
 
+/**
+ * Spectral separation coefficient between two modulations, in dB-Hz.
+ */
+export function spectralSeparationCoefficientDbHz(desired: SignalAnalysisModulation, interference: SignalAnalysisModulation, receiver_bandwidth_hz: number): number;
+
+/**
+ * Spectral separation coefficient between two modulations, in hertz.
+ */
+export function spectralSeparationCoefficientHz(desired: SignalAnalysisModulation, interference: SignalAnalysisModulation, receiver_bandwidth_hz: number): number;
+
 /**
  * Continuous seconds since J2000 for a split Julian date.
  */