Instructions to use cpnlab/YOLOR-radio with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- ultralytics
How to use cpnlab/YOLOR-radio with ultralytics:
from ultralytics import YOLOvv11 model = YOLOvv11.from_pretrained("cpnlab/YOLOR-radio") source = 'http://images.cocodataset.org/val2017/000000039769.jpg' model.predict(source=source, save=True) - Notebooks
- Google Colab
- Kaggle
Upload folder using huggingface_hub
Browse files- .gitattributes +2 -0
- README.md +96 -0
- overview2_updated.png +3 -0
- radio.png +3 -0
.gitattributes
CHANGED
|
@@ -33,3 +33,5 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
|
|
| 33 |
*.zip filter=lfs diff=lfs merge=lfs -text
|
| 34 |
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
|
|
|
|
|
|
|
|
| 33 |
*.zip filter=lfs diff=lfs merge=lfs -text
|
| 34 |
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
| 36 |
+
overview2_updated.png filter=lfs diff=lfs merge=lfs -text
|
| 37 |
+
radio.png filter=lfs diff=lfs merge=lfs -text
|
README.md
ADDED
|
@@ -0,0 +1,96 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# YOLOR-radio
|
| 2 |
+
|
| 3 |
+

|
| 4 |
+

|
| 5 |
+

|
| 6 |
+

|
| 7 |
+

|
| 8 |
+
|
| 9 |
+
|
| 10 |
+
<table>
|
| 11 |
+
<tr>
|
| 12 |
+
<td width="30%" valign="top">
|
| 13 |
+
<img src="radio.png" alt="YOLOR-radio — example radio detection" width="100%">
|
| 14 |
+
</td>
|
| 15 |
+
<td valign="top">
|
| 16 |
+
|
| 17 |
+
**YOLOR-radio** is a fine-tuned object detection model for BS identification for beam initialization to detect `radio` in one inference pass. The model is trained on imagery of **[Sivers Semiconductors](https://www.sivers-semiconductors.com/) 60 GHz mmWave Radio frontends (EVK06002)**. Part of the YOLOR detector family used for the Look Once, Beam Twice mmWave V2X beam-management pipeline (SECON 2026).
|
| 18 |
+
|
| 19 |
+
</td>
|
| 20 |
+
</tr>
|
| 21 |
+
</table>
|
| 22 |
+
|
| 23 |
+
|
| 24 |
+
Reference implementation for the paper:
|
| 25 |
+
|
| 26 |
+
> Avhishek Biswas\*, Apala Pramanik\*, Eylem Ekici, Mehmet C. Vuran.
|
| 27 |
+
> *"Look Once, Beam Twice: Camera-Primed Real-Time Double-Directional mmWave Beam Management for Vehicular Connectivity."* (\*equal contribution)
|
| 28 |
+
>
|
| 29 |
+
> arXiv: <https://doi.org/10.48550/arXiv.2605.05071>
|
| 30 |
+
|
| 31 |
+
<p align="center">
|
| 32 |
+
<img src="overview2_updated.png" alt="VIBE five-stage camera-primed beam-management pipeline" width="90%">
|
| 33 |
+
</p>
|
| 34 |
+
|
| 35 |
+
## Quick links
|
| 36 |
+
|
| 37 |
+
- Paper (arXiv): <https://doi.org/10.48550/arXiv.2605.05071>
|
| 38 |
+
Code and Data: <https://github.com/UNL-CPN-Lab/Look-Once-Beam-Twice>
|
| 39 |
+
|
| 40 |
+
| | |
|
| 41 |
+
|---|---|
|
| 42 |
+
| **Architecture** | YOLOv11x, 81-class output head (COCO 80 + 1 custom) |
|
| 43 |
+
| **Initialization** | stock `yolo11x.pt` |
|
| 44 |
+
| **Schedule** | 200 epochs, `cos_lr`, `close_mosaic=20`, `lr0=0.01` |
|
| 45 |
+
| **Training data** | IndoorCOTSDataset — 3,599 train / 449 val / 451 test |
|
| 46 |
+
| **Custom classes** | `radio` (id 80) |
|
| 47 |
+
| **Released checkpoint** | `last.pt` (the converged final model) |
|
| 48 |
+
|
| 49 |
+
## Usage
|
| 50 |
+
|
| 51 |
+
```python
|
| 52 |
+
from huggingface_hub import hf_hub_download
|
| 53 |
+
from ultralytics import YOLO
|
| 54 |
+
|
| 55 |
+
weights = hf_hub_download(repo_id="cpnlab/YOLOR-radio", filename="last.pt")
|
| 56 |
+
model = YOLO(weights)
|
| 57 |
+
|
| 58 |
+
results = model.predict("path/to/image.jpg", conf=0.25)
|
| 59 |
+
results[0].show()
|
| 60 |
+
```
|
| 61 |
+
|
| 62 |
+
Class indices in the returned detections: `0–79` are the standard COCO
|
| 63 |
+
classes; `80` is `radio`. The model's `names` dict carries the same
|
| 64 |
+
mapping.
|
| 65 |
+
|
| 66 |
+
## Intended use
|
| 67 |
+
|
| 68 |
+
- Stage-1 BS-candidate detector for the Look Once, Beam Twice detector pipeline.
|
| 69 |
+
- General-purpose RF-hardware-aware object detection in indoor / office
|
| 70 |
+
scenes where both COCO objects and RF radios may appear.
|
| 71 |
+
|
| 72 |
+
|
| 73 |
+
## Citation
|
| 74 |
+
|
| 75 |
+
```bibtex
|
| 76 |
+
@inproceedings{biswas2026look,
|
| 77 |
+
title = {Look Once, Beam Twice: Camera-Primed Real-Time Double-Directional
|
| 78 |
+
mmWave Beam Management for Vehicular Connectivity},
|
| 79 |
+
author = {Biswas, Avhishek and Pramanik, Apala and Ekici, Eylem and Vuran, Mehmet C.},
|
| 80 |
+
booktitle = {Proc. IEEE SECON},
|
| 81 |
+
year = {2026}
|
| 82 |
+
}
|
| 83 |
+
```
|
| 84 |
+
|
| 85 |
+
Paper: <https://doi.org/10.48550/arXiv.2605.05071> · Code: <https://github.com/UNL-CPN-Lab/Look-Once-Beam-Twice>
|
| 86 |
+
|
| 87 |
+
## Contact
|
| 88 |
+
|
| 89 |
+
For questions about this model or the paper, contact the corresponding authors:
|
| 90 |
+
|
| 91 |
+
- **Avhishek Biswas** — [abiswas3@huskers.unl.edu](mailto:abiswas3@huskers.unl.edu)
|
| 92 |
+
- **Apala Pramanik** — [apramanik2@huskers.unl.edu](mailto:apramanik2@huskers.unl.edu)
|
| 93 |
+
|
| 94 |
+
## Acknowledgments
|
| 95 |
+
|
| 96 |
+
Developed at the **[Cyber Physical Networking (CPN) Lab](https://cpn.unl.edu/)**, [School of Computing](https://computing.unl.edu/), [University of Nebraska–Lincoln](https://www.unl.edu/), in collaboration with [The Ohio State University](https://www.osu.edu/). Thanks to [Sivers Semiconductors](https://www.sivers-semiconductors.com/), [Ettus Research](https://www.ettus.com/), and the open-source [Ultralytics](https://ultralytics.com/), [PyTorch](https://pytorch.org/), and [Ettus UHD](https://www.ettus.com/) communities.
|
overview2_updated.png
ADDED
|
Git LFS Details
|
radio.png
ADDED
|
Git LFS Details
|