%config

  • Artikel

Peringatan

Dokumentasi ini mengacu pada QDK Klasik, yang telah digantikan oleh Modern QDK.

QDK Modern hanya mendukung perintah ajaib '%%qsharp'.

Ringkasan

Mengizinkan pengaturan atau mengkueri opsi konfigurasi.

Deskripsi

Perintah ajaib ini memungkinkan pengaturan atau opsi konfigurasi kueri yang digunakan untuk mengontrol perilaku kernel IQ# (seperti opsi visualisasi status). Ini juga memungkinkan untuk menyimpan opsi tersebut ke file JSON di direktori kerja saat ini (menggunakan --save opsi ).

Pengaturan konfigurasi

dump.basisStateLabelingConvention

Nilai:"LittleEndian" (default), "BigEndian", atau "Bitstring"

Konvensi yang akan digunakan saat melabeli status dasar komputasi dalam output dari panggilan seperti DumpMachine atau DumpRegister.

dump.truncateSmallAmplitudes

Nilai:true atau false (default)

Menyembunyikan status dasar vektor negara yang probabilitas pengukurannya (yaitu, amplitude kuadrat) lebih kecil dari ambang tertentu, seperti yang ditentukan oleh dump.truncationThreshold pengaturan.

dump.truncationThreshold

Nilai: angka titik mengambang seperti 0.001 atau 1E-8 (default 1E-10)

Jika dump.truncateSmallAmplitudes diatur ke true, menentukan ambang batas untuk probabilitas pengukuran (yaitu, amplitude kuadrat) di bawah ini untuk menyembunyikan tampilan status dasar vektor status.

dump.phaseDisplayStyle

Nilai:"ArrowOnly" (default), "NumberOnly", "ArrowAndNumber", atau "None"

Mengonfigurasi gaya visualisasi fase dalam output dari panggilan seperti DumpMachine atau DumpRegister. Mendukung menampilkan fase sebagai panah, angka (dalam radian), keduanya, atau tidak keduanya.

dump.measurementDisplayStyle

Nilai:"NumberOnly", "BarOnly", "BarAndNumber" (default), atau "None"

Mengonfigurasi gaya visualisasi probabilitas pengukuran dalam output yang dapat dipanggil seperti DumpMachine atau DumpRegister. Mendukung menampilkan probabilitas pengukuran sebagai bilah kemajuan, angka, keduanya, atau tidak keduanya.

dump.measurementDisplayPrecision

Nilai: bilangan bulat non-negatif (default 4)

Mengatur presisi probabilitas pengukuran yang ditampilkan sebagai persentase saat dump.measurementDisplayStyle diatur ke "NumberOnly" atau "BarAndNumber".

dump.measurementDisplayHistogram

Nilai:true atau false (default)

Jika dump.measurementDisplayHistogram diatur ke true, menampilkan representasi histogram interaktif dari status simulator di bawah visualisasi status statis.

dump.plainTextOnly

Nilai:true atau false (default)

Memaksa output teks biasa dari panggilan seperti DumpMachine dan DumpRegister, bahkan saat menggunakan klien berkemampuan HTML seperti Jupyter Notebook.

trace.defaultDepth

Nilai: bilangan bulat positif (default 1)

Mengonfigurasi kedalaman default yang %trace digunakan dalam perintah untuk memvisualisasikan operasi Q#.

trace.style

Nilai:"Default" (default), "BlackAndWhite", atau "Inverted"

Mengonfigurasi gaya default yang digunakan dalam menghasilkan visualisasi operasi Q# dengan %trace perintah .

Contoh untuk %config

Contoh 1

Cetak daftar semua opsi konfigurasi yang saat ini ditetapkan:

In []: %config
Out[]: Configuration key                 Value
       --------------------------------- -----------
       dump.basisStateLabelingConvention "BigEndian"
       dump.truncateSmallAmplitudes      true

Contoh 2

Konfigurasikan DumpMachine dan DumpRegister dapat dipanggil untuk menggunakan konvensi big-endian:

In []: %config dump.basisStateLabelingConvention="BigEndian"
Out[]: "BigEndian"

Contoh: 3

Simpan opsi konfigurasi saat ini ke .iqsharp-config.json dalam direktori kerja saat ini:

In []: %config --save
Out[]:

Perhatikan bahwa opsi yang disimpan dengan cara ini akan diterapkan secara otomatis saat buku catatan di direktori kerja saat ini dimuat.