105 lines
7.5 KiB
Markdown
105 lines
7.5 KiB
Markdown
## Italiano
|
|
|
|
### **Manuale Utente - Radar Data Reader & Processor**
|
|
|
|
#### **1. Introduzione**
|
|
|
|
Questo manuale fornisce una guida completa all'utilizzo dell'applicazione Radar Data Reader & Processor. L'applicazione è progettata per orchestrare un intero flusso di lavoro di analisi dei dati radar, dalla registrazione grezza all'estrazione finale dei dati, risolvendo tre problemi principali:
|
|
1. **Analisi di Volo**: Analizzare un'intera sessione di volo registrata (`.rec` files) per identificare e riassumere automaticamente i segmenti operativi significativi.
|
|
2. **Esportazione e Processamento Dati**: Estrarre dati specifici dai segmenti di volo generati (`.out` files) in formati standard (CSV, JSON) utilizzando profili di esportazione personalizzabili.
|
|
3. **Conversione Manuale**: Fornire un'interfaccia controllata per l'utility a riga di comando `g_reconvert.exe` per conversioni manuali o specifiche.
|
|
|
|
#### **2. Requisiti di Sistema**
|
|
|
|
* Un ambiente Python 3 installato.
|
|
* Le librerie Python richieste (es. `pandas`, `numpy`).
|
|
* L'eseguibile **`g_reconvert.exe`** deve essere accessibile dal sistema. L'applicazione è un wrapper e dipende da questo file per le sue funzionalità principali.
|
|
|
|
#### **3. Configurazione Iniziale**
|
|
|
|
Al primo avvio, l'applicazione crea un file `config/config.json` nella sua directory. È **fondamentale** configurare correttamente l'applicazione prima dell'uso.
|
|
|
|
1. Avvia l'applicazione.
|
|
2. Vai alla scheda **"4. REC to OUT Converter"**.
|
|
3. Clicca sul pulsante **"g_reconverter Advanced Config..."**.
|
|
4. Nella finestra che si apre, il primo campo è **"Executable Path"**. Clicca su **"Browse..."** e seleziona la posizione esatta del tuo file `g_reconvert.exe`.
|
|
5. Clicca su **"Save & Close"**.
|
|
|
|
Senza questo passaggio, nessuna delle funzionalità che dipendono da `g_reconvert.exe` (Analisi di Volo, Conversione) funzionerà.
|
|
|
|
#### **4. Guida all'Interfaccia**
|
|
|
|
L'interfaccia principale è stata riorganizzata per seguire un flusso di lavoro logico attraverso le sue schede (tab):
|
|
|
|
1. **`1. Flight Analyzer`**: Il punto di partenza. Analizza un'intera cartella di volo, riassume i segmenti e permette di esportare i dati grezzi dei segmenti di interesse.
|
|
2. **`2. Segment Processor`**: Il secondo passo. Processa in blocco i file `.out` dei segmenti esportati dalla prima tab per estrarre i dati in CSV/JSON.
|
|
3. **`3. Single OUT Processor`**: Per l'analisi dettagliata di un singolo file `.out` arbitrario.
|
|
4. **`4. REC to OUT Converter`**: Per conversioni manuali da `.rec` a `.out`.
|
|
|
|
La finestra include anche una **Log Console** per messaggi in tempo reale e una **Status Bar** per indicare lo stato corrente.
|
|
|
|
---
|
|
|
|
### **Flusso di Lavoro Principale**
|
|
|
|
#### **5. Passo 1: Analisi del Volo e Esportazione Segmenti (Tab "Flight Analyzer")**
|
|
|
|
Questa è la funzionalità principale per iniziare un'analisi.
|
|
|
|
1. **Seleziona Cartella del Volo**: Clicca su **"Browse..."** accanto a "Recordings Folder" e seleziona la cartella contenente la sequenza completa di file `.rec` del volo.
|
|
2. **Dai un Nome al Volo**: Inserisci un nome identificativo per il volo nel campo "Flight Name". Questo nome verrà usato per creare una cartella di lavoro dedicata.
|
|
3. **Avvia Analisi**: Clicca **"Start Flight Analysis"**. L'applicazione eseguirà `g_reconvert.exe` in background per analizzare tutti i file. Questo processo potrebbe richiedere del tempo.
|
|
4. **Visualizza Risultati**: Al termine, la tabella "Flight Summary & Segments" verrà popolata con un riepilogo di tutti i segmenti operativi trovati, mostrando modalità, durate e file di riferimento.
|
|
5. **Esporta Segmenti**: Seleziona uno o più segmenti dalla tabella e clicca su **"Export Selected Segment(s)"**. L'applicazione creerà una sottocartella per ogni segmento selezionato all'interno della cartella di lavoro del volo, contenente un file `.out` e altri file ausiliari (video, GPS, etc.).
|
|
|
|
#### **6. Passo 2: Processamento in Blocco dei Segmenti (Tab "Segment Processor")**
|
|
|
|
Dopo aver esportato i segmenti, questa tab permette di estrarre i dati da tutti loro in una sola operazione.
|
|
|
|
1. **Carica Segmenti**: Clicca su **"Load Exported Segments from Current Flight"**. La tabella si popolerà con i segmenti precedentemente esportati. Lo stato "Ready" indica che il segmento è pronto per il processing.
|
|
2. **Seleziona Segmenti**: Seleziona i segmenti che vuoi processare. Puoi usare i bottoni "Select All Ready" e "Select None" per velocizzare la selezione.
|
|
3. **Configura Output**:
|
|
* **Output Directory**: Scegli la cartella di destinazione finale per i tuoi file CSV e JSON.
|
|
* **Formati e Profili**: Abilita l'esportazione CSV e/o JSON spuntando le relative caselle e seleziona un **Profilo di Esportazione** per ciascuno.
|
|
* **Opzioni Aggiuntive**: Configura opzioni come la creazione di cartelle separate per ogni analisi o il formato del CSV.
|
|
4. **Avvia Processo**: Clicca su **"Process Selected Segments"**. L'applicazione analizzerà ogni file `.out` selezionato e creerà i file di dati corrispondenti nella directory di output. La barra di progresso mostrerà l'avanzamento.
|
|
|
|
---
|
|
|
|
### **Funzionalità Aggiuntive**
|
|
|
|
#### **7. Analisi di un Singolo File `.out` (Tab "Single OUT Processor")**
|
|
|
|
Questa scheda è utile per analizzare un file `.out` isolato, non necessariamente legato a un'analisi di volo completa.
|
|
|
|
1. **Seleziona File di Input**: Clicca **"Browse..."** e seleziona il file `.out` da analizzare.
|
|
2. **Configura Output**: Imposta la directory di output, il nome del file base e i profili di esportazione.
|
|
3. **Avvia Processo**: Clicca **"Process .out File"**. I dati verranno estratti secondo il profilo scelto.
|
|
|
|
#### **8. Gestione Avanzata: L'Editor dei Profili di Esportazione**
|
|
|
|
Per accedere all'editor, vai su `File -> Manage Export Profiles...`.
|
|
|
|
* **Pannello Sinistro (Profiles)**: Gestisci i profili (crea, elimina, seleziona).
|
|
* **Pannello Centrale (Available Fields)**: Visualizza tutti i campi dati estraibili. I campi `(Enum)` possono essere tradotti in formati leggibili. Seleziona un campo e usa **`>>`** per aggiungerlo.
|
|
* **Pannello Destro (Selected Fields for Profile)**: Mostra i campi del profilo corrente. Usa **`<<`** per rimuoverli e **Up/Down** per riordinarli.
|
|
* **Colonna "Translate"**: Clicca sulla cella in questa colonna per attivare/disattivare la traduzione di un valore da numerico a testuale (es. da `15` a `STT_MASTER_MODE`).
|
|
|
|
#### **9. Conversione Manuale `.rec` -> `.out` (Tab "REC to OUT Converter")**
|
|
|
|
Questa scheda offre un controllo diretto su `g_reconvert.exe` per semplici conversioni.
|
|
|
|
1. **Seleziona Input**: Scegli il primo file `.rec` e il numero di file da concatenare.
|
|
2. **Scegli Output**: Definisci la cartella di destinazione.
|
|
3. **Avvia Conversione**: Clicca **"Convert REC to OUT"**.
|
|
|
|
#### **10. Domande Frequenti (FAQ)**
|
|
|
|
* **D: Perché nessuna funzione sembra funzionare?**
|
|
* **R**: Controlla di aver impostato correttamente il percorso di `g_reconvert.exe` come descritto nella sezione "Configurazione Iniziale".
|
|
|
|
* **D: Perché un segmento nella tab "Segment Processor" appare in grigio e non è selezionabile?**
|
|
* **R**: Significa che il segmento non è stato ancora esportato (o l'esportazione non è riuscita). Torna alla tab "Flight Analyzer", seleziona quel segmento e clicca su "Export Selected Segment(s)".
|
|
|
|
* **D: Come posso aggiungere un campo che non vedo nell'albero "Available Fields"?**
|
|
* **R**: Questo richiede una modifica al codice sorgente. Dovrai definire la nuova struttura dati nel package `radar_data_reader/core/structures` e aggiornare la logica di parsing in `radar_data_reader/core/struct_parser.py`. |