dwave.system.composites.AutoEmbeddingComposite.sample

AutoEmbeddingComposite.sample(bqm, **parameters)[source]

Sample from the provided binary quadratic model.

Parameters:
  • bqm (dimod.BinaryQuadraticModel) – Binary quadratic model to be sampled from.
  • chain_strength (float, optional, default=1.0) – Magnitude of the quadratic bias (in SPIN-space) applied between variables to create chains. The energy penalty of chain breaks is 2 * chain_strength.
  • chain_break_method (function, optional) – Method used to resolve chain breaks during sample unembedding. See unembed_sampleset().
  • chain_break_fraction (bool, optional, default=True) – Add a chain_break_fraction field to the unembedded response with the fraction of chains broken before unembedding.
  • embedding_parameters (dict, optional) – If provided, parameters are passed to the embedding method as keyword arguments. Overrides any embedding_parameters passed to the constructor.
  • return_embedding (bool, optional) – If True, the embedding, chain strength, chain break method and embedding parameters are added to dimod.SampleSet.info of the returned sample set. The default behaviour is defined by return_embedding_default, which itself defaults to False.
  • warnings (WarningAction, optional) – Defines what warning action to take, if any. See warnings. The default behaviour is defined by warnings_default, which itself defaults to IGNORE
  • **parameters – Parameters for the sampling method, specified by the child sampler.
Returns:

dimod.SampleSet

Examples

See the example in EmbeddingComposite.