HMAX-Lite Banner

HMAX-Lite is a real-time SCADA (Supervisory Control and Data Acquisition) simulation designed to model the telemetry and operations of the Panama Metro System, including Lines 1, 2, and 3.

This project serves as a "Digital Twin" proof-of-concept for the Hitachi Rail / HPH Consortium, visualizing the movement of monorail and metro trainsets across all three lines:

• Line 1 (Red): San Isidro ↔ Albrook (North-South)
• Line 2 (Green): Nuevo Tocumen ↔ Albrook (East-West)
• Line 3 (Blue): Albrook ↔ Ciudad del Futuro (Westbound)

flowchart TB
 subgraph Docker["🐳 Docker Compose"]
 subgraph Backend["Train Simulator (FastAPI)"]
 PE[🔧 Physics Engine]
 TG[📊 Telemetry Generator]
 GF[📍 Geofencing]
 ML[🚇 Multi-Line Support]
 end
 
 subgraph Frontend["Operations Dashboard (React + TypeScript)"]
 LM[🗺️ Leaflet Map<br/>3 Lines]
 TS[📈 Telemetry Sidebar<br/>Line Selector]
 end
 
 Backend -->|"SSE Stream"| Frontend
 end
 
 style Docker fill:#1a1a2e,stroke:#16213e,color:#fff
 style Backend fill:#0f3460,stroke:#e94560,color:#fff
 style Frontend fill:#0f3460,stroke:#00d9ff,color:#fff

Comprehensive Coverage: All three Panama Metro lines with 39 stations total.

• Line Selector: Filter dashboard by individual line or view all lines simultaneously
• Color-Coded Routes: Each line has distinct color (Red/Green/Blue) for easy identification
• Interchange Stations: Albrook station serves as interchange for all three lines
• Line-Specific Trains: 13 total trains (4 on Line 1, 4 on Line 2, 5 on Line 3)

Engineering Context: The 5.3km tunnel under the Panama Canal requires specific communication relays and safety protocols.

• Geofence Detection: System automatically detects when trains enter the zone between Balboa and Panama Pacifico
• Visual Feedback: Dashboard switches train status to TUNNEL_MODE with purple indicators
• Communication Mode: Telemetry switches to TUNNEL_RELAY protocol simulation
• Line-Specific: Tunnel functionality only applies to Line 3 trains

Engineering Context: Hitachi monorails utilize the B-CHOP (Brake CHOPper) system to capture regenerative braking energy.

• Physics Simulation: Deceleration triggers regenerative braking mode
• Real-time Telemetry: energy_recovered_kwh spikes during braking events
• Temperature Monitoring: Brake system temperature varies 40°C - 90°C

Engineering Context: Communications-Based Train Control (CBTC) enables safe, close-proximity train operations.

• ETA Calculations: Real-time "Next Station ETA" for each train
• Headway Management: Virtual spacing management between active trains
• Speed Curves: Realistic acceleration/deceleration profiles

• Docker & Docker Compose v2.0+
• Node.js 18+ (for local development)
• Python 3.11+ (for local development)

# Clone and start
git clone https://github.com/yourusername/hmax-lite.git
cd hmax-lite
docker-compose up --build

15 stations running North-South across Panama City.

13 stations running East-West from Tocumen to Albrook.

11 stations on the 25km monorail line to the west.

⚠️ Tunnel Section: Line 3 stations ST-02 to ST-03 traverse the Canal Tunnel

hmax-lite/
├── docker-compose.yml # Container orchestration
├── backend/
│ ├── Dockerfile
│ ├── requirements.txt
│ ├── main.py # FastAPI application
│ ├── simulator.py # Physics & telemetry engine (multi-line)
│ ├── models.py # Pydantic schemas
│ └── stations.py # Route data (Lines 1, 2, 3)
├── frontend/
│ ├── Dockerfile
│ ├── package.json
│ ├── vite.config.ts
│ ├── tailwind.config.js
│ └── src/
│ ├── App.tsx
│ ├── components/
│ │ ├── Header.tsx # Line selector & status
│ │ ├── Map.tsx # Multi-line map
│ │ ├── TrainMarker.tsx # Line-colored train icons
│ │ ├── TrainList.tsx # Grouped by line
│ │ ├── TelemetrySidebar.tsx
│ │ ├── SpeedGauge.tsx
│ │ └── EnergyChart.tsx
│ ├── hooks/
│ │ └── useTrains.ts # Line filtering logic
│ ├── types/
│ │ └── train.ts # MetroLine types & config
│ └── utils/
│ └── api.ts # API client
└── docs/
 └── architecture.md

cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn main:app --reload --host 0.0.0.0 --port 8000

cd frontend
npm install
npm run dev

Angel Pinzon
Systems Engineer | Cloud Architecture & DevOps

• Portfolio: apinzon.dev
• LinkedIn: linkedin.com/in/angelpinzon

This is a personal project for educational and demonstration purposes. It is not affiliated with Metro de Panamá S.A., Hitachi Rail, or the HPH Consortium.

MIT License - See LICENSE for details.