Lumaktaw sa pangunahing nilalaman

Panimula sa mga opsyon

Maaari kang magpasa ng mga opsyon sa mga primitive para i-customize ang mga ito ayon sa iyong pangangailangan. Ang seksyong ito ay nakatuon sa mga opsyon ng Qiskit Runtime primitive. Habang ang interface ng run() na paraan ng mga primitive ay pare-pareho sa lahat ng implementasyon, hindi ganoon ang kanilang mga opsyon. Tingnan ang kaukulang mga API reference para sa impormasyon tungkol sa mga opsyon ng qiskit.primitives at qiskit_aer.primitives.

Pangkalahatang-ideya​

Istraktura​

Kapag tinatawagan ang mga primitive, maaari kang magpasa ng mga opsyon sa pamamagitan ng isang options class o isang dictionary. Ang mga madalas gamitin na opsyon, tulad ng resilience_level, ay nasa unang antas. Ang ibang mga opsyon ay nakagrupo sa iba't ibang kategorya, tulad ng execution. Tingnan ang seksyon ng Itakda ang mga opsyon ng primitive para sa kumpletong detalye.

Mga default​

Kung hindi mo tinukoy ang halaga para sa isang opsyon, bibigyan ito ng espesyal na halaga na Unset at gagamitin ang default na halaga ng server. Kaya naman, magiging pareho ang default na halaga anuman ang bersyon ng iyong code.

Inilista ng mga talahanayan sa seksyon ng Buod ng mga options class ang mga default na halaga.

Itakda ang mga opsyon​

Maaaring tukuyin ang mga opsyon bago pa itayo ang isang primitive at ipasa ito sa primitive, na gumagawa ng kopya ng mga ito. Magagawa ito bilang isang nested dictionary, o sa pamamagitan ng paggamit ng mga options class. Bukod pa rito, pagkatapos magtayo ng primitive, maaaring baguhin ang mga opsyon nito. Gamitin ang daloy ng trabaho na pinaka-angkop para sa iyong application. Tingnan ang Tukuyin ang mga opsyon para sa kumpletong detalye.

Buod ng mga options class​

  • Dynamical decoupling: Mga opsyon para sa dynamical decoupling.
  • Environment: Mga opsyon sa kapaligiran ng pagpapatakbo, tulad ng logging level na itatakda at mga job tag na idadagdag.
  • Execution: Mga opsyon sa pagpapatakbo ng primitive, kabilang ang kung i-initialize ang mga Qubit at ang repetition delay.
  • Resilience: Mga advanced na opsyon para sa pag-configure ng mga paraan ng error mitigation tulad ng measurement error mitigation, ZNE, at PEC.
  • Simulator: Mga opsyon ng simulator, tulad ng mga basis gate, simulator seed, at coupling map. Naaangkop sa lokal na testing mode lamang.
  • Twirling: Mga opsyon ng twirling, tulad ng kung mag-aaply ng two-qubit gate twirling at ang bilang ng shots na tatakbuhin para sa bawat random na sample.

Mga available na opsyon​

Idino-dokumento ng sumusunod na talahanayan ang mga opsyon mula sa pinakabagong bersyon ng qiskit-ibm-runtime. Para makita ang mga mas lumang bersyon ng opsyon, bisitahin ang qiskit-ibm-runtime API reference at pumili ng nakaraang bersyon.

default_shots​

Ang kabuuang bilang ng shots na gagamitin bawat Circuit bawat configuration.

Mga pagpipilian: Integer >= 0

Default: None

default_shots na dokumentasyon ng API

default_precision​

Ang default na precision na gagamitin para sa anumang PUB o run() na tawag na hindi nagtutukoy ng isa.

Mga pagpipilian: Float > 0

Default: 0.015625 (1 / sqrt(4096))

default_precision na dokumentasyon ng API

dynamical_decoupling​

Kontrolin ang mga setting ng dynamical decoupling error mitigation.

dynamical_decoupling na dokumentasyon ng API

dynamical_decoupling.enable​

Mga pagpipilian: True, False

Default: False

dynamical_decoupling.extra_slack_distribution​

Mga pagpipilian: middle, edges

Default: middle

dynamical_decoupling.scheduling_method​

Mga pagpipilian: asap, alap Default: alap

dynamical_decoupling.sequence_type​

Mga pagpipilian: XX, XpXm, XY4 Default: XX

dynamical_decoupling.skip_reset_qubits​

Mga pagpipilian: True, False Default: False

environment​

environment na dokumentasyon ng API

environment.callback​

Callable na function na tumatanggap ng Job ID at Job result.

Mga pagpipilian: None

Default: None

environment.job_tags​

Listahan ng mga tag.

Mga pagpipilian: None

Default: None

environment.log_level​

Mga pagpipilian: DEBUG, INFO, WARNING, ERROR, CRITICAL

Default: WARNING

environment.private​

Mga pagpipilian: True, False

Default: False

execution​

execution na dokumentasyon ng API

execution.init_qubits​

Kung ire-reset ang mga Qubit sa ground state para sa bawat shot.

Mga pagpipilian: True, False

Default: True

execution.rep_delay​

Ang pagitan sa pagitan ng isang sukat at ng kasunod na quantum Circuit.

Mga pagpipilian: Halaga sa hanay na ibinibigay ng backend.rep_delay_range

Default: Ibinibigay ng backend.default_rep_delay

max_execution_time​

Mga pagpipilian: Integer na bilang ng segundo sa hanay na [1, 10800]

Default: 10800 (3 oras)

max_execution_time na dokumentasyon ng API

resilience​

Mga advanced na opsyon ng resilience para pinong i-tune ang resilience strategy.

resilience na dokumentasyon ng API

resilience.layer_noise_learning​

Mga opsyon para sa pag-aaral ng layer noise.

resilience.layer_noise_learning na dokumentasyon ng API

resilience.layer_noise_learning.layer_pair_depths​

Mga pagpipilian: list[int] ng 2–10 na halaga sa hanay na [0, 200]

Default: (0, 1, 2, 4, 16, 32)

resilience.layer_noise_learning.max_layers_to_learn​

Mga pagpipilian: None, Integer >= 1

Default: 4

resilience.layer_noise_learning.num_randomizations​

Mga pagpipilian: Integer >= 1

Default: 32

resilience.layer_noise_learning.shots_per_randomization​

Mga pagpipilian: Integer >= 1

Default: 128

resilience.layer_noise_model​

Mga pagpipilian: NoiseLearnerResult, Sequence[LayerError]

Default: None

resilience.measure_mitigation​

Mga pagpipilian: True, False

Default: True

resilience.measure_noise_learning​

Mga opsyon para sa pag-aaral ng measurement noise.

resilience.measure_noise_learning na dokumentasyon ng API

resilience.measure_noise_learning.num_randomizations​

Mga pagpipilian: Integer >= 1

Default: 32

resilience.measure_noise_learning.shots_per_randomization​

Mga pagpipilian: Integer, auto

Default: auto

resilience.pec_mitigation​

Mga pagpipilian: True, False

Default: False

resilience.pec​

Mga opsyon ng probabilistic error cancellation mitigation.

resilience.pec na dokumentasyon ng API

resilience.pec.max_overhead​

Mga pagpipilian: None, Integer >= 1

Default: 100

resilience.pec.noise_gain​

Mga pagpipilian: auto, float sa hanay na [0, 1]

Default: auto

resilience.zne_mitigation​

Mga pagpipilian: True, False

Default: False

resilience.zne​

resilience.zne.amplifier​

Mga pagpipilian: gate_folding, gate_folding_front, gate_folding_back, pea

Default: gate_folding

resilience.zne.extrapolated_noise_factors​

Mga pagpipilian: Listahan ng mga float

Default: [0, *noise_factors]

resilience.zne.extrapolator​

Mga pagpipilian: Isa o higit pa sa: exponential, linear, double_exponential, polynomial_degree_(1 <= k <= 7), fallback

Default: (exponential, linear)

resilience.zne.noise_factors​

Mga pagpipilian: Listahan ng mga float; bawat float >= 1

Default: (1, 1.5, 2) para sa PEA, at (1, 3, 5) para sa iba

resilience_level​

Gaano karaming resilience ang itatayo laban sa mga error. Mas mataas na antas ay nagbibigay ng mas tumpak na mga resulta ngunit mas matagal ang pagpoproseso.

Mga pagpipilian: 0, 1, 2

Default: 1

resilience_level na dokumentasyon ng API

seed_estimator​

Mga pagpipilian: Integer

Default: None

seed_estimator

simulator​

Mga opsyon na ipapasa kapag nagsi-simulate ng isang Backend

simulator na dokumentasyon ng API

simulator.basis_gates​

Mga pagpipilian: Listahan ng mga pangalan ng basis gate na i-unroll

Default: Ang set ng lahat ng basis gate na sinusuportahan ng Qiskit Aer simulator

simulator.coupling_map​

Mga pagpipilian: Listahan ng mga direktibong two-qubit na interaksyon

Default: None, na nangangahulugang walang mga hadlang sa koneksyon (buong koneksyon).

simulator.noise_model​

Mga pagpipilian: Qiskit Aer NoiseModel, o ang representasyon nito

Default: None

simulator.seed_simulator​

Mga pagpipilian: Integer

Default: None

twirling​

Mga opsyon ng twirling

twirling na dokumentasyon ng API

twirling.enable_gates​

Mga pagpipilian: True, False

Default: False

twirling.enable_measure​

Mga pagpipilian: True, False

Default: True

twirling.num_randomizations​

Mga pagpipilian: auto, Integer >= 1

Default: auto

twirling.shots_per_randomization​

Mga pagpipilian: auto, Integer >= 1

Default: auto

twirling.strategy​

Mga pagpipilian: active, active-circuit, active-accum, all

Default: active-accum

experimental​

Mga experimental na opsyon, kung available.

Compatibility ng mga feature​

Dahil sa mga pagkakaiba sa proseso ng pag-compile ng device, ang ilang runtime feature ay hindi magagamit nang sabay-sabay sa iisang job. I-click ang angkop na tab para makita ang listahan ng mga feature na hindi compatible sa napiling feature:

Hindi compatible sa:

  • Gate-folding ZNE
  • PEA
  • PEC
  • Dynamical decoupling

Iba pang mga tala:

  • Maaaring gamitin kasama ang gate twirling para sa mga non-conditional na Gate.
  • Compatible sa fractional gates kapag gumagamit ng qiskit-ibm-runtime v0.42.0 o mas bago.

Mga susunod na hakbang​

Mga rekomendasyon