# prajeevans/teleplan_ai architecture

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

- Interactive diagram: https://gitdiagram.com/prajeevans/teleplan_ai
- Repository: https://github.com/prajeevans/teleplan_ai

## Overview

TelePlan AI is a Streamlit telecom network-planning and RF simulation application. Engineers add towers and radio settings, generate coverage predictions, inspect signal heatmaps and best-server regions on a map, and can generate synthetic telecom data for ML workflows. The runtime separates UI orchestration, RF calculations, geospatial/network analysis, and data generation. The README documents additional dashboard pages and ML training workflows, but their implementation is not shown in the sampled source; those links are therefore omitted or marked unverified.

Main entry points: [`simulator/dataset_builder.py`](https://github.com/prajeevans/teleplan_ai/blob/main/simulator/dataset_builder.py) (Telecom dataset builder), [`models/link_budget.py`](https://github.com/prajeevans/teleplan_ai/blob/main/models/link_budget.py) (Link budget), [`app.py`](https://github.com/prajeevans/teleplan_ai/blob/main/app.py) (Streamlit planner), [`ml/dataset_generator.py`](https://github.com/prajeevans/teleplan_ai/blob/main/ml/dataset_generator.py) (RSRP dataset generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Planning interface"]
  node_app["Streamlit planner<br/>[app.py]"]
  node_pages["Dashboard pages"]
  node_map["Map rendering<br/>[map_utils.py]"]
end

subgraph group_rf["RF modeling"]
  node_propagation["Propagation models<br/>[propagation.py]"]
  node_link["Link budget<br/>[link_budget.py]"]
  node_config["Radio defaults<br/>[config.py]"]
  node_rsrp["RSRP conversion<br/>[rsrp.py]"]
  node_signal["Signal calculator<br/>[signal.py]"]
  node_pathloss["Path-loss functions<br/>[path_loss.py]"]
end

subgraph group_analysis["Coverage analysis"]
  node_coverage["Coverage engine<br/>[coverage.py]"]
  node_grid["Coverage grid<br/>[coverage_grid.py]"]
  node_network["Best-server planner<br/>[network.py]"]
  node_distance["Distance calculation<br/>[calculations.py]"]
  node_classifier["Signal classification"]
end

subgraph group_data["Data and ML"]
  node_builder["Telecom dataset builder<br/>[dataset_builder.py]"]
  node_towergen["Tower synthesis<br/>[tower_generator.py]"]
  node_usergen["User synthesis<br/>[user_generator.py]"]
  node_environment["Environment synthesis"]
  node_weather["Weather synthesis"]
  node_traffic["Traffic synthesis"]
  node_fastdata["RSRP dataset generator"]
  node_ai_coverage["AI coverage predictor<br/>[ai_coverage.py]"]
  node_ai_model["AI predictor<br/>[ai_predictor.py]"]
  node_telecom_csv["Telecom dataset"]
  node_rsrp_csv["RSRP dataset<br/>[rsrp_dataset.csv]"]
end

node_engineer(("Telecom engineer"))

node_engineer -->|"configures towers"| node_app
node_app -->|"requests predictions"| node_coverage
node_app -->|"computes heatmap"| node_grid
node_app -->|"requests best server"| node_network
node_app -->|"renders heatmap"| node_map
node_app -.->|"offers pages"| node_pages
node_coverage -->|"calculates path loss"| node_propagation
node_coverage -->|"calculates power"| node_link
node_coverage -->|"measures distance"| node_distance
node_coverage -->|"classifies signal"| node_classifier
node_network -->|"measures distance"| node_distance
node_network -->|"calculates path loss"| node_propagation
node_network -->|"calculates power"| node_link
node_grid -->|"calculates RSRP"| node_signal
node_signal -->|"uses path loss"| node_pathloss
node_signal -->|"uses link budget"| node_link
node_link -->|"loads defaults"| node_config
node_builder -->|"generates towers"| node_towergen
node_builder -->|"generates users"| node_usergen
node_builder -->|"generates environment"| node_environment
node_builder -->|"generates weather"| node_weather
node_builder -->|"generates traffic"| node_traffic
node_builder -->|"calculates path loss"| node_propagation
node_builder -->|"calculates power"| node_link
node_builder -->|"converts power"| node_rsrp
node_builder -->|"measures distance"| node_distance
node_builder -->|"writes dataset"| node_telecom_csv
node_fastdata -->|"calculates path loss"| node_propagation
node_fastdata -->|"calculates power"| node_link
node_fastdata -->|"converts power"| node_rsrp
node_fastdata -->|"measures distance"| node_distance
node_fastdata -->|"writes dataset"| node_rsrp_csv
node_ai_coverage -->|"predicts signal"| node_ai_model
node_ai_coverage -->|"calculates path loss"| node_propagation
node_ai_coverage -->|"calculates power"| node_link
node_ai_coverage -->|"measures distance"| node_distance

click node_app "https://github.com/prajeevans/teleplan_ai/blob/main/app.py"
click node_pages "https://github.com/prajeevans/teleplan_ai/tree/main/pages"
click node_map "https://github.com/prajeevans/teleplan_ai/blob/main/utils/map_utils.py"
click node_coverage "https://github.com/prajeevans/teleplan_ai/blob/main/models/coverage.py"
click node_grid "https://github.com/prajeevans/teleplan_ai/blob/main/models/coverage_grid.py"
click node_network "https://github.com/prajeevans/teleplan_ai/blob/main/models/network.py"
click node_distance "https://github.com/prajeevans/teleplan_ai/blob/main/utils/calculations.py"
click node_classifier "https://github.com/prajeevans/teleplan_ai/blob/main/utils/signal_classifier.py"
click node_propagation "https://github.com/prajeevans/teleplan_ai/blob/main/models/propagation.py"
click node_link "https://github.com/prajeevans/teleplan_ai/blob/main/models/link_budget.py"
click node_config "https://github.com/prajeevans/teleplan_ai/blob/main/models/config.py"
click node_rsrp "https://github.com/prajeevans/teleplan_ai/blob/main/models/rsrp.py"
click node_signal "https://github.com/prajeevans/teleplan_ai/blob/main/models/signal.py"
click node_pathloss "https://github.com/prajeevans/teleplan_ai/blob/main/models/path_loss.py"
click node_builder "https://github.com/prajeevans/teleplan_ai/blob/main/simulator/dataset_builder.py"
click node_towergen "https://github.com/prajeevans/teleplan_ai/blob/main/simulator/tower_generator.py"
click node_usergen "https://github.com/prajeevans/teleplan_ai/blob/main/simulator/user_generator.py"
click node_environment "https://github.com/prajeevans/teleplan_ai/blob/main/simulator/environment_generator.py"
click node_weather "https://github.com/prajeevans/teleplan_ai/blob/main/simulator/weather_generator.py"
click node_traffic "https://github.com/prajeevans/teleplan_ai/blob/main/simulator/traffic_generator.py"
click node_fastdata "https://github.com/prajeevans/teleplan_ai/blob/main/ml/dataset_generator.py"
click node_ai_coverage "https://github.com/prajeevans/teleplan_ai/blob/main/models/ai_coverage.py"
click node_ai_model "https://github.com/prajeevans/teleplan_ai/blob/main/models/ai_predictor.py"
click node_telecom_csv "https://github.com/prajeevans/teleplan_ai/blob/main/data/telecom_dataset.csv"
click node_rsrp_csv "https://github.com/prajeevans/teleplan_ai/blob/main/data/rsrp_dataset.csv"

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_app,node_pages,node_map toneBlue
class node_propagation,node_link,node_config,node_rsrp,node_signal,node_pathloss toneAmber
class node_coverage,node_grid,node_network,node_distance,node_classifier toneMint
class node_builder,node_towergen,node_usergen,node_environment,node_weather,node_traffic,node_fastdata,node_ai_coverage,node_ai_model,node_telecom_csv,node_rsrp_csv toneRose
class node_engineer toneIndigo
```

## Components

### Planning interface

- [Streamlit planner](https://github.com/prajeevans/teleplan_ai/blob/main/app.py): `app.py`
- [Dashboard pages](https://github.com/prajeevans/teleplan_ai/tree/main/pages): `pages`
- [Map rendering](https://github.com/prajeevans/teleplan_ai/blob/main/utils/map_utils.py): `utils/map_utils.py`

### RF modeling

- [Propagation models](https://github.com/prajeevans/teleplan_ai/blob/main/models/propagation.py): `models/propagation.py`
- [Link budget](https://github.com/prajeevans/teleplan_ai/blob/main/models/link_budget.py): `models/link_budget.py`
- [Radio defaults](https://github.com/prajeevans/teleplan_ai/blob/main/models/config.py): `models/config.py`
- [RSRP conversion](https://github.com/prajeevans/teleplan_ai/blob/main/models/rsrp.py): `models/rsrp.py`
- [Signal calculator](https://github.com/prajeevans/teleplan_ai/blob/main/models/signal.py): `models/signal.py`
- [Path-loss functions](https://github.com/prajeevans/teleplan_ai/blob/main/models/path_loss.py): `models/path_loss.py`

### Coverage analysis

- [Coverage engine](https://github.com/prajeevans/teleplan_ai/blob/main/models/coverage.py): `models/coverage.py`
- [Coverage grid](https://github.com/prajeevans/teleplan_ai/blob/main/models/coverage_grid.py): `models/coverage_grid.py`
- [Best-server planner](https://github.com/prajeevans/teleplan_ai/blob/main/models/network.py): `models/network.py`
- [Distance calculation](https://github.com/prajeevans/teleplan_ai/blob/main/utils/calculations.py): `utils/calculations.py`
- [Signal classification](https://github.com/prajeevans/teleplan_ai/blob/main/utils/signal_classifier.py): `utils/signal_classifier.py`

### Data and ML

- [Telecom dataset builder](https://github.com/prajeevans/teleplan_ai/blob/main/simulator/dataset_builder.py): `simulator/dataset_builder.py`
- [Tower synthesis](https://github.com/prajeevans/teleplan_ai/blob/main/simulator/tower_generator.py): `simulator/tower_generator.py`
- [User synthesis](https://github.com/prajeevans/teleplan_ai/blob/main/simulator/user_generator.py): `simulator/user_generator.py`
- [Environment synthesis](https://github.com/prajeevans/teleplan_ai/blob/main/simulator/environment_generator.py): `simulator/environment_generator.py`
- [Weather synthesis](https://github.com/prajeevans/teleplan_ai/blob/main/simulator/weather_generator.py): `simulator/weather_generator.py`
- [Traffic synthesis](https://github.com/prajeevans/teleplan_ai/blob/main/simulator/traffic_generator.py): `simulator/traffic_generator.py`
- [RSRP dataset generator](https://github.com/prajeevans/teleplan_ai/blob/main/ml/dataset_generator.py): `ml/dataset_generator.py`
- [AI coverage predictor](https://github.com/prajeevans/teleplan_ai/blob/main/models/ai_coverage.py): `models/ai_coverage.py`
- [AI predictor](https://github.com/prajeevans/teleplan_ai/blob/main/models/ai_predictor.py): `models/ai_predictor.py`
- [Telecom dataset](https://github.com/prajeevans/teleplan_ai/blob/main/data/telecom_dataset.csv): `data/telecom_dataset.csv`
- [RSRP dataset](https://github.com/prajeevans/teleplan_ai/blob/main/data/rsrp_dataset.csv): `data/rsrp_dataset.csv`

### Other components

- **Telecom engineer**

## Connections

- Telecom engineer → Streamlit planner: configures towers (evidence: `app.py`)
- Streamlit planner → Coverage engine: requests predictions (evidence: `app.py`)
- Streamlit planner → Coverage grid: computes heatmap (evidence: `app.py`)
- Streamlit planner → Best-server planner: requests best server (evidence: `app.py`)
- Streamlit planner → Map rendering: renders heatmap (evidence: `app.py`)
- Streamlit planner → Dashboard pages: offers pages (evidence: `README.md`)
- Coverage engine → Propagation models: calculates path loss (evidence: `models/coverage.py`)
- Coverage engine → Link budget: calculates power (evidence: `models/coverage.py`)
- Coverage engine → Distance calculation: measures distance (evidence: `models/coverage.py`)
- Coverage engine → Signal classification: classifies signal (evidence: `models/coverage.py`)
- Best-server planner → Distance calculation: measures distance (evidence: `models/network.py`)
- Best-server planner → Propagation models: calculates path loss (evidence: `models/network.py`)
- Best-server planner → Link budget: calculates power (evidence: `models/network.py`)
- Coverage grid → Signal calculator: calculates RSRP (evidence: `models/coverage_grid.py`)
- Signal calculator → Path-loss functions: uses path loss (evidence: `models/signal.py`)
- Signal calculator → Link budget: uses link budget (evidence: `models/signal.py`)
- Link budget → Radio defaults: loads defaults (evidence: `models/link_budget.py`)
- Telecom dataset builder → Tower synthesis: generates towers (evidence: `simulator/dataset_builder.py`)
- Telecom dataset builder → User synthesis: generates users (evidence: `simulator/dataset_builder.py`)
- Telecom dataset builder → Environment synthesis: generates environment (evidence: `simulator/dataset_builder.py`)
- Telecom dataset builder → Weather synthesis: generates weather (evidence: `simulator/dataset_builder.py`)
- Telecom dataset builder → Traffic synthesis: generates traffic (evidence: `simulator/dataset_builder.py`)
- Telecom dataset builder → Propagation models: calculates path loss (evidence: `simulator/dataset_builder.py`)
- Telecom dataset builder → Link budget: calculates power (evidence: `simulator/dataset_builder.py`)
- Telecom dataset builder → RSRP conversion: converts power (evidence: `simulator/dataset_builder.py`)
- Telecom dataset builder → Distance calculation: measures distance (evidence: `simulator/dataset_builder.py`)
- Telecom dataset builder → Telecom dataset: writes dataset (evidence: `README.md`)
- RSRP dataset generator → Propagation models: calculates path loss (evidence: `ml/dataset_generator.py`)
- RSRP dataset generator → Link budget: calculates power (evidence: `ml/dataset_generator.py`)
- RSRP dataset generator → RSRP conversion: converts power (evidence: `ml/dataset_generator.py`)
- RSRP dataset generator → Distance calculation: measures distance (evidence: `ml/dataset_generator.py`)
- RSRP dataset generator → RSRP dataset: writes dataset (evidence: `README.md`)
- AI coverage predictor → AI predictor: predicts signal (evidence: `models/ai_coverage.py`)
- AI coverage predictor → Propagation models: calculates path loss (evidence: `models/ai_coverage.py`)
- AI coverage predictor → Link budget: calculates power (evidence: `models/ai_coverage.py`)
- AI coverage predictor → Distance calculation: measures distance (evidence: `models/ai_coverage.py`)
