gnss-js 0.1.2 → 1.0.0

package/dist/signals.d.cts

@@ -0,0 +1,93 @@
+/**
+ * GNSS signal definitions for PSD spectrum rendering.
+ * Frequencies in MHz, chip rates relative to f0 = 1.023 MHz.
+ */
+declare const FREQ_GPS_L1 = 1575.42;
+declare const FREQ_GPS_L2 = 1227.6;
+declare const FREQ_GPS_L5 = 1176.45;
+declare const FREQ_GLO_L1 = 1602;
+declare const FREQ_GLO_L2 = 1246;
+declare const DELTA_GLO_L1 = 0.5625;
+declare const DELTA_GLO_L2 = 0.4375;
+declare const FREQ_GLO_L1OC = 1600.995;
+declare const FREQ_GLO_L2OC = 1248.06;
+declare const FREQ_GLO_L3OC = 1202.025;
+declare const FREQ_GAL_E1 = 1575.42;
+declare const FREQ_GAL_E5 = 1191.795;
+declare const FREQ_GAL_E5a = 1176.45;
+declare const FREQ_GAL_E5b = 1207.14;
+declare const FREQ_GAL_E6 = 1278.75;
+declare const FREQ_BDS_B1I = 1561.098;
+declare const FREQ_BDS_B2I = 1207.14;
+declare const FREQ_BDS_B3I = 1268.52;
+declare const FREQ_BDS_B1A = 1575.42;
+declare const FREQ_BDS_B1C = 1575.42;
+declare const FREQ_BDS_B3A = 1268.52;
+declare const FREQ_QZS_L1 = 1575.42;
+declare const FREQ_QZS_L2 = 1227.6;
+declare const FREQ_QZS_L5 = 1176.45;
+declare const FREQ_QZS_L6 = 1278.75;
+declare const FREQ_NAVIC_L5 = 1176.45;
+type Modulation = 'BPSK' | 'BOCs' | 'BOCc' | 'AltBOC' | 'composite';
+interface SignalDef {
+    /** Parent constellation key */
+    constellation: string;
+    /** Display label (e.g. "L1 C/A") */
+    label: string;
+    /** Center frequency in MHz */
+    centerMHz: number;
+    /** Modulation type */
+    modulation: Modulation;
+    /** Modulation parameters: [n] for BPSK, [m, n] for BOC/AltBOC */
+    params: number[];
+    /** Half-span in f0 chips for the frequency sweep */
+    halfSpanChips: number;
+    /** Fill color */
+    color: string;
+    /** Draw direction: 'up' for I/data components, 'down' for Q/pilot components */
+    direction: 'up' | 'down';
+    /** Optional: composite PSD function coefficients for weighted sums */
+    composite?: {
+        weights: number[];
+        modulations: Modulation[];
+        paramSets: number[][];
+    };
+}
+interface ConstellationRow {
+    key: string;
+    label: string;
+    color: string;
+    signals: SignalDef[];
+}
+declare const CONSTELLATIONS: ConstellationRow[];
+interface BandPreset {
+    label: string;
+    minMHz: number;
+    maxMHz: number;
+}
+declare const BAND_PRESETS: BandPreset[];
+
+/**
+ * GNSS signal Power Spectral Density (PSD) functions.
+ *
+ * Ported from Python (gnss-utils/utils/signals/psd.py).
+ * All frequency inputs are in Hz; output is linear power spectral density.
+ */
+/** BPSK PSD: φ(f) = (1 / f₀n) · sinc²(f / f₀n) */
+declare function phiBPSK(f: number, f0: number, n: number): number;
+/** BOC sine-phased PSD */
+declare function phiBOCs(f: number, f0: number, m: number, n: number): number;
+/** BOC cosine-phased PSD */
+declare function phiBOCc(f: number, f0: number, m: number, n: number): number;
+/** AltBOC (constant envelope) PSD */
+declare function phiAltBOC(f: number, f0: number, m: number, n: number): number;
+/**
+ * Compute PSD in dB over a frequency range.
+ * Returns Float64Array of 10·log₁₀(φ(f)) values, clamped to a floor.
+ */
+declare function computePsdDb(centerMHz: number, halfSpanChips: number, numPoints: number, psdFn: (f: number) => number, f0?: number, floorDb?: number): {
+    freqsMHz: Float64Array;
+    psdDb: Float64Array;
+};
+
+export { BAND_PRESETS, type BandPreset, CONSTELLATIONS, type ConstellationRow, DELTA_GLO_L1, DELTA_GLO_L2, FREQ_BDS_B1A, FREQ_BDS_B1C, FREQ_BDS_B1I, FREQ_BDS_B2I, FREQ_BDS_B3A, FREQ_BDS_B3I, FREQ_GAL_E1, FREQ_GAL_E5, FREQ_GAL_E5a, FREQ_GAL_E5b, FREQ_GAL_E6, FREQ_GLO_L1, FREQ_GLO_L1OC, FREQ_GLO_L2, FREQ_GLO_L2OC, FREQ_GLO_L3OC, FREQ_GPS_L1, FREQ_GPS_L2, FREQ_GPS_L5, FREQ_NAVIC_L5, FREQ_QZS_L1, FREQ_QZS_L2, FREQ_QZS_L5, FREQ_QZS_L6, type Modulation, type SignalDef, computePsdDb, phiAltBOC, phiBOCc, phiBOCs, phiBPSK };

package/dist/signals.d.ts

@@ -0,0 +1,93 @@
+/**
+ * GNSS signal definitions for PSD spectrum rendering.
+ * Frequencies in MHz, chip rates relative to f0 = 1.023 MHz.
+ */
+declare const FREQ_GPS_L1 = 1575.42;
+declare const FREQ_GPS_L2 = 1227.6;
+declare const FREQ_GPS_L5 = 1176.45;
+declare const FREQ_GLO_L1 = 1602;
+declare const FREQ_GLO_L2 = 1246;
+declare const DELTA_GLO_L1 = 0.5625;
+declare const DELTA_GLO_L2 = 0.4375;
+declare const FREQ_GLO_L1OC = 1600.995;
+declare const FREQ_GLO_L2OC = 1248.06;
+declare const FREQ_GLO_L3OC = 1202.025;
+declare const FREQ_GAL_E1 = 1575.42;
+declare const FREQ_GAL_E5 = 1191.795;
+declare const FREQ_GAL_E5a = 1176.45;
+declare const FREQ_GAL_E5b = 1207.14;
+declare const FREQ_GAL_E6 = 1278.75;
+declare const FREQ_BDS_B1I = 1561.098;
+declare const FREQ_BDS_B2I = 1207.14;
+declare const FREQ_BDS_B3I = 1268.52;
+declare const FREQ_BDS_B1A = 1575.42;
+declare const FREQ_BDS_B1C = 1575.42;
+declare const FREQ_BDS_B3A = 1268.52;
+declare const FREQ_QZS_L1 = 1575.42;
+declare const FREQ_QZS_L2 = 1227.6;
+declare const FREQ_QZS_L5 = 1176.45;
+declare const FREQ_QZS_L6 = 1278.75;
+declare const FREQ_NAVIC_L5 = 1176.45;
+type Modulation = 'BPSK' | 'BOCs' | 'BOCc' | 'AltBOC' | 'composite';
+interface SignalDef {
+    /** Parent constellation key */
+    constellation: string;
+    /** Display label (e.g. "L1 C/A") */
+    label: string;
+    /** Center frequency in MHz */
+    centerMHz: number;
+    /** Modulation type */
+    modulation: Modulation;
+    /** Modulation parameters: [n] for BPSK, [m, n] for BOC/AltBOC */
+    params: number[];
+    /** Half-span in f0 chips for the frequency sweep */
+    halfSpanChips: number;
+    /** Fill color */
+    color: string;
+    /** Draw direction: 'up' for I/data components, 'down' for Q/pilot components */
+    direction: 'up' | 'down';
+    /** Optional: composite PSD function coefficients for weighted sums */
+    composite?: {
+        weights: number[];
+        modulations: Modulation[];
+        paramSets: number[][];
+    };
+}
+interface ConstellationRow {
+    key: string;
+    label: string;
+    color: string;
+    signals: SignalDef[];
+}
+declare const CONSTELLATIONS: ConstellationRow[];
+interface BandPreset {
+    label: string;
+    minMHz: number;
+    maxMHz: number;
+}
+declare const BAND_PRESETS: BandPreset[];
+
+/**
+ * GNSS signal Power Spectral Density (PSD) functions.
+ *
+ * Ported from Python (gnss-utils/utils/signals/psd.py).
+ * All frequency inputs are in Hz; output is linear power spectral density.
+ */
+/** BPSK PSD: φ(f) = (1 / f₀n) · sinc²(f / f₀n) */
+declare function phiBPSK(f: number, f0: number, n: number): number;
+/** BOC sine-phased PSD */
+declare function phiBOCs(f: number, f0: number, m: number, n: number): number;
+/** BOC cosine-phased PSD */
+declare function phiBOCc(f: number, f0: number, m: number, n: number): number;
+/** AltBOC (constant envelope) PSD */
+declare function phiAltBOC(f: number, f0: number, m: number, n: number): number;
+/**
+ * Compute PSD in dB over a frequency range.
+ * Returns Float64Array of 10·log₁₀(φ(f)) values, clamped to a floor.
+ */
+declare function computePsdDb(centerMHz: number, halfSpanChips: number, numPoints: number, psdFn: (f: number) => number, f0?: number, floorDb?: number): {
+    freqsMHz: Float64Array;
+    psdDb: Float64Array;
+};
+
+export { BAND_PRESETS, type BandPreset, CONSTELLATIONS, type ConstellationRow, DELTA_GLO_L1, DELTA_GLO_L2, FREQ_BDS_B1A, FREQ_BDS_B1C, FREQ_BDS_B1I, FREQ_BDS_B2I, FREQ_BDS_B3A, FREQ_BDS_B3I, FREQ_GAL_E1, FREQ_GAL_E5, FREQ_GAL_E5a, FREQ_GAL_E5b, FREQ_GAL_E6, FREQ_GLO_L1, FREQ_GLO_L1OC, FREQ_GLO_L2, FREQ_GLO_L2OC, FREQ_GLO_L3OC, FREQ_GPS_L1, FREQ_GPS_L2, FREQ_GPS_L5, FREQ_NAVIC_L5, FREQ_QZS_L1, FREQ_QZS_L2, FREQ_QZS_L5, FREQ_QZS_L6, type Modulation, type SignalDef, computePsdDb, phiAltBOC, phiBOCc, phiBOCs, phiBPSK };

package/dist/signals.js

@@ -0,0 +1,70 @@
+import {
+  BAND_PRESETS,
+  CONSTELLATIONS,
+  DELTA_GLO_L1,
+  DELTA_GLO_L2,
+  FREQ_BDS_B1A,
+  FREQ_BDS_B1C,
+  FREQ_BDS_B1I,
+  FREQ_BDS_B2I,
+  FREQ_BDS_B3A,
+  FREQ_BDS_B3I,
+  FREQ_GAL_E1,
+  FREQ_GAL_E5,
+  FREQ_GAL_E5a,
+  FREQ_GAL_E5b,
+  FREQ_GAL_E6,
+  FREQ_GLO_L1,
+  FREQ_GLO_L1OC,
+  FREQ_GLO_L2,
+  FREQ_GLO_L2OC,
+  FREQ_GLO_L3OC,
+  FREQ_GPS_L1,
+  FREQ_GPS_L2,
+  FREQ_GPS_L5,
+  FREQ_NAVIC_L5,
+  FREQ_QZS_L1,
+  FREQ_QZS_L2,
+  FREQ_QZS_L5,
+  FREQ_QZS_L6,
+  computePsdDb,
+  phiAltBOC,
+  phiBOCc,
+  phiBOCs,
+  phiBPSK
+} from "./chunk-HKN3PUGN.js";
+export {
+  BAND_PRESETS,
+  CONSTELLATIONS,
+  DELTA_GLO_L1,
+  DELTA_GLO_L2,
+  FREQ_BDS_B1A,
+  FREQ_BDS_B1C,
+  FREQ_BDS_B1I,
+  FREQ_BDS_B2I,
+  FREQ_BDS_B3A,
+  FREQ_BDS_B3I,
+  FREQ_GAL_E1,
+  FREQ_GAL_E5,
+  FREQ_GAL_E5a,
+  FREQ_GAL_E5b,
+  FREQ_GAL_E6,
+  FREQ_GLO_L1,
+  FREQ_GLO_L1OC,
+  FREQ_GLO_L2,
+  FREQ_GLO_L2OC,
+  FREQ_GLO_L3OC,
+  FREQ_GPS_L1,
+  FREQ_GPS_L2,
+  FREQ_GPS_L5,
+  FREQ_NAVIC_L5,
+  FREQ_QZS_L1,
+  FREQ_QZS_L2,
+  FREQ_QZS_L5,
+  FREQ_QZS_L6,
+  computePsdDb,
+  phiAltBOC,
+  phiBOCc,
+  phiBOCs,
+  phiBPSK
+};

package/dist/time-DnI1VpE8.d.cts

@@ -0,0 +1,33 @@
+type TimeDifference = {
+    seconds: number;
+    minutes: number;
+    hours: number;
+    days: number;
+};
+type HourCode = 'a' | 'b' | 'c' | 'd' | 'e' | 'f' | 'g' | 'h' | 'i' | 'j' | 'k' | 'l' | 'm' | 'n' | 'o' | 'p' | 'q' | 'r' | 's' | 't' | 'u' | 'v' | 'w' | 'x';
+
+declare const SECONDS_IN_WEEK: number;
+declare const SECONDS_IN_DAY: number;
+declare const SECONDS_IN_HOUR: number;
+declare const SECONDS_IN_MINUTE: number;
+declare const MILLISECONDS_IN_WEEK: number;
+declare const MILLISECONDS_IN_DAY: number;
+declare const MILLISECONDS_IN_HOUR: number;
+declare const MILLISECONDS_IN_MINUTE: number;
+declare const MILLISECONDS_IN_SECOND: number;
+declare const MILLISECONDS_TT_TAI: number;
+declare const MILLISECONDS_GPS_TAI: number;
+declare const START_GPS_TIME: Date;
+declare const START_GAL_TIME: Date;
+declare const START_BDS_TIME: Date;
+declare const START_UNIX_TIME: Date;
+declare const START_NTP_TIME: Date;
+declare const START_GLO_LEAP: Date;
+declare const START_TAI_TIME: Date;
+declare const RINEX_CODES: HourCode[];
+declare const START_JULIAN_TAI = 2436204.5;
+declare const DAYS_MJD_JULIAN = 2400000.5;
+declare const DAYS_MJD2000_MJD = 51544.5;
+declare const START_MJD_UNIX_SECONDS = 40587;
+
+export { DAYS_MJD2000_MJD as D, type HourCode as H, MILLISECONDS_GPS_TAI as M, RINEX_CODES as R, SECONDS_IN_DAY as S, type TimeDifference as T, DAYS_MJD_JULIAN as a, MILLISECONDS_IN_DAY as b, MILLISECONDS_IN_HOUR as c, MILLISECONDS_IN_MINUTE as d, MILLISECONDS_IN_SECOND as e, MILLISECONDS_IN_WEEK as f, MILLISECONDS_TT_TAI as g, SECONDS_IN_HOUR as h, SECONDS_IN_MINUTE as i, SECONDS_IN_WEEK as j, START_BDS_TIME as k, START_GAL_TIME as l, START_GLO_LEAP as m, START_GPS_TIME as n, START_JULIAN_TAI as o, START_MJD_UNIX_SECONDS as p, START_NTP_TIME as q, START_TAI_TIME as r, START_UNIX_TIME as s };

package/dist/time-DnI1VpE8.d.ts

@@ -0,0 +1,33 @@
+type TimeDifference = {
+    seconds: number;
+    minutes: number;
+    hours: number;
+    days: number;
+};
+type HourCode = 'a' | 'b' | 'c' | 'd' | 'e' | 'f' | 'g' | 'h' | 'i' | 'j' | 'k' | 'l' | 'm' | 'n' | 'o' | 'p' | 'q' | 'r' | 's' | 't' | 'u' | 'v' | 'w' | 'x';
+
+declare const SECONDS_IN_WEEK: number;
+declare const SECONDS_IN_DAY: number;
+declare const SECONDS_IN_HOUR: number;
+declare const SECONDS_IN_MINUTE: number;
+declare const MILLISECONDS_IN_WEEK: number;
+declare const MILLISECONDS_IN_DAY: number;
+declare const MILLISECONDS_IN_HOUR: number;
+declare const MILLISECONDS_IN_MINUTE: number;
+declare const MILLISECONDS_IN_SECOND: number;
+declare const MILLISECONDS_TT_TAI: number;
+declare const MILLISECONDS_GPS_TAI: number;
+declare const START_GPS_TIME: Date;
+declare const START_GAL_TIME: Date;
+declare const START_BDS_TIME: Date;
+declare const START_UNIX_TIME: Date;
+declare const START_NTP_TIME: Date;
+declare const START_GLO_LEAP: Date;
+declare const START_TAI_TIME: Date;
+declare const RINEX_CODES: HourCode[];
+declare const START_JULIAN_TAI = 2436204.5;
+declare const DAYS_MJD_JULIAN = 2400000.5;
+declare const DAYS_MJD2000_MJD = 51544.5;
+declare const START_MJD_UNIX_SECONDS = 40587;
+
+export { DAYS_MJD2000_MJD as D, type HourCode as H, MILLISECONDS_GPS_TAI as M, RINEX_CODES as R, SECONDS_IN_DAY as S, type TimeDifference as T, DAYS_MJD_JULIAN as a, MILLISECONDS_IN_DAY as b, MILLISECONDS_IN_HOUR as c, MILLISECONDS_IN_MINUTE as d, MILLISECONDS_IN_SECOND as e, MILLISECONDS_IN_WEEK as f, MILLISECONDS_TT_TAI as g, SECONDS_IN_HOUR as h, SECONDS_IN_MINUTE as i, SECONDS_IN_WEEK as j, START_BDS_TIME as k, START_GAL_TIME as l, START_GLO_LEAP as m, START_GPS_TIME as n, START_JULIAN_TAI as o, START_MJD_UNIX_SECONDS as p, START_NTP_TIME as q, START_TAI_TIME as r, START_UNIX_TIME as s };