FakeBrussels
class FakeBrussels
Basen: FakeBackendV2
Ein simuliertes 127-Qubit-Backend.
Ein Backend auf Basis von „ BackendV2 “ initialisieren
Parameter
- Anbieter – Ein optionaler Rückverweis auf das Anbieterobjekt, aus dem das Backend stammt
- name – Ein optionaler Name für das Backend
- Beschreibung – Eine optionale Beschreibung des Backends
- online_date – Ein optionales Datums- und Zeitangabe, zu der das Backend in Betrieb genommen wurde
- backend_version – Eine optionale Zeichenfolge für die Backend-Version. Dies unterscheidet sich vom Attribut
version, daversionfür die abstrakteBackendSchnittstellenversion des Objekts steht, währendbackend_versionder Versionierung des Backends selbst dient. - Felder – kwargs für die Werte, mit denen die Standardoptionen überschrieben werden sollen.
Erhöht
AttributeError – Wenn ein Feld angegeben wird, das außerhalb der Optionen des Backends liegt
Attribute
backend_name
Typ: str
Standardwert: 'fake_brussels'
Name des Backends.
conf_filename
Typ: str
Standardwert: 'conf_brussels.json'
Dateiname für die Backend-Konfiguration.
coupling_map
Das CouplingMap Objekt zurückgeben
dirname
Typ: str
Standardwert: '/home/runner/work/qiskit-ibm-runtime/qiskit-ibm-runtime/qiskit_ibm_runtime/fake_provider/backends/brussels'
Verzeichnis für die eigentlichen Backend-Snapshots.
dt
Gibt die Systemzeitauflösung der Eingangssignale zurück
Dies muss implementiert werden, wenn das Backend die Pulse-Planung unterstützt.
Rückgabe
Der Zeitschritt des Eingangssignals in Sekunden. dtWenn das Backend nicht definiert ist, None wird zurückgegeben.
dtm
Gibt die Zeitauflösung der Ausgangssignale an.
Rückgabe
Der Zeitschritt des Ausgangssignals in Sekunden.
instruction_durations
Gib das InstructionDurations Objekt zurück.
instructions
Eine Liste von Befehlstupeln im Backend des Formulars (instruction, (qubits))
max_circuits
Gibt die maximale Anzahl an Durchläufen zurück, die in einem einzelnen Job ausgeführt werden können.
Früher lieferte diese Eigenschaft den Wert „max_experiments“ aus der Backend-Konfiguration zurück, doch dieser Wert gibt die Grenzen der Backend-Schaltung nicht mehr korrekt wieder. Es werden neue Felder hinzugefügt, um neue Grenzwerte anzugeben.
meas_map
Gibt die Gruppierung der multiplexierten Messwerte zurück
Dies muss implementiert werden, wenn das Backend die Pulse-Planung unterstützt.
Rückgabe
Die Gruppierung von Messungen, die multiplexiert sind
Erhöht
NotImplementedError – wenn das Backend die Abfrage der Messwertzuordnung nicht unterstützt
num_qubits
Gibt die Anzahl der Qubits zurück, über die das Backend verfügt.
operation_names
Eine Liste der Befehlsnamen, die das Backend unterstützt.
operations
Eine Liste der Instruction Instanzen, die das Backend unterstützt.
options
Die Optionen für das Backend zurückgeben
Die Optionen eines Backends sind die dynamischen Parameter, die festlegen, wie das Backend verwendet wird. Diese dienen zur Steuerung der run() Methode.
physical_qubits
Gibt die Anzahl der physikalischen Qubits zurück, über die das Backend verfügt.
Gibt die Anzahl der physikalischen Qubits des Backends zurück (programmierbare Qubits, Reset-Qubits und Koppler zusammen).
props_filename
Typ: str
Standardwert: 'props_brussels.json'
Dateiname für die Backend-Eigenschaften.
provider
Gibt den Backend-Anbieter zurück.
Rückgabe
der für das Backend zuständige Anbieter.
Rückgabetyp
Anbieter
target
version
Standardwert: 2
name
Name des Backends.
description
Optionale, für Menschen lesbare Beschreibung.
online_date
Datum, an dem das Backend in Betrieb genommen wurde.
backend_version
Version des bereitgestellten Backends. Dies ist nicht dasselbe wie BackendV2.version, das die Version der Backend abstrakten Schnittstelle darstellt.
Methoden
check_faulty
check_faulty(circuit)
Überprüfen Sie, ob der Eingangsschaltkreis fehlerhafte Qubits oder Flanken verwendet.
Parameter
circuit (QuantumCircuit) – Zu prüfende Schaltung.
Erhöht
ValueError – Wenn eine Anweisung gefunden wird, die auf ein fehlerhaftes Qubit oder eine fehlerhafte Kante wirkt.
Rückgabetyp
Keine
configuration
properties
properties(refresh=False)
Gibt die Backend-Eigenschaften zurück.
Parameter
refresh (bool) – In Truediesem Fall rufe die Backend-Eigenschaften erneut aus der lokalen Datei ab.
Rückgabe
Die Backend-Eigenschaften.
Rückgabetyp
qubit_properties
qubit_properties(qubit)
Gibt den Rückgabewert „ QubitProperties “ für ein bestimmtes Qubit zurück.
Wenn keine definiert sind oder das Backend die Abfrage dieser Details nicht unterstützt, muss diese Methode nicht implementiert werden.
Parameter
qubit (int | list[int]) – Das Qubit, für das das QubitProperties Objekt benötigt wird. Dies kann eine einzelne Ganzzahl für 1 Qubit sein oder eine Liste von Qubits; eine Liste von QubitProperties Objekten wird in derselben Reihenfolge zurückgegeben
Rückgabe
Das QubitProperties Objekt für das angegebene Qubit. Wird eine Liste von Qubits übergeben, wird eine Liste zurückgegeben. NoneWenn für ein Qubit Eigenschaften fehlen, kann dies.
Erhöht
NotImplementedError – falls das Backend die Abfrage der Qubit-Eigenschaften nicht unterstützt
Rückgabetyp
QubitProperties | Liste[ QubitProperties ]
refresh
refresh(service, use_fractional_gates=False, persist=True)
Aktualisiere die Datendateien anhand der entsprechenden Originaldaten.
Diese Methode ruft die neuesten Backend-Datendateien von ihrem Originalabbild ab und überschreibt standardmäßig (persist=True) die entsprechenden Dateien in der lokalen Installation:
../fake_provider/backends/{backend_name}/conf_{backend_name}.json../fake_provider/backends/{backend_name}/props_{backend_name}.json
Die neuen Datendateien bleiben über Sitzungen hinweg erhalten, sodass die Dateien auf dem neuesten Stand bleiben, sofern sie nicht lokal manuell zurückgesetzt werden oder wenn qiskit-ibm-runtime das Programm aktualisiert oder neu installiert wird.
Das Überschreiben der installierten Datendateien schlägt jedoch fehl, wenn das Paket an einem schreibgeschützten Speicherort (z. B. in einem systemweiten site-packages Verzeichnis) installiert wird. In diesem Fall oder immer dann, wenn eine Änderung des installierten Pakets unerwünscht ist, übergeben Sie, um persist=False die aktualisierten Daten stattdessen in ein temporäres Verzeichnis zu schreiben. Das Backend wird zwar weiterhin für die aktuelle Sitzung aktualisiert, die Änderungen werden jedoch nicht auf der Festplatte gespeichert und gehen verloren, sobald das Backend von der Garbage Collection bereinigt wird oder der Prozess beendet wird.
Parameter
- service (QiskitRuntimeService) – Ein
QiskitRuntimeServiceBeispiel - use_fractional_gates (bool) – Setzen Sie den Wert auf „True“, damit die Backends Bruchteile von Gates einbeziehen können.
- persist (bool) – Wenn (
TrueStandard), überschreiben die aktualisierten Datendateien die im installierten Paket enthaltenen Kopien, sodass die Aktualisierung über mehrere Sitzungen hinweg erhalten bleibt. In diesem Fall werden die Daten stattdessen in ein temporäres Verzeichnis geschriebenFalse, wodurch die Ausführung auch dann erfolgreich istrefresh(), wenn das Paket an einem schreibgeschützten Speicherort installiert ist – allerdings geht dies zu Lasten der Persistenz der Aktualisierung über mehrere Sitzungen hinweg.
Erhöht
- ValueError – wenn es sich bei dem bereitgestellten Dienst um eine Instanz von „ non-QiskitRuntimeService “ handelt.
- Ausnahme – Wenn das eigentliche Ziel nicht existiert oder nicht zugänglich ist
Rückgabetyp
Keine
run
run(run_input, **options)
Führe das Programm mithilfe eines Simulators auf dem simulierten Backend aus.
Diese Methode führt Schaltkreisaufträge (ein einzelnes Objekt oder eine Liste von QuantumCircuit) unter Verwendung von BasicSimulator oder dem Aer-Simulator aus und gibt ein Job Object zurück.
Wenn qiskit-aer installiert ist, werden Jobs mit dem Befehl „ AerSimulator “ unter Verwendung des Rauschmodells des Fake-Backends ausgeführt. Andernfalls werden die Jobs über „ BasicSimulator “ ohne zusätzliche Angaben ausgeführt.
Derzeit wird die „Noisy Simulation“ eines Puls-Jobs in „ FakeBackendV2 “ noch nicht unterstützt.
Parameter
- run_input (QuantumCircuit | list[QuantumCircuit]) – Eine Person oder eine Liste von
QuantumCircuit - options (dict) – Gibt es irgendwelche kwarg-Optionen, die beim Ausführen der Konfiguration an das Backend übergeben werden müssen? Wenn ein Schlüssel auch im Attribut/Objekt „options“ vorhanden ist, wird erwartet, dass der dort angegebene Wert anstelle des im Objekt „options“ festgelegten Werts verwendet wird.
Rückgabe
Das Job-Objekt für den Lauf
Rückgabetyp
Job
set_options
set_options(**fields)
Legen Sie die Optionsfelder für das Backend fest
Diese Methode dient dazu, die Optionen eines Backends zu aktualisieren. Wenn Sie eine der Optionen vor der Ausführung ändern müssen, übergeben Sie einfach das Schlüsselwort mit dem neuen Wert für die Option.
Parameter
Felder – Die Felder, in denen die Optionen aktualisiert werden sollen
Erhöht
AttributeError – Wenn das übergebene Feld nicht zu den Optionen gehört