gnss-js 1.14.0 → 1.15.0

package/dist/sbf.d.cts

@@ -1,3 +1,139 @@
+import { E as Ephemeris } from './nav-BAI1a9vK.cjs';
+
+/**
+ * Septentrio SBF decoded navigation and almanac blocks.
+ *
+ * Nav blocks (GPSNav 5891, GLONav 4004, GALNav 4002, BDSNav 4081,
+ * QZSNav 4095) carry the fully decoded broadcast ephemeris; they are
+ * mapped onto the same `Ephemeris` union the RINEX nav parser produces,
+ * with identical units and conventions (sqrtA in m^1/2, angles in rad,
+ * semicircle fields scaled by π, GLONASS tauN with the RINEX sign, BDS
+ * epochs/weeks on the BDT scale like a RINEX file).
+ *
+ * Almanac blocks (GPSAlm 5892, GALAlm 4003, GLOAlm 4005, BDSAlm 4119)
+ * are decoded into dedicated types with all per-system relative fields
+ * (GPS/BDS δi, Galileo δi and ΔsqrtA) normalized to absolute values.
+ *
+ * Ported from RTKLIB demo5 (rtklibexplorer), src/rcv/septentrio.c
+ * (decode_gpsnav / decode_glonav / decode_galnav / decode_cmpnav /
+ * decode_qzssnav / decode_gpsalm / decode_galalm / decode_cmpalm),
+ * BSD-2-Clause, and cross-checked field by field against the Septentrio
+ * mosaic-X5 reference guide, which also supplies the GLOAlm layout
+ * (not decoded by RTKLIB).
+ */
+
+interface SbfNavResult {
+    ephemerides: Ephemeris[];
+    /** Frames whose CRC failed (corruption indicator). */
+    badCrc: number;
+}
+/**
+ * Decode every GPSNav/GLONav/GALNav/BDSNav/QZSNav block in an SBF byte
+ * stream into the RINEX-parser `Ephemeris` union. Every block is
+ * emitted (no issue-of-data dedup); other block types are skipped.
+ */
+declare function parseSbfNav(data: Uint8Array): SbfNavResult;
+/**
+ * GPS / Galileo / BeiDou almanac, normalized to ABSOLUTE Keplerian
+ * elements (units matching `KeplerEphemeris`: sqrtA in m^1/2, angles
+ * in rad, rates in rad/s) so a Kepler propagator can consume the
+ * record directly with all correction terms at zero.
+ *
+ * Normalizations applied per system:
+ * - GPS (`G`): the SIS δi (relative to 0.3 semicircles) is folded in —
+ *   `i0OrDeltaI` = 0.3π + δi·π. `weekAlm` is the full GPS week
+ *   (8-bit SIS week disambiguated against the receiver week).
+ * - Galileo (`E`): the SIS ΔsqrtA (relative to √29 600 000 m^1/2) and
+ *   δi (relative to 56°) are folded in — `sqrtA` and `i0OrDeltaI` are
+ *   absolute. `weekAlm` is the full GPS-aligned week (2-bit SIS week
+ *   disambiguated). `health` is the raw SBF bit field: bit 0 set ⇒
+ *   bits 1-2 are the L1-B HS, bit 3 set ⇒ bits 4-5 E5b HS, bit 6 set
+ *   ⇒ bits 7-8 E5a HS (0 = healthy).
+ * - BeiDou (`C`): δi is relative to 0.3 semicircles for MEO/IGSO and
+ *   to 0 for GEO satellites (PRN 1-5 and 59-63) per the BDS ICD; the
+ *   reference is folded in. `weekAlm` is the full BDS week (add 1356
+ *   for the GPS week) and `toaSec` is BDT seconds of week
+ *   (BDT = GPST − 14 s). `health` is the 9-bit SIS health word.
+ */
+interface SbfKeplerAlmanac {
+    system: 'G' | 'E' | 'C';
+    /** Satellite PRN, e.g. "G14". */
+    prn: string;
+    /** Full almanac reference week (see per-system notes above). */
+    weekAlm: number;
+    /** Almanac reference time of week in seconds (system time scale). */
+    toaSec: number;
+    /** Square root of semi-major axis in m^(1/2), absolute. */
+    sqrtA: number;
+    /** Eccentricity (dimensionless). */
+    e: number;
+    /** Inclination at reference time in rad, absolute (normalized). */
+    i0OrDeltaI: number;
+    /** Longitude of ascending node at the weekly epoch in rad. */
+    omega0: number;
+    /** Argument of perigee in rad. */
+    omega: number;
+    /** Mean anomaly at reference time in rad. */
+    m0: number;
+    /** Rate of right ascension in rad/s. */
+    omegaDot: number;
+    /** SV clock bias in seconds. */
+    af0: number;
+    /** SV clock drift in s/s. */
+    af1: number;
+    /** Health word, 0 = healthy (see per-system notes above). */
+    health: number;
+}
+/**
+ * GLONASS almanac (GLONASS ICD orbital parameters). Semicircle fields
+ * are converted to radians; everything else keeps the ICD units.
+ */
+interface SbfGlonassAlmanac {
+    system: 'R';
+    /** Satellite slot, e.g. "R05". */
+    prn: string;
+    /** Frequency channel number HnA (−7…+6). */
+    freqNr: number;
+    /** Full GPS week of the almanac reference time. */
+    weekAlm: number;
+    /** Almanac reference time of week in seconds, GPS time frame. */
+    toaSec: number;
+    /** εnA: orbit eccentricity. */
+    epsilon: number;
+    /** λnA: longitude of first ascending node in rad. */
+    lambda: number;
+    /** tλnA: time of first ascending node passage in s of day. */
+    tLambda: number;
+    /** ΔinA: inclination correction to 63° in rad. */
+    deltaI: number;
+    /** ωnA: argument of perigee in rad. */
+    omega: number;
+    /** ΔTnA: correction to the mean Draconian period (s / orbit). */
+    deltaT: number;
+    /** dΔTnA: rate of change of ΔT (s / orbit²). */
+    deltaTDot: number;
+    /** τnA: coarse satellite clock correction in s. */
+    tau: number;
+    /** CnA general health flag: 1 = healthy. */
+    health: number;
+    /** NA: calendar day number within the 4-year period. */
+    nDay: number;
+    /** N4: 4-year interval number since 1996. */
+    n4: number;
+}
+type SbfAlmanac = SbfKeplerAlmanac | SbfGlonassAlmanac;
+interface SbfAlmanacResult {
+    almanacs: SbfAlmanac[];
+    /** Frames whose CRC failed (corruption indicator). */
+    badCrc: number;
+}
+/**
+ * Decode every GPSAlm/GALAlm/GLOAlm/BDSAlm block in an SBF byte
+ * stream. Every block is emitted in stream order; other block types
+ * are skipped.
+ */
+declare function parseSbfAlmanac(data: Uint8Array): SbfAlmanacResult;
+
 /**
  * Septentrio SBF raw-measurement decoding (MeasEpoch + Meas3) — the
  * path from a receiver log to RINEX-grade observables.
@@ -23,6 +159,7 @@
  * Septentrio mosaic-X5 reference guide (the guide documents MeasEpoch
  * fully; the Meas3 bit layout is only public through that decoder).
  */
+
 interface SbfMeasurement {
     /** RINEX PRN, e.g. "G04", "R11", "S23" (SBAS PRN-100). */
     prn: string;
@@ -60,4 +197,4 @@ interface SbfParseResult {
  */
 declare function parseSbfMeas(data: Uint8Array): SbfParseResult;
 
-export { type SbfMeasEpoch, type SbfMeasurement, type SbfParseResult, parseSbfMeas };
+export { type SbfAlmanac, type SbfAlmanacResult, type SbfGlonassAlmanac, type SbfKeplerAlmanac, type SbfMeasEpoch, type SbfMeasurement, type SbfNavResult, type SbfParseResult, parseSbfAlmanac, parseSbfMeas, parseSbfNav };

package/dist/sbf.d.ts

@@ -1,3 +1,139 @@
+import { E as Ephemeris } from './nav-BAI1a9vK.js';
+
+/**
+ * Septentrio SBF decoded navigation and almanac blocks.
+ *
+ * Nav blocks (GPSNav 5891, GLONav 4004, GALNav 4002, BDSNav 4081,
+ * QZSNav 4095) carry the fully decoded broadcast ephemeris; they are
+ * mapped onto the same `Ephemeris` union the RINEX nav parser produces,
+ * with identical units and conventions (sqrtA in m^1/2, angles in rad,
+ * semicircle fields scaled by π, GLONASS tauN with the RINEX sign, BDS
+ * epochs/weeks on the BDT scale like a RINEX file).
+ *
+ * Almanac blocks (GPSAlm 5892, GALAlm 4003, GLOAlm 4005, BDSAlm 4119)
+ * are decoded into dedicated types with all per-system relative fields
+ * (GPS/BDS δi, Galileo δi and ΔsqrtA) normalized to absolute values.
+ *
+ * Ported from RTKLIB demo5 (rtklibexplorer), src/rcv/septentrio.c
+ * (decode_gpsnav / decode_glonav / decode_galnav / decode_cmpnav /
+ * decode_qzssnav / decode_gpsalm / decode_galalm / decode_cmpalm),
+ * BSD-2-Clause, and cross-checked field by field against the Septentrio
+ * mosaic-X5 reference guide, which also supplies the GLOAlm layout
+ * (not decoded by RTKLIB).
+ */
+
+interface SbfNavResult {
+    ephemerides: Ephemeris[];
+    /** Frames whose CRC failed (corruption indicator). */
+    badCrc: number;
+}
+/**
+ * Decode every GPSNav/GLONav/GALNav/BDSNav/QZSNav block in an SBF byte
+ * stream into the RINEX-parser `Ephemeris` union. Every block is
+ * emitted (no issue-of-data dedup); other block types are skipped.
+ */
+declare function parseSbfNav(data: Uint8Array): SbfNavResult;
+/**
+ * GPS / Galileo / BeiDou almanac, normalized to ABSOLUTE Keplerian
+ * elements (units matching `KeplerEphemeris`: sqrtA in m^1/2, angles
+ * in rad, rates in rad/s) so a Kepler propagator can consume the
+ * record directly with all correction terms at zero.
+ *
+ * Normalizations applied per system:
+ * - GPS (`G`): the SIS δi (relative to 0.3 semicircles) is folded in —
+ *   `i0OrDeltaI` = 0.3π + δi·π. `weekAlm` is the full GPS week
+ *   (8-bit SIS week disambiguated against the receiver week).
+ * - Galileo (`E`): the SIS ΔsqrtA (relative to √29 600 000 m^1/2) and
+ *   δi (relative to 56°) are folded in — `sqrtA` and `i0OrDeltaI` are
+ *   absolute. `weekAlm` is the full GPS-aligned week (2-bit SIS week
+ *   disambiguated). `health` is the raw SBF bit field: bit 0 set ⇒
+ *   bits 1-2 are the L1-B HS, bit 3 set ⇒ bits 4-5 E5b HS, bit 6 set
+ *   ⇒ bits 7-8 E5a HS (0 = healthy).
+ * - BeiDou (`C`): δi is relative to 0.3 semicircles for MEO/IGSO and
+ *   to 0 for GEO satellites (PRN 1-5 and 59-63) per the BDS ICD; the
+ *   reference is folded in. `weekAlm` is the full BDS week (add 1356
+ *   for the GPS week) and `toaSec` is BDT seconds of week
+ *   (BDT = GPST − 14 s). `health` is the 9-bit SIS health word.
+ */
+interface SbfKeplerAlmanac {
+    system: 'G' | 'E' | 'C';
+    /** Satellite PRN, e.g. "G14". */
+    prn: string;
+    /** Full almanac reference week (see per-system notes above). */
+    weekAlm: number;
+    /** Almanac reference time of week in seconds (system time scale). */
+    toaSec: number;
+    /** Square root of semi-major axis in m^(1/2), absolute. */
+    sqrtA: number;
+    /** Eccentricity (dimensionless). */
+    e: number;
+    /** Inclination at reference time in rad, absolute (normalized). */
+    i0OrDeltaI: number;
+    /** Longitude of ascending node at the weekly epoch in rad. */
+    omega0: number;
+    /** Argument of perigee in rad. */
+    omega: number;
+    /** Mean anomaly at reference time in rad. */
+    m0: number;
+    /** Rate of right ascension in rad/s. */
+    omegaDot: number;
+    /** SV clock bias in seconds. */
+    af0: number;
+    /** SV clock drift in s/s. */
+    af1: number;
+    /** Health word, 0 = healthy (see per-system notes above). */
+    health: number;
+}
+/**
+ * GLONASS almanac (GLONASS ICD orbital parameters). Semicircle fields
+ * are converted to radians; everything else keeps the ICD units.
+ */
+interface SbfGlonassAlmanac {
+    system: 'R';
+    /** Satellite slot, e.g. "R05". */
+    prn: string;
+    /** Frequency channel number HnA (−7…+6). */
+    freqNr: number;
+    /** Full GPS week of the almanac reference time. */
+    weekAlm: number;
+    /** Almanac reference time of week in seconds, GPS time frame. */
+    toaSec: number;
+    /** εnA: orbit eccentricity. */
+    epsilon: number;
+    /** λnA: longitude of first ascending node in rad. */
+    lambda: number;
+    /** tλnA: time of first ascending node passage in s of day. */
+    tLambda: number;
+    /** ΔinA: inclination correction to 63° in rad. */
+    deltaI: number;
+    /** ωnA: argument of perigee in rad. */
+    omega: number;
+    /** ΔTnA: correction to the mean Draconian period (s / orbit). */
+    deltaT: number;
+    /** dΔTnA: rate of change of ΔT (s / orbit²). */
+    deltaTDot: number;
+    /** τnA: coarse satellite clock correction in s. */
+    tau: number;
+    /** CnA general health flag: 1 = healthy. */
+    health: number;
+    /** NA: calendar day number within the 4-year period. */
+    nDay: number;
+    /** N4: 4-year interval number since 1996. */
+    n4: number;
+}
+type SbfAlmanac = SbfKeplerAlmanac | SbfGlonassAlmanac;
+interface SbfAlmanacResult {
+    almanacs: SbfAlmanac[];
+    /** Frames whose CRC failed (corruption indicator). */
+    badCrc: number;
+}
+/**
+ * Decode every GPSAlm/GALAlm/GLOAlm/BDSAlm block in an SBF byte
+ * stream. Every block is emitted in stream order; other block types
+ * are skipped.
+ */
+declare function parseSbfAlmanac(data: Uint8Array): SbfAlmanacResult;
+
 /**
  * Septentrio SBF raw-measurement decoding (MeasEpoch + Meas3) — the
  * path from a receiver log to RINEX-grade observables.
@@ -23,6 +159,7 @@
  * Septentrio mosaic-X5 reference guide (the guide documents MeasEpoch
  * fully; the Meas3 bit layout is only public through that decoder).
  */
+
 interface SbfMeasurement {
     /** RINEX PRN, e.g. "G04", "R11", "S23" (SBAS PRN-100). */
     prn: string;
@@ -60,4 +197,4 @@ interface SbfParseResult {
  */
 declare function parseSbfMeas(data: Uint8Array): SbfParseResult;
 
-export { type SbfMeasEpoch, type SbfMeasurement, type SbfParseResult, parseSbfMeas };
+export { type SbfAlmanac, type SbfAlmanacResult, type SbfGlonassAlmanac, type SbfKeplerAlmanac, type SbfMeasEpoch, type SbfMeasurement, type SbfNavResult, type SbfParseResult, parseSbfAlmanac, parseSbfMeas, parseSbfNav };

package/dist/sbf.js

@@ -1,6 +1,12 @@
 import {
-  parseSbfMeas
-} from "./chunk-YIHO74OS.js";
+  parseSbfAlmanac,
+  parseSbfMeas,
+  parseSbfNav
+} from "./chunk-BEQSEJMU.js";
+import "./chunk-HVXYFUCB.js";
+import "./chunk-LEEU5OIO.js";
 export {
-  parseSbfMeas
+  parseSbfAlmanac,
+  parseSbfMeas,
+  parseSbfNav
 };

package/package.json

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

package/dist/{chunk-VAHMHYID.js → chunk-OMVL3X7V.js}

@@ -1,9 +1,9 @@
-import {
-  getGpsLeap
-} from "./chunk-HVXYFUCB.js";
 import {
   ecefToGeodetic
 } from "./chunk-37QNKGTC.js";
+import {
+  getGpsLeap
+} from "./chunk-HVXYFUCB.js";
 import {
   START_BDS_TIME,
   START_GPS_TIME