Condividi tramite


%config

Avviso

Questa documentazione si riferisce al QDK classico, che è stato sostituito dal QDK moderno.

QDK moderno supporta solo il comando magic '%%qsharp'.

Riepilogo

Consente di impostare o eseguire query sulle opzioni di configurazione.

Descrizione

Questo comando magic consente di impostare o eseguire query sulle opzioni di configurazione usate per controllare il comportamento del kernel IQ#, ad esempio le opzioni di visualizzazione dello stato. Consente anche di salvare tali opzioni in un file JSON nella directory di lavoro corrente (usando l'opzione --save ).

Impostazioni di configurazione

dump.basisStateLabelingConvention

Valore:"LittleEndian" (impostazione predefinita), "BigEndian", o "Bitstring"

Convenzione da usare quando si etichettano gli stati di base di calcolo nell'output da chiamabili, DumpMachine ad esempio o DumpRegister.

dump.truncateSmallAmplitudes

Valore:true o false (impostazione predefinita)

Nasconde gli stati di base di un vettore di stato le cui probabilità di misurazione (ad esempio, le ampiezze quadrate) sono inferiori a una determinata soglia, come determinato dall'impostazione dump.truncationThreshold .

dump.truncationThreshold

Valore: numero a virgola mobile, 0.001 ad esempio o 1E-8 (impostazione predefinita 1E-10)

Se dump.truncateSmallAmplitudes è impostato su true, determina la soglia per le probabilità di misurazione (ad esempio, ampiezze quadrate) al di sotto del quale nascondere la visualizzazione degli stati di base di un vettore di stato.

dump.phaseDisplayStyle

Valore:"ArrowOnly" (impostazione predefinita), "NumberOnly", "ArrowAndNumber"o "None"

Configura lo stile di visualizzazione della fase nell'output da chiamabili, DumpMachine ad esempio o DumpRegister. Supporta la visualizzazione della fase come frecce, numeri (in radianti), entrambi o nessuno dei due.

dump.measurementDisplayStyle

Value:"NumberOnly", "BarOnly", "BarAndNumber" (impostazione predefinita) o "None"

Configura lo stile di visualizzazione della probabilità di misurazione nell'output di callables, DumpMachine ad esempio o DumpRegister. Supporta la visualizzazione della probabilità di misurazione come barre di stato, numeri, entrambi o nessuno dei due.

dump.measurementDisplayPrecision

Valore: intero non negativo (impostazione predefinita 4)

Imposta la precisione della probabilità di misurazione visualizzata come percentuale quando dump.measurementDisplayStyle è impostata su "NumberOnly" o "BarAndNumber".

dump.measurementDisplayHistogram

Valore:true o false (impostazione predefinita)

Se dump.measurementDisplayHistogram è impostato su true, visualizza una rappresentazione istogramma interattiva dello stato del simulatore sotto la visualizzazione dello stato statico.

dump.plainTextOnly

Valore:true o false (impostazione predefinita)

Forza l'output di testo normale da chiamabili come DumpMachine e DumpRegister, anche quando si usa un client abilitato per HTML, ad esempio Jupyter Notebook.

trace.defaultDepth

Valore: numero intero positivo (impostazione predefinita 1)

Configura la profondità predefinita usata nel %trace comando per visualizzare le operazioni Q#.

trace.style

Valore:"Default" (impostazione predefinita), "BlackAndWhite", o "Inverted"

Configura lo stile predefinito usato per generare la visualizzazione delle operazioni Q# con il %trace comando .

Esempi per %config

Esempio 1

Stampare un elenco di tutte le opzioni di configurazione attualmente impostate:

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

Esempio 2

Configurare e chiamabili per l'uso DumpMachineDumpRegister della convenzione big-endian:

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

Esempio 3

Salvare le opzioni .iqsharp-config.json di configurazione correnti in nella directory di lavoro corrente:

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

Si noti che le opzioni salvate in questo modo verranno applicate automaticamente alla successiva caricamento di un notebook nella directory di lavoro corrente.