SXXXXXXX_RadarDataReader/README.md
2025-06-24 07:54:57 +02:00

57 lines
3.9 KiB
Markdown

# Radar Data Reader & Processor
A graphical utility suite built in Python for processing, converting, and analyzing proprietary radar data files.
---
### Descrizione (Italiano)
**Radar Data Reader & Processor** è un'applicazione desktop progettata per semplificare il lavoro con i dati radar. Fornisce un'interfaccia grafica intuitiva per due compiti principali:
1. **Conversione di file `.rec`**: Funge da frontend per un tool di conversione esterno in C++ (`g_reconvert.exe`), permettendo agli utenti di convertire sequenze di file di registrazione grezzi (`.rec`) in un singolo file binario processato (`.out`).
2. **Analisi ed Esportazione di file `.out`**: Permette di leggere i file `.out`, di effettuare un parsing dettagliato della loro struttura binaria, e di esportare i dati di interesse in formati standard come **CSV** e **JSON** utilizzando profili di esportazione completamente personalizzabili.
L'applicazione è pensata per ingegneri e analisti che necessitano di estrarre e visualizzare dati specifici da complessi flussi di dati radar in modo efficiente e riproducibile.
### Key Features
* **Interfaccia Grafica Intuitiva**: Basata su Tkinter, con due sezioni dedicate per la conversione e l'analisi.
* **Wrapper per Tool Esterno**: Esegue e gestisce un eseguibile C++ per la conversione dei dati, catturando l'output in tempo reale.
* **Parsing Binario Avanzato**: Legge e interpreta una complessa struttura a blocchi di file `.out` utilizzando NumPy per l'efficienza.
* **Profili di Esportazione Personalizzabili**: Un potente editor permette di creare profili per selezionare esattamente quali campi dati esportare.
* **Traduzione Dati**: Converte automaticamente i codici numerici in etichette leggibili (es. da `1` a `LPRF`) basandosi su enumerazioni predefinite.
* **Output Multi-formato**: Esporta i dati estratti in file CSV o JSON.
* **Logging Integrato**: Una console di log mostra i messaggi dall'applicazione e dal tool esterno in tempo reale.
### Technology Stack
* **Python 3**
* **Tkinter** per la GUI
* **NumPy** per la manipolazione efficiente di dati binari
---
### Description (English)
**Radar Data Reader & Processor** is a desktop application designed to streamline working with radar data. It provides an intuitive graphical user interface for two primary tasks:
1. **`.rec` File Conversion**: Acts as a frontend for an external C++ conversion tool (`g_reconvert.exe`), allowing users to convert sequences of raw recording files (`.rec`) into a single, processed binary file (`.out`).
2. **`.out` File Analysis and Export**: Allows reading `.out` files, performing a detailed parsing of their binary structure, and exporting data of interest into standard formats like **CSV** and **JSON** using fully customizable export profiles.
The application is intended for engineers and analysts who need to efficiently and reproducibly extract and view specific data from complex radar data streams.
### Key Features
* **Intuitive Graphical Interface**: Based on Tkinter, with two dedicated tabs for conversion and analysis.
* **External Tool Wrapper**: Runs and manages a C++ executable for data conversion, capturing its output in real-time.
* **Advanced Binary Parsing**: Reads and interprets a complex block-based structure of `.out` files, using NumPy for efficiency.
* **Customizable Export Profiles**: A powerful editor allows creating profiles to select exactly which data fields to export.
* **Data Translation**: Automatically converts numeric codes into human-readable labels (e.g., from `1` to `LPRF`) based on predefined enumerations.
* **Multi-format Output**: Exports extracted data to CSV or JSON files.
* **Integrated Logging**: A log console displays messages from both the application and the external tool in real-time.
### Technology Stack
* **Python 3**
* **Tkinter** for the GUI
* **NumPy** for efficient binary data manipulation