@saber-usa/node-common 1.7.40 → 1.7.41-alpha.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saber-usa/node-common",
-  "version": "1.7.40",
+  "version": "1.7.41-alpha.1",
   "description": "Common node functions for Saber",
   "main": "src/index.js",
   "type": "module",

package/src/udl.js

@@ -11,12 +11,162 @@ import {
     azElToRaDec,
     raDecToGeodetic,
     estimateSlantRange,
+    getResiduals,
 } from "./astro.js";
 import {REGIMES, MU} from "./constants.js";
 import {lowerCaseObjectKeys, jsonArrayOrNull} from "./transform.js";
 import {isDefined} from "./utils.js";
 import _ from "lodash";
 
+/**
+ * Resolves the sensor id for a UDL observation, preferring idSensor and
+ * falling back to origSensorId.
+ * @param {Object} ob UDL observation row
+ * @return {String|null} resolved sensor id
+ */
+const getSensorId = (ob) => ob.idSensor ?? ob.origSensorId ?? null;
+
+const getObsSatno = (udlRow) => udlRow.idOnOrbit ?? udlRow.origObjectId ?? null;
+
+/**
+ * Converts a UDL EOObservation row to NPS EoObs (PascalCase keys).
+ * Callers that insert via ingest should wrap with lowerCaseObjectKeys.
+ * @param {Object} udlRow
+ * @param {Object} tles - satNo → TLE map (empty skips residuals)
+ * @param {Object} log - logger with .error
+ * @return {Object}
+ */
+const udlToNpsObs = (udlRow, tles = {}, log = console) => {
+    const satno = getObsSatno(udlRow);
+    const sensorId = getSensorId(udlRow);
+    let result = {
+        IdUdl: get(udlRow, "id", null),
+        ObTime: get(udlRow, "obTime", null),
+        IdSensor: sensorId,
+        SatNo: satno,
+        TrackId: get(udlRow, "trackId", null),
+        Uct: get(udlRow, "uct", null),
+        Azimuth: get(udlRow, "azimuth", null),
+        AzimuthRate: get(udlRow, "azimuthRate", null),
+        AzimuthUnc: get(udlRow, "azimuthUnc", null),
+        Elevation: get(udlRow, "elevation", null),
+        ElevationRate: get(udlRow, "elevationRate", null),
+        ElevationUnc: get(udlRow, "elevationUnc", null),
+        Range: get(udlRow, "range", null),
+        Ra: get(udlRow, "ra", null),
+        Dec: get(udlRow, "declination", null),
+        SenLat: get(udlRow, "senlat", null),
+        SenLon: get(udlRow, "senlon", null),
+        SenAlt: get(udlRow, "senalt", null),
+        SenX: get(udlRow, "senx", null),
+        SenY: get(udlRow, "seny", null),
+        SenZ: get(udlRow, "senz", null),
+        Mag: get(udlRow, "mag", null),
+        MagUnc: get(udlRow, "magUnc", null),
+        LosUnc: get(udlRow, "losUnc", null),
+        GeoLat: get(udlRow, "geolat", null),
+        GeoLon: get(udlRow, "geolon", null),
+        GeoAlt: get(udlRow, "geoalt", null),
+        GeoRange: get(udlRow, "georange", null),
+        SolarPhaseAngle: get(udlRow, "solarPhaseAngle", null),
+        SolarEqPhaseAngle: get(udlRow, "solarEqPhaseAngle", null),
+        SolarDecAngle: get(udlRow, "solarDecAngle", null),
+        ExpDuration: get(udlRow, "expDuration", null),
+        ShutterDelay: get(udlRow, "shutterDelay", null),
+        Source: get(udlRow, "source", null),
+        DataMode: get(udlRow, "dataMode", null),
+        Type: get(udlRow, "type", null),
+        AzimuthBias: get(udlRow, "azimuthBias", null),
+        ElevationBias: get(udlRow, "elevationBias", null),
+        RangeUnc: get(udlRow, "rangeUnc", null),
+        RangeBias: get(udlRow, "rangeBias", null),
+        RangeRate: get(udlRow, "rangeRate", null),
+        RangeRateUnc: get(udlRow, "rangeRateUnc", null),
+        RaUnc: get(udlRow, "raUnc", null),
+        RaBias: get(udlRow, "raBias", null),
+        RaRate: get(udlRow, "raRate", null),
+        DeclinationUnc: get(udlRow, "declinationUnc", null),
+        DeclinationBias: get(udlRow, "declinationBias", null),
+        DeclinationRate: get(udlRow, "declinationRate", null),
+        TimingBias: get(udlRow, "timingBias", null),
+        ReferenceFrame: get(udlRow, "referenceFrame", null),
+        SenReferenceFrame: get(udlRow, "senReferenceFrame", null),
+        CreatedAt: fixDate(get(udlRow, "createdAt", null)),
+    };
+
+    try {
+        result = enrichUdlFields({...result});
+        const tle = tles[satno];
+        const residuals = tle ? getResiduals([{...result}], tle) : null;
+        const first = residuals?.[0];
+        result.ElevationResidual = first?.ElErr ?? null;
+        result.AzimuthResidual = first?.AzErr ?? null;
+    } catch (e) {
+        log.error("Error enriching UDL fields: ", e);
+    }
+
+    return result;
+};
+
+/**
+ * Converts a UDL RadarObservation row to NPS RadarObs (PascalCase keys).
+ * Sen* come from the sensors map only (not the UDL row).
+ * Callers that insert via ingest should wrap with lowerCaseObjectKeys.
+ * @param {Object} udlRow
+ * @param {Object} tles
+ * @param {Object} sensors - idSensor → {latitude, longitude, altitude}
+ * @param {Object} log
+ * @return {Object}
+ */
+const udlToRadarObs = (udlRow, tles = {}, sensors = {}, log = console) => {
+    const satno = getObsSatno(udlRow);
+    const sensorId = getSensorId(udlRow);
+    const sensor = sensors[sensorId];
+
+    let result = {
+        IdUdl: get(udlRow, "id", null),
+        ObTime: get(udlRow, "obTime", null),
+        IdSensor: sensorId,
+        SatNo: satno,
+        TrackId: get(udlRow, "trackId", null),
+        Uct: get(udlRow, "uct", null),
+        Azimuth: get(udlRow, "azimuth", null),
+        AzimuthUnc: get(udlRow, "azimuthUnc", null),
+        Elevation: get(udlRow, "elevation", null),
+        ElevationUnc: get(udlRow, "elevationUnc", null),
+        Ra: get(udlRow, "ra", null),
+        Dec: get(udlRow, "declination", null),
+        Range: get(udlRow, "range", null),
+        RangeUnc: get(udlRow, "rangeUnc", null),
+        RangeRate: get(udlRow, "rangeRate", null),
+        RangeRateUnc: get(udlRow, "rangeRateUnc", null),
+        Doppler: get(udlRow, "doppler", null),
+        DopplerUnc: get(udlRow, "dopplerUnc", null),
+        Rcs: get(udlRow, "rcs", null),
+        Snr: get(udlRow, "snr", null),
+        Beam: get(udlRow, "beam", null),
+        SenLat: sensor ? sensor.latitude : null,
+        SenLon: sensor ? sensor.longitude : null,
+        SenAlt: sensor ? sensor.altitude : null,
+        Source: get(udlRow, "source", null),
+        DataMode: get(udlRow, "dataMode", null),
+        Type: get(udlRow, "type", null),
+        CreatedAt: fixDate(get(udlRow, "createdAt", null)),
+    };
+
+    try {
+        result = enrichUdlFields({...result});
+        const tle = tles[satno];
+        const residuals = tle && sensor ? getResiduals([{...result}], tle) : null;
+        const first = residuals?.[0];
+        result.ElevationResidual = first?.ElErr ?? null;
+        result.AzimuthResidual = first?.AzErr ?? null;
+    } catch (e) {
+        log.error("Error enriching UDL fields: ", e);
+    }
+    return result;
+};
+
 const udlToNpsElset = (udlRow) => {
     let derivedElset;
     try {
@@ -420,4 +570,13 @@ const udlToNpsState = (udlRow) => {
     return npsState;
 };
 
-export {udlToNpsElset, udlToNpsGroundSite, udlToNpsConjunction, udlToNpsState, enrichUdlFields};
+export {
+    udlToNpsElset,
+    udlToNpsGroundSite,
+    udlToNpsConjunction,
+    udlToNpsState,
+    enrichUdlFields,
+    getSensorId,
+    udlToNpsObs,
+    udlToRadarObs,
+};