gnss-js 1.11.0 → 1.12.0

package/dist/rinex.d.ts

@@ -135,4 +135,132 @@ interface IonexGrid {
 }
 declare function parseIonex(text: string): IonexGrid;
 
-export { type CrxField, type DiffState, EMPTY_WARNINGS, type IonexGrid, NavResult, RinexHeader, type RinexWarning, type RinexWarnings, WarningAccumulator, type WarningSeverity, crxDecompress, crxRepair, fmtF, hdrLine, padL, padR, parseCrxDataLine, parseIonex, writeRinexNav };
+/**
+ * SP3-c/-d precise orbit and clock parser, with Lagrange interpolation
+ * for evaluating positions between the tabulated epochs.
+ *
+ * Positions are converted to meters (SP3 tabulates km), clocks to
+ * seconds (SP3 tabulates microseconds). Missing positions (all-zero
+ * coordinates) and the 999999.999999 bad-clock sentinel become null.
+ * Epoch tags are read in the file's own time scale (GPS for IGS/MGEX
+ * products) as epoch milliseconds, matching the convention of the
+ * RINEX parsers in this library.
+ */
+interface Sp3Sample {
+    /** ECEF meters. */
+    x: number;
+    y: number;
+    z: number;
+    /** Satellite clock offset in seconds, or null when flagged bad. */
+    clk: number | null;
+}
+interface Sp3File {
+    version: string;
+    /** Epoch timestamps (ms). */
+    epochs: number[];
+    /** Tabulated interval in seconds (from the ## header line). */
+    intervalSec: number;
+    /** Time system from the %c line, e.g. 'GPS'. */
+    timeSystem: string;
+    /** prn → per-epoch samples (null where the satellite is missing). */
+    satellites: Record<string, (Sp3Sample | null)[]>;
+}
+declare function parseSp3(text: string): Sp3File;
+/**
+ * Satellite position at an arbitrary time by Lagrange interpolation
+ * over the `order` nearest tabulated samples (default 9, the standard
+ * choice for 5–15 min SP3 tables; centimetre-level between nodes).
+ * Clock is interpolated linearly between the bracketing samples.
+ *
+ * Returns null outside the covered span, near data gaps, or when the
+ * satellite is absent.
+ */
+declare function sp3Position(sp3: Sp3File, prn: string, tMs: number, order?: number): {
+    x: number;
+    y: number;
+    z: number;
+    clk: number | null;
+} | null;
+
+/**
+ * RINEX 3.04 / 4.01 observation file writer.
+ *
+ * The two formats share the same header layout and epoch record
+ * encoding — only the version line and the provenance comment differ
+ * (see obs-writer.test.ts, which pins this). RINEX 2.11 lives in
+ * obs-writer-v2.ts (different header records and epoch layout).
+ *
+ * Streams text through gzip compression so we never hold the full
+ * uncompressed output in memory. Returns a gzip-compressed Blob.
+ */
+
+/**
+ * Compact epoch — stores observation values in Float64Arrays
+ * indexed by a per-system obs code registry (NaN = missing).
+ * ~10-15x less memory than Map-of-Maps.
+ */
+interface CompactEpoch {
+    time: number;
+    sats: Map<string, Float64Array>;
+}
+/**
+ * Write RINEX 3.04 obs file from compact observations.
+ *
+ * The `obsTypes` map defines both the RINEX header declaration order and
+ * the Float64Array index order for each system.
+ */
+declare function writeRinexObsBlob(header: RinexHeader, epochs: CompactEpoch[], obsTypes: Map<string, string[]>): Promise<Blob>;
+/** Shared RINEX 3/4 implementation (also used by obs-writer-v4.ts). */
+declare function writeModernObsBlob(header: RinexHeader, epochs: CompactEpoch[], obsTypes: Map<string, string[]>, opts: {
+    version: string;
+    comment: string;
+}): Promise<Blob>;
+
+/**
+ * RINEX 2.11 observation file writer.
+ *
+ * Converts RINEX 3 obs codes to RINEX 2 format and writes
+ * a valid RINEX 2.11 observation file.
+ */
+
+/**
+ * Write RINEX 2.11 obs file from compact observations.
+ * Only GPS+GLONASS satellites are included (RINEX 2 limitation).
+ */
+declare function writeRinex2ObsBlob(header: RinexHeader, epochs: CompactEpoch[], obsTypes: Map<string, string[]>): Promise<Blob>;
+
+/**
+ * RINEX 4.01 observation file writer.
+ *
+ * RINEX 4 is structurally identical to RINEX 3 for our output — same
+ * header layout, same epoch record format. Only the version line and
+ * the provenance comment differ, so this delegates to the shared
+ * implementation in obs-writer.ts.
+ */
+
+/** Write RINEX 4.01 obs file from compact observations. */
+declare function writeRinex4ObsBlob(header: RinexHeader, epochs: CompactEpoch[], obsTypes: Map<string, string[]>): Promise<Blob>;
+
+/**
+ * Shared plumbing for the RINEX 2/3/4 observation writers.
+ */
+
+/**
+ * Batched line sink that streams text through gzip compression so the
+ * full uncompressed output is never held in memory.
+ *
+ * Callers decide when to `flush()` (the writers flush every N epochs);
+ * `finish()` flushes, closes the stream, and returns the Blob.
+ */
+declare function createGzipLineSink(): {
+    push(line: string): void;
+    flush: () => Promise<void>;
+    finish(): Promise<Blob>;
+};
+/**
+ * Station / receiver / antenna header block — byte-identical across
+ * RINEX 2.11, 3.04, and 4.01.
+ */
+declare function stationHeaderLines(header: RinexHeader): string[];
+
+export { type CompactEpoch, type CrxField, type DiffState, EMPTY_WARNINGS, type IonexGrid, NavResult, RinexHeader, type RinexWarning, type RinexWarnings, type Sp3File, type Sp3Sample, WarningAccumulator, type WarningSeverity, createGzipLineSink, crxDecompress, crxRepair, fmtF, hdrLine, padL, padR, parseCrxDataLine, parseIonex, parseSp3, sp3Position, stationHeaderLines, writeModernObsBlob, writeRinex2ObsBlob, writeRinex4ObsBlob, writeRinexNav, writeRinexObsBlob };

package/dist/rinex.js

@@ -1,14 +1,22 @@
 import {
   EMPTY_WARNINGS,
   WarningAccumulator,
+  createGzipLineSink,
   fmtF,
   hdrLine,
   padL,
   padR,
   parseIonex,
   parseNavFile,
-  writeRinexNav
-} from "./chunk-77VUSDNI.js";
+  parseSp3,
+  sp3Position,
+  stationHeaderLines,
+  writeModernObsBlob,
+  writeRinex2ObsBlob,
+  writeRinex4ObsBlob,
+  writeRinexNav,
+  writeRinexObsBlob
+} from "./chunk-HXF7XVW7.js";
 import {
   SYSTEM_ORDER,
   crxDecompress,
@@ -23,6 +31,7 @@ export {
   EMPTY_WARNINGS,
   SYSTEM_ORDER,
   WarningAccumulator,
+  createGzipLineSink,
   crxDecompress,
   crxRepair,
   fmtF,
@@ -33,7 +42,14 @@ export {
   parseIonex,
   parseNavFile,
   parseRinexStream,
+  parseSp3,
+  sp3Position,
+  stationHeaderLines,
   systemCmp,
   systemName,
-  writeRinexNav
+  writeModernObsBlob,
+  writeRinex2ObsBlob,
+  writeRinex4ObsBlob,
+  writeRinexNav,
+  writeRinexObsBlob
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gnss-js",
-  "version": "1.11.0",
+  "version": "1.12.0",
   "description": "Comprehensive GNSS library for JavaScript — time scales, coordinates, RINEX parsing, RTCM3 decoding, orbit computation, and signal analysis",
   "type": "module",
   "sideEffects": false,