Risultati dell'esperimento

qiskit.result.marginal_counts(result, indices=None, inplace=False, format_marginal=False, marginalize_memory=True)

Marginalizzare i conteggi di un esperimento su alcuni indici di interesse.

Parametri

• result (dict |Result) – risultato da emarginare (un oggetto Result o un dict(str, int) contenente i conteggi).
• indices (list[int] | None) – Le posizioni dei bit che si desidera escludere. Se None (impostazione predefinita), non applicare alcuna marginalizzazione.
• inplace (bool) – Predefinito: Falso. Opera sull'argomento Risultato originale se Vero, con conseguente perdita del Risultato originale del lavoro. Non ha effetto se result è un dict.
• format_marginal (bool) – Predefinito: Falso. Se vero, prende l'output di marginalize e lo formatta con segnaposto tra i caratteri e per i non indici.
• marginalize_memory (bool | None) – Se Vero, si marginalizza anche il campo di memoria (se presente). Se Falso, rimuovere il campo di memoria dal risultato. Se Nessuno, lasciare il campo di memoria così com'è.

Risultati

Un oggetto Result o un dizionario con

i conteggi osservati, marginalizzati per tenere conto solo della frequenza delle osservazioni dei bit di interesse.

Tipo di restituzione

Risultato : dict ( str, int )

Aumenti

QiskitError - in caso di indici non validi da marginalizzare.

qiskit.result.marginal_distribution(counts, indices=None, format_marginal=False)

Marginalizzare i conteggi di un esperimento su alcuni indici di interesse.

A differenza di marginal_counts() questa funzione rispetta l'ordine dell'ingresso indices. Se viene specificato l'elenco di input indices , l'ordine in cui sono specificati gli indici di bit sarà l'ordine di uscita delle stringhe di bit nell'output marginalizzato.

Parametri

• counts (dict) – risultato di essere emarginati
• indices (Sequence[int] | None) – Le posizioni dei bit che si desidera escludere. Se None (impostazione predefinita), non applicare alcuna marginalizzazione.
• format_marginal (bool) – Predefinito: Falso. Se vero, prende l'output di marginalize e lo formatta con segnaposto tra i caratteri e per i non indici.

Risultati

Un dizionario emarginato

Tipo di restituzione

dict (str, int )

Aumenti

• QiskitError - Se un valore di indices non è valido o il dict counts non è valido
• non è valido. -

qiskit.result.marginal_memory(memory, indices=None, int_return=False, hex_return=False, avg_data=False, parallel_threshold=1000)

Marginalizzare la memoria dei pallini

Questa funzione è multithread e lancia un pool di thread con un numero di thread pari al numero di CPU per impostazione predefinita. È possibile regolare il numero di thread con la variabile d'ambiente RAYON_NUM_THREADS . Ad esempio, impostando RAYON_NUM_THREADS=4 si limita il pool di thread a 4 thread.

Parametri

• memory (list[str] | ndarray) – L'elenco della memoria di input può essere costituito da una lista di stringhe esadecimali da marginalizzare, che rappresentano la memoria di misurazione di livello 2, oppure da un array NumPy che rappresenta la memoria di misurazione di livello 0 (singola o media) o di livello 1 (singola o media).
• indices (list[int] | None) – Le posizioni dei bit che si desidera escludere. Se None (impostazione predefinita), non applicare alcuna marginalizzazione.
• int_return (bool) – Se impostato su True , l'output sarà un elenco di numeri interi. Per impostazione predefinita, il tipo di ritorno è una stringa di bit. Questo e hex_return si escludono a vicenda e non possono essere specificati contemporaneamente. Questa opzione ha effetto solo con il livello di memoria 2.
• hex_return (bool) – Se impostato su True , l'output sarà un elenco di stringhe esadecimali. Per impostazione predefinita, il tipo di ritorno è una stringa di bit. Questo e int_return si escludono a vicenda e non possono essere specificati contemporaneamente. Questa opzione ha effetto solo con il livello di memoria 2.
• avg_data (bool) – Se viene passato un array numpy a 2 dimensioni per memory , questo può essere impostato su True per indicare che si tratta di dati avg di livello 0 invece di dati singoli di livello 1.
• parallel_threshold (int) – Il numero di elementi in memory per avviare l'esecuzione in più thread. Se len(memory) è >= questo valore, la funzione verrà eseguita in più thread. L'impostazione predefinita è 1000.

Risultati

L'elenco della memoria emarginata

Tipo di restituzione

memoria marginale

Aumenti

ValueError - se entrambi int_return e hex_return sono impostati su True

qiskit.result.sampled_expectation_value(dist, oper)

Calcola il valore dell'aspettativa da una distribuzione campionata

Si noti che il passaggio di un dict grezzo richiede chiavi a stringa di bit.

Parametri

• dist (dict |result.Counts |QuasiDistribution |ProbDistribution) – Distribuzione campionaria degli input.
• oper (str |quantum_info.Pauli |quantum_info.SparsePauliOp |quantum_info.SparseObservable) – L'operatore relativo all'osservabile.

Risultati

Il valore atteso.

Aumenti

QiskitError - se la distribuzione o l'operatore in ingresso è di tipo non valido

Tipo di restituzione

mobile