milewire's picture
Update README.md
651c129 verified
|
Raw
History Blame Contribute Delete
2.35 kB
---
title: UL Interference Analyzer
emoji: 📶
colorFrom: blue
colorTo: indigo
sdk: gradio
app_file: app.py
pinned: false
sdk_version: 6.15.1
---
# UL Interference Analyzer
AI-assisted LTE and 5G uplink interference analysis using RF KPI and PM counter indicators.
## Overview
UL Interference Analyzer evaluates uplink radio conditions using commonly monitored LTE and 5G RAN KPIs including:
- UL SINR
- RTWP
- PUSCH BLER
- UL/DL PRB utilization
- CQI
The application applies engineering threshold logic to classify potential uplink interference conditions, congestion scenarios, and RF degradation patterns.
## Features
- RF KPI threshold analysis
- Uplink interference detection
- Capacity congestion differentiation
- Severity grading
- Engineering action recommendations
- Structured operational output
## Example KPIs
```text
UL SINR = -8
PUSCH BLER = 41
RTWP = -94
UL PRB = 72
DL PRB = 35
CQI = 3
```
## Example Output
- LIKELY UL INTERFERENCE
- HIGH Severity
- Recommended RF engineering actions
## KPI Threshold Examples
| KPI | Threshold | Interpretation |
|---|---|---|
| UL SINR | < 0 dB | Potential uplink degradation |
| UL SINR | < -5 dB | Severe uplink impairment |
| RTWP | > -100 dBm | Elevated uplink noise floor |
| RTWP | > -95 dBm | Severe interference indication |
| PUSCH BLER | > 15% | Elevated uplink retransmissions |
| PUSCH BLER | > 30% | Critical uplink quality issue |
| UL PRB | > 85% | Potential uplink congestion |
| CQI | < 5 | Poor radio quality indication |
## Potential Use Cases
- LTE RAN troubleshooting
- 5G uplink diagnostics
- RF optimization workflows
- PM counter analysis
- Network operations support
- Private wireless operational analysis
## Current Scope
This project currently uses rule-based engineering logic and static KPI interpretation.
Future enhancements may include:
- Historical KPI trend analysis
- Vendor-specific logic
- Multi-sector correlation
- AI-assisted recommendation engines
- RAG integration for operational runbooks
## Technology Stack
- Python
- Gradio
- Hugging Face Spaces
-
## Application Preview
### UL Interference Detection
![Interference](./interference_case.png)
### Capacity Congestion Detection
![Congestion](./congestion_case.png)
## Disclaimer
This project is intended for demonstration and operational workflow prototyping purposes only.