How marcle-bert26-ui/fs-telemetry works
EIGSI Formula Student Telemetry is a desktop and console system for acquiring vehicle telemetry, recording it, replaying runs, and analyzing them. The principal GUI workflow starts in the live or replay mode, reads serial or CSV data, parses and manages telemetry, then updates displays and visualizations; live data is also logged to CSV. The README documents GPS track mapping and fuel analysis alongside charts and G-force views. Some visualization wiring is documented rather than visible in sampled source, so those edges cite the README; other unsampled details are omitted.
Main entry points: live_mode_widget.py Live mode · main.py Console workflow · replay_mode_widget.py Replay mode · main_window.py Main window
Components 19
Application entry
- GUI launcher
src/gui_app.py - Console workflow
src/main.py
Acquisition and data
- Serial source
src/sources/serial_source.py - CSV source
src/data/csv_source.py - Telemetry parser
src/data/csv_parser.py - Telemetry manager
src/core/telemetry_manager.py - CSV logger
src/data/csv_logger.py
Desktop experience
- Main window
src/gui/main_window.py - Live mode
src/gui/live_mode_widget.py - Replay mode
src/gui/replay_mode_widget.py - File selector
src/gui/file_selector_widget.py
Analysis and visualization
- Telemetry charts
src/visualization/telemetry_charts.py - Temporal analysis
src/gui/temporal_analysis_widget.py - G-force spider
src/visualization/spider_charts.py - GPS track map
visualization/track_map.py - Fuel injection data
tools/ecu_injection_table.py - Console display
src/utils/console_display.py
Other components
- Vehicle operator
- Arduino / serial
Connections 30
- Vehicle operator → GUI launcher: launches
- GUI launcher → Main window: opens
src/gui_app.py - Vehicle operator → Main window: uses
- Main window → Live mode: hosts
src/gui/main_window.py - Main window → Replay mode: hosts
src/gui/main_window.py - Main window → File selector: hosts
src/gui/main_window.py - Arduino / serial → Serial source: sends telemetry
src/sources/serial_source.py - Live mode → Serial source: reads
src/gui/live_mode_widget.py - Live mode → Telemetry parser: parses
src/gui/live_mode_widget.py - Live mode → Telemetry manager: updates
src/gui/live_mode_widget.py - Live mode → CSV logger: logs data
src/gui/live_mode_widget.py - Live mode → Telemetry charts: updates
src/gui/live_mode_widget.py - Live mode → Temporal analysis: updates
src/gui/live_mode_widget.py - Live mode → GPS track map: shows position
- Replay mode → File selector: selects file
src/gui/replay_mode_widget.py - Replay mode → CSV source: reads run
src/gui/replay_mode_widget.py - Replay mode → Telemetry parser: parses
src/gui/replay_mode_widget.py - Replay mode → Telemetry manager: updates
src/gui/replay_mode_widget.py - Replay mode → Telemetry charts: updates
src/gui/replay_mode_widget.py - Replay mode → Temporal analysis: updates
src/gui/replay_mode_widget.py - Temporal analysis → G-force spider: displays forces
src/gui/temporal_analysis_widget.py - Temporal analysis → GPS track map: displays trajectory
- Telemetry charts → Fuel injection data: uses fuel data
src/visualization/telemetry_charts.py - Vehicle operator → Console workflow: runs
- Console workflow → Serial source: reads live data
src/main.py - Console workflow → CSV source: reads replay
src/main.py - Console workflow → Telemetry parser: parses
src/main.py - Console workflow → Telemetry manager: updates
src/main.py - Console workflow → CSV logger: logs live data
src/main.py - Console workflow → Console display: displays data
src/main.py