Exceptions de niveau supérieur
qiskit.exceptions
Exceptions
Toutes les exceptions liées à Qiskit soulevées par Qiskit sont des sous-classes de la base :
QiskitError
exception qiskit.exceptions.QiskitError(*message)
Bases : Exception
Classe de base pour les erreurs soulevées par Qiskit.
Définir le message d'erreur.
Les erreurs qui ne sont que des erreurs de programmation générales, telles qu'une frappe incorrecte, peuvent toujours provoquer des erreurs standard sur Python, telles que TypeError. QiskitError concerne généralement les erreurs liées à une utilisation particulière de Qiskit.
De nombreux sous-packages Qiskit définissent leurs propres erreurs plus granulaires, pour aider à attraper uniquement le sous-ensemble d'erreurs qui vous intéresse. Par exemple, qiskit.circuit utilise presque exclusivement CircuitErroralors que QASM2ExportError et QASM2ParseError dérivent de QASM2Error en qiskit.qasm2qui est à son tour un type de QiskitError.
Qiskit possède plusieurs fonctionnalités optionnelles qui dépendent d'autres paquets qui ne sont pas nécessaires pour une installation minimale. Pour en savoir plus sur ces derniers et sur les moyens de vérifier leur présence, voir qiskit.utils.optionals. Toute tentative d'utilisation d'une fonctionnalité nécessitant une option supplémentaire entraînera une erreur particulière, qui relève à la fois de la sous-classe QiskitError et de l'élément intégré Python ImportError.
MissingOptionalLibraryError
exception qiskit.exceptions.MissingOptionalLibraryError(libname, name, pip_install=None, msg=None)
Bases : QiskitError, ImportError
Signalé lorsqu'une bibliothèque optionnelle est manquante.
Définir le message d'erreur :param libname : Nom de la bibliothèque manquante :param name : Nom de la classe, de la fonction, du module qui utilise cette bibliothèque :param pip_install : Commande pip install, le cas échéant :param msg : Message descriptif, le cas échéant
Paramètres
Type de retour
Aucun
Deux autres erreurs peu courantes concernent des échecs dans la lecture des fichiers de configuration de l'utilisateur, ou la spécification d'un nom de fichier qui ne peut pas être utilisé :
QiskitUserConfigError
exception qiskit.exceptions.QiskitUserConfigError(*message)
Bases : QiskitError
Levée lorsqu'une erreur est rencontrée lors de la lecture d'un fichier de configuration utilisateur.
Définir le message d'erreur.
InvalidFileError
exception qiskit.exceptions.InvalidFileError(*message)
Bases : QiskitError
Lancé lorsque le fichier fourni n'est pas valide pour la tâche spécifique.
Définir le message d'erreur.
Avertissements
Certaines fonctionnalités particulières de Qiskit peuvent donner lieu à des avertissements personnalisés. En général, Qiskit utilisera les avertissements intégrés de Python (tels que DeprecationWarning) lorsque cela est approprié, mais les avertissements liés aux fonctionnalités spécifiques de Qiskit seront des sous-types de QiskitWarning.
QiskitWarning
exception qiskit.exceptions.QiskitWarning
Bases : UserWarning
Sous-classe commune d'avertissements pour les avertissements spécifiques à Qiskit.
En rapport avec MissingOptionalLibraryErrordans certains cas, une dépendance optionnelle peut être trouvée, mais ne pas être importée pour une autre raison. Dans ce cas, Qiskit continuera comme si la dépendance n'était pas présente, mais lèvera la case OptionalDependencyImportWarning pour vous en informer.
OptionalDependencyImportWarning
exception qiskit.exceptions.OptionalDependencyImportWarning
Bases : QiskitWarning
Levée lorsqu'une bibliothèque optionnelle soulève des erreurs lors de son importation.
Lorsque des fonctions expérimentales sont utilisées, Qiskit lève les ExperimentalWarning.
Les fonctionnalités expérimentales de Qiskit peuvent être interrompues à chaque version mineure et leur API peut être modifiée sans notification préalable. Leur utilisation n'est pas recommandée dans la production.
ExperimentalWarning
exception qiskit.exceptions.ExperimentalWarning
Bases : QiskitWarning
Signalé en cas d'utilisation d'une fonctionnalité expérimentale.
Filtrage des avertissements
Python dispose de mécanismes intégrés permettant de filtrer les avertissements, décrits dans la documentation du warnings module. Vous pouvez utiliser ces sous-classes dans vos filtres d'avertissement via Python pour masquer les avertissements qui ne vous intéressent pas. Par exemple, si vous utilisez sciemment des fonctionnalités expérimentales et que cela ne vous pose pas de problème qu'elles cessent de fonctionner dans des versions ultérieures, vous pouvez désactiver les notifications ExperimentalWarning comme suit :
import warnings
from qiskit.exceptions import ExperimentalWarning
warnings.filterwarnings("ignore", category=ExperimentalWarning)