Skip to main content
IBM Quantum Platform

Ausnahmen auf oberster Ebene

qiskit.exceptions


Ausnahmen

Alle Qiskit-bezogenen Ausnahmen, die von Qiskit ausgelöst werden, sind Unterklassen der Basis:

QiskitError

exception qiskit.exceptions.QiskitError(*message)

GitHub

Basen: Exception

Basisklasse für von Qiskit ausgelöste Fehler.

Legen Sie die Fehlermeldung fest.

Anmerkung

Fehler, die nur allgemeine Programmierfehler sind, wie z.B. falsche Eingabe, können immer noch Standardfehler von Python wie TypeError auslösen. QiskitError ist im Allgemeinen für Fehler gedacht, die bei der Verwendung von Qiskit auftreten.

Viele der Qiskit-Unterpakete definieren ihre eigenen granularen Fehler, um nur die Teilmenge von Fehlern abzufangen, die Sie interessieren. Zum Beispiel, qiskit.circuit verwendet fast ausschließlich CircuitError, während sowohl QASM2ExportError und QASM2ParseError sich ableiten von QASM2Error in qiskit.qasm2ableiten, das wiederum ein Typ von QiskitError.

Qiskit hat mehrere optionale Funktionen, die von anderen Paketen abhängen, die für eine Minimalinstallation nicht erforderlich sind. Mehr darüber und darüber, wie man sie aufspüren kann, erfahren Sie in qiskit.utils.optionals. Der Versuch, eine Funktion zu verwenden, die ein optionales Extra erfordert, führt zu einem besonderen Fehler, der sowohl die Unterklassen QiskitError als auch der Python eingebauten ImportError untergeordnet ist.

MissingOptionalLibraryError

exception qiskit.exceptions.MissingOptionalLibraryError(libname, name, pip_install=None, msg=None)

GitHub

Basen: QiskitError, ImportError

Wird ausgelöst, wenn eine optionale Bibliothek fehlt.

Legen Sie die Fehlermeldung fest. :param libname: Name der fehlenden Bibliothek :param name: Name der Klasse, Funktion, des Moduls, das diese Bibliothek verwendet :param pip_install: pip install Befehl, falls vorhanden :param msg: Beschreibende Meldung, falls vorhanden

Parameter

  • libname (str)
  • name (str)
  • pip_install (str | None)
  • msg (str | None)

Rückgabetyp

Keine

Zwei weitere ungewöhnliche Fehler beziehen sich auf Fehler beim Lesen von Benutzerkonfigurationsdateien oder auf die Angabe eines Dateinamens, der nicht verwendet werden kann:

QiskitUserConfigError

exception qiskit.exceptions.QiskitUserConfigError(*message)

GitHub

Basen: QiskitError

Wird ausgelöst, wenn ein Fehler beim Lesen einer Benutzerkonfigurationsdatei auftritt.

Legen Sie die Fehlermeldung fest.

InvalidFileError

exception qiskit.exceptions.InvalidFileError(*message)

GitHub

Basen: QiskitError

Wird ausgelöst, wenn die angegebene Datei für die spezifische Aufgabe nicht gültig ist.

Legen Sie die Fehlermeldung fest.


Warnungen

Einige besondere Funktionen von Qiskit können benutzerdefinierte Warnungen auslösen. Im Allgemeinen verwendet Qiskit integrierte Python Warnungen (wie z.B DeprecationWarning), wenn es angebracht ist, aber Warnungen, die sich auf Qiskit-spezifische Funktionen beziehen, sind Untertypen von QiskitWarning.

QiskitWarning

exception qiskit.exceptions.QiskitWarning

GitHub

Basen: UserWarning

Gemeinsame Unterklasse von Warnungen für Qiskit-spezifische Warnungen, die ausgelöst werden.

Bezogen auf MissingOptionalLibraryErrorkann es vorkommen, dass eine optionale Abhängigkeit zwar gefunden wird, aber aus anderen Gründen nicht importiert werden kann. In diesem Fall wird Qiskit so fortfahren, als ob die Abhängigkeit nicht vorhanden wäre, aber es wird OptionalDependencyImportWarning um Sie darüber zu informieren.

OptionalDependencyImportWarning

exception qiskit.exceptions.OptionalDependencyImportWarning

GitHub

Basen: QiskitWarning

Wird ausgelöst, wenn eine optionale Bibliothek während ihres Imports einen Fehler verursacht.

Wenn experimentelle Funktionen verwendet werden, wird Qiskit die ExperimentalWarning.

Achtung

Die experimentellen Funktionen von Qiskit können bei jeder kleineren Version ausfallen und ihre API kann sich ohne vorherige Ankündigung ändern. Ihre Verwendung in der Produktion wird nicht empfohlen.

ExperimentalWarning

exception qiskit.exceptions.ExperimentalWarning

GitHub

Basen: QiskitWarning

Wird ausgelöst, wenn eine experimentelle Funktion verwendet wird.

Warnungen filtern

Python verfügt über integrierte Mechanismen zum Filtern von Warnungen, die in der Dokumentation des warnings Moduls beschrieben sind. Sie können diese Unterklassen in Ihren Warnungsfiltern unter „ Python “ verwenden, um Warnungen auszublenden, die für Sie nicht von Interesse sind. Wenn Sie beispielsweise bewusst experimentelle Funktionen nutzen und damit einverstanden sind, dass diese in späteren Versionen möglicherweise nicht mehr funktionieren, können Sie die Meldungen wie folgt ExperimentalWarning deaktivieren:

import warnings
from qiskit.exceptions import ExperimentalWarning

warnings.filterwarnings("ignore", category=ExperimentalWarning)
War diese Seite hilfreich?
Melden Sie auf GitHub einen Fehler, einen Tippfehler oder fordern Sie Inhalte an.