Skip to main contentIBM Quantum Documentation

SamplerV2

class SamplerV2(mode=None, options=None)

GitHub

Class for interacting with Qiskit Runtime Sampler primitive service.

This class supports version 2 of the Sampler interface, which uses different input and output formats than version 1.

Qiskit Runtime Sampler primitive returns the sampled result according to the specified output type. For example, it returns a bitstring for each shot if measurement level 2 (bits) is requested.

The run() method can be used to submit circuits and parameters to the Sampler primitive.

Initializes the Sampler primitive.

Parameters

  • mode (Union[BackendV1, BackendV2, Session, Batch, str, None]) –

    The execution mode used to make the primitive query. It can be:

    • A Backend if you are using job mode.
    • A Session if you are using session execution mode.
    • A Batch if you are using batch execution mode.

    Refer to the Qiskit Runtime documentation. for more information about the Execution modes.

  • options (Union[Dict, SamplerOptions, None]) – Sampler options, see SamplerOptions for detailed description.


Attributes

mode

Return the execution mode used by this primitive.

Return type

Optional[Session | Batch]

Returns

Mode used by this primitive, or None if an execution mode is not used.

options

Type: SamplerOptions

Return options

Return type

TypeVar(OptionsT, bound= BaseOptions)

version

Default value: 2


Methods

backend

backend()

GitHub

Return the backend the primitive query will be run on.

Return type

BackendV1 | BackendV2

run

run(pubs, *, shots=None)

GitHub

Submit a request to the sampler primitive.

Parameters

  • pubs (Iterable[SamplerPubLike]) – An iterable of pub-like objects. For example, a list of circuits or tuples (circuit, parameter_values).
  • shots (int | None) – The total number of shots to sample for each sampler pub that does not specify its own shots. If None, the primitive’s default shots value will be used, which can vary by implementation.

Return type

RuntimeJobV2

Returns

Submitted job. The result of the job is an instance of qiskit.primitives.containers.PrimitiveResult.

Raises

ValueError – Invalid arguments are given.

Was this page helpful?
Report a bug or request content on GitHub.