---
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.