gnss-js 0.1.2 → 1.0.0

package/dist/orbit.d.ts

@@ -0,0 +1,117 @@
+import { E as Ephemeris, G as GlonassEphemeris, K as KeplerEphemeris } from './nav-BAI1a9vK.js';
+import { E as EphemerisInfo } from './ephemeris-BUWzfmBy.js';
+export { e as ecefToGeodetic, g as geodeticToEcef } from './ecef-CF0uAysr.js';
+
+/**
+ * Satellite orbit computation from broadcast ephemerides.
+ * Supports GPS, Galileo, BeiDou (Keplerian) and GLONASS (Runge-Kutta).
+ */
+
+interface SatPosition {
+    prn: string;
+    x: number;
+    y: number;
+    z: number;
+}
+interface SatAzEl {
+    prn: string;
+    az: number;
+    el: number;
+    lat: number;
+    lon: number;
+    cn0?: number;
+}
+interface DopValues {
+    gdop: number;
+    pdop: number;
+    hdop: number;
+    vdop: number;
+}
+/**
+ * Compute satellite ECEF position from Keplerian ephemeris.
+ * @param eph Broadcast ephemeris
+ * @param t GPS time of week in seconds
+ */
+declare function keplerPosition(eph: KeplerEphemeris, t: number): SatPosition;
+/**
+ * Compute GLONASS satellite ECEF position.
+ * @param eph GLONASS ephemeris
+ * @param tUtc Target time as UTC seconds since Unix epoch
+ */
+declare function glonassPosition(eph: GlonassEphemeris, tUtc: number): SatPosition;
+/**
+ * Compute azimuth and elevation from receiver ECEF to satellite ECEF.
+ * @param rxX Receiver X in meters (ECEF)
+ * @param rxY Receiver Y in meters (ECEF)
+ * @param rxZ Receiver Z in meters (ECEF)
+ * @param satX Satellite X in meters (ECEF)
+ * @param satY Satellite Y in meters (ECEF)
+ * @param satZ Satellite Z in meters (ECEF)
+ * @returns {az: radians, el: radians}
+ */
+declare function ecefToAzEl(rxX: number, rxY: number, rxZ: number, satX: number, satY: number, satZ: number): {
+    az: number;
+    el: number;
+};
+/**
+ * Compute DOP values from a set of satellite az/el.
+ * @param satAzEls Array of satellite azimuth/elevation pairs (radians)
+ * @returns DOP values (GDOP, PDOP, HDOP, VDOP), or null if fewer than 4 satellites
+ */
+declare function computeDop(satAzEls: {
+    az: number;
+    el: number;
+}[]): DopValues | null;
+/**
+ * Find the best ephemeris for a given PRN at a given time.
+ * Selects the one with the closest epoch (toe/toc) to the target time.
+ * @param ephemerides Array of candidate ephemerides
+ * @param prn Satellite PRN identifier (e.g. "G01")
+ * @param timeMs Target time in Unix milliseconds
+ */
+declare function selectEphemeris(ephemerides: Ephemeris[], prn: string, timeMs: number): Ephemeris | null;
+/**
+ * Compute satellite position from ephemeris.
+ * @param eph Ephemeris record
+ * @param timeMs Target time in Unix milliseconds
+ * @returns Satellite position with ECEF coordinates in meters
+ */
+declare function computeSatPosition(eph: Ephemeris, timeMs: number): SatPosition;
+interface EpochSkyData {
+    time: number;
+    satellites: SatAzEl[];
+    dop: DopValues | null;
+}
+/**
+ * Derive evenly-spaced epoch times from an ephemeris set's toc range.
+ * @param ephs Array of ephemerides to derive the time span from
+ * @returns Array of epoch timestamps in Unix milliseconds
+ */
+declare function navTimesFromEph(ephs: Ephemeris[]): number[];
+interface SatPoint {
+    lat: number;
+    lon: number;
+    az: number;
+    el: number;
+}
+interface AllPositionsData {
+    /** All unique PRNs sorted. */
+    prns: string[];
+    /** Epoch timestamps in Unix ms. */
+    times: number[];
+    /** positions[prn][epochIdx] — null if no valid ephemeris. */
+    positions: Record<string, (SatPoint | null)[]>;
+}
+/**
+ * Compute satellite positions for ALL PRNs at all times in a single pass.
+ * Returns geodetic (lat/lon) for ground tracks and az/el for sky plot.
+ * When rxPos is provided, az/el are computed; otherwise they are 0.
+ */
+declare function computeAllPositions(ephemerides: Ephemeris[], times: number[], rxPos?: [number, number, number]): AllPositionsData;
+/**
+ * Compute current satellite az/el from live RTCM3 ephemeris data.
+ * Returns array of SatAzEl for all satellites with valid ephemeris.
+ */
+declare function computeLiveSkyPositions(ephemerides: Map<string, EphemerisInfo>, rxPos: [number, number, number], cn0Map?: Map<string, number>): SatAzEl[];
+
+export { type AllPositionsData, type DopValues, type EpochSkyData, type SatAzEl, type SatPoint, type SatPosition, computeAllPositions, computeDop, computeLiveSkyPositions, computeSatPosition, ecefToAzEl, glonassPosition, keplerPosition, navTimesFromEph, selectEphemeris };

package/dist/orbit.js

@@ -0,0 +1,29 @@
+import {
+  computeAllPositions,
+  computeDop,
+  computeLiveSkyPositions,
+  computeSatPosition,
+  ecefToAzEl,
+  glonassPosition,
+  keplerPosition,
+  navTimesFromEph,
+  selectEphemeris
+} from "./chunk-SDRRAJT5.js";
+import {
+  ecefToGeodetic,
+  geodeticToEcef
+} from "./chunk-37QNKGTC.js";
+import "./chunk-6FAL6P4G.js";
+export {
+  computeAllPositions,
+  computeDop,
+  computeLiveSkyPositions,
+  computeSatPosition,
+  ecefToAzEl,
+  ecefToGeodetic,
+  geodeticToEcef,
+  glonassPosition,
+  keplerPosition,
+  navTimesFromEph,
+  selectEphemeris
+};

package/dist/parser-JPjjFgeP.d.cts

@@ -0,0 +1,73 @@
+/**
+ * Streaming RINEX / CRX observation file parser.
+ * Supports RINEX 2.x, 3.x/4.x and Compact RINEX (Hatanaka) 1.0/3.0.
+ */
+interface RinexHeader {
+    version: number;
+    type: string;
+    satSystem: string;
+    markerName: string;
+    markerType: string;
+    observer: string;
+    agency: string;
+    receiverNumber: string;
+    receiverType: string;
+    receiverVersion: string;
+    antNumber: string;
+    antType: string;
+    approxPosition: [number, number, number] | null;
+    antDelta: [number, number, number] | null;
+    interval: number | null;
+    timeOfFirstObs: Date | null;
+    timeOfLastObs: Date | null;
+    obsTypes: Record<string, string[]>;
+    /** GLONASS frequency channel numbers. Key = slot (1-24), value = channel k (−7…+6). */
+    glonassSlots: Record<number, number>;
+    isCrx: boolean;
+    crxVersion: number;
+}
+interface EpochSummary {
+    time: number;
+    totalSats: number;
+    satsPerSystem: Record<string, number>;
+    meanSnr: number | null;
+    snrPerSystem: Record<string, number>;
+    snrPerSat: Record<string, number>;
+    /** Per-satellite per-band SNR.  Key = "PRN:band" e.g. "G01:1" → dB-Hz */
+    snrPerSatBand?: Record<string, number>;
+}
+interface RinexStats {
+    totalEpochs: number;
+    validEpochs: number;
+    duration: number | null;
+    startTime: Date | null;
+    endTime: Date | null;
+    interval: number | null;
+    uniqueSatellites: number;
+    uniqueSatsPerSystem: Record<string, number>;
+    systems: string[];
+    meanSatellites: number;
+    meanSnr: number | null;
+}
+interface RinexResult {
+    header: RinexHeader;
+    epochs: EpochSummary[];
+    stats: RinexStats;
+}
+/** Canonical constellation display order: GPS → GLONASS → Galileo → BeiDou → QZSS → NavIC → SBAS */
+declare const SYSTEM_ORDER: readonly ["G", "R", "E", "C", "J", "I", "S"];
+/** Compare two system codes (or PRNs) in canonical constellation order. */
+declare function systemCmp(a: string, b: string): number;
+declare function systemName(code: string): string;
+/** Callback invoked for each satellite observation line with all raw values. */
+type SatObsCallback = (time: number, prn: string, codes: string[], values: (number | null)[]) => void;
+interface ParseOptions {
+    onProgress?: (percent: number) => void;
+    signal?: AbortSignal;
+    onSatObs?: SatObsCallback;
+    /** Skip EpochSummary construction and setTimeout yields (for Web Worker). */
+    workerMode?: boolean;
+}
+declare function parseRinexStream(file: File, onProgress?: (percent: number) => void, signal?: AbortSignal, onSatObs?: SatObsCallback, workerMode?: boolean): Promise<RinexResult>;
+
+export { type EpochSummary as E, type ParseOptions as P, type RinexHeader as R, SYSTEM_ORDER as S, type RinexResult as a, type RinexStats as b, type SatObsCallback as c, systemName as d, parseRinexStream as p, systemCmp as s };

package/dist/parser-JPjjFgeP.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Streaming RINEX / CRX observation file parser.
+ * Supports RINEX 2.x, 3.x/4.x and Compact RINEX (Hatanaka) 1.0/3.0.
+ */
+interface RinexHeader {
+    version: number;
+    type: string;
+    satSystem: string;
+    markerName: string;
+    markerType: string;
+    observer: string;
+    agency: string;
+    receiverNumber: string;
+    receiverType: string;
+    receiverVersion: string;
+    antNumber: string;
+    antType: string;
+    approxPosition: [number, number, number] | null;
+    antDelta: [number, number, number] | null;
+    interval: number | null;
+    timeOfFirstObs: Date | null;
+    timeOfLastObs: Date | null;
+    obsTypes: Record<string, string[]>;
+    /** GLONASS frequency channel numbers. Key = slot (1-24), value = channel k (−7…+6). */
+    glonassSlots: Record<number, number>;
+    isCrx: boolean;
+    crxVersion: number;
+}
+interface EpochSummary {
+    time: number;
+    totalSats: number;
+    satsPerSystem: Record<string, number>;
+    meanSnr: number | null;
+    snrPerSystem: Record<string, number>;
+    snrPerSat: Record<string, number>;
+    /** Per-satellite per-band SNR.  Key = "PRN:band" e.g. "G01:1" → dB-Hz */
+    snrPerSatBand?: Record<string, number>;
+}
+interface RinexStats {
+    totalEpochs: number;
+    validEpochs: number;
+    duration: number | null;
+    startTime: Date | null;
+    endTime: Date | null;
+    interval: number | null;
+    uniqueSatellites: number;
+    uniqueSatsPerSystem: Record<string, number>;
+    systems: string[];
+    meanSatellites: number;
+    meanSnr: number | null;
+}
+interface RinexResult {
+    header: RinexHeader;
+    epochs: EpochSummary[];
+    stats: RinexStats;
+}
+/** Canonical constellation display order: GPS → GLONASS → Galileo → BeiDou → QZSS → NavIC → SBAS */
+declare const SYSTEM_ORDER: readonly ["G", "R", "E", "C", "J", "I", "S"];
+/** Compare two system codes (or PRNs) in canonical constellation order. */
+declare function systemCmp(a: string, b: string): number;
+declare function systemName(code: string): string;
+/** Callback invoked for each satellite observation line with all raw values. */
+type SatObsCallback = (time: number, prn: string, codes: string[], values: (number | null)[]) => void;
+interface ParseOptions {
+    onProgress?: (percent: number) => void;
+    signal?: AbortSignal;
+    onSatObs?: SatObsCallback;
+    /** Skip EpochSummary construction and setTimeout yields (for Web Worker). */
+    workerMode?: boolean;
+}
+declare function parseRinexStream(file: File, onProgress?: (percent: number) => void, signal?: AbortSignal, onSatObs?: SatObsCallback, workerMode?: boolean): Promise<RinexResult>;
+
+export { type EpochSummary as E, type ParseOptions as P, type RinexHeader as R, SYSTEM_ORDER as S, type RinexResult as a, type RinexStats as b, type SatObsCallback as c, systemName as d, parseRinexStream as p, systemCmp as s };