AirTrace

About | Run and Debug | Issues | Links | seperet.com

A motion and sensor core CLI

automates:

• multi‑sensor input
• mode switching
• sensor failure/error handling

Includes a core library for motion models and sensor behavior, and a CLI/TUI for running scenarios.

Focuses: state estimation, sensor modeling, and robust fallback behavior under degraded inputs.

Built with:

Features:

Expand

• Kalman Filtering: Optimal state estimation, ensuring accurate position tracking even in noisy conditions.

• Heat Signature Detection: Integrates thermal data to enhance tracking capabilities, enabling the identification of objects based on their heat emissions.

• Predictive Algorithms: Employ quick prediction techniques to anticipate movements and improve response times in any potential scenarios.

• Dead Reckoning Failsafe: Maintains tracking integrity when GPS or thermal inputs are compromised, ensuring continuous operation through smart estimations of position.

• Real-Time and Test Modes: Easily switch between real-time tracking and a comprehensive test mode for simulations and performance evaluations, facilitating robust development and debugging.

Run and Debug

Expand

Quick commands (cross-platform):

• macOS/Linux: ./scripts/build.sh or ./scripts/run.sh
• Windows PowerShell: .\scripts\build.ps1 or .\scripts\run.ps1

TUI controls:

• Use Up/Down to move, Space or Enter to select, Esc to go back/exit.

Commands (CMake + Ninja example):

Purpose	Command
Configure	cmake -S . -B build -G Ninja -DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++
Build app + examples	cmake --build build --target AirTrace AirTraceExample AirTraceSimExample
Run main TUI	./build/AirTrace (Windows: .\build\AirTrace.exe)
Run CLI demo	./build/AirTraceExample (Windows: .\build\AirTraceExample.exe)
Run 3D sim demo	./build/AirTraceSimExample (Windows: .\build\AirTraceSimExample.exe)

Flags (sim demo):

Flag	Description	Example
CONFIG_PATH (arg 1)	Path to the sim config file	./build/AirTraceSimExample configs/sim_default.cfg

Testing:

Purpose	Command
Build only	cmake --build build
Build sim example	cmake --build build --target AirTraceSimExample

1. Clone source code or download the .zip

   • Clone: git clone https://github.com/denv3rr/AirTrace
   • cd AirTrace
   • .zip: https://github.com/denv3rr/AirTrace/archive/refs/heads/main.zip

2. Build and run (current)

   • Configure (Ninja + GCC example):

     • Make sure you have CMake (3.10+) and a compiler on PATH.
     • Configure: cmake -S . -B build -G Ninja -DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++

   • Build app + examples:

     • cmake --build build --target AirTrace AirTraceExample AirTraceSimExample

   • Run the main TUI:

     • ./build/AirTrace (Windows: .\build\AirTrace.exe)

   • Run the config-driven 3D sim demo:

     • ./build/AirTraceSimExample configs/sim_default.cfg

   • Config file location:

     • configs/sim_default.cfg

Issues

Expand

If you have any problems with anything, submit an issue to let me know.

Issues

Links

Expand

• Seperet || Seperet

• Tracker Component Library || US Naval Research Laboratory TrackerComponentLibrary

• Kalman Filter || An Introduction to the Kalman Filter - MIT

• Understanding Kalman Filters || An Introduction to the Kalman Filter - University of North Carolina

• Tutorial: The Kalman Filter || Tutorial: The Kalman Filter - MIT

• Predictive Algorithms in Motion Tracking || An Elementary Introduction to Kalman Filtering - University of Texas

• Thermal Detection || Long-Range Thermal Target Detection in Data-Limited Settings Using Restricted Receptive Fields

• Detecting Minimal Thermal Signatures || Detecting Small Size and Minimal Thermal Signature Targets in Infrared Imagery Using Biologically Inspired Vision