---
title: EstimatorOptions (latest version)
description: API reference for qiskit_ibm_runtime.options.EstimatorOptions in the latest version of qiskit-ibm-runtime
source: https://eu-de.quantum.cloud.ibm.com/docs/en/api/qiskit-ibm-runtime/options-estimator-options
---

# EstimatorOptions

*class* `EstimatorOptions(_VERSION=2, max_execution_time=Unset, environment=<factory>, simulator=<factory>, default_precision=Unset, default_shots=Unset, resilience_level=Unset, seed_estimator=Unset, dynamical_decoupling=<factory>, resilience=<factory>, execution=<factory>, twirling=<factory>, experimental=Unset)`

[GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.49/qiskit_ibm_runtime/options/estimator_options.py#L27-L117)

Bases: `OptionsV2`

Options for V2 Estimator.

## Attributes

**Parameters**

- **\_VERSION** (*int*)
- **max\_execution\_time** (*UnsetType | int*)
- **environment** ([*EnvironmentOptions*](/docs/api/qiskit-ibm-runtime/options-environment-options "qiskit_ibm_runtime.options.environment_options.EnvironmentOptions") *| Dict*)
- **simulator** ([*SimulatorOptions*](/docs/api/qiskit-ibm-runtime/options-simulator-options "qiskit_ibm_runtime.options.simulator_options.SimulatorOptions") *| Dict*)
- **default\_precision** (*UnsetType | float*)
- **default\_shots** (*UnsetType | int | None*)
- **resilience\_level** (*UnsetType | int*)
- **seed\_estimator** (*UnsetType | int*)
- **dynamical\_decoupling** ([*DynamicalDecouplingOptions*](/docs/api/qiskit-ibm-runtime/options-dynamical-decoupling-options "qiskit_ibm_runtime.options.dynamical_decoupling_options.DynamicalDecouplingOptions") *| Dict*)
- **resilience** ([*ResilienceOptionsV2*](/docs/api/qiskit-ibm-runtime/options-resilience-options-v2 "qiskit_ibm_runtime.options.resilience_options.ResilienceOptionsV2") *| Dict*)
- **execution** ([*ExecutionOptionsV2*](/docs/api/qiskit-ibm-runtime/options-execution-options-v2 "qiskit_ibm_runtime.options.execution_options.ExecutionOptionsV2") *| Dict*)
- **twirling** ([*TwirlingOptions*](/docs/api/qiskit-ibm-runtime/options-twirling-options "qiskit_ibm_runtime.options.twirling_options.TwirlingOptions") *| Dict*)
- **experimental** (*UnsetType | dict*)

### default\_precision

Type: `UnsetType | float`

Default value: `Unset`

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

Type: `UnsetType | int | None`

Default value: `Unset`

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`.

### dynamical\_decoupling

Type: `DynamicalDecouplingOptions | Dict`

Default value: `FieldInfo(annotation=NoneType, required=False, default_factory=DynamicalDecouplingOptions)`

Suboptions for dynamical decoupling.

See [`DynamicalDecouplingOptions`](/docs/api/qiskit-ibm-runtime/options-dynamical-decoupling-options "qiskit_ibm_runtime.options.DynamicalDecouplingOptions") for all available options.

### environment

Type: `EnvironmentOptions | Dict`

Default value: `FieldInfo(annotation=NoneType, required=False, default_factory=EnvironmentOptions)`

### execution

Type: `ExecutionOptionsV2 | Dict`

Default value: `FieldInfo(annotation=NoneType, required=False, default_factory=ExecutionOptionsV2)`

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

### experimental

Type: `UnsetType | dict`

Default value: `Unset`

Experimental options.

These options are subject to change without notification, and stability is not guaranteed.

### max\_execution\_time

Type: `UnsetType | int`

Default value: `Unset`

### resilience

Type: `ResilienceOptionsV2 | Dict`

Default value: `FieldInfo(annotation=NoneType, required=False, default_factory=ResilienceOptionsV2)`

Advanced resilience options to fine-tune the resilience strategy.

See [`ResilienceOptionsV2`](/docs/api/qiskit-ibm-runtime/options-resilience-options-v2 "qiskit_ibm_runtime.options.ResilienceOptionsV2") for all available options.

### resilience\_level

Type: `UnsetType | int`

Default value: `Unset`

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/guides/configure-error-mitigation) guide for more information about the error mitigation methods used at each level.

Default: 1.

### seed\_estimator

Type: `UnsetType | int`

Default value: `Unset`

Seed used to control sampling.

Default: `None`.

### simulator

Type: `SimulatorOptions | Dict`

Default value: `FieldInfo(annotation=NoneType, required=False, default_factory=SimulatorOptions)`

### twirling

Type: `TwirlingOptions | Dict`

Default value: `FieldInfo(annotation=NoneType, required=False, default_factory=TwirlingOptions)`

Pauli twirling options.

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

## Methods

### update

`update(**kwargs)`

[GitHub](https://github.com/Qiskit/qiskit-ibm-runtime/tree/stable/0.49/qiskit_ibm_runtime/options/options.py#L147-L156)

Update the options.

**Parameters**

**kwargs** (*Any*)

**Return type**

None
