S1005403_RisCC/doc/user_guide/05_analizzare_risultati.md
2025-11-24 08:24:07 +01:00

54 lines
4.0 KiB
Markdown

# Capitolo 5: Analizzare i Risultati
Al termine di ogni simulazione, l'applicazione salva automaticamente un "archivio" completo della sessione. Questo archivio contiene tutti i dati necessari per analizzare le prestazioni di tracciamento del tuo sistema radar.
## 5.1. Accedere ai Report di Simulazione
1. **Vai alla Scheda "Analysis":**
* Nella finestra principale, clicca sulla scheda `Analysis` nel pannello di lavoro a destra.
2. **Visualizza le Sessioni Precedenti:**
* Troverai una tabella che elenca tutte le simulazioni che hai eseguito, ordinate dalla più recente alla più vecchia. Per ogni sessione, vengono mostrati la data, il nome dello scenario e la durata.
* Se non vedi l'ultima sessione, clicca su `Refresh List`.
3. **Apri un'Analisi:**
* Seleziona la sessione che ti interessa analizzare cliccando sulla riga corrispondente.
* Clicca sul pulsante `Analyze Selected`.
Si aprirà la finestra **Analysis Window**, che mostra un'analisi dettagliata della performance.
### 5.1.1. Caricare file di profilazione e sincronizzazione
L'`Analysis Window` permette ora di caricare non solo i file di trail/latency ma anche i file di performance generati dal sistema di profilazione (`.perf.csv`) e i report prodotti dallo `Sync Tool` (`*_sync_latency.csv`).
- **Caricare un `.perf.csv`:** usa il pulsante `Load Performance File` nella finestra di analisi. Il grafico comparativo mostrerà i tempi di parsing, hub update e altri campioni raccolti durante la sessione.
- **Caricare un report di Sync:** usa `Load Sync Report` per visualizzare il grafico RTT/offset e confrontarlo con i picchi di errore nel tracciamento.
Puoi anche caricare la cattura PCAP correlata (generata con Wireshark/dumpcap) per correlare pacchetti di rete con gli eventi applicativi usando i marker `SYNC-SEQ` o i campi `seq` presenti nei pacchetti di profiler esterni.
## 5.2. Leggere le Statistiche di Errore
La finestra di analisi ti permette di valutare quantitativamente quanto bene il tuo sistema radar ha tracciato i target simulati.
![Finestra di Analisi](<percorso/relativo/a/finestra_analisi.png>)
*(Nota: Usa lo stesso screenshot `finestra_analisi.png` del manuale tecnico)*
### Elementi Principali della Finestra
* **Select Target ID:** Se il tuo scenario aveva più di un target, puoi usare questo menu a tendina per scegliere quale analizzare.
* **Error Statistics (Statistiche di Errore):** Questa tabella è il cuore dell'analisi. Mostra l'errore calcolato come `Posizione Reale - Posizione Simulata`.
* **Mean (Errore Medio):** Ti dice se il radar tende a "essere in ritardo" o "in anticipo" rispetto al target. Un valore vicino a zero è ideale. Un valore costantemente positivo o negativo indica un *bias* sistematico.
* **RMSE (Root Mean Square Error):** È la metrica più importante per l'accuratezza generale. Misura la "distanza media" tra il target reale e quello simulato. **Più basso è questo valore, migliori sono le prestazioni di tracciamento.**
* **Error Over Time (Grafico dell'Errore):**
* Questo grafico mostra come è variato l'errore (sui tre assi X, Y, Z) durante tutta la simulazione.
* È molto utile per capire se il radar ha avuto difficoltà in momenti specifici, ad esempio durante una virata stretta del target (dove tipicamente l'errore tende ad aumentare).
### Come Interpretare i Risultati
* **Un buon tracciamento** è caratterizzato da valori di **RMSE bassi** e curve nel grafico che rimangono vicine alla linea dello zero.
* **Un errore medio (Mean) grande e negativo** potrebbe indicare che il radar è "in ritardo" nel tracciamento (il target reale è dietro a quello simulato). Questo può essere dovuto alla latenza di rete o di elaborazione.
* **Picchi nel grafico dell'errore** che corrispondono a manovre del target (es. virate) sono normali, ma un buon sistema di tracciamento dovrebbe essere in grado di ridurre rapidamente l'errore dopo la manovra.
Usando questi strumenti, puoi ottenere una valutazione quantitativa e oggettiva delle prestazioni del tuo sistema radar in diversi scenari di test.