README.md

metadata

title: PHI Arc Engine PHM
emoji: 🚀
colorFrom: red
colorTo: red
sdk: docker
app_port: 8501
tags:
  - streamlit
pinned: false
short_description: Interactive PHM digital twin for TPE331 gas turbine engines.
license: apache-2.0

PHI-Arc Engine PHM Digital Twin

Multi-engine prognostics and health monitoring system for MRO technicians.

🔗 Live Demo: [https://huggingface.co/spaces/SM-Bello/PHI-Arc-Engine-PHM]

---

Supported Engines

Engine	Type	Icon
TPE331-25	Turboprop	🛩️
CFM-LEAP Class	Turbofan	✈️
J85-GE Class	Turbojet	🚀
RJ43 Class	Ramjet	⚡
X-51A Class	Scramjet	🔥
RS-25 Class	Rocket	🌌

---

Features

• Physics-informed baseline — ISA atmosphere + thermodynamic cycle matching per flight condition
• 5-fault signature library per engine type with 3 severity levels (Advisory / Warning / Critical)
• Cosine-similarity fault classification against known ATA-linked degradation fingerprints
• Certification-linked maintenance actions — FAA TCDS, EASA CS-E, FAR Part 33, MIL-STD, NASA-STD
• Report generation — PDF, DOCX, and CSV export for offline MRO documentation
• Trend analysis — Upload CSV flight-cycle logs, detect fault onset, view degradation curves
• Interactive charts — Plotly heatmaps, Matplotlib steady-state comparisons, trend plots
• Responsive design — Mobile and desktop optimized via custom CSS

---

Architecture

PHI-Arc Engine PHM/
├── app.py                      # Main Streamlit application
├── Dockerfile                  # HF Spaces Docker container
├── requirements.txt            # Python dependencies
├── packages.txt                # System dependencies (apt)
├── assets/
│   └── style.css               # Responsive UI styling
├── engines/
│   ├── base_engine.py          # Abstract engine interface
│   ├── turboprop.py            # TPE331-25 (FAA TCDS E2WE)
│   ├── turbofan.py             # CFM-LEAP class
│   ├── turbojet.py             # J85-GE class
│   ├── ramjet.py               # RJ43 class
│   ├── scramjet.py             # X-51A class
│   └── rocket.py               # RS-25 class
└── reports/
    ├── pdf_generator.py        # MRO diagnostic PDF reports
    ├── docx_generator.py       # Editable Word reports
    └── csv_exporter.py         # Telemetry CSV export

---

Quick Start (Local)

# Clone the repo
git clone https://huggingface.co/spaces/SM-Bello/phi-arc-phm
cd phi-arc-phm

# Install dependencies
pip install -r requirements.txt

# Run locally
streamlit run app.py

---

Deployment (Hugging Face Spaces)

This Space uses the Docker SDK. The Dockerfile is included — no additional configuration needed.

1. Create a new Space at huggingface.co/spaces
2. Select Docker as the SDK
3. Upload all files from this repository
4. The Space will auto-build and deploy on push

---

Usage for MRO Technicians

1. Select Engine Type — Choose from the 6 supported propulsion systems
2. Input Flight Conditions — Altitude, Mach, power setting, fuel type
3. Input Measured Telemetry — EGT, Fuel Flow, N1/N2, CDP/P3 from ECU/FDR logs
4. Run Diagnosis — System computes physics-healthy baseline and matches fault signatures
5. Review Results — See degradation trends, fault rankings, ATA-linked actions, and certification requirements
6. Download Report — Export PDF/DOCX/CSV for maintenance records

---

Certification Standards Referenced

• FAA TCDS E2WE Rev.8 — Honeywell TPE331
• EASA CS-E — Certification Specifications for Engines
• FAR Part 33 — Airworthiness Standards: Aircraft Engines
• SAE AIR 1168/4 — Gas Turbine Engine Performance Deterioration
• MIL-E-5007D — Military Turbojet Engine Specification
• MIL-STD-810 — Environmental Engineering Considerations
• NASA-STD-5012 — Structural Requirements and Factors of Safety
• AIAA S-080 / S-081 — Ramjet/Scramjet & Liquid Rocket Engine Standards

---

License

Apache-2.0

---

PHI-Arc Systems — Physics-Informed Archetype for Engine Health Monitoring
Built for MRO professionals worldwide.