dimod.binary.BinaryQuadraticModel.energy¶

BinaryQuadraticModel.energy(sample, dtype: Union[numpy.dtype[Any], None, Type[Any], numpy._typing._dtype_like._SupportsDType[numpy.dtype[Any]], str, Tuple[Any, int], Tuple[Any, Union[SupportsIndex, Sequence[SupportsIndex]]], List[Any], numpy._typing._dtype_like._DTypeDict, Tuple[Any, Any]] = None) → Union[float, numpy.floating, numpy.integer][source]¶

Determine the energy of the given sample.

Parameters

sample (samples_like) – Raw sample. samples_like is an extension of NumPy’s array_like structure. See as_samples().
dtype – Desired NumPy data type for the energy. Defaults to float64.

Returns

The energy.

Examples

>>> bqm = dimod.BinaryQuadraticModel({}, {("x0", "x1"): -1}, "BINARY")
>>> bqm.energy({"x0": 1, "x1": 1})
-1.0

See also the example under energies().