# mdave9111/cooperative-localisation-under-communication-dropout architecture

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

- Interactive diagram: https://gitdiagram.com/mdave9111/cooperative-localisation-under-communication-dropout
- Repository: https://github.com/mdave9111/cooperative-localisation-under-communication-dropout

## Overview

This repository is a local simulation benchmark for comparing dead reckoning, a fixed-gain cooperative observer, and an EKF as communication packet loss varies. The principal workflow is to initialize a rover fleet, advance rover motion, form range packets, apply the selected correction, compute non-anchor RMSE, and plot results. The graph separates simulation orchestration, rover state and motion, and packet-based estimation. The available excerpts show these call paths; unshown details are not inferred.

Main entry points: [`main.py`](https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/main.py) (Monte Carlo runner), [`agent.py`](https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/agent.py) (Rover agent), [`estimators.py`](https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/estimators.py) (Range packet model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Simulation benchmark"]
  node_runner["Monte Carlo runner<br/>[main.py]"]
  node_rmse["RMSE evaluation<br/>[main.py]"]
  node_plot["Benchmark plot<br/>[main.py]"]
end

subgraph group_rover["Rover state and motion"]
  node_agent["Rover agent<br/>[agent.py]"]
  node_motion["Kinematics and drift<br/>[agent.py]"]
  node_covariance["Odometry covariance<br/>[agent.py]"]
end

subgraph group_estimation["Cooperative estimation"]
  node_packet["Range packet model<br/>[estimators.py]"]
  node_fixed["Fixed-gain observer<br/>[estimators.py]"]
  node_ekf["EKF range update<br/>[estimators.py]"]
end

node_user(("Benchmark user"))

node_user -->|"runs benchmark"| node_runner
node_runner -->|"initializes fleet"| node_agent
node_runner -->|"ticks agents"| node_motion
node_agent -->|"updates motion"| node_motion
node_motion -->|"propagates uncertainty"| node_covariance
node_runner -->|"creates packets"| node_packet
node_packet -->|"reads coordinates"| node_agent
node_runner -->|"selects correction"| node_fixed
node_agent -->|"delegates correction"| node_fixed
node_runner -->|"applies EKF update"| node_ekf
node_runner -->|"computes error"| node_rmse
node_agent -->|"provides histories"| node_rmse
node_runner -->|"plots sweep"| node_plot

click node_runner "https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/main.py"
click node_rmse "https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/main.py"
click node_plot "https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/main.py"
click node_agent "https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/agent.py"
click node_motion "https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/agent.py"
click node_covariance "https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/agent.py"
click node_packet "https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/estimators.py"
click node_fixed "https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/estimators.py"
click node_ekf "https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/estimators.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_runner,node_rmse,node_plot,node_user toneBlue
class node_agent,node_motion,node_covariance toneAmber
class node_packet,node_fixed,node_ekf toneMint
```

## Components

### Simulation benchmark

- [Monte Carlo runner](https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/main.py): `main.py`
- [RMSE evaluation](https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/main.py): `main.py`
- [Benchmark plot](https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/main.py): `main.py`

### Rover state and motion

- [Rover agent](https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/agent.py): `agent.py`
- [Kinematics and drift](https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/agent.py): `agent.py`
- [Odometry covariance](https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/agent.py): `agent.py`

### Cooperative estimation

- [Range packet model](https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/estimators.py): `estimators.py`
- [Fixed-gain observer](https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/estimators.py): `estimators.py`
- [EKF range update](https://github.com/mdave9111/cooperative-localisation-under-communication-dropout/blob/main/estimators.py): `estimators.py`

### Other components

- **Benchmark user**

## Connections

- Benchmark user → Monte Carlo runner: runs benchmark (evidence: `readme.md`)
- Monte Carlo runner → Rover agent: initializes fleet (evidence: `main.py`)
- Monte Carlo runner → Kinematics and drift: ticks agents (evidence: `main.py`)
- Rover agent → Kinematics and drift: updates motion (evidence: `agent.py`)
- Kinematics and drift → Odometry covariance: propagates uncertainty (evidence: `agent.py`)
- Monte Carlo runner → Range packet model: creates packets (evidence: `main.py`)
- Range packet model → Rover agent: reads coordinates (evidence: `estimators.py`)
- Monte Carlo runner → Fixed-gain observer: selects correction (evidence: `main.py`)
- Rover agent → Fixed-gain observer: delegates correction (evidence: `agent.py`)
- Monte Carlo runner → EKF range update: applies EKF update (evidence: `main.py`)
- Monte Carlo runner → RMSE evaluation: computes error (evidence: `main.py`)
- Rover agent → RMSE evaluation: provides histories (evidence: `main.py`)
- Monte Carlo runner → Benchmark plot: plots sweep (evidence: `main.py`)
