Konfigurasi Qiskit SDK secara lokal
Setelah Qiskit SDK terpasang dan berjalan, ada beberapa langkah opsional yang bisa kamu lakukan untuk mengubah perilaku bawaan Qiskit.
File konfigurasi penggunaβ
Lokasi utama untuk konfigurasi lokal Qiskit adalah file konfigurasi pengguna. Ini adalah file berformat .ini yang bisa digunakan untuk mengubah pengaturan bawaan 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 default, file ini berada di ~/.qiskit/settings.conf, tapi jalurnya bisa diganti dengan variabel lingkungan QISKIT_SETTINGS.
Opsi yang tersediaβ
circuit_drawer: Mengubah sistem default untuk circuit drawer. Bisa diatur kelatex,mpl,text, ataulatex_source. Ketika kwarg output tidak ditentukan secara eksplisit, sistem drawer ini yang digunakan.circuit_mpl_style: Lembar gaya default yang digunakan untuk sistem output mpl pada circuit drawer. Nilai yang valid adalahdefaultataubw.circuit_mpl_style_path: Jalur yang digunakan circuit drawer untuk mencari lembar gaya JSON saat menggunakan mode output mpl.state_drawer: Digunakan untuk mengubah sistem default untuk metode draw visualisasi state. Nilai yang valid adalahrepr,text,latex,latex_source,qsphere,hinton, ataubloch. Ketika kwarg output tidak ditentukan secara eksplisit pada metode qiskit.quantum_info.DensityMatrix.draw, metode output yang ditentukan ini yang digunakan.transpile_optimization_level: Mengubah level optimasi default untuk qiskit.compiler.transpile. Tentukan bilangan bulat 0-3.parallel: Apakah multiprocessing Python diaktifkan untuk operasi yang mendukung eksekusi paralel. Misalnya, transpilasi beberapa objek qiskit.circuit.QuantumCircuit. Pengaturan ini bisa diganti dengan variabel lingkunganQISKIT_PARALLEL. Tentukan nilai boolean.num_processes: Jumlah maksimum proses paralel yang diluncurkan untuk operasi paralel jika eksekusi paralel diaktifkan. Pengaturan ini bisa diganti dengan variabel lingkunganQISKIT_NUM_PROCS. Tentukan bilangan bulat lebih besar dari0.
catatan
- Pengaturan circuit drawer berlaku untuk qiskit.circuit.QuantumCircuit.draw dan qiskit.visualization.circuit_drawer.
- Metode draw visualisasi state adalah qiskit.quantum_info.Statevector.draw dan qiskit.quantum_info.DensityMatrix.draw.
Variabel lingkunganβ
Atur variabel lingkungan berikut untuk mengubah perilaku bawaan Qiskit:
QISKIT_PARALLEL: Mengaktifkan multiprocessing Python untuk memparalelkan operasi tertentu; misalnya, transpilasi beberapa Circuit di Qiskit. Tentukan nilai boolean.QISKIT_NUM_PROCS: Jumlah maksimum proses paralel yang diluncurkan untuk operasi paralel jika eksekusi paralel diaktifkan. Tentukan bilangan bulat lebih besar dari nol.RAYON_NUM_THREADS: Jumlah thread untuk menjalankan operasi multithreaded di Qiskit. Secara default, kode multithreaded meluncurkan satu thread untuk setiap CPU logis. Untuk menyesuaikan jumlah thread yang digunakan Qiskit, atur ini ke nilai bilangan bulat. Misalnya, menetapkan RAYON_NUM_THREADS=4 meluncurkan empat thread untuk fungsi multithreaded.QISKIT_FORCE_THREADS: Menentukan bahwa kode multithreaded harus selalu dieksekusi dalam beberapa thread. Secara default, jika kamu menjalankan kode multithreaded di bagian Qiskit yang sudah berjalan dalam proses paralel, Qiskit tidak meluncurkan beberapa thread melainkan mengeksekusi fungsi tersebut secara serial. Ini dilakukan untuk menghindari potensi kelebihan beban pada sumber daya CPU yang terbatas. Namun, jika kamu ingin memaksakan penggunaan beberapa thread bahkan dalam konteks multiproses, aturQISKIT_FORCE_THREADS=TRUE.QISKIT_SABRE_ALL_THREADS: Mengontrol perilaku pass layout dan routing di preset pass manager Qiskit. Ketika diatur ke1atauTRUE, ini menggunakan semua CPU yang tersedia untuk menjalankan beberapa percobaan acak. Ini bisa meningkatkan kualitas hasil, terutama untuk sistem dengan lebih dari 20 CPU/core; namun, konsekuensinya adalah hasil tidak dapat direproduksi saat dijalankan pada perangkat keras lokal yang berbeda.
Langkah berikutnyaβ
Rekomendasi
- Coba tutorial, seperti algoritma Grover.
- Jalankan program Hello world.
- Baca panduan berkontribusi jika kamu ingin berkontribusi ke Qiskit SDK open-source.
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 Mar 2026