Eccezioni di livello superiore
qiskit.exceptions
Eccezioni
Tutte le eccezioni relative a Qiskit sollevate da Qiskit sono sottoclassi della base:
QiskitError
exception qiskit.exceptions.QiskitError(*message)
Basi: Exception
Classe di base per gli errori sollevati da Qiskit.
Impostare il messaggio di errore.
Errori che sono solo errori generali di programmazione, come una digitazione errata, possono comunque sollevare errori standard di Python come TypeError. QiskitError è generalmente per gli errori generati da un uso particolare di Qiskit.
Molti dei sottopacchetti di Qiskit definiscono i propri errori in modo più granulare, per aiutare a catturare solo il sottoinsieme di errori che interessano. Ad esempio, qiskit.circuit utilizza quasi esclusivamente CircuitError, mentre sia QASM2ExportError e QASM2ParseError derivano da QASM2Error in qiskit.qasm2, che è a sua volta un tipo di QiskitError.
Qiskit ha diverse funzioni opzionali che dipendono da altri pacchetti che non sono necessari per un'installazione minima. Per saperne di più su questi aspetti e sui modi per verificarne la presenza, consultare il sito qiskit.utils.optionals. Se si tenta di utilizzare una funzione che richiede un optional, si solleva un errore particolare, che sottoclasse sia il metodo QiskitError e il built-in Python ImportError.
MissingOptionalLibraryError
exception qiskit.exceptions.MissingOptionalLibraryError(libname, name, pip_install=None, msg=None)
Basi: QiskitError, ImportError
Viene sollevato quando manca una libreria opzionale.
Imposta il messaggio di errore. :param libname: Nome della libreria mancante :param name: Nome della classe, funzione, modulo che utilizza questa libreria :param pip_install: Comando di installazione di pip, se presente :param msg: Messaggio descrittivo, se presente
Parametri
Tipo di restituzione
Nessuna
Altri due errori poco comuni riguardano la mancata lettura dei file di configurazione dell'utente o l'indicazione di un nome di file che non può essere utilizzato:
QiskitUserConfigError
exception qiskit.exceptions.QiskitUserConfigError(*message)
Basi: QiskitError
Viene sollevato quando si verifica un errore nella lettura di un file di configurazione utente.
Impostare il messaggio di errore.
InvalidFileError
exception qiskit.exceptions.InvalidFileError(*message)
Basi: QiskitError
Viene sollevato quando il file fornito non è valido per l'attività specifica.
Impostare il messaggio di errore.
Avvertenze
Alcune funzioni particolari di Qiskit possono generare avvisi personalizzati. In generale, Qiskit utilizzerà gli avvisi incorporati di Python (come ad esempio DeprecationWarning) quando appropriato, ma gli avvisi relativi a funzionalità specifiche di Qiskit saranno sottotipi di QiskitWarning.
QiskitWarning
exception qiskit.exceptions.QiskitWarning
Basi: UserWarning
Sottoclasse comune di avvisi per gli avvisi specifici di Qiskit.
In relazione a MissingOptionalLibraryErrorin alcuni casi una dipendenza opzionale potrebbe essere trovata, ma non essere importata per qualche altro motivo. In questo caso, Qiskit continuerà come se la dipendenza non fosse presente, ma solleverà il messaggio OptionalDependencyImportWarning per informare l'utente.
OptionalDependencyImportWarning
exception qiskit.exceptions.OptionalDependencyImportWarning
Basi: QiskitWarning
Sollevato quando una libreria opzionale genera errori durante la sua importazione.
Quando si utilizzano funzioni sperimentali, Qiskit solleverà ExperimentalWarning.
Le funzioni sperimentali di Qiskit possono rompersi in qualsiasi release minore e le loro API possono cambiare senza preavviso. Il loro uso è sconsigliato in produzione.
ExperimentalWarning
exception qiskit.exceptions.ExperimentalWarning
Basi: QiskitWarning
Viene sollevato quando si utilizza una funzione sperimentale.
Filtraggio degli avvisi
Python dispone di meccanismi integrati per filtrare gli avvisi, descritti nella documentazione del modulo warnings . È possibile utilizzare queste sottoclassi nei filtri di avviso all'interno di Python per ignorare gli avvisi che non ti interessano. Ad esempio, se stai utilizzando consapevolmente funzionalità sperimentali e sei consapevole che potrebbero non funzionare correttamente nelle versioni successive, puoi disattivare gli avvisi ExperimentalWarning in questo modo:
import warnings
from qiskit.exceptions import ExperimentalWarning
warnings.filterwarnings("ignore", category=ExperimentalWarning)