ToQUBO.jl Documentation
ToQUBO.jl is a Julia Package intended to automatically translate models written in JuMP, into the QUBO mathematical optimization framework.
Quick Start
Installation
julia> import Pkg
julia> Pkg.add("ToQUBO")Example
Using the Exact Sampler
using JuMP
using ToQUBO
using QUBODrivers
model = Model(() -> ToQUBO.Optimizer(ExactSampler.Optimizer))
@variable(model, x[1:3], Bin)
@objective(model, Max, 1.0*x[1] + 2.0*x[2] + 3.0*x[3])
@constraint(model, 0.3*x[1] + 0.5*x[2] + 1.0*x[3] <= 1.6)
optimize!(model)
solution_summary(model)solution_summary(; result = 1, verbose = false)
├ solver_name : Virtual QUBO Model
├ Termination
│ ├ termination_status : OPTIMAL
│ ├ result_count : 256
│ └ raw_status : optimal
├ Solution (result = 1)
│ ├ primal_status : FEASIBLE_POINT
│ ├ dual_status : NO_SOLUTION
│ └ objective_value : 5.00000e+00
└ Work counters
└ solve_time (sec) : 2.70247e-01Using PySA (Simulated Annealing)
PySA can be used in the same optimizer wrapper pattern when it is available in your project environment:
using JuMP
using ToQUBO
using PySA
model = Model(() -> ToQUBO.Optimizer(PySA.Optimizer))
@variable(model, x[1:3], Bin)
@objective(model, Max, 1.0*x[1] + 2.0*x[2] + 3.0*x[3])
@constraint(model, 0.3*x[1] + 0.5*x[2] + 1.0*x[3] <= 1.6)
optimize!(model)
solution_summary(model)Application-oriented examples now live in the Examples in QUBO.jl section.
Citing ToQUBO.jl
<!– citation-policy:start –> For general use of ToQUBO.jl and the broader QUBO.jl ecosystem, cite the published journal article. The earlier arXiv preprint remains available, but the journal article is the version of record.
For a software citation, use the Zenodo concept DOI. The concept DOI is the evergreen identifier for the actively maintained archive and is the DOI recorded in CITATION.cff. When reproducibility requires an exact release, cite the matching version DOI instead. The version DOI for v0.8.1 is 10.5281/zenodo.24250064.
The BibTeX entries below pin that exact release. Replace the @software entry's doi and url with the concept DOI when an evergreen software citation is preferred:
@article{xavier2026qubojl,
author = {Maciel Xavier, Pedro and Ripper, Pedro and Andrade, Tiago and Dias Garcia, Joaquim and Maculan, Nelson and Bernal Neira, David E.},
title = {{QUBO.jl: a Julia ecosystem for quadratic unconstrained binary optimization}},
journal = {Optimization Methods and Software},
year = {2026},
pages = {1--24},
doi = {10.1080/10556788.2026.2702926},
url = {https://doi.org/10.1080/10556788.2026.2702926}
}
@software{toqubo:2026,
author = {Maciel Xavier, Pedro and Ripper, Pedro and Andrade, Tiago and Dias Garcia, Joaquim and Bernal Neira, David E.},
title = {{ToQUBO.jl}},
year = {2026},
publisher = {Zenodo},
version = {v0.8.1},
doi = {10.5281/zenodo.24250064},
url = {https://doi.org/10.5281/zenodo.24250064},
note = {Evergreen concept DOI: 10.5281/zenodo.21763525}
}The historical concept DOI covers releases through v0.1.6 and remains part of the project's provenance; it is not the identifier for current releases. Machine-readable metadata is in CITATION.cff, with BibTeX in CITATION.bib. <!– citation-policy:end –>