최상위 예외
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)
베이스: 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
제공된 파일이 특정 작업에 유효하지 않을 때 발생합니다.
오류 메시지를 설정합니다.
경고
Qiskit의 특정 기능으로 인해 사용자 정의 경고가 발생할 수 있습니다. 일반적으로 Qiskit은 적절한 경우 내장된 Python 경고(예: DeprecationWarning)를 사용하지만, Qiskit 고유의 기능과 관련된 경고는 의 하위 유형이 됩니다 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)