최상위 예외
qiskit.exceptions
예외
키스킷이 제기하는 모든 키스킷 관련 예외는 베이스의 서브클래스입니다:
QiskitError
exception qiskit.exceptions.QiskitError(*message)
베이스: Exception
키스킷에서 발생하는 에러에 대한 베이스 클래스.
오류 메시지를 설정합니다.
잘못된 입력과 같이 일반적인 프로그래밍 오류에 불과한 오류도 TypeError 과 같은 표준 Python 오류가 발생할 수 있습니다. QiskitError 는 일반적으로 키스킷 사용 시 발생하는 에러에 대한 것입니다.
많은 키스킷 서브 패키지는 관심 있는 오류의 하위 집합만 포착할 수 있도록 자체적으로 더 세분화된 오류를 정의합니다. 예를 들어 qiskit.circuit 은 거의 독점적으로 CircuitError를 사용하는 반면 QASM2ExportError 와 QASM2ParseError 에서 파생 QASM2Error 에서 qiskit.qasm2에서 파생되며, 이는 차례로 QiskitError.
키스킷에는 최소한의 설치에 필요하지 않은 다른 패키지에 의존하는 몇 가지 옵션 기능이 있습니다. 이에 대한 자세한 내용과 존재 여부를 확인하는 방법은 qiskit.utils.optionals. 옵션 추가가 필요한 기능을 사용하려고 하면 특정 에러가 발생하며, 이 에러는 QiskitError 와 Python 내장 ImportError.
MissingOptionalLibraryError
exception qiskit.exceptions.MissingOptionalLibraryError(libname, name, pip_install=None, msg=None)
Bases: QiskitError, ImportError
선택적 라이브러리가 누락된 경우 발생합니다.
오류 메시지를 설정합니다. :param libname: 누락된 라이브러리 이름 :param name: 이 라이브러리를 사용하는 클래스, 함수, 모듈의 이름 :param pip_install: pip 설치 명령(있는 경우) :param msg: 설명 메시지(있는 경우)
매개변수
리턴 유형
없음
흔하지 않은 두 가지 오류는 사용자 구성 파일을 읽지 못하거나 사용할 수 없는 파일 이름을 지정하는 데 실패하는 것과 관련이 있습니다:
QiskitUserConfigError
exception qiskit.exceptions.QiskitUserConfigError(*message)
베이스: QiskitError
사용자 구성 파일을 읽는 동안 오류가 발생하면 발생합니다.
오류 메시지를 설정합니다.
InvalidFileError
exception qiskit.exceptions.InvalidFileError(*message)
베이스: QiskitError
제공된 파일이 특정 작업에 유효하지 않을 때 발생합니다.
오류 메시지를 설정합니다.
경고
키스킷의 일부 특정 기능은 사용자 지정 경고를 표시할 수 있습니다. 일반적으로 키스킷은 적절한 경우 내장된 Python 경고(예를 들어 DeprecationWarning)를 적절한 경우 사용하지만, 키스킷 특정 기능과 관련된 경고는 하위 유형인 QiskitWarning.
QiskitWarning
관련 MissingOptionalLibraryError선택적 종속성이 발견되었지만 다른 이유로 가져오기에 실패하는 경우도 있습니다. 이 경우 키스킷은 종속성이 없는 것처럼 계속 진행하지만, 이를 알리기 위해 OptionalDependencyImportWarning 를 발생시켜 사용자에게 알립니다.
OptionalDependencyImportWarning
exception qiskit.exceptions.OptionalDependencyImportWarning
베이스: QiskitWarning
선택적 라이브러리가 가져오는 동안 오류가 발생할 때 발생합니다.
실험적 기능을 사용 중일 때 키스킷은 ExperimentalWarning.
키스킷의 실험적 기능은 마이너 릴리스에서 중단될 수 있으며 사전 알림 없이 API가 변경될 수 있습니다. 프로덕션에서는 사용하지 않는 것이 좋습니다.
ExperimentalWarning
경고 필터링
Python 이 warnings 모듈의 설명서에 설명된 대로, 경고 메시지를 필터링하는 기능이 내장되어 있습니다. Python 내부의 경고 필터에서 이러한 하위 클래스를 사용하여 관심 없는 경고가 표시되지 않도록 할 수 있습니다. 예를 들어, 실험적 기능을 의도적으로 사용하고 있으며 향후 버전에서 해당 기능이 작동하지 않을 수도 있다는 점을 감수할 수 있다면, 다음과 같이 알림을 ExperimentalWarning 비활성화할 수 있습니다:
import warnings
from qiskit.exceptions import ExperimentalWarning
warnings.filterwarnings("ignore", category=ExperimentalWarning)