README.md

metadata

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

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

Capacity Congestion Detection

Disclaimer

This project is intended for demonstration and operational workflow prototyping purposes only.