Repository navigation
Draft the combined EKF/UKF/RBPF anomaly-aiding paper for ION NAVIGATION - #420
Merged
Merged
Conversation
Adds papers/anom_combined: a NAVIGATION Regular Paper draft (ION's IONconf-v2 template) that combines the ITM 2026 UKF and Pacific PNT 2026 RBPF conference papers, adds the EKF, and explicitly withdraws their results. The defects behind those results (anomaly units, radian latitude, missing free-air term, Eotvos sign, WMM in tesla, mismatched event streams, diverged baselines) were confirmed at the revisions that produced them, 4a4e3de and 4ea73af. Every number is computed from the run outputs by scripts/ (stats, tables, figures, phone-sensor mechanism), which read STRAPDOWN_DATA and are deterministic. NOTES.md lists the open items, including the unrecorded provenance of the smartphone-arm runs and where the dissertation's figures differ from the recomputed ones. No source, config or analysis code changes. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Copilot review overview
🟡 Changes recommended
The gradient calculation, reproducibility claims, and scientific interpretations need correction.
Review effort: Balanced
Findings: 1
Open (9)
Differentiate the containing bilinear cell · New Derive default data path from repository root · New Clarify ENU versus NED frame conventions · New Include state-dependent reference terms in conservatism claims · New Qualify gradient-based position bounds as directional heuristics · New Add deterministic diagnostics for reported aggregate statistics · New Correct claims about uninformative likelihoods and resampling · New Support temporal error-correlation claims with residual evidence · New Qualify reproducibility claims and verify archived configurations · New
What changed in this PR
Adds a journal-paper draft presenting corrected anomaly-aiding evaluations for strapdown-rs. Navigation code is unchanged, and no new simulations were run.
Changes:
- Combines and supersedes the earlier conference results, adding the EKF comparison.
- Adds scripts and generated tables for analyzing existing runs.
- Documents experimental limitations, provenance gaps, and rebuild instructions.
| File | Description |
|---|---|
| papers/anom_combined/tables/rbpf.tex | Paired RBPF results. |
| papers/anom_combined/tables/phone_numbers.tex | Smartphone diagnostic macros. |
| papers/anom_combined/tables/numbers.tex | Generated result macros. |
| papers/anom_combined/tables/error_model.tex | Sensor error summaries. |
| papers/anom_combined/tables/dataset.tex | Dataset statistics. |
| papers/anom_combined/tables/baselines.tex | Unaided filter results. |
| papers/anom_combined/tables/aiding.tex | Paired Kalman-filter comparisons. |
| papers/anom_combined/sections/09-availability.tex | Data and software availability. |
| papers/anom_combined/sections/08-conclusion.tex | Conclusions and future work. |
| papers/anom_combined/sections/07-discussion.tex | Interpretation and limitations. |
| papers/anom_combined/sections/06-results.tex | Results and diagnostics. |
| papers/anom_combined/sections/05-experiment.tex | Dataset and experimental design. |
| papers/anom_combined/sections/04-geophysical.tex | Anomaly and sensor models. |
| papers/anom_combined/sections/03-navigation.tex | Filter formulations and settings. |
| papers/anom_combined/sections/02-corrections.tex | Corrections to conference results. |
| papers/anom_combined/sections/01-introduction.tex | Motivation and contributions. |
| papers/anom_combined/sections/00-abstract.tex | Study summary. |
| papers/anom_combined/scripts/stats.py | Loads outputs and computes statistics. |
| papers/anom_combined/scripts/phone_mechanism.py | Computes smartphone diagnostics. |
| papers/anom_combined/scripts/build_tables.py | Generates tables and macros. |
| papers/anom_combined/scripts/build_figures.py | Generates analysis figures. |
| papers/anom_combined/references.bib | Bibliography. |
| papers/anom_combined/README.md | Layout and rebuild instructions. |
| papers/anom_combined/NOTES.md | Provenance gaps and submission tasks. |
| papers/anom_combined/main.tex | Manuscript assembly and front matter. |
| papers/anom_combined/IONconf-v2.cls | ION formatting template. |
| papers/anom_combined/.gitignore | Excludes build artifacts. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
- Differentiate the bilinear cell containing each track point for the map gradient, rather than sampling a grid-node central difference; regenerate the bound figure and emit the gradients, single-update scales and noise targets as macros (1.44 mGal/km, 6.37 nT/km). - Present noise/gradient as a directional single-update heuristic, not a localization bound or proof of the null result. - Generate the RBPF crossing-time and reported-sigma-vs-error statistics and the cross-arm sensitivity counts in scripts, with the pooling defined. - Drop the claims that the incomplete Jacobian is conservative and that an uninformative likelihood redistributes particles; tie error-correlation claims to the phone arm's heading-dependent residual, not map decorrelation. - State that the runs declare is_enu = true while the equations use NED. - Correct the RBPF particle counts (2,000 full GNSS, 1,000 otherwise, per conf/ at 2a40f1e), qualify provenance and the availability statement, and fix the 2025-06-14 description (197 fixes, 12.2 m median accuracy). - Default STRAPDOWN_DATA to the checkout's own data/ directory. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Adds papers/mems_nav_data: a Data in Brief (elsarticle) revision of the rejected MEMS-Nav data paper. It adds per-device and per-trajectory statistics computed from data/raw and data/input_real, GNSS accuracy and gravity-norm characterization, EKF/UKF/RBPF benchmark baselines, and a frank limitations section (the reference is the phone's own GNSS). scripts/build.py regenerates every table, figure and quoted number. Open items (Zenodo release, ethics and consent, mounting details, CRediT, the unverified RBPF particle count) are marked TODO in the text and listed in NOTES.md. App device identifiers are not reproduced. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.



What
Adds
papers/anom_combined/, a first complete draft of an ION NAVIGATION Regular Paper (ION'sIONconf-v2template, APA 7). It combines the ITM 2026 UKF paper and the Pacific PNT 2026 RBPF paper and adds the EKF. It is 19 pages (the limit is 20), with 8 figures and 9 tables. The PR also includes a revised data paper (see below).This PR adds only paper material. Nothing under
core/,sim/,geonav/,analysis/orconf/changes, and no new simulation runs were made.Why
The two conference papers' results do not hold. The draft therefore explicitly corrects and supersedes them (Section 2), and reports the corrected, paired evaluation from the September runs:
Reviewer notes
Conference-era defects were verified, not recalled. Each defect in Section 2 was confirmed by reading the source at the two conference-paper commits:
4a4e3de(UKF paper)4ea73af(RBPF paper)The defects: anomaly units, radian latitude, the missing free-air term, the Eötvös sign and radii, the WMM subtracted in tesla, and the geonav event stream diverging from core's. The divergence matters only for the RBPF paper: its aided runs lacked the heading update the unaided runs had.
Every number is recomputed from the run CSVs. The scripts in
scripts/readSTRAPDOWN_DATA(default: the main checkout'sdata/), andbuild_tables.pyis deterministic. The numbers match the dissertation where the dissertation is self-consistent. Where it is not,NOTES.mdlists each discrepancy; one example is the UKF α, which was 0.1 for these runs, not 1e-3.Open item, provenance:
data/output_real2(the smartphone arm) has no committed recipe, andconf/real/rbpf_*.tomlno longer parses. Regenerate that arm from a committed config before submission. This is inNOTES.md.Data paper (
papers/mems_nav_data/, commit bec1291): the rejected MEMS-Nav data paper, retargeted to Data in Brief. It adds device and trajectory statistics, GNSS-accuracy and gravity-norm characterization, and EKF/UKF/RBPF benchmark baselines.scripts/build.pyregenerates every table and figure. Author decisions (Zenodo release, consent/ethics, mounting details, CRediT) are marked TODO in the text and listed in itsNOTES.md. App device identifiers are deliberately not reproduced.Review follow-up (commit 99552a7):
2a40f1e, and the binary's revision is unverified.Build:
latexmk -pdf main.texbuilds with no undefined references or citations. Ruff check and format pass on the scripts.🤖 Generated with Claude Code