gnss-js 0.1.2 → 1.0.1

package/dist/ecef-CF0uAysr.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Clamp value to [-1, 1] to prevent NaN from asin/acos rounding errors.
+ * @param x Value to clamp
+ * @returns Clamped value in [-1, 1]
+ */
+declare function clampUnit(x: number): number;
+/**
+ * Convert geodetic coordinates to ECEF (Earth-Centered, Earth-Fixed).
+ * @param lat Latitude in radians
+ * @param lon Longitude in radians
+ * @param h Ellipsoidal height in meters
+ * @returns [X, Y, Z] in meters
+ */
+declare function geodeticToEcef(lat: number, lon: number, h: number): [number, number, number];
+/**
+ * Convert ECEF coordinates to geodetic (iterative Bowring method).
+ * @param x X in meters
+ * @param y Y in meters
+ * @param z Z in meters
+ * @returns [lat (rad), lon (rad), height (m)]
+ */
+declare function ecefToGeodetic(x: number, y: number, z: number): [number, number, number];
+/**
+ * Compute ENU (East, North, Up) difference between a point and a reference in ECEF.
+ * @param x Target X in meters (ECEF)
+ * @param y Target Y in meters (ECEF)
+ * @param z Target Z in meters (ECEF)
+ * @param xRef Reference X in meters (ECEF)
+ * @param yRef Reference Y in meters (ECEF)
+ * @param zRef Reference Z in meters (ECEF)
+ * @returns [deltaE, deltaN, deltaU] in meters
+ */
+declare function getEnuDifference(x: number, y: number, z: number, xRef: number, yRef: number, zRef: number): [number, number, number];
+/**
+ * Compute Azimuth, Elevation, and Range from a reference point to a target in ECEF.
+ * @returns [elevation (rad), azimuth (rad), slant range (m)]
+ */
+declare function getAer(x: number, y: number, z: number, xRef: number, yRef: number, zRef: number): [number, number, number];
+
+export { getAer as a, getEnuDifference as b, clampUnit as c, ecefToGeodetic as e, geodeticToEcef as g };

package/dist/ephemeris-C10stHhM.d.cts

@@ -0,0 +1,114 @@
+/**
+ * RTCM3 frame decoder with CRC-24Q validation and bit-level payload reader.
+ */
+/** Decoded RTCM3 frame header (we only parse the message type, not full content). */
+interface Rtcm3Frame {
+    messageType: number;
+    length: number;
+    payload: Uint8Array;
+}
+/** Simple bit reader for parsing RTCM3 payloads at bit level. */
+declare class BitReader {
+    private data;
+    private bitPos;
+    constructor(data: Uint8Array);
+    /** Read `n` bits as unsigned integer (max 53). */
+    readU(n: number): number;
+    /** Read `n` bits as signed (two's complement) integer. */
+    readS(n: number): number;
+    /** Read `n` bits as sign-magnitude integer (MSB = sign, rest = magnitude). */
+    readSM(n: number): number;
+    /** Skip `n` bits. */
+    skip(n: number): void;
+    get bitsLeft(): number;
+}
+/**
+ * Streaming RTCM3 frame decoder.
+ *
+ * RTCM3 frames: [0xD3] [6 reserved bits + 10 bit length] [payload] [3 byte CRC-24Q]
+ * Total frame = 3 (header) + length + 3 (CRC) = length + 6
+ */
+declare class Rtcm3Decoder {
+    private buffer;
+    /** Feed raw bytes and extract any complete RTCM3 frames. */
+    decode(data: Uint8Array): Rtcm3Frame[];
+    reset(): void;
+}
+
+/**
+ * RTCM3 ephemeris decoders for GPS, GLONASS, Galileo, BeiDou, and QZSS.
+ */
+
+/** Decoded ephemeris information for display purposes. */
+interface EphemerisInfo {
+    prn: string;
+    constellation: string;
+    health: number;
+    lastReceived: number;
+    messageType: number;
+    week?: number;
+    ura?: number;
+    toc?: number;
+    toe?: number;
+    sqrtA?: number;
+    eccentricity?: number;
+    inclination?: number;
+    omega0?: number;
+    omegaDot?: number;
+    argPerigee?: number;
+    meanAnomaly?: number;
+    deltaN?: number;
+    idot?: number;
+    crs?: number;
+    crc?: number;
+    cuc?: number;
+    cus?: number;
+    cic?: number;
+    cis?: number;
+    af0?: number;
+    af1?: number;
+    af2?: number;
+    iode?: number;
+    iodc?: number;
+    tgd?: number;
+    l2Codes?: number;
+    l2PFlag?: number;
+    fitInterval?: number;
+    bgdE5aE1?: number;
+    bgdE5bE1?: number;
+    e5aDataInvalid?: number;
+    e5bDataInvalid?: number;
+    e1bHealth?: number;
+    e1bDataInvalid?: number;
+    aodc?: number;
+    tgd1?: number;
+    tgd2?: number;
+    freqChannel?: number;
+    x?: number;
+    y?: number;
+    z?: number;
+    vx?: number;
+    vy?: number;
+    vz?: number;
+    ax?: number;
+    ay?: number;
+    az?: number;
+    gammaN?: number;
+    tb?: number;
+    tk?: number;
+    deltaTauN?: number;
+    en?: number;
+    p4?: number;
+    ft?: number;
+    nt?: number;
+    satType?: number;
+    tauC?: number;
+    n4?: number;
+    tauGPS?: number;
+}
+/** Read a UTF-8 string of `nChars` bytes from a BitReader (must be byte-aligned). */
+declare function readString(r: BitReader, nChars: number): string;
+/** Decode any supported ephemeris message. Returns null for non-ephemeris or decode errors. */
+declare function decodeEphemeris(frame: Rtcm3Frame): EphemerisInfo | null;
+
+export { BitReader as B, type EphemerisInfo as E, Rtcm3Decoder as R, type Rtcm3Frame as a, decodeEphemeris as d, readString as r };

package/dist/ephemeris-C10stHhM.d.ts

@@ -0,0 +1,114 @@
+/**
+ * RTCM3 frame decoder with CRC-24Q validation and bit-level payload reader.
+ */
+/** Decoded RTCM3 frame header (we only parse the message type, not full content). */
+interface Rtcm3Frame {
+    messageType: number;
+    length: number;
+    payload: Uint8Array;
+}
+/** Simple bit reader for parsing RTCM3 payloads at bit level. */
+declare class BitReader {
+    private data;
+    private bitPos;
+    constructor(data: Uint8Array);
+    /** Read `n` bits as unsigned integer (max 53). */
+    readU(n: number): number;
+    /** Read `n` bits as signed (two's complement) integer. */
+    readS(n: number): number;
+    /** Read `n` bits as sign-magnitude integer (MSB = sign, rest = magnitude). */
+    readSM(n: number): number;
+    /** Skip `n` bits. */
+    skip(n: number): void;
+    get bitsLeft(): number;
+}
+/**
+ * Streaming RTCM3 frame decoder.
+ *
+ * RTCM3 frames: [0xD3] [6 reserved bits + 10 bit length] [payload] [3 byte CRC-24Q]
+ * Total frame = 3 (header) + length + 3 (CRC) = length + 6
+ */
+declare class Rtcm3Decoder {
+    private buffer;
+    /** Feed raw bytes and extract any complete RTCM3 frames. */
+    decode(data: Uint8Array): Rtcm3Frame[];
+    reset(): void;
+}
+
+/**
+ * RTCM3 ephemeris decoders for GPS, GLONASS, Galileo, BeiDou, and QZSS.
+ */
+
+/** Decoded ephemeris information for display purposes. */
+interface EphemerisInfo {
+    prn: string;
+    constellation: string;
+    health: number;
+    lastReceived: number;
+    messageType: number;
+    week?: number;
+    ura?: number;
+    toc?: number;
+    toe?: number;
+    sqrtA?: number;
+    eccentricity?: number;
+    inclination?: number;
+    omega0?: number;
+    omegaDot?: number;
+    argPerigee?: number;
+    meanAnomaly?: number;
+    deltaN?: number;
+    idot?: number;
+    crs?: number;
+    crc?: number;
+    cuc?: number;
+    cus?: number;
+    cic?: number;
+    cis?: number;
+    af0?: number;
+    af1?: number;
+    af2?: number;
+    iode?: number;
+    iodc?: number;
+    tgd?: number;
+    l2Codes?: number;
+    l2PFlag?: number;
+    fitInterval?: number;
+    bgdE5aE1?: number;
+    bgdE5bE1?: number;
+    e5aDataInvalid?: number;
+    e5bDataInvalid?: number;
+    e1bHealth?: number;
+    e1bDataInvalid?: number;
+    aodc?: number;
+    tgd1?: number;
+    tgd2?: number;
+    freqChannel?: number;
+    x?: number;
+    y?: number;
+    z?: number;
+    vx?: number;
+    vy?: number;
+    vz?: number;
+    ax?: number;
+    ay?: number;
+    az?: number;
+    gammaN?: number;
+    tb?: number;
+    tk?: number;
+    deltaTauN?: number;
+    en?: number;
+    p4?: number;
+    ft?: number;
+    nt?: number;
+    satType?: number;
+    tauC?: number;
+    n4?: number;
+    tauGPS?: number;
+}
+/** Read a UTF-8 string of `nChars` bytes from a BitReader (must be byte-aligned). */
+declare function readString(r: BitReader, nChars: number): string;
+/** Decode any supported ephemeris message. Returns null for non-ephemeris or decode errors. */
+declare function decodeEphemeris(frame: Rtcm3Frame): EphemerisInfo | null;
+
+export { BitReader as B, type EphemerisInfo as E, Rtcm3Decoder as R, type Rtcm3Frame as a, decodeEphemeris as d, readString as r };

package/dist/gnss-BT6ulR17.d.cts

@@ -0,0 +1,56 @@
+import { R as RinexHeader } from './parser-JPjjFgeP.cjs';
+
+/**
+ * Core GNSS constants: constellation metadata, signal frequencies,
+ * GLONASS FDMA helpers, and processing parameters.
+ */
+declare const SYSTEM_NAMES: Record<string, string>;
+/** Short human-readable labels for each constellation identifier. */
+declare const SYS_SHORT: Record<string, string>;
+/** Speed of light in m/s. */
+declare const C_LIGHT = 299792458;
+/** Carrier frequencies (Hz) per system letter, per RINEX band digit. GLONASS FDMA bands 1/2 use gloFreq(). */
+declare const FREQ: Record<string, Record<string, number>>;
+declare const BAND_LABELS: Record<string, Record<string, string>>;
+/** Preferred dual-frequency pairs [primary, secondary] per system. */
+declare const DUAL_FREQ_PAIRS: Record<string, [string, string][]>;
+declare const GLO_F1_BASE = 1602000000;
+declare const GLO_F1_STEP = 562500;
+declare const GLO_F2_BASE = 1246000000;
+declare const GLO_F2_STEP = 437500;
+declare const GLO_F3 = 1202025000;
+/** Fallback channel assignments when RINEX header lacks GLONASS SLOT / FRQ #. */
+declare const GLO_CHANNEL_FALLBACK: Record<string, number>;
+/**
+ * Build a PRN → channel-k map from parsed RINEX header glonassSlots.
+ * Falls back to hardcoded ICD assignments if the header record is absent.
+ */
+declare function buildGloChannelMap(slots: Record<number, number>): Record<string, number>;
+/** Get GLONASS FDMA frequency for a given PRN and band. */
+declare function gloFreq(gloChannels: Record<string, number>, prn: string, band: string): number | undefined;
+/** Resolve frequency for a PRN + band, handling GLONASS FDMA. */
+declare function getFreq(gloChannels: Record<string, number>, prn: string, band: string): number | undefined;
+interface BdsSatellite {
+    prn: string;
+    phase: 'BDS-2' | 'BDS-3';
+    orbit: 'GEO' | 'IGSO' | 'MEO';
+}
+declare const BDS_SATELLITES: BdsSatellite[];
+
+/** Callback type for cycle slip notifications. */
+type OnSlipDetected = (time: number, prn: string, bands: Set<string>) => void;
+/**
+ * Build observation indices per system per band, preferring better tracking attributes.
+ * @param header Parsed RINEX header containing observation type definitions
+ * @returns Map of system letter to Map of band digit to {L, C} column indices
+ */
+declare function buildObsIndices(header: RinexHeader): Map<string, Map<string, {
+    L: number;
+    C: number | null;
+}>>;
+declare const ARC_GAP_FACTOR = 5;
+declare const DEFAULT_ELEV_MASK_DEG = 5;
+/** Format a Date as HH:MM:SS UTC string. */
+declare function formatUTCTime(d: Date): string;
+
+export { ARC_GAP_FACTOR as A, BAND_LABELS as B, C_LIGHT as C, DEFAULT_ELEV_MASK_DEG as D, FREQ as F, GLO_CHANNEL_FALLBACK as G, type OnSlipDetected as O, SYSTEM_NAMES as S, BDS_SATELLITES as a, type BdsSatellite as b, DUAL_FREQ_PAIRS as c, GLO_F1_BASE as d, GLO_F1_STEP as e, GLO_F2_BASE as f, GLO_F2_STEP as g, GLO_F3 as h, SYS_SHORT as i, buildGloChannelMap as j, buildObsIndices as k, formatUTCTime as l, getFreq as m, gloFreq as n };

package/dist/gnss-C-tgoYNa.d.ts

@@ -0,0 +1,56 @@
+import { R as RinexHeader } from './parser-JPjjFgeP.js';
+
+/**
+ * Core GNSS constants: constellation metadata, signal frequencies,
+ * GLONASS FDMA helpers, and processing parameters.
+ */
+declare const SYSTEM_NAMES: Record<string, string>;
+/** Short human-readable labels for each constellation identifier. */
+declare const SYS_SHORT: Record<string, string>;
+/** Speed of light in m/s. */
+declare const C_LIGHT = 299792458;
+/** Carrier frequencies (Hz) per system letter, per RINEX band digit. GLONASS FDMA bands 1/2 use gloFreq(). */
+declare const FREQ: Record<string, Record<string, number>>;
+declare const BAND_LABELS: Record<string, Record<string, string>>;
+/** Preferred dual-frequency pairs [primary, secondary] per system. */
+declare const DUAL_FREQ_PAIRS: Record<string, [string, string][]>;
+declare const GLO_F1_BASE = 1602000000;
+declare const GLO_F1_STEP = 562500;
+declare const GLO_F2_BASE = 1246000000;
+declare const GLO_F2_STEP = 437500;
+declare const GLO_F3 = 1202025000;
+/** Fallback channel assignments when RINEX header lacks GLONASS SLOT / FRQ #. */
+declare const GLO_CHANNEL_FALLBACK: Record<string, number>;
+/**
+ * Build a PRN → channel-k map from parsed RINEX header glonassSlots.
+ * Falls back to hardcoded ICD assignments if the header record is absent.
+ */
+declare function buildGloChannelMap(slots: Record<number, number>): Record<string, number>;
+/** Get GLONASS FDMA frequency for a given PRN and band. */
+declare function gloFreq(gloChannels: Record<string, number>, prn: string, band: string): number | undefined;
+/** Resolve frequency for a PRN + band, handling GLONASS FDMA. */
+declare function getFreq(gloChannels: Record<string, number>, prn: string, band: string): number | undefined;
+interface BdsSatellite {
+    prn: string;
+    phase: 'BDS-2' | 'BDS-3';
+    orbit: 'GEO' | 'IGSO' | 'MEO';
+}
+declare const BDS_SATELLITES: BdsSatellite[];
+
+/** Callback type for cycle slip notifications. */
+type OnSlipDetected = (time: number, prn: string, bands: Set<string>) => void;
+/**
+ * Build observation indices per system per band, preferring better tracking attributes.
+ * @param header Parsed RINEX header containing observation type definitions
+ * @returns Map of system letter to Map of band digit to {L, C} column indices
+ */
+declare function buildObsIndices(header: RinexHeader): Map<string, Map<string, {
+    L: number;
+    C: number | null;
+}>>;
+declare const ARC_GAP_FACTOR = 5;
+declare const DEFAULT_ELEV_MASK_DEG = 5;
+/** Format a Date as HH:MM:SS UTC string. */
+declare function formatUTCTime(d: Date): string;
+
+export { ARC_GAP_FACTOR as A, BAND_LABELS as B, C_LIGHT as C, DEFAULT_ELEV_MASK_DEG as D, FREQ as F, GLO_CHANNEL_FALLBACK as G, type OnSlipDetected as O, SYSTEM_NAMES as S, BDS_SATELLITES as a, type BdsSatellite as b, DUAL_FREQ_PAIRS as c, GLO_F1_BASE as d, GLO_F1_STEP as e, GLO_F2_BASE as f, GLO_F2_STEP as g, GLO_F3 as h, SYS_SHORT as i, buildGloChannelMap as j, buildObsIndices as k, formatUTCTime as l, getFreq as m, gloFreq as n };