mqt.ddsim.primitives

Module for Qiskit Primitives.

Submodules

• mqt.ddsim.primitives.estimator
• mqt.ddsim.primitives.sampler

Package Contents

class Estimator(*, default_precision: float = 0.0, seed: int = -1)

Bases: qiskit.primitives.base.BaseEstimatorV2

DDSIM implementation of Qiskit’s estimator.

The implementation is adapted from Qiskit’s StatevectorEstimator.

property default_precision: float

Return the default precision.

property seed: int

Return the seed.

run(pubs: Iterable[qiskit.primitives.containers.EstimatorPubLike], *, precision: float | None = None) → PrimitiveJob[qiskit.primitives.containers.PrimitiveResult[qiskit.primitives.containers.PubResult]]

Estimate expectation values for each provided PUB (primitive unified bloc).

Each PUB is run on the CircuitSimulator.

Parameters:

• pubs – An iterable of pub-like objects, such as tuples (circuit, observables) or (circuit, observables, parameter_values).

• precision – The target precision for expectation-value estimates. If None, the default precision is used.

class Sampler(*, default_shots: int = 1024, seed: int = -1)

Bases: qiskit.primitives.base.BaseSamplerV2

DDSIM implementation of Qiskit’s sampler.

The implementation is adapted from Qiskit’s StatevectorSampler.

property default_shots: int

Return the default shots.

property seed: int

Return the seed.

run(pubs: Iterable[qiskit.primitives.containers.SamplerPubLike], *, shots: int | None = None) → PrimitiveJob[qiskit.primitives.containers.PrimitiveResult[qiskit.primitives.containers.SamplerPubResult]]

Run and collect samples from each provided PUB (primitive unified bloc).

Each PUB is run on the CircuitSimulator.

Parameters:

• pubs – An iterable of pub-like objects, such as tuples (circuit, parameter_values).

• shots – The number of shots to sample. If None, the default number of shots is used.