Langkau ke kandungan utama

Konfigurasi SDK Qiskit secara tempatan

Setelah SDK Qiskit dipasang dan berjalan, terdapat beberapa langkah pilihan yang boleh anda ambil untuk menukar tingkah laku lalai Qiskit.

Fail konfigurasi pengguna​

Lokasi utama untuk konfigurasi tempatan Qiskit ialah fail konfigurasi pengguna. Ini ialah fail berformat .ini yang boleh digunakan untuk menukar tetapan lalai Qiskit.

Contoh:

[default]
circuit_drawer = mpl
circuit_mpl_style = default
circuit_mpl_style_path = ~:~/.qiskit
state_drawer = hinton
transpile_optimization_level = 3
parallel = False
num_processes = 15

Secara lalai, fail ini berada di ~/.qiskit/settings.conf tetapi laluan boleh dikembalikan dengan pemboleh ubah persekitaran QISKIT_SETTINGS.

Pilihan tersedia​

  • circuit_drawer: Menukar sistem lalai untuk pelukis Circuit. Ia boleh ditetapkan kepada latex, mpl, text, atau latex_source. Apabila kwarg output tidak ditetapkan secara eksplisit, sistem pelukis ini digunakan.
  • circuit_mpl_style: Helaian gaya lalai yang digunakan untuk sistem output mpl bagi pelukis Circuit. Nilai yang sah ialah default atau bw.
  • circuit_mpl_style_path: Laluan untuk pelukis Circuit cari helaian gaya JSON apabila menggunakan mod output mpl.
  • state_drawer: Ini digunakan untuk menukar sistem lalai bagi kaedah lukisan visualisasi keadaan. Nilai yang sah ialah repr, text, latex, latex_source, qsphere, hinton, atau bloch. Apabila kwarg output tidak ditetapkan secara eksplisit pada kaedah qiskit.quantum_info.DensityMatrix.draw, kaedah output yang ditentukan digunakan.
  • transpile_optimization_level: Tukar tahap pengoptimuman lalai untuk qiskit.compiler.transpile. Nyatakan integer 0-3.
  • parallel: Sama ada multiproses Python diaktifkan untuk operasi yang menyokong pelaksanaan selari. Contohnya, transpilasi berbilang objek qiskit.circuit.QuantumCircuit. Tetapan ini boleh dikembalikan oleh pemboleh ubah persekitaran QISKIT_PARALLEL. Nyatakan nilai boolean.
  • num_processes: Bilangan maksimum proses selari yang akan dilancarkan untuk operasi selari jika pelaksanaan selari diaktifkan. Tetapan ini boleh dikembalikan oleh pemboleh ubah persekitaran QISKIT_NUM_PROCS. Nyatakan integer lebih besar daripada 0.

Pemboleh ubah persekitaran​

Tetapkan pemboleh ubah persekitaran ini untuk mengubah tingkah laku lalai Qiskit:

  • QISKIT_PARALLEL: Mengaktifkan multiproses Python untuk memparalelkan operasi tertentu; contohnya, transpilasi melalui berbilang Circuit dalam Qiskit. Nyatakan nilai boolean.
  • QISKIT_NUM_PROCS: Bilangan maksimum proses selari yang akan dilancarkan untuk operasi selari jika pelaksanaan selari diaktifkan. Nyatakan integer lebih besar daripada sifar.
  • RAYON_NUM_THREADS: Bilangan benang untuk menjalankan operasi berbilang benang dalam Qiskit. Secara lalai, kod berbilang benang melancarkan satu benang untuk setiap CPU logik. Untuk melaraskan bilangan benang yang digunakan oleh Qiskit, tetapkan ini kepada nilai integer. Contohnya, menetapkan RAYON_NUM_THREADS=4 melancarkan empat benang untuk fungsi berbilang benang.
  • QISKIT_FORCE_THREADS: Menentukan bahawa kod berbilang benang harus sentiasa dilaksanakan dalam berbilang benang. Secara lalai, jika anda menjalankan kod berbilang benang dalam bahagian Qiskit yang sudah berjalan dalam proses selari, Qiskit tidak melancarkan berbilang benang tetapi sebaliknya melaksanakan fungsi tersebut secara bersiri. Ini dilakukan untuk mengelakkan kemungkinan membebankan sumber CPU yang terhad. Walau bagaimanapun, jika anda ingin memaksa penggunaan berbilang benang walaupun dalam konteks berbilang proses, tetapkan QISKIT_FORCE_THREADS=TRUE.
  • QISKIT_SABRE_ALL_THREADS: Mengawal tingkah laku pas susun atur dan penghalaan dalam pengurus pas pratetap Qiskit. Apabila ditetapkan kepada 1 atau TRUE, ini menggunakan semua CPU yang tersedia untuk menjalankan berbilang percubaan rawak. Ini boleh meningkatkan kualiti keputusan, terutamanya untuk sistem dengan lebih daripada 20 CPU/teras; pertukaran yang berlaku ialah keputusan tidak boleh dihasilkan semula apabila dijalankan pada perkakasan tempatan yang berbeza.

Langkah seterusnya​

Cadangan
Source: IBM Quantum docs β€” updated 23 Apr 2026
English version on doQumentation β€” updated 7 Mei 2026
This translation based on the English version of 11 Mac 2026