# msancheznet/dtnsim architecture

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

- Interactive diagram: https://gitdiagram.com/msancheznet/dtnsim
- Repository: https://github.com/msancheznet/dtnsim

## Overview

DtnSim is a configurable discrete-event simulator for delay-tolerant networks. The principal workflow parses a scenario, initializes its simulated network, runs events such as bundle generation, routing, queuing and transmission over time-varying links, then finalizes results. The graph preserves major network and analysis subsystems visible in the tree. Runtime links not established by the excerpts or explicit README statements are marked dashed and unverified; the README itself provides little product detail.

Main entry points: [`simulator/environments/DtnSimEnvironment.py`](https://github.com/msancheznet/dtnsim/blob/master/simulator/environments/DtnSimEnvironment.py) (Simulation environment), [`simulator/nodes/DtnNode.py`](https://github.com/msancheznet/dtnsim/blob/master/simulator/nodes/DtnNode.py) (Network nodes), [`bin/main.py`](https://github.com/msancheznet/dtnsim/blob/master/bin/main.py) (Run entry point), [`simulator/core/DtnBundle.py`](https://github.com/msancheznet/dtnsim/blob/master/simulator/core/DtnBundle.py) (Bundles and queues)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Scenario setup"]
  node_cli["Run entry point<br/>[main.py]"]
  node_args["Argument parsing"]
  node_config["Config parsing<br/>[DtnConfigParser.py]"]
  node_parsers["Scenario parsers"]
  node_io["Scenario I/O<br/>[DtnIO.py]"]
end

subgraph group_runtime["Simulation runtime"]
  node_env["Simulation environment"]
  node_core["Event simulation core<br/>[DtnCore.py]"]
  node_bundles["Bundles and queues<br/>[DtnBundle.py]"]
  node_generators["Traffic generators"]
  node_utils["Runtime utilities<br/>[DtnUtils.py]"]
end

subgraph group_network["Network behavior"]
  node_nodes["Network nodes<br/>[DtnNode.py]"]
  node_routers["Routing strategies"]
  node_mobility["Mobility models"]
  node_connections["Link connections"]
  node_radios["Radio models"]
  node_ducts["Convergence ducts"]
  node_endpoints["Bundle endpoints"]
end

subgraph group_analysis["Results and analysis"]
  node_reports["Simulation reports"]
end

node_user(("Simulator user"))

node_user -.->|"starts run"| node_cli
node_cli -->|"parses arguments"| node_args
node_cli -->|"parses configuration"| node_config
node_cli -->|"creates and runs"| node_env
node_config -->|"dispatches parsing"| node_parsers
node_env -.->|"runs events"| node_core
node_env -->|"initializes nodes"| node_nodes
node_env -->|"initializes links"| node_connections
node_env -->|"initializes models"| node_mobility
node_env -.->|"finalizes results"| node_reports
node_nodes -.->|"initializes router"| node_routers
node_nodes -.->|"initializes ducts"| node_ducts
node_nodes -.->|"configures endpoints"| node_endpoints
node_nodes -.->|"configures radios"| node_radios
node_generators -->|"creates bundles"| node_bundles
node_routers -->|"loads route schedules"| node_io
node_nodes -->|"queues bundles"| node_bundles
node_nodes -->|"sends on links"| node_connections
node_ducts -->|"segments transfers"| node_bundles
node_connections -.->|"coordinates access"| node_radios
node_env -->|"uses utilities"| node_utils
node_core -->|"supports simulation"| node_bundles

click node_cli "https://github.com/msancheznet/dtnsim/blob/master/bin/main.py"
click node_args "https://github.com/msancheznet/dtnsim/blob/master/simulator/utils/DtnArgumentParser.py"
click node_config "https://github.com/msancheznet/dtnsim/blob/master/simulator/utils/DtnConfigParser.py"
click node_parsers "https://github.com/msancheznet/dtnsim/tree/master/simulator/parsers"
click node_io "https://github.com/msancheznet/dtnsim/blob/master/simulator/utils/DtnIO.py"
click node_env "https://github.com/msancheznet/dtnsim/blob/master/simulator/environments/DtnSimEnvironment.py"
click node_core "https://github.com/msancheznet/dtnsim/blob/master/simulator/core/DtnCore.py"
click node_bundles "https://github.com/msancheznet/dtnsim/blob/master/simulator/core/DtnBundle.py"
click node_generators "https://github.com/msancheznet/dtnsim/tree/master/simulator/generators"
click node_nodes "https://github.com/msancheznet/dtnsim/blob/master/simulator/nodes/DtnNode.py"
click node_routers "https://github.com/msancheznet/dtnsim/tree/master/simulator/routers"
click node_mobility "https://github.com/msancheznet/dtnsim/tree/master/simulator/mobility_models"
click node_connections "https://github.com/msancheznet/dtnsim/tree/master/simulator/connections"
click node_radios "https://github.com/msancheznet/dtnsim/tree/master/simulator/radios"
click node_ducts "https://github.com/msancheznet/dtnsim/tree/master/simulator/ducts"
click node_endpoints "https://github.com/msancheznet/dtnsim/tree/master/simulator/endpoints"
click node_reports "https://github.com/msancheznet/dtnsim/tree/master/simulator/reports"
click node_utils "https://github.com/msancheznet/dtnsim/blob/master/simulator/utils/DtnUtils.py"

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_cli,node_args,node_config,node_parsers,node_io,node_user toneBlue
class node_env,node_core,node_bundles,node_generators,node_utils toneAmber
class node_nodes,node_routers,node_mobility,node_connections,node_radios,node_ducts,node_endpoints toneMint
class node_reports toneRose
```

## Components

### Scenario setup

- [Run entry point](https://github.com/msancheznet/dtnsim/blob/master/bin/main.py): `bin/main.py`
- [Argument parsing](https://github.com/msancheznet/dtnsim/blob/master/simulator/utils/DtnArgumentParser.py): `simulator/utils/DtnArgumentParser.py`
- [Config parsing](https://github.com/msancheznet/dtnsim/blob/master/simulator/utils/DtnConfigParser.py): `simulator/utils/DtnConfigParser.py`
- [Scenario parsers](https://github.com/msancheznet/dtnsim/tree/master/simulator/parsers): `simulator/parsers`
- [Scenario I/O](https://github.com/msancheznet/dtnsim/blob/master/simulator/utils/DtnIO.py): `simulator/utils/DtnIO.py`

### Simulation runtime

- [Simulation environment](https://github.com/msancheznet/dtnsim/blob/master/simulator/environments/DtnSimEnvironment.py): `simulator/environments/DtnSimEnvironment.py`
- [Event simulation core](https://github.com/msancheznet/dtnsim/blob/master/simulator/core/DtnCore.py): `simulator/core/DtnCore.py`
- [Bundles and queues](https://github.com/msancheznet/dtnsim/blob/master/simulator/core/DtnBundle.py): `simulator/core/DtnBundle.py`
- [Traffic generators](https://github.com/msancheznet/dtnsim/tree/master/simulator/generators): `simulator/generators`
- [Runtime utilities](https://github.com/msancheznet/dtnsim/blob/master/simulator/utils/DtnUtils.py): `simulator/utils/DtnUtils.py`

### Network behavior

- [Network nodes](https://github.com/msancheznet/dtnsim/blob/master/simulator/nodes/DtnNode.py): `simulator/nodes/DtnNode.py`
- [Routing strategies](https://github.com/msancheznet/dtnsim/tree/master/simulator/routers): `simulator/routers`
- [Mobility models](https://github.com/msancheznet/dtnsim/tree/master/simulator/mobility_models): `simulator/mobility_models`
- [Link connections](https://github.com/msancheznet/dtnsim/tree/master/simulator/connections): `simulator/connections`
- [Radio models](https://github.com/msancheznet/dtnsim/tree/master/simulator/radios): `simulator/radios`
- [Convergence ducts](https://github.com/msancheznet/dtnsim/tree/master/simulator/ducts): `simulator/ducts`
- [Bundle endpoints](https://github.com/msancheznet/dtnsim/tree/master/simulator/endpoints): `simulator/endpoints`

### Results and analysis

- [Simulation reports](https://github.com/msancheznet/dtnsim/tree/master/simulator/reports): `simulator/reports`

### Other components

- **Simulator user**

## Connections

- Simulator user → Run entry point: starts run
- Run entry point → Argument parsing: parses arguments (evidence: `bin/main.py`)
- Run entry point → Config parsing: parses configuration (evidence: `bin/main.py`)
- Run entry point → Simulation environment: creates and runs (evidence: `bin/main.py`)
- Config parsing → Scenario parsers: dispatches parsing (evidence: `simulator/utils/DtnConfigParser.py`)
- Simulation environment → Event simulation core: runs events
- Simulation environment → Network nodes: initializes nodes (evidence: `simulator/environments/DtnSimEnvironment.py`)
- Simulation environment → Link connections: initializes links (evidence: `simulator/environments/DtnSimEnvironment.py`)
- Simulation environment → Mobility models: initializes models (evidence: `simulator/environments/DtnSimEnvironment.py`)
- Simulation environment → Simulation reports: finalizes results
- Network nodes → Routing strategies: initializes router
- Network nodes → Convergence ducts: initializes ducts
- Network nodes → Bundle endpoints: configures endpoints
- Network nodes → Radio models: configures radios
- Traffic generators → Bundles and queues: creates bundles (evidence: `simulator/generators/DtnMarkovBundleGenerator.py`)
- Routing strategies → Scenario I/O: loads route schedules (evidence: `simulator/routers/DtnLookupRouter.py`)
- Network nodes → Bundles and queues: queues bundles
- Network nodes → Link connections: sends on links
- Convergence ducts → Bundles and queues: segments transfers (evidence: `simulator/ducts/inducts/DtnInductMBLTP.py`)
- Link connections → Radio models: coordinates access
- Simulation environment → Runtime utilities: uses utilities (evidence: `simulator/environments/DtnSimEnvironment.py`)
- Event simulation core → Bundles and queues: supports simulation (evidence: `simulator/core/DtnBundle.py`)
