QMLSampler¶

class QMLSampler(*, shots=None, **kwargs)[source]¶

Bases: StatevectorSampler

V2-based sampler primitive with two modes.

shots=None (default): exact mode, no sampling. Returns deterministic probabilities.

shots=int : sampling mode, delegate to StatevectorSampler with given default_shots.

Statevector-based sampler supporting exact (analytic) and sampling modes.

Parameters:

shots (int | None) – Number of shots for sampling mode. If None, run in exact mode.
**kwargs – Additional arguments forwarded to StatevectorSampler.

Returns:

Configured sampler instance.

Return type:

QMLSampler

Attributes

default_shots¶: Return the default shots

seed¶: Return the seed or Generator object for random number generation.

Methods

run(pubs, *, shots=None)[source]¶

Run the sampler on PUBs.

Parameters:

pubs (Iterable[SamplerPubLike]) – Publications to evaluate.
shots (int | None) – Optional override for number of shots.

Returns:

Job executing the sampler.

Return type:

PrimitiveJob[PrimitiveResult[SamplerPubResult]]