Ziel

Rückgabe dt.

Holt die Liste der Tupel (Instruction, (qargs)) für das Ziel

Für global definierte Operationen mit variabler Breite hat das Tupel die Form (class, None) , wobei class die tatsächliche Operationsklasse ist, die global definiert ist.

Abrufen der Vorgangsnamen im Ziel.

Abrufen der Operationsobjekte im Ziel.

Gibt eine sortierte Liste der physischen Qubits zurück.

Die Menge der qargs im Ziel.

add_instruction(instruction, properties=None, name=None, *, angle_bounds=None)

Fügen Sie eine neue Anweisung zum Target

Da Target Objekte strikt additiv sind, ist dies die primäre Methode, um ein Target zu verändern. Normalerweise werden Sie dies verwenden, um eine Target vollständig zu füllen, bevor Sie sie in BackendV2. Zum Beispiel:

from qiskit.circuit.library import CXGate
from qiskit.transpiler import Target, InstructionProperties

target = Target()
cx_properties = {
    (0, 1): None,
    (1, 0): None,
    (0, 2): None,
    (2, 0): None,
    (0, 3): None,
    (2, 3): None,
    (3, 0): None,
    (3, 2): None
}
target.add_instruction(CXGate(), cx_properties)

Fügt eine CXGate zum Ziel ohne Eigenschaften (Dauer, Fehler usw.) mit der Kopplungskantenliste: (0, 1), (1, 0), (0, 2), (2, 0), (0, 3), (2, 3), (3, 0), (3, 2). Wenn für die Anweisung Eigenschaften verfügbar sind, können Sie den Wert None im Eigenschaftswörterbuch durch ein InstructionProperties objekt ersetzen. Dieses Muster wiederholt sich für jede Instruction das Ziel unterstützt.

Parameter

• instruction (Union[qiskit.circuit.Instruction, Type[qiskit.circuit.Instruction]]) – Das Operationsobjekt, das der Karte hinzugefügt werden soll. Wenn er parametrisiert ist, kann für den Parameter ein beliebiger Wert festgelegt werden. Optional können Sie für Anweisungen mit variabler Breite (wie z. B. Steuerungsoperationen wie ForLoop oder MCXGate) die Klasse angeben. Wenn die Klasse angegeben wird, muss das name Argument angegeben werden. Wenn eine Klasse verwendet wird, wird das Gate als global behandelt und es werden keine Eigenschaften festgelegt.
• properties (dict) – Ein Wörterbuch mit qarg-Einträgen zu einem InstructionProperties objekt für diese Befehlsimplementierung auf dem Backend. Eigenschaften sind für jede Befehlsimplementierung optional, wenn es keine InstructionProperties für das Backend verfügbar sind, kann der Wert None sein. Wenn es keine Einschränkungen für die Anweisung gibt (wie bei einer geräuschlosen/idealen Simulation), kann dies auf {None, None} gesetzt werden, was bedeutet, dass sie auf allen Qubits läuft (oder auf allen verfügbaren Permutationen von Qubits für Multi-Qubit-Gatter). Das erste None zeigt an, dass sie für alle Qubits gilt, und das zweite None zeigt an, dass es keine InstructionProperties für diese Anweisung. Wenn properties nicht gesetzt ist, entspricht dies standardmäßig der Übergabe von {None: None}.
• name (str) – Ein optionaler Name, der zur Identifizierung der Anweisung verwendet wird. Wenn nicht angegeben, wird das name attribut von gate verwendet. Alle Gates auf Target benötigen eindeutige Namen. Backends können zwischen verschiedenen Parametrisierungen eines einzelnen Gatters unterscheiden, indem sie für jedes einen eindeutigen Namen vergeben (z.B. “rx30”, “rx60”, `”rx90”`` ähnlich dem Beispiel in der Dokumentation für die Target klasse).
• angle_bounds (list) – Die Grenzen der Parameter für ein bestimmtes Tor. Dies wird durch eine Liste von Tupeln (niedrig, hoch) angegeben, die die untere und obere Grenze (einschließlich) der zulässigen Float-Werte für den Parameter an dieser Position darstellen. Wenn ein Parameter keine Winkelbegrenzung hat, können Sie None verwenden, um dies darzustellen. Wenn z.B. ein 3-Parameter-Gate nur eine Begrenzung auf den zweiten Parameter hat, würde man das mit [None, [0, 3.14], None] darstellen, was bedeutet, dass der erste und dritte Parameter jeden Wert zulassen, der zweite Parameter aber nur Werte zwischen 0 und 3.14 akzeptiert.

Erhöht

• AttributeError - Wenn das Tor bereits in der Karte enthalten ist
• TranspilerError – Wenn eine Operationsklasse für instruction übergeben wird und kein Name angegeben ist oder properties gesetzt ist.

build_coupling_map(two_q_gate=None, filter_idle_qubits=False)

Erhalten Sie eine CouplingMap von diesem Ziel.

Wenn es eine Mischung aus zwei-Qubit-Operationen gibt, für die eine Konnektivitätsbeschränkung gilt, und solchen, die global definiert sind, wird dies ebenfalls zurückgegeben, None da die globale Konnektivität bedeutet, dass für das Ziel keine Beschränkung besteht. Wenn Sie die Einschränkungen der beiden Qubit-Operationen sehen möchten, für die Einschränkungen gelten, sollten Sie das two_q_gate Argument verwenden, um die Ausgabe auf die Gatter zu beschränken, für die eine Einschränkung gilt.

Parameter

• two_q_gate (str) – Ein optionaler Gattername für ein Zwei-Qubit-Gatter in der Target , für das die Kopplungskarte erstellt werden soll. Wenn dies angegeben wird, enthält die Ausgangskopplungskarte nur Kanten zwischen Qubits, bei denen dieses Gatter vorhanden ist.
• filter_idle_qubits (bool) – Wenn auf True gesetzt, wird die Ausgabe CouplingMap alle Qubits entfernen, für die im Ziel keine Operationen definiert sind. Beachten Sie, dass die Verwendung dieses Arguments zu einem Ausgabe CouplingMap objekt führt, das Löcher in seinen Indizes hat, die von den Annahmen der Klasse abweichen können. Der typische Anwendungsfall für dieses Argument ist die Verknüpfung mit CouplingMap.connected_components() gepaart zu werden, das die Löcher wie erwartet behandeln wird.

Rückgabe

**Das Objekt CouplingMap **

für dieses Ziel. Wenn es im Ziel keine Konnektivitätseinschränkungen gibt, wird None zurückgegeben.

Rückgabetyp

CouplingMap

Erhöht

• ValueError - Wenn ein Nicht-Zwei-Qubit-Gatter für two_q_gate eingegeben wird.
• IndexError - Wenn eine Anweisung, die nicht in Target enthalten ist, an two_q_gate übergeben wird.

durations()

Ein InstructionDurations Objekt vom Ziel abrufen

Rückgabe

Die Anweisungsdauer, die in der Tabelle

Ziel

Rückgabetyp

InstructionDurations

classmethod from_configuration(basis_gates, num_qubits=None, coupling_map=None, instruction_durations=None, concurrent_measurements=None, dt=None, timing_constraints=None, custom_name_mapping=None)

Erstellen eines Zielobjekts aus der individuellen globalen Konfiguration

Vor der Erstellung der Klasse Target klasse wurden die Beschränkungen eines Backends durch eine Sammlung verschiedener Objekte dargestellt, die zusammen eine Teilmenge der in der Target. Diese Funktion bietet eine einfache Schnittstelle zur Umwandlung dieser separaten Objekte in eine Target.

Dieser Konstruktor verwendet die Eingaben von basis_gates, num_qubits und coupling_map , um ein Basismodell des Backends zu erstellen, und die Eingaben von instruction_durations, backend_properties und inst_map werden dann (in dieser Reihenfolge) auf der Grundlage dieses Modells abgefragt, um die Eigenschaften jeder Anweisung und jedes Qubits nachzuschlagen. Wenn es eine Unstimmigkeit zwischen den Eingaben gibt, werden alle zusätzlichen oder widersprüchlichen Informationen, die in instruction_durations, backend_properties oder inst_map enthalten sind, ignoriert.

Parameter

• basis_gates (list[str]) – Die Liste der Basis-Gate-Bezeichnungen für das Backend. Damit das Ziel erstellt werden kann, müssen diese Namen entweder in der Ausgabe von get_standard_gate_name_mapping() enthalten sein oder im angegebenen custom_name_mapping Argument vorhanden sein.
• num_qubits (int | None) – Die Anzahl der vom Backend unterstützten Qubits.
• coupling_map (CouplingMap | None) – Die Kopplungskarte, die die Konnektivitätsbeschränkungen am Backend darstellt. Falls angegeben, werden alle Gatter von basis_gates auf allen Qubits (oder Qubitpaaren) unterstützt.
• instruction_durations (InstructionDurations | None) – Optionale Anweisungsdauern für Anweisungen. Wenn dies angegeben ist, hat es Vorrang beim Setzen des Feldes duration in den InstructionProperties objekten für die Anweisungen im Ziel.
• concurrent_measurements (list) – Eine Liste von Gruppen von Qubits, die zusammen gemessen werden müssen. Diese muss als verschachtelte Liste wie [[0, 1], [2, 3, 4]] angegeben werden.
• dt (float | None) – Die Systemzeitauflösung der Eingangssignale in Sekunden
• timing_constraints (TimingConstraints | None) – Optionale zeitliche Einschränkungen, die in die Target
• custom_name_mapping (dict[str, Any] | None) – Ein optionales Wörterbuch, das benutzerdefinierte Gate-/Operationsnamen in basis_gates einem Operation Objekt abbildet, das dieses Gate bzw. diese Operation repräsentiert. Standardmäßig werden die meisten Standard-Gatterbezeichnungen dem Standard-Gatterobjekt zugeordnet; qiskit.circuit.library dies muss nur dann angegeben werden, wenn in der Eingabe basis_gates Gatter mit Namen definiert werden, die nicht zu dieser Menge gehören.

Rückgabe

das aus der Eingabekonfiguration erstellte Ziel

Rückgabetyp

Target

Erhöht

• TranspilerError – Wenn die Eingangsbasisgatter mehr als 2 Qubits enthalten und coupling_map ist
• angegeben. -
• KeyError - Wenn für ein bestimmtes basis_gate keine Zuordnung vorhanden ist.

gate_has_angle_bounds(name)

Prüfen, ob für ein bestimmtes Gatter eine Winkelbegrenzung festgelegt ist

Parameter

name (str) – Der Name der Anweisung, um zu prüfen, ob eine Winkelbegrenzung gesetzt ist

Rückgabe

Diese Funktion gibt True zurück, wenn sich das Tor im Ziel befindet und die Winkelbegrenzungen definiert sind. Sie gibt False zurück, wenn für das Tor keine Winkelbegrenzungen definiert sind oder es sich nicht im Ziel befindet.

Rückgabetyp

bool

get(key, default=None)

Ruft ein Element aus dem Ziel ab. Wenn nicht gefunden, wird ein angegebener Standardwert oder None zurückgegeben.

get_non_global_operation_names(strict_direction=False)

Rückgabe der nicht-globalen Operationsnamen für das Ziel

Die nicht-globalen Operationen sind diejenigen im Ziel, die nicht auf alle Qubits (bei Ein-Qubit-Operationen) oder alle Multi-Qubits (bei Multi-Qubit-Operationen) anwendbar sind.

Parameter

strict_direction (bool) – Wenn sie auf True gesetzt ist, respektieren die Multi-QuBit-Operationen, die als nicht-global betrachtet werden, die strikte Richtung (oder die Reihenfolge der Qubits in den Qargs ist wichtig). Wenn z. B. cx auf (0, 1) und ecr auf (1, 0) definiert ist, würde keiner von beiden als nicht-global betrachtet werden, aber wenn strict_direction auf True gesetzt wird, würden sowohl cx als auch ecr zurückgegeben werden.

Rückgabe

Eine Liste von Vorgangsnamen für Vorgänge, die in diesem Ziel nicht global sind

Rückgabetyp

Liste [str ]

has_angle_bounds()

Prüfen, ob im Ziel irgendwelche Winkelbegrenzungen festgelegt sind

Rückgabe

Diese Funktion gibt True zurück, wenn für eine der Anweisungen in der Schaltung Winkelbegrenzungen festgelegt sind

Rückgabetyp

bool

instruction_properties(index)

Abrufen der Befehlseigenschaften für ein bestimmtes Befehlstupel

Diese Methode ist in Verbindung mit dem instructions attribut eines Target objekts. Mit dieser Methode können Sie schnell die Anweisungseigenschaften für ein Element von instructions abrufen, indem Sie den Index in dieser Liste verwenden. Wenn Sie jedoch nicht direkt mit instructions arbeiten, ist es wahrscheinlich effizienter, über den Namen und die Qubits direkt auf das Ziel zuzugreifen, um die Befehlseigenschaften zu erhalten. Zum Beispiel, wenn instructions zurückgegeben:

[(XGate(), (0,)), (XGate(), (1,))]

könnte man die Eigenschaften des XGate auf dem Qubit 1 mit erhalten:

props = target.instruction_properties(1)

aber ein direkter Zugriff über den Namen wäre effizienter:

props = target['x'][(1,)]

(unter der Annahme, dass der kanonische Name des XGateim Ziel 'x' lautet). Dies gilt insbesondere für größere Ziele, da die Skalierung mit der Anzahl der Instruktionstupel in einem Ziel schlechter ausfällt.

Parameter

index (int) – Der Index des Instruktionstupels aus dem instructions attribut. Wenn Sie zum Beispiel die Eigenschaften des dritten Elements in instructions möchten, würden Sie dies auf 2 setzen.

Rückgabe

Die Instruktionseigenschaften für das angegebene Instruktionstupel

Rückgabetyp

InstructionProperties

instruction_supported(operation_name=None, qargs=Ellipsis, operation_class=None, parameters=None, check_angle_bounds=True)

Rückgabe, ob die Anweisung (Operation + Qubits) vom Ziel unterstützt wird

Parameter

• operation_name (str) – Der Name der Operation für die Anweisung. Es muss entweder dies oder operation_class angegeben werden; wenn beide angegeben sind, hat operation_class Vorrang und dieses Argument wird ignoriert.

• qargs (tuple) – Das Tupel der Qubit-Indizes für die Anweisung. Wenn dies nicht angegeben wird, gibt diese Methode True zurück, wenn die angegebene Operation auf allen Qubits unterstützt wird. In der typischen Anwendung wird diese Einstellung immer vorhanden sein (andernfalls ist es dasselbe, als würde man nur prüfen, ob das Ziel die Operation enthält). Normalerweise würden Sie dieses Argument nicht setzen, wenn Sie ganz allgemein prüfen wollen, ob das Ziel eine Operation mit der parameters auf allen Qubits unterstützt.

• operation_class (Type[qiskit.circuit.Instruction]) – Die Operationsklasse, mit der geprüft wird, ob das Ziel eine bestimmte Operation anhand der Klasse und nicht anhand des Namens unterstützt. Dieser Suchvorgang ist aufwendiger, da er alle Operationen im Ziel durchlaufen muss, anstatt nur einen einzigen Suchvorgang durchzuführen. Wird dies angegeben, hat es Vorrang vor dem operation_name Argument. Der typische Anwendungsfall für diese Operation besteht darin, zu prüfen, ob eine bestimmte Variante einer Operation auf dem Backend unterstützt wird. Wenn Sie beispielsweise prüfen wollten, ob ein RXGate auf einem bestimmten Qubit bei einem festen Winkel unterstützt wird. Diese Variante mit festem Winkel hat in der Regel einen anderen Namen als das Attribut ("rx") des name Objekts im Ziel. Damit lässt sich in einem solchen Fall überprüfen, ob Instanzen der Klasse verfügbar sind.

• parameters (list) –

  Eine Liste von Parametern, um zu prüfen, ob das Ziel sie auf den angegebenen Qubits unterstützt. Wenn die Anweisung die in der Liste angegebenen Parameterwerte für die angegebene Operation und die angegebenen qargs unterstützt, wird True zurückgegeben. Wenn die Parameter für die angegebene Anweisung nicht unterstützt werden, wird False zurückgegeben. Wenn dieses Argument nicht angegeben wird, gibt diese Methode True zurück, wenn die Anweisung unabhängig von den Anweisungsparametern unterstützt wird. Wenn ein Eintrag mit einem beliebigen Parameter objekten in der Liste angegeben wird, wird dieser Eintrag so behandelt, als ob er einen beliebigen Wert unterstützt, jedoch werden die Parameternamen nicht überprüft (wenn z. B. eine Operation im Ziel als parametrisiert mit "theta" aufgeführt ist und "phi" an diese Funktion übergeben wird, wird True zurückgegeben). Zum Beispiel, wenn sie mit aufgerufen werden:

  parameters = [Parameter("theta")]
  target.instruction_supported("rx", (0,), parameters=parameters)

  wird True zurückgeben, wenn ein RXGate auf Qubit 0 unterstützt wird, das einen beliebigen Parameter akzeptiert. Wenn Sie nach einem festen numerischen Wertparameter suchen müssen, wird dieses Argument normalerweise mit dem Argument operation_class gepaart. Zum Beispiel:

  target.instruction_supported("rx", (0,), RXGate, parameters=[pi / 4])

  gibt True zurück, wenn ein RXGate( pi/4 ) auf Qubit 0 existiert.

• check_angle_bounds (bool) – Wenn der Wert von parameters auf True (Standard) gesetzt ist, wird er anhand der im Ziel festgelegten Winkelgrenzen überprüft. Wenn einer der Werte in parameters auf ParameterExpression gesetzt sind, hat dieses Flag keine Auswirkung, da sich die Winkelbegrenzungen nur auf nicht parametrisierte Operationen in der Schaltung auswirken.

Rückgabe

Gibt True zurück, wenn die Anweisung unterstützt wird, und False , wenn sie es nicht ist.

Rückgabetyp

bool

items()

Gibt Paare von Gatternamen und ihre Eigenschaftszuordnung zurück (str, dicttuple[, InstructionProperties] )

keys()

Rückgabe der Schlüssel (operation_names) des Target

operation_from_name(instruction)

Abrufen des Operationsklassenobjekts für einen bestimmten Namen

Parameter

instruction (str) – Der Name der Anweisung zum Abrufen der Instruction instanz für

Rückgabe

Die Instanz der Anweisung, die dem Namen entspricht. Dies kann auch die Klasse für global definierte Variablen mit Operationen sein.

Rückgabetyp

qiskit.circuit.Instruction

operation_names_for_qargs(qargs, /)

Abrufen der Operationsnamen für ein angegebenes qargs-Tupel

Parameter

qargs (tuple) – Ein qargs Tupel der Qubits, um die Gates zu erhalten, die auf sie zutreffen. Zum Beispiel gibt (0,) die Menge aller Anweisungen zurück, die sich auf das Qubit 0 beziehen. Wenn diese Option auf None gesetzt ist, werden die Namen aller global definierten Operationen im Ziel zurückgegeben.

Rückgabe

Die Menge der Vorgangsnamen, die für den angegebenen qargs gelten.

Rückgabetyp

set

Erhöht

KeyError - Wenn qargs nicht im Ziel ist

operations_for_qargs(qargs, /)

Abrufen des Operationsklassenobjekts für ein angegebenes qargs-Tupel

Parameter

qargs (tuple) – Ein qargs-Tupel der Qubits, um die Gates zu erhalten, die darauf zutreffen. Zum Beispiel gibt (0,) die Menge aller Anweisungen zurück, die sich auf das Qubit 0 beziehen. Wenn diese Option auf None gesetzt ist, werden alle global definierten Operationen im Ziel zurückgegeben.

Rückgabe

Die Liste der Instruction instanzen, die auf das angegebene qarg zutreffen. Dies kann auch eine Klasse sein, wenn eine Operation mit variabler Breite global definiert ist.

Rückgabetyp

Liste

Erhöht

KeyError - Wenn qargs nicht in target enthalten ist

qargs_for_operation_name(operation)

Holt die qargs für einen gegebenen Operationsnamen

Parameter

operation (str) – Der Name der Operation, für die qargs abgerufen werden sollen

Rückgabe

Die Menge der Qargs, für die die Gate-Instanz gilt.

Rückgabetyp

set

seconds_to_dt(duration)

Konvertierung einer gegebenen Dauer in Sekunden in Einheiten von dt

Parameter

duration (float) – Die Dauer in Sekunden, z. B. in einem InstructionProperties feld für eine Anweisung im Ziel.

Rückgabetyp

int

Rückgabe

dauer: Die Dauer in Einheiten von dt

supported_angle_bound(name, angles)

Prüfen, ob die Parameter eines bestimmten Gatters mit den Winkelgrenzen übereinstimmen

Parameter

• name (str) – Der Name der Anweisung zur Überprüfung der Winkelbegrenzungen von
• angles (list) – Eine Liste von Float-Parameterwerten für name , um zu sehen, ob sie mit den definierten Winkelgrenzen übereinstimmen.

Rückgabe

Gibt True zurück, wenn die angegebenen Parameterwerte mit den Winkelbegrenzungen kompatibel sind. False wird zurückgegeben, wenn einer der Parameter außerhalb der festgelegten Grenzen liegt.

Rückgabetyp

bool

Erhöht

• TranspilerError – Wenn name nicht im Ziel enthalten ist oder nicht
• haben definierte Winkelgrenzen. -

timing_constraints()

Ein TimingConstraints Objekt vom Ziel abrufen

Rückgabe

Die zeitlichen Beschränkungen, die in der Target

Rückgabetyp

TimingConstraints

update_instruction_properties(instruction, qargs, properties)

Aktualisierung des Eigenschaftsobjekts für ein bereits im Target vorhandenes Befehls-Qarg-Paar.

Zur Erleichterung des Zugriffs kann ein Benutzer die Zuordnung zwischen den anwendbaren qargs einer Anweisung und ihren Anweisungseigenschaften über das Zuordnungsprotokoll (mit __getitem__) erhalten, wobei der Name der Anweisung der Schlüssel ist. Diese Methode ist die einzige Möglichkeit, die Eigenschaften einer Anweisung in Target zu ändern/zu aktualisieren. Die Verwendung des Mapping-Protokolls für Änderungen wird nicht unterstützt.

Parameter

• instruction (str) – Der Name der zu aktualisierenden Anweisung
• qargs (tuple) – Die qargs zum Aktualisieren der Eigenschaften von
• properties (InstructionProperties) – Die für diese Anweisung zu setzenden Eigenschaften

Erhöht

KeyError - Wenn instruction oder qarg nicht im Ziel enthalten sind

values()

Rückgabe der Property Map (qargs -> InstructionProperties ) jeder Anweisung im Target