Langkau ke kandungan utama

Pengenalan kepada pilihan

Anda boleh menghantar pilihan kepada primitif untuk menyesuaikannya mengikut keperluan anda. Bahagian ini menumpukan pada pilihan primitif Qiskit Runtime. Walaupun antara muka kaedah run() primitif adalah sama di semua implementasi, pilihan mereka berbeza. Rujuk rujukan API yang berkaitan untuk maklumat tentang pilihan qiskit.primitives dan qiskit_aer.primitives.

Gambaran keseluruhan​

Struktur​

Apabila memanggil primitif, anda boleh menghantar pilihan menggunakan kelas pilihan atau kamus. Pilihan yang kerap digunakan, seperti resilience_level, berada di peringkat pertama. Pilihan lain dikumpulkan ke dalam kategori berbeza, seperti execution. Lihat bahagian Tetapkan pilihan primitif untuk butiran penuh.

Nilai lalai​

Jika anda tidak menentukan nilai untuk sesuatu pilihan, ia akan diberikan nilai khas Unset dan nilai lalai pelayan akan digunakan. Oleh itu, nilai lalai akan sama tanpa mengira versi kod anda.

Jadual dalam bahagian Ringkasan kelas pilihan menyenaraikan nilai lalai.

Tetapkan pilihan​

Pilihan boleh ditakrifkan sebelum primitif dibina dan dihantar kepada primitif, yang akan membuat salinannya. Ini boleh dilakukan sama ada sebagai kamus bersarang, atau menggunakan kelas pilihan. Selain itu, selepas primitif dibina, pilihannya boleh diubah. Gunakan aliran kerja yang paling sesuai untuk aplikasi anda. Lihat Tentukan pilihan untuk butiran penuh.

Ringkasan kelas pilihan​

  • Dynamical decoupling: Pilihan untuk dynamical decoupling.
  • Environment: Pilihan persekitaran pelaksanaan, seperti tahap pengelogan yang hendak ditetapkan dan tag kerja yang hendak ditambah.
  • Execution: Pilihan pelaksanaan primitif, termasuk sama ada hendak memulakan semula Qubit dan kelewatan pengulangan.
  • Resilience: Pilihan lanjutan untuk mengkonfigurasi kaedah mitigasi ralat seperti mitigasi ralat pengukuran, ZNE, dan PEC.
  • Simulator: Pilihan simulator, seperti gate asas, benih simulator, dan peta gandingan. Hanya terpakai kepada mod ujian tempatan.
  • Twirling: Pilihan twirling, seperti sama ada hendak menggunakan twirling Gate dua-Qubit dan bilangan shot yang hendak dijalankan bagi setiap sampel rawak.

Pilihan yang tersedia​

Jadual berikut mendokumentasikan pilihan daripada versi terkini qiskit-ibm-runtime. Untuk melihat versi pilihan yang lebih lama, layari rujukan API qiskit-ibm-runtime dan pilih versi sebelumnya.

default_shots​

Jumlah keseluruhan shot yang hendak digunakan bagi setiap Circuit bagi setiap konfigurasi.

Pilihan: Integer >= 0

Lalai: None

default_shots dokumentasi API

default_precision​

Ketepatan lalai yang hendak digunakan bagi mana-mana PUB atau panggilan run() yang tidak menentukannya.

Pilihan: Float > 0

Lalai: 0.015625 (1 / sqrt(4096))

default_precision dokumentasi API

dynamical_decoupling​

Kawal tetapan mitigasi ralat dynamical decoupling.

dynamical_decoupling dokumentasi API

dynamical_decoupling.enable​

Pilihan: True, False

Lalai: False

dynamical_decoupling.extra_slack_distribution​

Pilihan: middle, edges

Lalai: middle

dynamical_decoupling.scheduling_method​

Pilihan: asap, alap Lalai: alap

dynamical_decoupling.sequence_type​

Pilihan: XX, XpXm, XY4 Lalai: XX

dynamical_decoupling.skip_reset_qubits​

Pilihan: True, False Lalai: False

environment​

environment dokumentasi API

environment.callback​

Fungsi boleh panggil yang menerima Job ID dan Job result.

Pilihan: None

Lalai: None

environment.job_tags​

Senarai tag.

Pilihan: None

Lalai: None

environment.log_level​

Pilihan: DEBUG, INFO, WARNING, ERROR, CRITICAL

Lalai: WARNING

environment.private​

Pilihan: True, False

Lalai: False

execution​

execution dokumentasi API

execution.init_qubits​

Sama ada hendak menetapkan semula Qubit ke keadaan asas bagi setiap shot.

Pilihan: True, False

Lalai: True

execution.rep_delay​

Kelewatan antara pengukuran dan Circuit kuantum berikutnya.

Pilihan: Nilai dalam julat yang dibekalkan oleh backend.rep_delay_range

Lalai: Diberikan oleh backend.default_rep_delay

max_execution_time​

Pilihan: Bilangan integer saat dalam julat [1, 10800]

Lalai: 10800 (3 jam)

max_execution_time dokumentasi API

resilience​

Pilihan ketahanan lanjutan untuk menala halus strategi ketahanan.

resilience dokumentasi API

resilience.layer_noise_learning​

Pilihan untuk mempelajari hingar lapisan.

resilience.layer_noise_learning dokumentasi API

resilience.layer_noise_learning.layer_pair_depths​

Pilihan: list[int] dengan 2-10 nilai dalam julat [0, 200]

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

resilience.layer_noise_learning.max_layers_to_learn​

Pilihan: None, Integer >= 1

Lalai: 4

resilience.layer_noise_learning.num_randomizations​

Pilihan: Integer >= 1

Lalai: 32

resilience.layer_noise_learning.shots_per_randomization​

Pilihan: Integer >= 1

Lalai: 128

resilience.layer_noise_model​

Pilihan: NoiseLearnerResult, Sequence[LayerError]

Lalai: None

resilience.measure_mitigation​

Pilihan: True, False

Lalai: True

resilience.measure_noise_learning​

Pilihan untuk mempelajari hingar pengukuran.

resilience.measure_noise_learning dokumentasi API

resilience.measure_noise_learning.num_randomizations​

Pilihan: Integer >= 1

Lalai: 32

resilience.measure_noise_learning.shots_per_randomization​

Pilihan: Integer, auto

Lalai: auto

resilience.pec_mitigation​

Pilihan: True, False

Lalai: False

resilience.pec​

Pilihan pengurangan ralat kebarangkalian (probabilistic error cancellation).

resilience.pec dokumentasi API

resilience.pec.max_overhead​

Pilihan: None, Integer >= 1

Lalai: 100

resilience.pec.noise_gain​

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

Lalai: auto

resilience.zne_mitigation​

Pilihan: True, False

Lalai: False

resilience.zne​

resilience.zne.amplifier​

Pilihan: gate_folding, gate_folding_front, gate_folding_back, pea

Lalai: gate_folding

resilience.zne.extrapolated_noise_factors​

Pilihan: Senarai float

Lalai: [0, *noise_factors]

resilience.zne.extrapolator​

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

Lalai: (exponential, linear)

resilience.zne.noise_factors​

Pilihan: Senarai float; setiap float >= 1

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

resilience_level​

Tahap ketahanan terhadap ralat. Tahap yang lebih tinggi menghasilkan keputusan yang lebih tepat tetapi memerlukan masa pemprosesan yang lebih lama.

Pilihan: 0, 1, 2

Lalai: 1

resilience_level dokumentasi API

seed_estimator​

Pilihan: Integer

Lalai: None

seed_estimator

simulator​

Pilihan untuk dihantar semasa mensimulasikan Backend

simulator dokumentasi API

simulator.basis_gates​

Pilihan: Senarai nama gate asas untuk dileraikan

Lalai: Set semua gate asas yang disokong oleh simulator Qiskit Aer

simulator.coupling_map​

Pilihan: Senarai interaksi dua-Qubit berarah

Lalai: None, bermaksud tiada kekangan sambungan (sambungan penuh).

simulator.noise_model​

Pilihan: Qiskit Aer NoiseModel, atau representasinya

Lalai: None

simulator.seed_simulator​

Pilihan: Integer

Lalai: None

twirling​

Pilihan twirling

twirling dokumentasi API

twirling.enable_gates​

Pilihan: True, False

Lalai: False

twirling.enable_measure​

Pilihan: True, False

Lalai: True

twirling.num_randomizations​

Pilihan: auto, Integer >= 1

Lalai: auto

twirling.shots_per_randomization​

Pilihan: auto, Integer >= 1

Lalai: auto

twirling.strategy​

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

Lalai: active-accum

experimental​

Pilihan eksperimental, apabila tersedia.

Keserasian ciri​

Disebabkan perbezaan dalam proses penyusunan peranti, sesetengah ciri runtime tidak boleh digunakan bersama dalam satu kerja. Klik tab yang sesuai untuk melihat senarai ciri yang tidak serasi dengan ciri yang dipilih:

Tidak serasi dengan:

  • ZNE lipatan Gate
  • PEA
  • PEC
  • Dynamical decoupling

Nota lain:

  • Boleh digunakan dengan gate twirling untuk gate bukan bersyarat.
  • Serasi dengan fractional gate apabila menggunakan qiskit-ibm-runtime v0.42.0 atau lebih baru.

Langkah seterusnya​

Cadangan
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 Mac 2026