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-01

Using 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 –>