# 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:* 1. *Etichetta "1" che punta al **PPI Display**.* 2. *Etichetta "2" che punta al **Pannello di Controllo Scenari** (in alto a destra).* 3. *Etichetta "3" che punta al **Pannello di Lavoro a Schede** (sotto il controllo scenari).* 4. *Etichetta "4" che punta al **Pannello di Connessione** (sopra il PPI).* 5. *Etichetta "5" che punta al **Pannello dei Log** (in basso).* 6. *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:* 1. *I pulsanti "Start Live" / "Stop Live".* 2. *Lo slider di progresso della simulazione.* 3. *La sezione "Ownship State".* 4. *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.