3D-GPS

Rust GPS Doppler absolute velocity algorithm library and a Dioxus Android-ready visualization app.

Workspace Layout

• gps_doppler_core: GNSS Doppler solver, filter, coordinate transforms, simulator, and trajectory recorder.
• gps_doppler_app: Dioxus mobile UI for realtime altitude, 3D velocity, track history, analysis, export, and Android bridge integration guidance.

Quick Start

Core tests

cargo test -p gps_doppler_core

Desktop preview of the Dioxus app

cargo run -p gps_doppler_app

Android development with Dioxus CLI

cargo install dioxus-cli
dx serve --platform android

The app ships with a deterministic demo GNSS source that exercises the full Doppler velocity pipeline while persisting JSONL and CSV track data for later analysis.

Android Raw GNSS Integration

The workspace now includes:

• Android JNI bridge models in gps_doppler_core::android
• JNI exports in gps_doppler_core::android_bridge for Android builds
• Java bridge stub in gps_doppler_app/android/src/main/java/com/example/gpsdoppler/RustBridge.java

You can push either raw Android GNSS measurement epochs or prebuilt observation envelopes into Rust.

For real-device ingestion, the intended runtime flow is:

1. GnssCollector gathers GnssMeasurementsEvent and Location
2. Java serializes to AndroidRawMeasurementEpoch
3. Rust queue receives raw epochs via JNI
4. A satellite-state provider resolves ephemeris into AndroidSatelliteState
5. AndroidObservationBuilderInput::try_into_epoch() builds ObservationEpoch
6. GpsDopplerEngine::process_android_builder_input() solves and records the result

Documentation

• docs/BUILD_AND_RUN.md
• docs/ANDROID_INTEGRATION.md
• docs/ARCHITECTURE.md
• docs/TROUBLESHOOTING.md
• docs/HANDOFF_CHECKLIST.md

Product UI Pages

The app is now focused on real-device workflows:

• Device diagnostics
• Real-device track history
• Real-device analysis
• Export/integration