Update model card with paper link, graph-ml tag, and usage instructions
#1
by nielsr HF Staff - opened
README.md
CHANGED
|
@@ -1,16 +1,48 @@
|
|
| 1 |
---
|
| 2 |
-
license: mit
|
| 3 |
datasets:
|
| 4 |
- ai4co/rrnco
|
| 5 |
-
|
|
|
|
| 6 |
---
|
| 7 |
|
| 8 |
-
# RRNCO
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 9 |
|
|
|
|
|
|
|
|
|
|
|
|
|
| 10 |
|
| 11 |
-
|
|
|
|
|
|
|
|
|
|
| 12 |
|
|
|
|
| 13 |
|
| 14 |
-
|
| 15 |
|
| 16 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
---
|
|
|
|
| 2 |
datasets:
|
| 3 |
- ai4co/rrnco
|
| 4 |
+
license: mit
|
| 5 |
+
pipeline_tag: graph-ml
|
| 6 |
---
|
| 7 |
|
| 8 |
+
# RRNCO: Towards Real-World Routing with Neural Combinatorial Optimization
|
| 9 |
+
|
| 10 |
+
This repository contains the pre-trained models for **RRNCO**, as presented in the paper [RRNCO: Towards Real-World Routing with Neural Combinatorial Optimization](https://huggingface.co/papers/2503.16159).
|
| 11 |
+
|
| 12 |
+
RRNCO is a novel architecture designed to bridge the sim-to-real gap in Neural Combinatorial Optimization (NCO) for Vehicle Routing Problems (VRPs). It introduces two key innovations: **Adaptive Node Embedding (ANE)** and **Neural Adaptive Bias (NAB)** to handle complex real-world features like asymmetric distance and duration matrices.
|
| 13 |
+
|
| 14 |
+
- **Main code on Github:** [ai4co/real-routing-nco](https://github.com/ai4co/real-routing-nco)
|
| 15 |
+
- **Dataset:** [ai4co/rrnco](https://huggingface.co/datasets/ai4co/rrnco)
|
| 16 |
+
|
| 17 |
+
## Usage
|
| 18 |
+
|
| 19 |
+
You can evaluate the pre-trained checkpoints (available under the [`checkpoints/`](https://huggingface.co/ai4co/rrnco/tree/main/checkpoints) folder) using the `test.py` script from the official repository.
|
| 20 |
+
|
| 21 |
+
### ATSP (Asymmetric Traveling Salesman Problem)
|
| 22 |
+
```bash
|
| 23 |
+
python test.py --problem atsp --datasets data/atsp/atsp_n100_seed3333_in_distribution.npz --batch_size 32 --checkpoint checkpoints/atsp/epoch_199.ckpt
|
| 24 |
+
```
|
| 25 |
|
| 26 |
+
### RCVRP (Real-world Capacitated VRP)
|
| 27 |
+
```bash
|
| 28 |
+
python test.py --problem rcvrp --datasets data/rcvrp/rcvrp_n100_seed3333_in_distribution.npz --batch_size 32 --checkpoint checkpoints/rcvrp/epoch_199.ckpt
|
| 29 |
+
```
|
| 30 |
|
| 31 |
+
### RCVRPTW (Real-world Capacitated VRP with Time Windows)
|
| 32 |
+
```bash
|
| 33 |
+
python test.py --problem rcvrptw --datasets data/rcvrptw/rcvrptw_n100_seed3333_in_distribution.npz --batch_size 32 --checkpoint checkpoints/rcvrptw/epoch_199.ckpt
|
| 34 |
+
```
|
| 35 |
|
| 36 |
+
## Citation
|
| 37 |
|
| 38 |
+
If you find RRNCO valuable for your research, please cite the work:
|
| 39 |
|
| 40 |
+
```bibtex
|
| 41 |
+
@inproceedings{son2026rrnconeuralcombinatorialoptimizationrealworldrouting,
|
| 42 |
+
title = {Towards Real-World Routing with Neural Combinatorial Optimization},
|
| 43 |
+
author = {Son, Jiwoo and Zhao, Zhikai and Berto, Federico and Hua, Chuanbo and Cao, Zhiguang and Kwon, Changhyun and Park, Jinkyoo},
|
| 44 |
+
booktitle = {Proceedings of the International Conference on Learning Representations (ICLR)},
|
| 45 |
+
year = {2026},
|
| 46 |
+
url = {https://openreview.net/forum?id=sKvo9ZZfpe}
|
| 47 |
+
}
|
| 48 |
+
```
|