Threats¶
Threats are managed across multiple GVA HMI displays — the DEF radar, the SA PPI overlay, and the LSAS camera strip. All threat displays share the same DDS data source and update simultaneously.
Threat Displays¶
Radar View (DEF Screen)¶
The DEF screen features a top-down radar view centred on the vehicle. Threats appear as colour-coded diamond markers positioned by bearing and range:
| Radar View | Radar Zoom |
|---|---|
![]() |
![]() |
Press F2 on the DEF screen to toggle between standard and zoomed views.
Threat Table¶
The tabular view lists all tracked battlespace objects with their hostility classification, bearing, range, and last update time:

PPI Overlay (SA Screen)¶
The SA screen PPI widget overlays threat contacts on top of the camera feed. Several PPI styles support threat display:
- Style 3 — Tactical display with threats
- Simple with Threats — Simplified threat display
- Classic with Threats — Classic style with threat contacts
- Modern with Threats — Modern style with threat contacts
See the PPI page for all available styles.
LSAS Strip Integration¶
The LSAS (Local Situational Awareness System) strip shows six live camera thumbnails in a horizontally scrollable view with a 360° direction bar. When threats are present, diamond-shaped indicators are overlaid directly onto the camera thumbnails at the corresponding bearing. This provides immediate visual correlation between camera feeds and detected threats:
- Threat diamonds are positioned vertically by range (closer = lower, further = higher)
- Colour coding matches the radar view hostility scheme
- Labels show threat identifiers (e.g. "H1", "S2") and range in metres
- Indicators update in real time as threats move
The LSAS strip is toggled with F6 on the SA screen and supports day/night mode switching via F5.
Hostility Classification¶
Threats are classified by hostility using colour-coded indicators consistent across all displays:
| Classification | Colour | Description |
|---|---|---|
| Hostile | Red | Confirmed enemy |
| Suspect | Orange | Probable enemy |
| Unknown | Yellow | Not yet classified |
| Neutral | Green | Non-combatant |
| Friendly | Blue | Allied forces |
| Pending | White | Awaiting classification |
Threat Lifecycle¶
Threats follow a DDS-driven lifecycle using the Battlespace Objects topics defined in DEF STAN 23-009 LDM:
Lifecycle Stages¶
| Stage | DDS Topic | Description |
|---|---|---|
| Detection | C_Battlespace_Object |
New object received with hostility classification |
| Tracking | C_Object_Location |
Continuous position updates; bearing and range calculated from vehicle position |
| Reclassification | C_Battlespace_Object |
Hostility updated (e.g. Unknown → Hostile) |
| Removal | C_Battlespace_Object_CP_objectDeleted |
Object removed from all displays |
ThreatManager¶
The ThreatManager class maintains the threat track table. It subscribes to the DDS Battlespace Objects topics and provides the threat data to all display widgets. Key responsibilities:
- Receiving and parsing
C_Battlespace_Objectmessages - Calculating relative bearing and range from vehicle position
- Maintaining the track table with latest position and hostility
- Notifying display widgets of updates
- Removing stale or deleted tracks
All threat displays — PPI overlay, DEF radar, threat table, and LSAS strip diamonds — update simultaneously from the same ThreatManager data source.
Related¶
- DEF — Defence screen with radar and threat table
- SA — Situational Awareness with PPI overlay
- PPI Widget — Radar overlay styles including threat variants
- Alarms — Alarm notifications for threat-related events

