---
title: EstimatorOptions (v0.26)
description: API reference for qiskit_ibm_runtime.options.EstimatorOptions in qiskit-ibm-runtime v0.26
source: https://quantum.cloud.ibm.com/docs/en/api/qiskit-ibm-runtime/0.26/options-estimator-options
---

# EstimatorOptions

*class* `EstimatorOptions(*args, **kwargs)`

[GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.26/qiskit_ibm_runtime/options/estimator_options.py#L35-L134)

Options for V2 Estimator.

**Parameters**

- **default\_precision** – The default precision to use for any PUB or `run()` call that does not specify one. Each estimator pub can specify its own precision. If the `run()` method is given a precision, then that value is used for all PUBs in the `run()` call that do not specify their own. Default: 0.015625 (1 / sqrt(4096)).

- **default\_shots** –

  The total number of shots to use per circuit per configuration.

  > **Note**
  >
  > If set, this value overrides [`default_precision`](#qiskit_ibm_runtime.options.EstimatorOptions.default_precision "qiskit_ibm_runtime.options.EstimatorOptions.default_precision").

  A configuration is a combination of a specific parameter value binding set and a physical measurement basis. A physical measurement basis groups together some collection of qubit-wise commuting observables for some specific circuit/parameter value set to create a single measurement with basis rotations that is inserted into hardware executions.

  If twirling is enabled, the value of this option will be divided over circuit, randomizations, with a smaller number of shots per randomization. See the [`twirling`](#qiskit_ibm_runtime.options.EstimatorOptions.twirling "qiskit_ibm_runtime.options.EstimatorOptions.twirling") options.

  Default: `None`.

- **optimization\_level** –

  (DEPRECATED) How much optimization to perform on the circuits. Higher levels generate more optimized circuits, at the expense of longer processing times.

  - 0: no optimization
  - 1: light optimization

  Default: 0.

- **resilience\_level** –

  How much resilience to build against errors. Higher levels generate more accurate results, at the expense of longer processing times.

  - 0: No mitigation.
  - 1: Minimal mitigation costs. Mitigate error associated with readout errors.
  - 2: Medium mitigation costs. Typically reduces bias in estimators but is not guaranteed to be zero bias.

  Refer to the [Configure error mitigation for Qiskit Runtime](/docs/run/configure-error-mitigation). for more information about the error mitigation methods used at each level.

  Default: 1.

- **seed\_estimator** – Seed used to control sampling. Default: `None`.

- **dynamical\_decoupling** – Suboptions for dynamical decoupling. See [`DynamicalDecouplingOptions`](/docs/api/qiskit-ibm-runtime/0.26/options-dynamical-decoupling-options "qiskit_ibm_runtime.options.DynamicalDecouplingOptions") for all available options.

- **resilience** – Advanced resilience options to fine tune the resilience strategy. See [`ResilienceOptionsV2`](/docs/api/qiskit-ibm-runtime/0.26/options-resilience-options-v2 "qiskit_ibm_runtime.options.ResilienceOptionsV2") for all available options.

- **execution** – Execution time options. See [`ExecutionOptionsV2`](/docs/api/qiskit-ibm-runtime/0.26/options-execution-options-v2 "qiskit_ibm_runtime.options.ExecutionOptionsV2") for all available options.

- **twirling** – Pauli twirling options. See [`TwirlingOptions`](/docs/api/qiskit-ibm-runtime/0.26/options-twirling-options "qiskit_ibm_runtime.options.TwirlingOptions") for all available options.

- **experimental** –

  Experimental options. These options are subject to change without notification, and stability is not guaranteed. Currently, the available options are:

  - Probabilistic Error Amplification (PEA). To enable PEA, set:

    ```python
    estimator_options.experimental = {"resilience": {"zne": {"amplifier": "pea"}}}
    ```

    Since PEA is an amplification technique of ZNE, you will also need to enable ZNE by setting `resilience.zne_mitigation = True`. Other documented `resilience.zne` options can be used in conjunction to set extrapolators, amplification levels, etc. Experiments to learn a sparse Pauli noise model will be performed for every uniquely identified entangling layer (up to a specified cutoff) in the union of circuits across PUBs; see :class:\~.LayerNoiseLearningOptions\` for options. Add full-width barriers to specify layers unambiguously.

## Attributes

### default\_precision

Type: `UnsetType | float`

Default value: `Unset`

### default\_shots

Type: `UnsetType | int | None`

Default value: `Unset`

### dynamical\_decoupling

Type: `DynamicalDecouplingOptions | Dict`

Default value: `FieldInfo(annotation=Union[DynamicalDecouplingOptions, Dict], required=False, default_factory=DynamicalDecouplingOptions)`

### environment

Type: `EnvironmentOptions | Dict`

Default value: `FieldInfo(annotation=Union[EnvironmentOptions, Dict], required=False, default_factory=EnvironmentOptions)`

### execution

Type: `ExecutionOptionsV2 | Dict`

Default value: `FieldInfo(annotation=Union[ExecutionOptionsV2, Dict], required=False, default_factory=ExecutionOptionsV2)`

### experimental

Type: `UnsetType | dict`

Default value: `Unset`

### max\_execution\_time

Type: `UnsetType | int`

Default value: `Unset`

### optimization\_level

Type: `UnsetType | int`

Default value: `Unset`

### resilience

Type: `ResilienceOptionsV2 | Dict`

Default value: `FieldInfo(annotation=Union[ResilienceOptionsV2, Dict], required=False, default_factory=ResilienceOptionsV2)`

### resilience\_level

Type: `UnsetType | int`

Default value: `Unset`

### seed\_estimator

Type: `UnsetType | int`

Default value: `Unset`

### simulator

Type: `SimulatorOptions | Dict`

Default value: `FieldInfo(annotation=Union[SimulatorOptions, Dict], required=False, default_factory=SimulatorOptions)`

### twirling

Type: `TwirlingOptions | Dict`

Default value: `FieldInfo(annotation=Union[TwirlingOptions, Dict], required=False, default_factory=TwirlingOptions)`

## Methods

### update

`update(**kwargs)`

[GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.26/qiskit_ibm_runtime/options/options.py#L153-L173)

Update the options.

**Return type**

`None`