How d33pk3rn3l/altitimematcher works
Main Components
• GUI Component: Represented by the main application (main.py) and the GUI elements built using tkinter/customtkinter. This is the user interface that provides buttons for selecting files, entering liftoff time and row index, and triggering visualizations.
• Data Handling Module: This component encompasses the logic to load and process the CSV (altimeter) and TXT (IMU) files. It includes reading the files (ensuring proper columns as expected), processing the timestamps, and saving the resulting CSV.
• Visualization Module: Embodied partly in webview_plotly.py, this is responsible for generating interactive visualizations of the altimeter heights and acceleration data via Plotly. It likely collaborates with the GUI.
• External Libraries & Dependencies: Indicate dependencies such as pandas (for data manipulation), Plotly (for visualization), tkinter/customtkinter (for GUI), and webview (for embedding web content). Python 3 is the runtime.
Relationships and Interactions
• The GUI component (main.py) serves as the entry point, handling user inputs (file selections, liftoff time/index) and then relaying these commands to the Data Handling and Visualization modules.
• The Data Handling module uses pandas to load/process files and communicates back processed data for further visualization.
• The Visualization module calls Plotly (and possibly uses webview as a container) to render charts that the GUI displays.
• Data flows from the file system (CSV and TXT file inputs) into the Data Handling module, then into the Visualization module, with processed results also being written back as a CSV output file.
• The packaging build tool (pyinstaller) is used separately to bundle everything into a standalone executable for end-users.
Architectural Patterns and Principles
• Modular Structure: The division into separate files (main.py for core application logic, webview_plotly.py for visualization) shows a clear modular separation.
• Separation of Concerns: Input handling, data processing, and visualization are distinct functional blocks.
• Dependency Management: External libraries (pandas, tkinter, plotly) are clearly identified in the requirements.txt to manage dependencies.