# open-dis/open-dis-java architecture

> Architecture diagram of the GitHub repository open-dis/open-dis-java, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/open-dis/open-dis-java
- Repository: https://github.com/open-dis/open-dis-java

## Overview

Open DIS for Java is a Java implementation of the IEEE 1278 Distributed Interactive Simulation protocol. A caller creates or receives DIS PDUs; protocol-version models marshal or unmarshal their binary representation, and the utility factory selects PDU types. The library also provides dead reckoning, spatial conversions, network support, and PDU logging and replay. The tree and excerpts identify these major capabilities, but most transport and spatial implementation details were not sampled, so their internal connections are not asserted.

Main entry points: [`src/main/java/edu/nps/moves/dis/EntityStatePdu.java`](https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/dis/EntityStatePdu.java) (Entity State 6), [`src/main/java/edu/nps/moves/dis7/EntityStatePdu.java`](https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/dis7/EntityStatePdu.java) (Entity State 7), [`src/main/java/edu/nps/moves/disutil/PduFactory.java`](https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/disutil/PduFactory.java) (PDU Factory), [`src/main/java/edu/nps/moves/disutil/DisConnection.java`](https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/disutil/DisConnection.java) (DIS Connection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_protocol["DIS Protocol"]
  node_dis6["DIS 6 Models"]
  node_dis7["DIS 7 Models"]
  node_pdu["PDU Base<br/>[Pdu.java]"]
  node_entity6["Entity State 6"]
  node_entity7["Entity State 7"]
end

subgraph group_transport["PDU Transport"]
  node_factory["PDU Factory<br/>[PduFactory.java]"]
  node_stream["PDU Stream<br/>[PduStream.java]"]
  node_connection["DIS Connection<br/>[DisConnection.java]"]
end

subgraph group_motion["Motion and Spatial"]
  node_reckoner["Dead Reckoning"]
  node_reckoner6["DIS 6 Reckoner"]
  node_reckoner7["DIS 7 Reckoner"]
  node_spatial["Spatial Utilities"]
end

subgraph group_logging["PDU Logging"]
  node_logger["DIS Logger<br/>[DisLogger.java]"]
  node_writer["Log Writer<br/>[LogWriter.java]"]
  node_replay["Log Replay<br/>[LogReplay.java]"]
  node_logfiles["Log Files"]
end

node_client(("Simulation Client"))
node_network(("DIS Network"))

node_client -.->|"provides PDU bytes"| node_factory
node_factory -->|"creates PDU"| node_dis6
node_entity6 -.->|"extends base"| node_pdu
node_entity7 -.->|"uses protocol models"| node_dis7
node_reckoner6 -->|"specializes"| node_reckoner
node_reckoner7 -->|"specializes"| node_reckoner
node_entity6 -->|"supplies entity state"| node_reckoner6
node_entity7 -->|"supplies entity state"| node_reckoner7
node_logger -->|"uses writer"| node_writer
node_writer -->|"writes logs"| node_logfiles
node_replay -->|"sends PDUs"| node_network
node_logfiles -.->|"provides recorded PDUs"| node_replay
node_client -.->|"exchanges PDUs"| node_connection
node_connection -.->|"communicates"| node_network

click node_dis6 "https://github.com/open-dis/open-dis-java/tree/master/src/main/java/edu/nps/moves/dis"
click node_dis7 "https://github.com/open-dis/open-dis-java/tree/master/src/main/java/edu/nps/moves/dis7"
click node_pdu "https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/dis/Pdu.java"
click node_entity6 "https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/dis/EntityStatePdu.java"
click node_entity7 "https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/dis7/EntityStatePdu.java"
click node_factory "https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/disutil/PduFactory.java"
click node_stream "https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/disutil/PduStream.java"
click node_connection "https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/disutil/DisConnection.java"
click node_reckoner "https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/deadreckoning/AbstractDeadReckoner.java"
click node_reckoner6 "https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/deadreckoning/Dis6DeadReckoner.java"
click node_reckoner7 "https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/deadreckoning/Dis7DeadReckoner.java"
click node_spatial "https://github.com/open-dis/open-dis-java/tree/master/src/main/java/edu/nps/moves/spatial"
click node_logger "https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/logger/DisLogger.java"
click node_writer "https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/logger/LogWriter.java"
click node_replay "https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/logger/LogReplay.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dis6,node_dis7,node_pdu,node_entity6,node_entity7,node_client toneBlue
class node_factory,node_stream,node_connection toneAmber
class node_reckoner,node_reckoner6,node_reckoner7,node_spatial toneMint
class node_logger,node_writer,node_replay,node_logfiles toneRose
class node_network toneIndigo
```

## Components

### DIS Protocol

- [DIS 6 Models](https://github.com/open-dis/open-dis-java/tree/master/src/main/java/edu/nps/moves/dis): `src/main/java/edu/nps/moves/dis`
- [DIS 7 Models](https://github.com/open-dis/open-dis-java/tree/master/src/main/java/edu/nps/moves/dis7): `src/main/java/edu/nps/moves/dis7`
- [PDU Base](https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/dis/Pdu.java): `src/main/java/edu/nps/moves/dis/Pdu.java`
- [Entity State 6](https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/dis/EntityStatePdu.java): `src/main/java/edu/nps/moves/dis/EntityStatePdu.java`
- [Entity State 7](https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/dis7/EntityStatePdu.java): `src/main/java/edu/nps/moves/dis7/EntityStatePdu.java`

### PDU Transport

- [PDU Factory](https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/disutil/PduFactory.java): `src/main/java/edu/nps/moves/disutil/PduFactory.java`
- [PDU Stream](https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/disutil/PduStream.java): `src/main/java/edu/nps/moves/disutil/PduStream.java`
- [DIS Connection](https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/disutil/DisConnection.java): `src/main/java/edu/nps/moves/disutil/DisConnection.java`

### Motion and Spatial

- [Dead Reckoning](https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/deadreckoning/AbstractDeadReckoner.java): `src/main/java/edu/nps/moves/deadreckoning/AbstractDeadReckoner.java`
- [DIS 6 Reckoner](https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/deadreckoning/Dis6DeadReckoner.java): `src/main/java/edu/nps/moves/deadreckoning/Dis6DeadReckoner.java`
- [DIS 7 Reckoner](https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/deadreckoning/Dis7DeadReckoner.java): `src/main/java/edu/nps/moves/deadreckoning/Dis7DeadReckoner.java`
- [Spatial Utilities](https://github.com/open-dis/open-dis-java/tree/master/src/main/java/edu/nps/moves/spatial): `src/main/java/edu/nps/moves/spatial`

### PDU Logging

- [DIS Logger](https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/logger/DisLogger.java): `src/main/java/edu/nps/moves/logger/DisLogger.java`
- [Log Writer](https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/logger/LogWriter.java): `src/main/java/edu/nps/moves/logger/LogWriter.java`
- [Log Replay](https://github.com/open-dis/open-dis-java/blob/master/src/main/java/edu/nps/moves/logger/LogReplay.java): `src/main/java/edu/nps/moves/logger/LogReplay.java`
- **Log Files**

### Other components

- **Simulation Client**
- **DIS Network**

## Connections

- Simulation Client → PDU Factory: provides PDU bytes
- PDU Factory → DIS 6 Models: creates PDU (evidence: `src/main/java/edu/nps/moves/disutil/PduFactory.java`)
- Entity State 6 → PDU Base: extends base
- Entity State 7 → DIS 7 Models: uses protocol models
- DIS 6 Reckoner → Dead Reckoning: specializes (evidence: `src/main/java/edu/nps/moves/deadreckoning/Dis6DeadReckoner.java`)
- DIS 7 Reckoner → Dead Reckoning: specializes (evidence: `src/main/java/edu/nps/moves/deadreckoning/Dis7DeadReckoner.java`)
- Entity State 6 → DIS 6 Reckoner: supplies entity state (evidence: `src/main/java/edu/nps/moves/deadreckoning/Dis6DeadReckoner.java`)
- Entity State 7 → DIS 7 Reckoner: supplies entity state (evidence: `src/main/java/edu/nps/moves/deadreckoning/Dis7DeadReckoner.java`)
- DIS Logger → Log Writer: uses writer (evidence: `src/main/java/edu/nps/moves/logger/DisLogger.java`)
- Log Writer → Log Files: writes logs (evidence: `src/main/java/edu/nps/moves/logger/LogWriter.java`)
- Log Replay → DIS Network: sends PDUs (evidence: `src/main/java/edu/nps/moves/logger/LogReplay.java`)
- Log Files → Log Replay: provides recorded PDUs
- Simulation Client → DIS Connection: exchanges PDUs (evidence: `README.md`)
- DIS Connection → DIS Network: communicates (evidence: `README.md`)
