118 lines
7.6 KiB
Markdown
118 lines
7.6 KiB
Markdown
# 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. |