SAPIENT

The SAPIENT (Sensor Protocol Intelligent Exploitation and Network Transmission) integration connects autonomous sensor networks to Hydris. It supports sensor registration, detection reports, status monitoring, field-of-view tracking, and sensor mode tasking.

Setup

1. Open the command menu with Ctrl+K (or ⌘+K) and select Configuration
2. Find SAPIENT under Network in the sidebar
3. Select Server, Peer, or Client and click Create
4. Fill in the settings and click Apply Configuration

Connection Modes

Server

Accept inbound connections from SAPIENT sensors. The most common mode — sensors connect to Hydris directly.

Receives registrations, detection reports, and status updates from connected sensors. Sends registration acknowledgments and mode change tasks back to sensors. Supports both SAPIENT v1 and v2 ICD versions (auto-detected from the registration message).

Peer

Connect to an Apex middleware instance as a SAPIENT peer.

Same functionality as server mode, but connects outbound to existing SAPIENT middleware infrastructure rather than accepting inbound connections.

Client

Connect to a remote SAPIENT server as a fusion node. Primarily outbound.

Registers as a fusion node, watches for detection entities in Hydris and forwards them as detection reports. Sends periodic status reports every 10 seconds. Automatically reconnects after 5 seconds on disconnection.

Entity Mapping

Sensor Registration

When a sensor registers (server/peer modes), Hydris creates a device entity with ID sapient:{nodeID}. The sensor's node type is mapped to a MIL-STD-2525C symbol:

Available sensor modes from the registration are stored as a ConfigurableComponent, allowing operators to switch modes through the Hydris UI.

Detection Reports

Incoming detections are created as entities with ID sapient:{nodeID}:{objectID}. The integration handles two location formats:

• Cartesian (lat/lng): Stored directly as a geo component
• Polar (range/bearing): Stored as a pose component relative to the sensor entity, preserving the original measurement frame. For radar sensors with known position, azimuth, elevation, and slant range are computed.

Detections with an empty classification, classification type "Unknown", or confidence below 0.5 are dropped. Default expiry is 30 seconds (5 seconds for radar detections).

Status Reports

Sensor status updates map to:

Sensor Mode Tasking

When an operator changes a sensor's mode through the Hydris configuration UI, the integration detects the mismatch between the requested and reported mode and automatically sends a mode_change task to the sensor. Redundant tasks are suppressed if the sensor is already in the requested mode.

Classification Mapping

SAPIENT detection classifications are mapped to MIL-STD-2525C symbols using pattern matching: