Skip to content

Commit dc994c2

Browse files
committed
docs: fix QQA/CPRA paper citations, adopt TMLR title rename, broaden PyPI classifiers
The QQA4CO repo had three places where the QQA paper (Ichikawa & Arai, ICLR 2025) and the CPRA paper (Ichikawa & Iwashita, TMLR 2025) were silently swapped or labelled with their obsolete arXiv preprint titles: - src/qqa/__init__.py docstring referenced the CTRA preprint title ("Continuous Tensor Relaxation ...") and attributed it to Ichikawa & Arai at ICLR 2025. The actual ICLR 2025 paper by those authors is the QQA paper, "Optimization by Parallel Quasi-Quantum Annealing with Gradient-Based Sampling" (OpenReview 9EfBeXaXf0, arXiv:2409.02135). - notebooks/cra_pignn_example.ipynb had the same swap in its "QQA paper" bullet. Replaced with the real QQA citation and added a separate CPRA citation (Ichikawa & Iwashita, TMLR 2025). - notebooks/cpra_pignn_example.ipynb still used the algorithm name ("Continual Parallel Relaxation Annealing for Diverse Solutions in Combinatorial Optimization") as the paper title in the intro link and bibtex. The actual TMLR title is "Continuous Parallel Relaxation for Finding Diverse Solutions in Combinatorial Optimization Problems" (the paper was renamed when accepted at TMLR; the older "Continuous Tensor Relaxation" arXiv preprint title is obsolete). Also broadens pyproject.toml PyPI classifiers (Environment :: Console, Environment :: GPU :: NVIDIA CUDA, Intended Audience :: Education / Developers, OS-specific tags, Topic :: Mathematics / Physics, Typing :: Typed) to improve PyPI discoverability for the awesome-list / PWC campaign.
1 parent 1b693a3 commit dc994c2

4 files changed

Lines changed: 20 additions & 5 deletions

File tree

notebooks/cpra_pignn_example.ipynb

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
"source": [
88
"# CPRA walkthrough — diverse solutions in a single GNN run\n",
99
"\n",
10-
"This notebook is a minimal tour of **CPRA** (*Continual Parallel Relaxation Annealing*), the multi-replica extension of CRA-PI-GNN published in *Transactions on Machine Learning Research* (2025): [\"Continual Parallel Relaxation Annealing for Diverse Solutions in Combinatorial Optimization\"](https://openreview.net/forum?id=ix33zd5zCw).\n",
10+
"This notebook is a minimal tour of **CPRA** (*Continual Parallel Relaxation Annealing*), the multi-replica extension of CRA-PI-GNN published in *Transactions on Machine Learning Research* (2025): [\"Continuous Parallel Relaxation for Finding Diverse Solutions in Combinatorial Optimization Problems\"](https://openreview.net/forum?id=ix33zd5zCw).\n",
1111
"\n",
1212
"CPRA trains a **single shared GCN backbone** that produces ``R`` parallel continuous solutions in one forward pass, so one training run yields a *diverse population* of high-quality discrete solutions. QQA4CO ships it under `qqa.pignn.train_cpra_pi_gnn`, sharing the same `GCNNet` backbone and `BinaryRelaxation` penalty as `train_cra_pi_gnn`.\n",
1313
"\n",
@@ -436,7 +436,7 @@
436436
"\n",
437437
"```bibtex\n",
438438
"@article{ichikawa2025cpra,\n",
439-
" title = {Continual Parallel Relaxation Annealing for Diverse Solutions in Combinatorial Optimization},\n",
439+
" title = {Continuous Parallel Relaxation for Finding Diverse Solutions in Combinatorial Optimization Problems},\n",
440440
" author = {Ichikawa, Yuma and Iwashita, Hiroaki},\n",
441441
" journal= {Transactions on Machine Learning Research},\n",
442442
" year = {2025},\n",

notebooks/cra_pignn_example.ipynb

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -470,7 +470,8 @@
470470
"- **Blackwell / B200 GPU sanity check**: `scripts/sanity_pignn_gpu.sbatch` (Slurm) verifies `sm_100` is in `torch.cuda.get_arch_list()` and runs the demo on the GPU.\n",
471471
"- **CLI**: `qqa solve --problem mis --backend pignn --learning-rate 1e-3 --pignn-init-reg-param -2 --pignn-annealing-rate 5e-4 --epochs 5000`.\n",
472472
"- **Reference DGL implementation**: <https://github.com/Yuma-Ichikawa/CRA4CO> (NeurIPS 2024).\n",
473-
"- **QQA paper**: Ichikawa & Arai, *\"Continuous Tensor Relaxation for Finding Diverse Solutions in Combinatorial Optimization\"*, ICLR 2025 ([OpenReview](https://openreview.net/forum?id=9EfBeXaXf0))."
473+
"- **QQA paper**: Ichikawa & Arai, *\"Optimization by Parallel Quasi-Quantum Annealing with Gradient-Based Sampling\"*, ICLR 2025 ([OpenReview](https://openreview.net/forum?id=9EfBeXaXf0), [arXiv:2409.02135](https://arxiv.org/abs/2409.02135)).\n",
474+
"- **CPRA paper (CRA / CPRA backends)**: Ichikawa & Iwashita, *\"Continuous Parallel Relaxation for Finding Diverse Solutions in Combinatorial Optimization Problems\"*, TMLR 2025 ([OpenReview](https://openreview.net/forum?id=ix33zd5zCw))."
474475
]
475476
}
476477
],

pyproject.toml

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,14 +25,27 @@ keywords = [
2525
]
2626
classifiers = [
2727
"Development Status :: 4 - Beta",
28+
"Environment :: Console",
29+
"Environment :: GPU :: NVIDIA CUDA",
2830
"Intended Audience :: Science/Research",
31+
"Intended Audience :: Education",
32+
"Intended Audience :: Developers",
2933
"License :: OSI Approved :: BSD License",
34+
"Operating System :: OS Independent",
35+
"Operating System :: POSIX :: Linux",
36+
"Operating System :: MacOS",
37+
"Operating System :: Microsoft :: Windows",
3038
"Programming Language :: Python :: 3",
3139
"Programming Language :: Python :: 3.10",
3240
"Programming Language :: Python :: 3.11",
3341
"Programming Language :: Python :: 3.12",
42+
"Programming Language :: Python :: 3 :: Only",
43+
"Topic :: Scientific/Engineering",
3444
"Topic :: Scientific/Engineering :: Artificial Intelligence",
45+
"Topic :: Scientific/Engineering :: Mathematics",
3546
"Topic :: Scientific/Engineering :: Physics",
47+
"Topic :: Software Development :: Libraries :: Python Modules",
48+
"Typing :: Typed",
3649
]
3750
dependencies = [
3851
# The lower bound matches ``requirements.txt`` (used by Streamlit Community

src/qqa/__init__.py

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,9 @@
11
"""Quasi-Quantum Annealing (QQA) for combinatorial and spin-glass optimization.
22
33
Reference:
4-
Y. Ichikawa, Y. Arai. "Continuous Tensor Relaxation for Finding Diverse
5-
Solutions in Combinatorial Optimization." ICLR 2025.
4+
Y. Ichikawa, Y. Arai. "Optimization by Parallel Quasi-Quantum Annealing
5+
with Gradient-Based Sampling." ICLR 2025.
6+
https://openreview.net/forum?id=9EfBeXaXf0 (arXiv:2409.02135)
67
78
Typical usage::
89

0 commit comments

Comments
 (0)