Skip to main content

Module debug

Module debug 

Source
Expand description

Debug information export utilities for path calculation (US7)

This module provides functions to export intermediate HMM calculation results for troubleshooting and parameter tuning.

Output files are numbered by phase:

  1. 01_emission_probabilities.geojson — Emission probabilities: links from each GNSS position to its candidate netelements with distance / heading probabilities.
  2. 02_transition_probabilities.geojson — Transition probabilities between every feasible (non-zero) candidate pair across consecutive GNSS steps.
  3. 03_viterbi_trace.geojson — Viterbi decoding trace: the netelement selected at each observation step.
  4. 04_candidate_netelements.geojson — All candidate netelements with aggregate emission probabilities and Viterbi membership flag.
  5. 05_path_sanity_decisions.geojson — Post-Viterbi navigability sanity check decisions for each consecutive segment pair.
  6. 06_filling_gaps.geojson — Gap-fill decisions: bridge netelements inserted between disconnected consecutive segments after sanity validation.
  7. 07_selected_path.geojson — Only the netelements that form the final validated path (including bridge segments).

Functions§

export_all_debug_info
Export all HMM debug information to numbered GeoJSON files (T158)
export_gap_fills
Export gap-fill records to a GeoJSON file (phase 6).
export_hmm_candidate_netelements
Export Phase 4 – All candidate netelements with aggregate probabilities as GeoJSON
export_hmm_emission_probabilities
Export Phase 1 – HMM emission probabilities as GeoJSON
export_hmm_selected_path
Export Phase 5 – Selected Viterbi path netelements as GeoJSON
export_hmm_transition_probabilities
Export Phase 2 – HMM transition probabilities as GeoJSON
export_hmm_viterbi_trace
Export Phase 3 – Viterbi decoding trace as GeoJSON
export_path_sanity_decisions
Export Phase 5 — Post-Viterbi path sanity decisions as GeoJSON