QuasiDistribution
class qiskit.result.QuasiDistribution(data, shots=None, stddev_upper_bound=None)
Basen: dict
Eine diktatähnliche Klasse zur Darstellung von Quasi-Wahrscheinlichkeiten.
Erzeugt ein Quasi-Wahrscheinlichkeitsverteilungsobjekt.
Die Quasi-Wahrscheinlichkeitswerte können Fließkommafehler enthalten. QuasiDistribution.__repr__ runden mit numpy.round() und der Parameter ndigits können mit dem Klassenattribut __ndigits__ manipuliert werden. Der Standardwert ist 15.
Parameter
-
data (dict) –
Eingabe von Quasi-Wahrscheinlichkeitsdaten. Dabei stellen die Schlüssel einen gemessenen klassischen Wert dar und der Wert ist ein Float für die Quasi-Wahrscheinlichkeit dieses Ergebnisses. Die Schlüssel können in einem von mehreren Formaten vorliegen:
- Eine hexadezimale Zeichenfolge der Form
"0x4a" - Eine Bitfolge z.B.
'0b1011'oder"01011" - Eine ganze Zahl
- Eine hexadezimale Zeichenfolge der Form
-
shots (int) – Anzahl der Schüsse, aus denen die Verteilung abgeleitet wurde.
-
stddev_upper_bound (float) – Eine Obergrenze für die Standardabweichung
Erhöht
- TypeError - Wenn die Eingabeschlüssel keine Zeichenkette oder int sind
- ValueError - Wenn das String-Format der Schlüssel nicht korrekt ist
Attribute
stddev_upper_bound
Gibt eine obere Schranke für die Standardabweichung des expval-Schätzers zurück.
Methoden
binary_probabilities
binary_probabilities(num_bits=None)
Erstellen eines Quasi-Wahrscheinlichkeitsverzeichnisses mit binären String-Schlüsseln
Parameter
num_bits (int) – anzahl der Bits in den binären Bitstrings (führende Nullen werden aufgefüllt). Wenn keine, wird ein Standardwert verwendet. Wenn die Schlüssel als Ganzzahlen oder Zeichenketten mit binärem oder hexadezimalen Präfix angegeben werden, wird der Standardwert vom größten vorhandenen Schlüssel abgeleitet. Wenn die Schlüssel als Bitstrings ohne Präfix angegeben werden, wird der Standardwert von der größten Schlüssellänge abgeleitet.
Rückgabe
Ein Wörterbuch, dessen Schlüssel aus binären Zeichenfolgen im Format
"0110"
Rückgabetyp
clear
clear()
Entferne alle Elemente aus dem Wörterbuch.
copy
copy()
Gibt eine flache Kopie des Dicts zurück.
fromkeys
classmethod fromkeys(iterable, value=None, /)
Erstellen eines neuen Wörterbuchs mit Schlüsseln aus iterable und Werten, die auf value gesetzt sind.
get
get(key, default=None, /)
Rückgabe des Wertes für key, wenn key im Wörterbuch enthalten ist, sonst Standard.
hex_probabilities
hex_probabilities()
Erstellen eines Quasi-Wahrscheinlichkeitsverzeichnisses mit hexadezimalen String-Schlüsseln
Rückgabe
Ein Wörterbuch, in dem die Schlüssel hexadezimale Zeichenfolgen im
Format "0x1a"
Rückgabetyp
items
items()
Gibt ein Set-ähnliches Objekt zurück, das einen Überblick über die Elemente des Dicts bietet.
keys
keys()
Gibt ein Set-ähnliches Objekt zurück, das einen Überblick über die Schlüssel des Dicts bietet.
nearest_probability_distribution
nearest_probability_distribution(return_distance=False)
Nimmt eine Quasi-Wahrscheinlichkeitsverteilung und bildet sie auf die nächstliegende Wahrscheinlichkeitsverteilung ab, wie sie durch L2-norm definiert ist.
Parameter
return_distance (bool) – Gibt den L2 Abstand zwischen den Verteilungen zurück.
Rückgabe
Die nächstliegende Wahrscheinlichkeitsverteilung. schwimmer: Euklidischer ( L2 ) Abstand der Verteilungen.
Rückgabetyp
Hinweise
Methode von Smolin et al, Phys. Rev. Lett. 108, 070502 (2012).
pop
pop(k[, d]) → v, remove specified key and return the corresponding value.
Wenn der Schlüssel nicht gefunden wird, gib den Standardwert zurück, falls angegeben; andernfalls löse eine Ausnahme vom Typ „ KeyError “ aus.
popitem
popitem()
Entfernen und Zurückgeben eines Paares (Schlüssel, Wert) als 2-Tupel.
Die Paare werden in LIFO-Reihenfolge (last-in, first-out) zurückgegeben. Gibt KeyError aus, wenn das Diktat leer ist.
setdefault
setdefault(key, default=None, /)
Schlüssel mit einem Standardwert einfügen, wenn der Schlüssel nicht im Wörterbuch enthalten ist.
Rückgabe des Wertes für key, wenn key im Wörterbuch enthalten ist, sonst Standard.
update
update([E, ]**F) → None. Update D from mapping/iterable E and F.
Wenn E vorhanden ist und über eine.keys()-Methode verfügt, dann gilt: for k in E.keys (): [Dk] = E [k] Wenn E vorhanden ist und keine.keys()-Methode hat, dann gilt: for k, v in E: [Dk] = v In beiden Fällen folgt darauf: for k in F: [Dk] = [Fk]
values
values()
Gibt ein Objekt zurück, das einen Überblick über die Werte des Dicts bietet.