TwirlingOptions

class TwirlingOptions(enable_gates=Unset, enable_measure=Unset, num_randomizations=Unset, shots_per_randomization=Unset, strategy=Unset)

GitHub

Bases: object

Twirling options.

Attributes

Parameters

enable_gates (UnsetType | bool)
enable_measure (UnsetType | bool)
num_randomizations (UnsetType | int | Literal['auto'])
shots_per_randomization (UnsetType | int | Literal['auto'])
strategy (UnsetType | Literal['active', 'active-accum', 'active-circuit', 'all'])

enable_gates

유형: UnsetType | bool

기본값: Unset

Whether to apply 2-qubit Clifford gate twirling.

Default: False.

enable_measure

유형: UnsetType | bool

기본값: Unset

Whether to enable twirling to measurement instructions, as long as the measurement is not involved within a conditional block.

Default: True for Estimator, False for Sampler.

num_randomizations

유형: UnsetType | int | Literal['auto']

기본값: Unset

The number of random samples to use when twirling or peforming sampled mitigation.

If num_randomizations is “auto”, for every pub executed shots times:

If shots_per_randomization is also “auto”, shots_per_randomization is set first as described below, then num_randomizations is set as ceil(shots/shots_per_randomization), where ceil is the ceiling function.

Otherwise, the value is set to ceil(shots/shots_per_randomization).

Default: "auto".

Note

The shots value specified in a PUB or in the run() method is considered part of the primitive execution interface and therefore is always obeyed. default_shots, on the other hand, is considered a Qiskit Runtime specific option. Therefore, the product of num_randomizations and shots_per_randomization takes precedence over default_shots.

shots_per_randomization

유형: UnsetType | int | Literal['auto']

기본값: Unset

The number of shots to run for each random sample.

If “auto”, for every pub executed shots times:

If num_randomizations is also “auto”, the value is set to 64 for PEC mitigation or to max(64, ceil(shots / 32)) in all other cases, where ceil is the ceiling function.

Otherwise, the value is set to ceil(shots/num_randomizations).

Default: "auto".

Note

strategy

유형: UnsetType | Literal['active', 'active-accum', 'active-circuit', 'all']

기본값: Unset

Specify the strategy of twirling qubits in identified layers of 2-qubit twirled gates.

Allowed values are:

If "active" only the instruction qubits in each individual twirled layer will be twirled.

If "active-circuit" the union of all instruction qubits in the circuit will be twirled in each twirled layer.

If "active-accum" the union of instructions qubits in the circuit up to the current twirled layer will be twirled in each individual twirled layer.

If "all" all qubits in the input circuit will be twirled in each twirled layer.

Default: "active-accum".

Image illustrating the differences among twirling strategies. If "active", only instruction qubits in each layer will be twirled. If "active-circuit", all instruction qubits in the circuit will be twirled. If "active-accum", the union all instruction qubits in the circuit up to the current twirled layer will be twirled. Finally, if "all", all qubits in the input circuit will be twirled in each twirled layer.

Methods

이 페이지가 도움이 되었습니까?

GitHub에서 버그, 오타를 보고하거나 컨텐츠를 요청하십시오.