BqmTranslator

BQM to AQM translator.

Utility class for converting between dimod.BinaryQuadraticModel (BQM) and symbolic models.

BqmTranslator provides methods to: - Convert a BQM into a symbolic Model - Convert a Model (with quadratic objective) into a BQM

These conversions are especially useful when interacting with external solvers or libraries that operate on BQMs.

Examples:

>>> import dimod
>>> import numpy as np
>>> from luna_quantum.translator import BqmTranslator, Vtype
>>> bqm = dimod.generators.gnm_random_bqm(5, 10, "BINARY")

Create a model from a matrix:

>>> model = BqmTranslator.to_aq(bqm, name="bqm_model")

Convert it back to a dense matrix:

>>> recovered = BqmTranslator.from_aq(model)

from_aq staticmethod

from_aq(model: Model) -> BinaryQuadraticModel

Convert a symbolic model to a dense QUBO matrix representation.

Parameters:

Name	Type	Description	Default
model	Model	The symbolic model to convert. The objective must be quadratic-only and unconstrained.	required

Returns:

Type	Description
BinaryQuadraticModel	The resulting BQM.

Raises:

Type	Description
TranslationError	Generally if the translation fails. Might be specified by one of the four following errors.
ModelNotQuadraticError	If the objective contains higher-order (non-quadratic) terms.
ModelNotUnconstrainedError	If the model contains any constraints.
ModelSenseNotMinimizeError	If the model's optimization sense is 'maximize'.
ModelVtypeError	If the model contains different vtypes or vtypes other than binary and spin.

to_aq staticmethod

to_aq(bqm: BinaryQuadraticModel) -> Model

to_aq(bqm: BinaryQuadraticModel, *, name: str) -> Model

to_aq(bqm: BinaryQuadraticModel, *, name: str | None = ...) -> Model

Convert a BQM into a symbolic Model.

Parameters:

Name	Type	Description	Default
bqm	BinaryQuadraticModel	The BQM.	required
name	str	An optional name to assign to the resulting model.	...

Returns:

Type	Description
Model	A symbolic model representing the given BQM.