Exceções de nível superior
qiskit.exceptions
Exceções
Todas as exceções relacionadas ao Qiskit levantadas pelo Qiskit são subclasses da base:
QiskitError
exception qiskit.exceptions.QiskitError(*message)
Bases: Exception
Classe base para erros gerados pelo Qiskit.
Defina a mensagem de erro.
Os erros que são apenas erros gerais de programação, como digitação incorreta, ainda podem gerar erros padrão no site Python, como TypeError. QiskitError é geralmente para erros gerados no uso específico do Qiskit.
Muitos dos subpacotes do Qiskit definem seus próprios erros mais granulares, para ajudar a capturar apenas o subconjunto de erros que lhe interessa. Por exemplo, qiskit.circuit usa quase exclusivamente CircuitError, enquanto ambos QASM2ExportError e QASM2ParseError derivam de QASM2Error em qiskit.qasm2que, por sua vez, é um tipo de QiskitError.
O Qiskit tem vários recursos opcionais que dependem de outros pacotes que não são necessários para uma instalação mínima. Você pode ler mais sobre eles e maneiras de verificar sua presença em qiskit.utils.optionals. A tentativa de usar um recurso que requer um extra opcional gerará um erro específico, que subclasses tanto QiskitError e o Python incorporado ImportError.
MissingOptionalLibraryError
exception qiskit.exceptions.MissingOptionalLibraryError(libname, name, pip_install=None, msg=None)
Bases: QiskitError, ImportError
Levantado quando uma biblioteca opcional está faltando.
Defina a mensagem de erro :param libname: Nome da biblioteca ausente :param name: Nome da classe, função ou módulo que usa essa biblioteca :param pip_install: Comando de instalação do pip, se houver :param msg: Mensagem descritiva, se houver
Parâmetros
Tipo de retorno
Nenhum
Outros dois erros incomuns estão relacionados a falhas na leitura de arquivos de configuração do usuário ou à especificação de um nome de arquivo que não pode ser usado:
QiskitUserConfigError
exception qiskit.exceptions.QiskitUserConfigError(*message)
Bases: QiskitError
Levantado quando é encontrado um erro na leitura de um arquivo de configuração do usuário.
Defina a mensagem de erro.
InvalidFileError
exception qiskit.exceptions.InvalidFileError(*message)
Bases: QiskitError
Gerado quando o arquivo fornecido não é válido para a tarefa específica.
Defina a mensagem de erro.
Avisos
Alguns recursos específicos do Qiskit podem gerar avisos personalizados. Em geral, o Qiskit usará avisos incorporados em Python (como DeprecationWarning) quando apropriado, mas os avisos relacionados à funcionalidade específica do Qiskit serão subtipos de QiskitWarning.
QiskitWarning
exception qiskit.exceptions.QiskitWarning
Bases: UserWarning
Subclasse comum de avisos para avisos específicos do Qiskit que estão sendo levantados.
Relacionado a MissingOptionalLibraryErrorem alguns casos, uma dependência opcional pode ser encontrada, mas não ser importada por algum outro motivo. Nesse caso, o Qiskit continuará como se a dependência não estivesse presente, mas levantará OptionalDependencyImportWarning para que você saiba disso.
OptionalDependencyImportWarning
exception qiskit.exceptions.OptionalDependencyImportWarning
Bases: QiskitWarning
Levantado quando uma biblioteca opcional gera erros durante sua importação.
Quando recursos experimentais estiverem sendo usados, o Qiskit aumentará ExperimentalWarning.
Os recursos experimentais do Qiskit podem ser interrompidos em qualquer versão secundária e sua API pode ser alterada sem notificação prévia. Seu uso não é recomendado na produção.
ExperimentalWarning
exception qiskit.exceptions.ExperimentalWarning
Bases: QiskitWarning
Levantado quando um recurso experimental está sendo usado.
Filtragem de avisos
Python possui mecanismos integrados para filtrar avisos, descritos na documentação do módulo warnings . Você pode usar essas subclasses nos seus filtros de aviso no arquivo Python para ignorar os avisos que não lhe interessam. Por exemplo, se você estiver usando recursos experimentais de forma consciente e não se importar que eles possam deixar de funcionar em versões futuras, pode desativar o aviso ExperimentalWarning da seguinte maneira:
import warnings
from qiskit.exceptions import ExperimentalWarning
warnings.filterwarnings("ignore", category=ExperimentalWarning)