@tak-ps/node-cot 14.55.0 → 14.56.0

package/CHANGELOG.md

@@ -12,6 +12,10 @@
 
 ### Pending Fixed
 
+### v14.56.0 - 2026-10-22
+
+- :bug: More closely mirror ATAK's sensor math for consistent sensor display
+
 ### v14.55.0 - 2026-10-20
 
 - :tada: Add `device` Link attribute marking a CoT as the projection of a CloudTAK Core Device

package/dist/lib/sensor.d.ts

@@ -5,5 +5,9 @@ export default class Sensor {
     center: Static<typeof Position>;
     sensor: Static<typeof SensorAttributes>;
     constructor(center: Static<typeof Position>, sensor: Static<typeof SensorAttributes>);
+    /**
+     * Ground footprint of the sensor cone, centred on the azimuth.
+     * `range` is a slant range so it is projected to the ground via the elevation
+     */
     to_geojson(): Static<typeof Polygon> | null;
 }

package/dist/lib/sensor.js

@@ -8,14 +8,23 @@ export default class Sensor {
         this.center = center;
         this.sensor = sensor;
     }
+    /**
+     * Ground footprint of the sensor cone, centred on the azimuth.
+     * `range` is a slant range so it is projected to the ground via the elevation
+     */
     to_geojson() {
         if (!this.sensor.range)
             return null;
-        if (!this.sensor.azimuth)
+        if (typeof this.sensor.azimuth !== 'number')
             return null;
         if (!this.sensor.fov)
             return null;
-        return sector(this.center, this.sensor.range / 1000, this.sensor.azimuth, this.sensor.azimuth + this.sensor.fov).geometry;
+        const elevation = this.sensor.elevation || 0;
+        const ground = this.sensor.range * Math.cos(elevation * Math.PI / 180);
+        if (ground < 1)
+            return null;
+        const half = this.sensor.fov / 2;
+        return sector(this.center, ground / 1000, this.sensor.azimuth - half, this.sensor.azimuth + half).geometry;
     }
 }
 //# sourceMappingURL=sensor.js.map

package/dist/lib/sensor.js.map

@@ -1 +1 @@
-{"version":3,"file":"sensor.js","sourceRoot":"","sources":["../../lib/sensor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,OAAO,OAAO,MAAM;IACvB,MAAM,CAA0B;IAChC,MAAM,CAAkC;IAExC,YACI,MAA+B,EAC/B,MAAuC;QAEvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED,UAAU;QACN,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QAElC,OAAO,MAAM,CACT,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,EACxB,IAAI,CAAC,MAAM,CAAC,OAAO,EACnB,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CACxC,CAAC,QAAQ,CAAC;IACf,CAAC;CACJ"}
+{"version":3,"file":"sensor.js","sourceRoot":"","sources":["../../lib/sensor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,OAAO,OAAO,MAAM;IACvB,MAAM,CAA0B;IAChC,MAAM,CAAkC;IAExC,YACI,MAA+B,EAC/B,MAAuC;QAEvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,UAAU;QACN,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACpC,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACzD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QAElC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC;QACvE,IAAI,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAE5B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;QAEjC,OAAO,MAAM,CACT,IAAI,CAAC,MAAM,EACX,MAAM,GAAG,IAAI,EACb,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,EAC1B,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,CAC7B,CAAC,QAAQ,CAAC;IACf,CAAC;CACJ"}

package/dist/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@tak-ps/node-cot",
     "type": "module",
-    "version": "14.55.0",
+    "version": "14.56.0",
     "description": "Lightweight JavaScript library for parsing and manipulating TAK messages",
     "author": "Nick Ingalls <nick@ingalls.ca>",
     "types": "index.ts",

package/lib/sensor.ts

@@ -15,16 +15,26 @@ export default class Sensor {
         this.sensor = sensor;
     }
 
+    /**
+     * Ground footprint of the sensor cone, centred on the azimuth.
+     * `range` is a slant range so it is projected to the ground via the elevation
+     */
     to_geojson(): Static<typeof Polygon> | null {
         if (!this.sensor.range) return null;
-        if (!this.sensor.azimuth) return null;
+        if (typeof this.sensor.azimuth !== 'number') return null;
         if (!this.sensor.fov) return null;
 
+        const elevation = this.sensor.elevation || 0;
+        const ground = this.sensor.range * Math.cos(elevation * Math.PI / 180);
+        if (ground < 1) return null;
+
+        const half = this.sensor.fov / 2;
+
         return sector(
             this.center,
-            this.sensor.range / 1000,
-            this.sensor.azimuth,
-            this.sensor.azimuth + this.sensor.fov,
+            ground / 1000,
+            this.sensor.azimuth - half,
+            this.sensor.azimuth + half,
         ).geometry;
     }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@tak-ps/node-cot",
     "type": "module",
-    "version": "14.55.0",
+    "version": "14.56.0",
     "description": "Lightweight JavaScript library for parsing and manipulating TAK messages",
     "author": "Nick Ingalls <nick@ingalls.ca>",
     "types": "index.ts",