# snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025- architecture

> Architecture diagram of the GitHub repository snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-
- Repository: https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-

## Overview

ITMS acquires synchronized railway-sensor readings, derives track condition and geometry measurements, detects component defects and clearance infringements, and records rear-facing video. The central evidenced runtime path is UART time/trigger publication to subscribing measurement and detection processes; the repository also includes separate dashboard-forwarding entry points. README-described capabilities whose wiring is not shown are retained as subsystem nodes, but their unverified connections are omitted. Source excerpts do not establish one end-to-end fusion or dashboard pipeline.

Main entry points: [`master/uart_time_mux.py`](https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/master/uart_time_mux.py) (UART time publisher), [`xsens_MTI710/raw_data_reciver.cpp`](https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/xsens_MTI710/raw_data_reciver.cpp) (Xsens acquisition), [`rail_profile/stero.py`](https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/rail_profile/stero.py) (Rail profile), [`Acceleration/track_accel.py`](https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/Acceleration/track_accel.py) (Acceleration monitor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sync["Synchronization"]
  node_uart["UART time publisher<br/>[uart_time_mux.py]"]
end

subgraph group_geometry["Track Measurement"]
  node_trackgeom["Track geometry"]
  node_profile["Rail profile<br/>[stero.py]"]
  node_accel["Acceleration monitor<br/>[track_accel.py]"]
  node_xsens["Xsens acquisition"]
  node_plot["IMU plotting<br/>[ploter.py]"]
end

subgraph group_inspection["Visual Inspection"]
  node_condition["Component defect detection<br/>[ml.py]"]
  node_model["YOLO model weights<br/>[best.pt]"]
end

subgraph group_safety["Safety Monitoring"]
  node_lidar["LiDAR infringement analysis"]
end

subgraph group_delivery["Recording and Delivery"]
  node_rear["Rear-window capture<br/>[ardu.py]"]
  node_sender["HTTP-to-WebSocket bridge<br/>[jetson_sender.py]"]
  node_receiver["Stdin WebSocket relay<br/>[reciever.py]"]
end

node_dashboard["Web dashboard"]
node_track_sensors(("ToF and encoder"))
node_stereo(("Stereo cameras and laser"))
node_imu(("GNSS/INS unit"))
node_oust(("Ouster LiDAR"))
node_camera(("Rear camera"))
node_runtime(("Subsystem packet producer"))

node_uart -->|"publishes readings"| node_trackgeom
node_uart -->|"publishes triggers"| node_profile
node_uart -->|"publishes readings"| node_accel
node_uart -->|"publishes triggers"| node_condition
node_track_sensors -->|"sends UART data"| node_uart
node_track_sensors -->|"measured by"| node_profile
node_stereo -->|"captured for profiling"| node_profile
node_imu -->|"sampled by"| node_xsens
node_imu -->|"supplies motion data"| node_accel
node_xsens -->|"streams readings"| node_plot
node_xsens -.->|"provides IMU data"| node_trackgeom
node_xsens -.->|"provides IMU data"| node_accel
node_condition -->|"loads weights"| node_model
node_oust -->|"scans clearance"| node_lidar
node_camera -->|"captures video"| node_rear
node_rear -->|"writes display frame"| node_dashboard
node_runtime -->|"posts packets"| node_sender
node_sender -->|"forwards WebSocket data"| node_dashboard
node_runtime -->|"pipes JSON"| node_receiver
node_receiver -->|"sends WebSocket data"| node_dashboard

click node_uart "https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/master/uart_time_mux.py"
click node_trackgeom "https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/tof_stm32_interface/complete_track_geometry.py"
click node_profile "https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/rail_profile/stero.py"
click node_accel "https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/Acceleration/track_accel.py"
click node_xsens "https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/xsens_MTI710/raw_data_reciver.cpp"
click node_plot "https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/xsens_MTI710/ploter.py"
click node_condition "https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/condition/ml.py"
click node_model "https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/best.pt"
click node_lidar "https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/lidar/complete_solution.py"
click node_rear "https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/rear_window/ardu.py"
click node_sender "https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/jetson_sender.py"
click node_receiver "https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/reciever.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_uart toneBlue
class node_trackgeom,node_profile,node_accel,node_xsens,node_plot toneAmber
class node_condition,node_model toneMint
class node_lidar toneRose
class node_rear,node_sender,node_receiver,node_dashboard,node_track_sensors,node_stereo,node_imu,node_oust,node_camera,node_runtime toneIndigo
```

## Components

### Synchronization

- [UART time publisher](https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/master/uart_time_mux.py): `master/uart_time_mux.py`

### Track Measurement

- [Track geometry](https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/tof_stm32_interface/complete_track_geometry.py): `tof_stm32_interface/complete_track_geometry.py`
- [Rail profile](https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/rail_profile/stero.py): `rail_profile/stero.py`
- [Acceleration monitor](https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/Acceleration/track_accel.py): `Acceleration/track_accel.py`
- [Xsens acquisition](https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/xsens_MTI710/raw_data_reciver.cpp): `xsens_MTI710/raw_data_reciver.cpp`
- [IMU plotting](https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/xsens_MTI710/ploter.py): `xsens_MTI710/ploter.py`

### Visual Inspection

- [Component defect detection](https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/condition/ml.py): `condition/ml.py`
- [YOLO model weights](https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/best.pt): `best.pt`

### Safety Monitoring

- [LiDAR infringement analysis](https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/lidar/complete_solution.py): `lidar/complete_solution.py`

### Recording and Delivery

- [Rear-window capture](https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/rear_window/ardu.py): `rear_window/ardu.py`
- [HTTP-to-WebSocket bridge](https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/jetson_sender.py): `jetson_sender.py`
- [Stdin WebSocket relay](https://github.com/snehanaik-754/indigenous-integrated-track-monitoring-system-sih2025-/blob/main/reciever.py): `reciever.py`

### Other components

- **Web dashboard**
- **ToF and encoder**
- **Stereo cameras and laser**
- **GNSS/INS unit**
- **Ouster LiDAR**
- **Rear camera**
- **Subsystem packet producer**

## Connections

- UART time publisher → Track geometry: publishes readings (evidence: `tof_stm32_interface/complete_track_geometry.py`)
- UART time publisher → Rail profile: publishes triggers (evidence: `rail_profile/stero.py`)
- UART time publisher → Acceleration monitor: publishes readings (evidence: `Acceleration/track_accel.py`)
- UART time publisher → Component defect detection: publishes triggers (evidence: `condition/ml.py`)
- ToF and encoder → UART time publisher: sends UART data (evidence: `master/uart_time_mux.py`)
- ToF and encoder → Rail profile: measured by (evidence: `rail_profile/stero.py`)
- Stereo cameras and laser → Rail profile: captured for profiling (evidence: `rail_profile/stero.py`)
- GNSS/INS unit → Xsens acquisition: sampled by (evidence: `xsens_MTI710/raw_data_reciver.cpp`)
- GNSS/INS unit → Acceleration monitor: supplies motion data (evidence: `Acceleration/track_accel.py`)
- Xsens acquisition → IMU plotting: streams readings (evidence: `xsens_MTI710/ploter.py`)
- Xsens acquisition → Track geometry: provides IMU data
- Xsens acquisition → Acceleration monitor: provides IMU data
- Component defect detection → YOLO model weights: loads weights (evidence: `condition/ml.py`)
- Ouster LiDAR → LiDAR infringement analysis: scans clearance (evidence: `lidar/complete_solution.py`)
- Rear camera → Rear-window capture: captures video (evidence: `rear_window/ardu.py`)
- Rear-window capture → Web dashboard: writes display frame (evidence: `rear_window/ardu.py`)
- Subsystem packet producer → HTTP-to-WebSocket bridge: posts packets (evidence: `jetson_sender.py`)
- HTTP-to-WebSocket bridge → Web dashboard: forwards WebSocket data (evidence: `jetson_sender.py`)
- Subsystem packet producer → Stdin WebSocket relay: pipes JSON (evidence: `reciever.py`)
- Stdin WebSocket relay → Web dashboard: sends WebSocket data (evidence: `reciever.py`)
