Reinforcement Learning

Update model card with paper link, graph-ml tag, and usage instructions

#1
by nielsr HF Staff - opened
Files changed (1) hide show
  1. README.md +38 -6
README.md CHANGED
@@ -1,16 +1,48 @@
1
  ---
2
- license: mit
3
  datasets:
4
  - ai4co/rrnco
5
- pipeline_tag: reinforcement-learning
 
6
  ---
7
 
8
- # RRNCO models
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
9
 
 
 
 
 
10
 
11
- These are the models accompanying our work ["Neural Combinatorial Optimization for Real-World Routing"](https://arxiv.org/abs/2503.16159)
 
 
 
12
 
 
13
 
14
- Main code on Github: https://github.com/ai4co/real-routing-nco
15
 
16
- Models are available under the [`checkpoints/`](https://huggingface.co/ai4co/rrnco/tree/main/checkpoints) folder
 
 
 
 
 
 
 
 
 
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
+ ```