Vinayak Nair/ AEROSPACE

Home / Projects / GHOST-X

Active engineering baselineHardware + controlled software truth + SIL

GHOST-X

TARGET ESTIMATION · VISUAL OCCLUSION · ROS 2 · RASPBERRY PI · GNC SIL

GHOST-X propagates target state and uncertainty through visual occlusion, reports prediction-only status, and reacquires measurements when visibility returns. Hardware behavior and software-truth accuracy are reported separately.

Illustration representing the GHOST-X target-estimation problem through visual occlusion.

01Results you can inspect

These are repository-generated plots, not decorative mockups. Each caption states whether the evidence came from the Raspberry Pi hardware campaign, deterministic analytic software truth or runtime characterization.

Hardware2.451 sMeasured vision gap
Software truth24/24Controlled-truth trials
Fault injection12/12Declared software cases
Runtime limit11/12Timing maxima below 33.333 ms
Evidence snapshot: ghost-x-v1.0.0 / 1784548Pinned sourceFull results report
Plot of guided hardware range response showing closer and farther holds relative to the center baseline.
Raspberry Pi hardware

Directional range response

The closer retest produced 32 valid hold samples and a −0.344 m change from its run-specific center baseline; the farther hold produced 89 samples and a +0.249 m change. This establishes direction, not metrology-grade position truth.

Open source plot
Log-scale comparison of first-reacquisition proxy error for last-seen hold, GHOST-MH and constant velocity during one hardware dropout.
Raspberry Pi hardware

Short-dropout reacquisition

A 2.451 s vision gap reacquired without reset inside the configured 3.0 s envelope. GHOST-MH beat constant velocity in this stationary-target proxy, but the simpler last-seen hold was best; universal superiority is not supported.

Open source plot
Controlled-truth RMSE comparison across target estimators on 24 deterministic analytic-truth trials.
Deterministic software truth

Estimator RMSE

Across 24 accepted trials in eight scenario families, the formal IMM recorded 0.0344 m overall and 0.1305 m hidden-step RMSE. These are frozen analytic-truth results, not physical camera accuracy.

Open source plot
Detection and recovery time chart for 12 deterministic software fault-injection cases.
Software fault injection

Fault handling

All 12 deterministic cases passed their declared detection, isolation, explicit-status and recovery checks, with no non-finite outputs. The campaign verifies software response paths; it is not physical fault qualification.

Open source plot
Raspberry Pi estimator p99 and maximum execution times compared with a 33.333 millisecond deadline.
Runtime limit retained

Deadline evidence

Eleven of 12 measured maximum-execution rows were below 33.333 ms; one C++ constant-velocity maximum was not. Broader publication and latency bounds also missed, so GHOST-X makes no hard-real-time claim.

Open source plot
Numerical equivalence comparison between C++ and Python estimator outputs across 24 frozen trials.
Pinned implementation check

C++ / Python equivalence

Across 24 frozen trials, maximum elementwise state and covariance differences stayed below the declared 1e−10 tolerance. This demonstrates implementation agreement for pinned inputs, not physical model accuracy.

Open source plot

02Problem

A camera-based tracker has an abrupt failure mode: the target disappears behind an obstruction and the measurement stream becomes empty. A useful estimator must distinguish measurement-backed tracking from prediction, propagate uncertainty honestly while hidden, and reacquire without pretending that a software prediction is a physical measurement.

GHOST-X focuses on relative target-state estimation under that condition. It is not presented as a general VIO/SLAM system or a flight-qualified navigation solution.

03Current architecture

The published target-estimation path uses a formal Interacting Multiple Model (IMM) estimator alongside a bounded GHOST-MH comparison architecture. AprilTag pose measurements enter the target-estimation path; the estimators expose state, covariance or ranked hypotheses, measurement age and dropout context.

Important distinction

The repository also contains a portable C++ attitude ESKF and CV/CTRV filter components. Those are supporting components. The attitude ESKF is not the headline target tracker used to summarize the current published target-estimation results.

LayerRoleEvidence type
Camera / AprilTagRelative pose measurementsRaspberry Pi hardware
Formal IMMProbabilistic model mixing for target stateDeterministic software truth + replay
GHOST-MHBounded comparison / alternative futuresDeterministic comparison + hardware replay
GNC supervisorTRACKING / PREDICTION / SAFE_HOLD behaviorClosed-loop SIL

04Validation tiers

HARDWARE

Raspberry Pi + USB camera + AprilTag measurements with simultaneous estimator output and real measurement gaps. This demonstrates execution, directional response, dropout and reacquisition behavior.

SOFTWARE TRUTH

Frozen deterministic scenarios provide known analytic truth so estimator error and consistency can be evaluated without presenting those numbers as physical accuracy.

SIL

The estimator is placed inside a relative-standoff guidance/control loop with actuator and follower dynamics plus a prediction/safe-hold supervisor.

The separation is deliberate: a millimeter-scale SIL final error is a software result, not evidence that the physical camera system is millimeter accurate.

05What is verified

Tests10/10C++ mathematical tests
Tests38/38GHOST-X Python tests
Evidence gates47/47Replay and evidence checks
Traceability34/34Requirements traced
  • Public result generation is reproducible from source-backed artifacts.
  • Deterministic replay compares estimator behavior against controlled truth.
  • Closed-loop SIL exercises nominal, temporary-dropout and longer-dropout/safe-hold behavior.
  • Release evidence is packaged with machine-readable provenance and SHA-256 integrity records.

The source repository remains the authority if the implementation evolves beyond this release snapshot.

06Negative results retained

The project keeps cases that weaken the headline rather than deleting them. A stationary-hold baseline beat GHOST-MH in one guided hardware dropout condition, some trial attempts were rejected, and some runtime or validation targets were not met. Those results are useful because they identify where estimator complexity is and is not justified.

These results define when added estimator complexity is justified and which regressions the test gates should catch.

07Claim boundary

Demonstrated
  • Raspberry Pi / ROS 2 measurement and estimator pipeline
  • Target prediction through real measurement loss
  • Deterministic estimator evaluation on controlled truth
  • Closed-loop software-in-the-loop GNC behavior
  • Reproducible replay, regression and evidence packaging
Not claimed
  • Metrology-grade physical accuracy
  • Universal superiority of one tracker
  • General object tracking beyond the declared measurement setup
  • VIO / SLAM
  • PX4 flight integration or autonomous flight qualification
  • Hard-real-time or certification claims

08What this project demonstrates

Estimation: state/covariance reasoning, multiple-model estimation, dropout/reacquisition and observability questions.

GNC integration: putting an estimator inside a closed loop rather than evaluating it only in isolation.

Verification: deterministic truth, regression, replay and explicit failure cases.

Engineering judgment: separating hardware validation from software verification and refusing to upgrade claims when the evidence does not support them.