qiskit_addon_opt_mapper.applications.ExactCover

class ExactCover(subsets)[source]

Bases: OptimizationApplication

Optimization application for the “exact cover” [1] problem.

References

[1]: “Exact cover”, https://en.wikipedia.org/wiki/Exact_cover

Init method.

Parameters:

subsets (list[list[int]]) – A list of subsets

__init__(subsets)[source]

Init method.

Parameters:

subsets (list[list[int]]) – A list of subsets

Return type:

None

Methods

__init__(subsets)

Init method.

interpret(result)

Interpret a result as a list of subsets.

sample_most_likely(state_vector)

Compute the most likely binary string from state vector.

to_optimization_problem()

Represent as an optimization problem.
interpret(result)[source]

Interpret a result as a list of subsets.

Parameters:

result (ndarray) – The calculated result of the problem

Returns:

A list of subsets whose corresponding variable is 1

Return type:

list[list[int]]

static sample_most_likely(state_vector)[source]

Compute the most likely binary string from state vector.

Parameters:

state_vector (QuasiDistribution | Statevector | ndarray | dict) – state vector or counts or quasi-probabilities.

Returns:

binary string as numpy.ndarray of ints.

Raises:

ValueError – if state_vector is not QuasiDistribution, Statevector, np.ndarray, or dict.

Return type:

ndarray

to_optimization_problem()[source]

Represent as an optimization problem.

Convert an exact cover instance into a OptimizationProblem

Returns:

The OptimizationProblem created from the exact cover instance.

Return type:

OptimizationProblem