Capitolo 3: Guida all'Interfaccia Principale

L'interfaccia utente (GUI) del Radar Target Simulator è progettata per fornire un controllo centralizzato su tutte le fasi della simulazione, dalla creazione degli scenari all'analisi dei risultati. Questa sezione descrive in dettaglio ogni componente della finestra principale.

3.1. Panoramica Generale

La finestra principale è suddivisa in diverse aree funzionali, ciascuna con un ruolo specifico.

(Placeholder per l'immagine)

Descrizione dell'Immagine: panoramica_gui.png Qui ti aspetti di vedere uno screenshot a schermo intero dell'applicazione. Usa un editor di immagini per aggiungere delle etichette numerate che puntano alle seguenti sezioni:

Etichetta "1" che punta al PPI Display.
Etichetta "2" che punta al Pannello di Controllo Scenari (in alto a destra).
Etichetta "3" che punta al Pannello di Lavoro a Schede (sotto il controllo scenari).
Etichetta "4" che punta al Pannello di Connessione (sopra il PPI).
Etichetta "5" che punta al Pannello dei Log (in basso).
Etichetta "6" che punta alla Barra di Stato (in fondo).

Nota sulla nuova schermata di Profilazione

Nella barra degli strumenti principale è disponibile un collegamento alla nuova finestra External Profiler / Profiling (menu Debug e voce External Profiler... o dalla sezione Connection). Questa finestra consente di avviare il profiler esterno che monitora le porte dedicate e di aprire la configurazione dei profili target per assegnarli ai target nel Trajectory Editor.

Placeholder immagine - Layout consigliato

(Placeholder: panoramica_gui_profiling.png)

Suggerimento layout per lo screenshot:

Area centrale: PPI Display (grande) con etichette sovrapposte.
Colonna destra: Pannello di Controllo Scenari in alto e sotto l'elenco dei profili/strumenti (link rapido a External Profiler).
Barra superiore: icone di accesso rapido (Settings, Connection, External Profiler).
Barra inferiore: indicatori di stato e metriche (latency, pkt/s, uso risorse).

Consiglio: inserire lo screenshot reale dell'app e aggiungere etichette numerate che rimandino alle descrizioni nel manuale. Se preferisci, posso generare un mockup PNG da aggiungere al repository.

3.2. Il PPI Display

Il Plan Position Indicator (PPI) è il componente visivo centrale dell'applicazione.

Scopo: Fornisce una rappresentazione grafica in tempo reale dello scenario tattico, mostrando la posizione dell'ownship, dei target simulati e dei target reali ricevuti dal radar.
Caratteristiche:
- Griglia Polare: Mostra anelli di range (in miglia nautiche) e linee di azimut (in gradi).
- Controlli Radar: Permettono di cambiare il range massimo visualizzato e di attivare/disattivare l'animazione della linea di scansione dell'antenna.
- Visualizzazione antenna: L'icona e la linea di scansione dell'antenna possono essere mostrate sul PPI e sono aggiornate in base al platform azimuth fornito dallo scenario o dal server. Questo aiuta a verificare l'allineamento della scena rispetto alla direttività radar.
- Modalità di Visualizzazione: Offre le modalità North-Up e Heading-Up (vedi Capitolo 2.3 per i dettagli).
- Opzioni di Visualizzazione: Consente di mostrare/nascondere selettivamente i punti e le tracce (trail) dei target simulati e reali.
- Legenda: Identifica i simboli grafici per l'ownship, i target simulati e i target reali.

3.3. Pannello di Controllo Scenari

Questa sezione, situata in alto a destra, è dedicata alla gestione dei file di scenario.

Selettore Scenario: Un menu a tendina per caricare rapidamente uno scenario esistente. La selezione di uno scenario lo carica immediatamente nell'area di editing.
Pulsanti di Gestione:
- New...: Apre una finestra di dialogo per creare un nuovo scenario vuoto, chiedendone il nome.
- Save: Salva le modifiche correnti sovrascrivendo il file dello scenario attualmente selezionato.
- Save As...: Salva le modifiche correnti in un nuovo file di scenario, chiedendone il nome.
- Delete: Rimuove permanentemente il file dello scenario attualmente selezionato.

3.4. Pannello di Lavoro Principale (a schede)

Questo pannello a schede organizza le diverse fasi del lavoro.

3.4.1. Scheda "Editing scenario"

È l'area di lavoro predefinita per la creazione e modifica delle traiettorie. Contiene la Lista dei Target (TargetListFrame), una tabella che mostra i parametri iniziali di ogni target dello scenario corrente. Da qui è possibile:

Add: Aggiungere un nuovo target allo scenario, aprendo l'Editor di Traiettoria.
Remove: Rimuovere il target selezionato.
Edit Trajectory...: Aprire l'Editor di Traiettoria per modificare il target selezionato.

3.4.2. Scheda "Simulation"

Questa scheda contiene i controlli per l'esecuzione della simulazione in tempo reale.

(Placeholder per l'immagine)

Descrizione dell'Immagine: pannello_simulazione.png Qui ti aspetti uno screenshot che mostra in dettaglio la scheda "Simulation", evidenziando:

I pulsanti "Start Live" / "Stop Live".
Lo slider di progresso della simulazione.
La sezione "Ownship State".
La tabella "Active Targets".

Live Simulation Engine:
- Start Live / Stop Live: Pulsanti per avviare e fermare la simulazione.
- Speed / Update(s): Controlli per accelerare la simulazione e definire la frequenza di invio degli aggiornamenti al radar.
- Reset Sim: Riporta la simulazione allo stato iniziale (T=0) senza fermarla.
- Reset Radar: Invia un comando di reset al radar per cancellare tutte le tracce esistenti.
- Slider di Progresso: Mostra l'avanzamento della simulazione e permette di "cercare" (seek) un punto specifico nel tempo trascinando il cursore (solo a simulazione in pausa).
Ownship State: Un pannello di sola lettura che visualizza i dati di navigazione più recenti dell'ownship (posizione, altitudine, heading, velocità) ricevuti dal sistema reale.
Active Targets: Una tabella che, durante la simulazione, mostra i dati geografici calcolati in tempo reale per i target simulati.

3.5. Pannello di Connessione

Posizionato sopra il PPI, questo pannello gestisce la connessione con il sistema radar.

Indicatori di Stato: Mostra il tipo di connessione configurata (SFP, TFTP, Seriale) e i parametri principali (es. indirizzo IP e porte).
Settings...: Apre la finestra di configurazione dettagliata della connessione (vedi Capitolo 5).
Connect / Disconnect: Stabilisce o interrompe la comunicazione con il device under test.

3.6. Log e Barra di Stato

Pannello dei Log

Situato nella parte inferiore della finestra, visualizza i messaggi di log generati dall'applicazione. È uno strumento essenziale per il debug e per monitorare le operazioni in background. I messaggi sono colorati in base al loro livello di severità (es. INFO, WARNING, ERROR).

Barra di Stato

La barra in fondo alla finestra fornisce informazioni di stato rapide:

Indicatori di Connessione (Target/LRU): Due LED grafici (rosso per disconnesso, verde per connesso) mostrano lo stato della comunicazione.
Messaggio di Stato: Un'area di testo che mostra lo stato corrente ("Ready", "Simulation running", etc.) o messaggi temporanei.
Rate / Latency: Visualizza le metriche di comunicazione in tempo reale, come i pacchetti al secondo (pkt/s) e la latenza stimata.
Uso Risorse: Mostra l'utilizzo corrente di CPU e memoria da parte dell'applicazione.

7.6 KiB Raw Blame History