Illustrated C/C++ source sheets, symbol index, API relationship graph, compiler console and debug trace

LIVE AI / FLEXIBLE SENSING / FLIGHT CONTEXT

Sensoraia API

Live AI and sensing, connected to the flight.
See, listen, inspect and return supported results while airborne.

Loading...
Searching...
No Matches
lwir_analysis.h File Reference

Optional saved-image adapter combining thermal detection, pose and projection. More...

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions

int lwir_geolocate_image (const char *filename, const char *calibration_path)
 Annotate a saved thermal JPEG without recompressing its display pixels.

Detailed Description

Optional saved-image adapter combining thermal detection, pose and projection.

Compiled only in analysis builds (LWIR_ENABLE_ANALYSIS=1, see lwir_features.h); imagery-only builds contain none of this code or its static scratch storage. The adapter post-processes an LWIR JPEG that was already saved with its exact native temperature plane embedded (LWIRRAW1, or LWIRSIM1 for simulated evidence, read via lwir_container.h). It is invoked by lwircam after a capture is written and by the --geolocate command-line mode.

Pipeline: temperature plane -> lwir_detect_hotspots() (pixel candidates) -> pose parsed from the image's EXIF ImageDescription -> optional lwir_geolocation_project() -> text record appended to EXIF UserComment. Detection and projection stay separate modules so they can be reused without JPEG or flight EXIF.

Definition in file lwir_analysis.h.

Function Documentation

◆ lwir_geolocate_image()

int lwir_geolocate_image ( const char * filename,
const char * calibration_path )

Annotate a saved thermal JPEG without recompressing its display pixels.

Parameters
filenameExclusively owned image; native thermal and SENSOR02 evidence survive.
calibration_pathProjection calibration, or NULL for pixel-only results.
Returns
Zero on success, otherwise -1. Missing pose/calibration is recorded, not invented.

Serial worker adapter with its own bounded workspace. The underlying detector and projection interfaces remain usable without JPEG or flight EXIF.

The record is written to EXIF UserComment after the existing ImageDescription text and a LWIR_HOTSPOTS_V1 separator line. A record is still published (with a status= explaining why) when the thermal plane is invalid or absent, the pose is missing, calibration is missing/invalid/unverified, or nothing is detected. Coordinates appear only for status=estimated hotspots whose projection succeeds.

Warning
Not reentrant or thread-safe: all large buffers are file-scope statics. Call from one worker thread at a time.
Projection is not gated on capture timing. The record carries capture_pose_synchronized and capture_pose_uncertainty_m; consumers must reject or down-weight coordinates whose pose is not exposure-qualified (for example a host arrival timestamp).
Note
C has no exceptions; -1 is returned when the file cannot be read or rewritten, the detector rejects the plane, or the record would exceed its fixed 8192-byte buffer. errno may reflect the last failing system call but is not guaranteed to be meaningful. Failures before publishing leave the file untouched; with IMAGE_EXIF_ATOMIC_REPLACE a failed rewrite also keeps the original, whereas the in-place fallback offers no such guarantee.

Annotate a saved thermal JPEG without recompressing its display pixels.

See lwir_analysis.h for the contract. Order of evaluation:

  1. Read the embedded temperature plane: invalid -> status=invalid_native_frame; absent -> status=no_temperature_plane (both published, return value from publishing).
  2. Read pose and calibration (each may be missing without aborting).
  3. Detect hotspots, then derive a single status with precedence missing pose > missing calibration > invalid calibration > unverified calibration, finally overridden by no_hotspots.
  4. For each hotspot, report the rounded pixel, its nearest-pixel temperature and the subpixel projection input; project only when status is estimated.
    Returns
    0 when a record was published, -1 otherwise.

Definition at line 395 of file lwir_analysis.c.