Lewati ke konten utama

Pengenalan opsi

Kamu bisa meneruskan opsi ke primitif untuk menyesuaikannya sesuai kebutuhan. Bagian ini berfokus pada opsi primitif Qiskit Runtime. Meskipun antarmuka metode run() pada primitif sama di semua implementasi, opsinya tidak sama. Lihat referensi API yang sesuai untuk informasi tentang opsi qiskit.primitives dan qiskit_aer.primitives.

Gambaran umum​

Struktur​

Saat memanggil primitif, kamu bisa meneruskan opsi menggunakan kelas opsi atau dictionary. Opsi yang sering digunakan, seperti resilience_level, ada di level pertama. Opsi lainnya dikelompokkan ke kategori yang berbeda, seperti execution. Lihat bagian Set primitive options untuk detail lengkapnya.

Default​

Kalau kamu tidak menentukan nilai untuk suatu opsi, opsi itu akan diberi nilai khusus Unset dan nilai default server yang akan dipakai. Jadi, nilai default-nya akan sama terlepas dari versi kode kamu.

Tabel di bagian Ringkasan kelas opsi mencantumkan nilai default-nya.

Set opsi​

Opsi bisa didefinisikan sebelum primitif dibuat lalu diteruskan ke primitif, yang akan membuat salinannya. Ini bisa dilakukan sebagai nested dictionary atau menggunakan kelas opsi. Selain itu, setelah primitif dibuat, opsinya bisa diubah. Gunakan alur kerja yang paling cocok untuk aplikasimu. Lihat Specify options untuk detail lengkapnya.

Ringkasan kelas opsi​

  • Dynamical decoupling: Opsi untuk dynamical decoupling.
  • Environment: Opsi lingkungan eksekusi, seperti level logging yang mau diset dan tag job yang mau ditambahkan.
  • Execution: Opsi eksekusi primitif, termasuk apakah mau menginisialisasi Qubit dan repetition delay.
  • Resilience: Opsi lanjutan untuk mengonfigurasi metode error mitigation seperti measurement error mitigation, ZNE, dan PEC.
  • Simulator: Opsi simulator, seperti basis gate, simulator seed, dan coupling map. Hanya berlaku untuk mode pengujian lokal.
  • Twirling: Opsi twirling, seperti apakah mau menerapkan two-qubit gate twirling dan jumlah shot yang dijalankan untuk setiap sampel acak.

Opsi yang tersedia​

Tabel berikut mendokumentasikan opsi dari versi terbaru qiskit-ibm-runtime. Untuk melihat versi opsi yang lebih lama, kunjungi referensi API qiskit-ibm-runtime dan pilih versi sebelumnya.

default_shots​

Jumlah total shot yang digunakan per Circuit per konfigurasi.

Pilihan: Integer >= 0

Default: None

Dokumentasi API default_shots

default_precision​

Presisi default yang digunakan untuk PUB atau panggilan run() yang tidak menentukan presisi secara eksplisit.

Pilihan: Float > 0

Default: 0.015625 (1 / sqrt(4096))

Dokumentasi API default_precision

dynamical_decoupling​

Kendalikan pengaturan error mitigation dynamical decoupling.

Dokumentasi API dynamical_decoupling

dynamical_decoupling.enable​

Pilihan: True, False

Default: False

dynamical_decoupling.extra_slack_distribution​

Pilihan: middle, edges

Default: middle

dynamical_decoupling.scheduling_method​

Pilihan: asap, alap Default: alap

dynamical_decoupling.sequence_type​

Pilihan: XX, XpXm, XY4 Default: XX

dynamical_decoupling.skip_reset_qubits​

Pilihan: True, False Default: False

environment​

Dokumentasi API environment

environment.callback​

Fungsi callable yang menerima Job ID dan Job result.

Pilihan: None

Default: None

environment.job_tags​

Daftar tag.

Pilihan: None

Default: None

environment.log_level​

Pilihan: DEBUG, INFO, WARNING, ERROR, CRITICAL

Default: WARNING

environment.private​

Pilihan: True, False

Default: False

execution​

Dokumentasi API execution

execution.init_qubits​

Apakah mau mereset Qubit ke ground state untuk setiap shot.

Pilihan: True, False

Default: True

execution.rep_delay​

Jeda antara pengukuran dan Circuit kuantum berikutnya.

Pilihan: Nilai dalam rentang yang disediakan oleh backend.rep_delay_range

Default: Diberikan oleh backend.default_rep_delay

max_execution_time​

Pilihan: Jumlah detik berupa integer dalam rentang [1, 10800]

Default: 10800 (3 jam)

Dokumentasi API max_execution_time

resilience​

Opsi resilience lanjutan untuk menyetel strategi resilience secara detail.

Dokumentasi API resilience

resilience.layer_noise_learning​

Opsi untuk mempelajari noise layer.

Dokumentasi API resilience.layer_noise_learning

resilience.layer_noise_learning.layer_pair_depths​

Pilihan: list[int] berisi 2–10 nilai dalam rentang [0, 200]

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

resilience.layer_noise_learning.max_layers_to_learn​

Pilihan: None, Integer >= 1

Default: 4

resilience.layer_noise_learning.num_randomizations​

Pilihan: Integer >= 1

Default: 32

resilience.layer_noise_learning.shots_per_randomization​

Pilihan: Integer >= 1

Default: 128

resilience.layer_noise_model​

Pilihan: NoiseLearnerResult, Sequence[LayerError]

Default: None

resilience.measure_mitigation​

Pilihan: True, False

Default: True

resilience.measure_noise_learning​

Opsi untuk mempelajari noise pengukuran.

Dokumentasi API resilience.measure_noise_learning

resilience.measure_noise_learning.num_randomizations​

Pilihan: Integer >= 1

Default: 32

resilience.measure_noise_learning.shots_per_randomization​

Pilihan: Integer, auto

Default: auto

resilience.pec_mitigation​

Pilihan: True, False

Default: False

resilience.pec​

Opsi mitigasi probabilistic error cancellation.

Dokumentasi API resilience.pec

resilience.pec.max_overhead​

Pilihan: None, Integer >= 1

Default: 100

resilience.pec.noise_gain​

Pilihan: auto, float dalam rentang [0, 1]

Default: auto

resilience.zne_mitigation​

Pilihan: True, False

Default: False

resilience.zne​

resilience.zne.amplifier​

Pilihan: gate_folding, gate_folding_front, gate_folding_back, pea

Default: gate_folding

resilience.zne.extrapolated_noise_factors​

Pilihan: Daftar float

Default: [0, *noise_factors]

resilience.zne.extrapolator​

Pilihan: Satu atau lebih dari: exponential, linear, double_exponential, polynomial_degree_(1 <= k <= 7), fallback

Default: (exponential, linear)

resilience.zne.noise_factors​

Pilihan: Daftar float; setiap float >= 1

Default: (1, 1.5, 2) untuk PEA, dan (1, 3, 5) selainnya

resilience_level​

Seberapa besar ketahanan yang dibangun terhadap kesalahan. Level yang lebih tinggi menghasilkan hasil yang lebih akurat dengan mengorbankan waktu pemrosesan yang lebih lama.

Pilihan: 0, 1, 2

Default: 1

resilience_level dokumentasi API

seed_estimator​

Pilihan: Integer

Default: None

seed_estimator

simulator​

Opsi yang diteruskan saat mensimulasikan backend

simulator dokumentasi API

simulator.basis_gates​

Pilihan: Daftar nama gate basis untuk di-unroll

Default: Kumpulan semua gate basis yang didukung oleh simulator Qiskit Aer

simulator.coupling_map​

Pilihan: Daftar interaksi dua-qubit terarah

Default: None, yang berarti tidak ada batasan konektivitas (konektivitas penuh).

simulator.noise_model​

Pilihan: Qiskit Aer NoiseModel, atau representasinya

Default: None

simulator.seed_simulator​

Pilihan: Integer

Default: None

twirling​

Opsi twirling

twirling dokumentasi API

twirling.enable_gates​

Pilihan: True, False

Default: False

twirling.enable_measure​

Pilihan: True, False

Default: True

twirling.num_randomizations​

Pilihan: auto, Integer >= 1

Default: auto

twirling.shots_per_randomization​

Pilihan: auto, Integer >= 1

Default: auto

twirling.strategy​

Pilihan: active, active-circuit, active-accum, all

Default: active-accum

experimental​

Opsi eksperimental, jika tersedia.

Kompatibilitas fitur​

Karena perbedaan proses kompilasi perangkat, fitur-fitur runtime tertentu tidak bisa dipakai bersamaan dalam satu job. Klik tab yang sesuai untuk melihat daftar fitur yang tidak kompatibel dengan fitur yang dipilih:

Tidak kompatibel dengan:

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

Catatan lain:

  • Bisa dipakai dengan gate twirling untuk gate non-conditional.
  • Kompatibel dengan fractional gate saat menggunakan qiskit-ibm-runtime v0.42.0 atau lebih baru.

Langkah selanjutnya​

Rekomendasi
Source: IBM Quantum docs — updated 27 Apr 2026
English version on doQumentation — updated 7 Mei 2026
This translation based on the English version of 11 Mar 2026