Hugging Face's logo

Spaces:
milewire
/
ul-interference-analyzer
Sleeping

App Files Community
ul-interference-analyzer
File size: 2,351 Bytes
e0f2fbc
 
 
 
 
 
 
 
52e7aad
e0f2fbc
4f96e15
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
4bf9c05
 
 
 
 
 
 
 
 
 
 
 
 
4f96e15
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
392b804
 
 
651c129
392b804
651c129
 
 
 
 
4f96e15
 
 
52e7aad
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
---
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.