Skip to main contentIBM Quantum Documentation Mirror

Primitive options

qiskit_ibm_runtime.options

Options that can be passed to the Qiskit Runtime primitives.


V2 Primitives

SamplerV2 and EstimatorV2 each have their own options. You can use the options attribute to set the options. For example:

from qiskit_ibm_runtime import QiskitRuntimeService, EstimatorV2
 
service = QiskitRuntimeService()
backend = service.least_busy(operational=True, simulator=False)
estimator = EstimatorV2(backend=backend)
estimator.options.resilience_level = 1

You can also use the update() method to do bulk update. For example:

from qiskit_ibm_runtime import QiskitRuntimeService, EstimatorV2
 
service = QiskitRuntimeService()
backend = service.least_busy(operational=True, simulator=False)
estimator = EstimatorV2(backend=backend)
estimator.options.update(resilience_level=1)

Refer to SamplerOptions and EstimatorOptions for V2 Sampler and V2 Estimator options, respectively.

Note

If an option is not specified, the server default value is used. The default values are subject to change. Refer to this current module’s documentation for the latest defaults.


Classes

Base primitive options

EstimatorOptions(*args, **kwargs)Options for V2 Estimator.
SamplerOptions(*args, **kwargs)Options for V2 Sampler.

Suboptions

NoiseLearnerOptions(*args, **kwargs)Options for NoiseLearner.
DynamicalDecouplingOptions(*args, **kwargs)Options for dynamical decoupling (DD).
ResilienceOptionsV2(*args, **kwargs)Resilience options for V2 Estimator.
LayerNoiseLearningOptions(*args, **kwargs)Options for learning layer noise.
MeasureNoiseLearningOptions(*args, **kwargs)Options for measurement noise learning.
PecOptions(*args, **kwargs)Probabalistic error cancellation mitigation options.
ZneOptions(*args, **kwargs)Zero noise extrapolation mitigation options.
TwirlingOptions(*args, **kwargs)Twirling options.
ExecutionOptionsV2(*args, **kwargs)Execution options for V2 primitives.
SamplerExecutionOptionsV2(*args, **kwargs)Extension of ExecutionOptionsV2 for the sampler primitive.
EnvironmentOptions(*args, **kwargs)Options related to the execution environment.
SimulatorOptions(*args, **kwargs)Simulator options.