옵션
class qiskit.providers.Options(**kwargs)
베이스: Mapping
기본 옵션 개체
이 클래스는 모든 백엔드 옵션의 기반이 되는 클래스입니다. 클래스의 속성은 사용자가 필요에 따라 백엔드를 재구성할 수 있도록 모두 동적으로 조정할 수 있도록 설계되었습니다. 사용자가 변경할 수 없는 속성(예: 큐비트 수)의 경우 옵션이 아닌 백엔드 클래스 자체의 구성이어야 합니다.
이 클래스의 인스턴스는 사전처럼 동작합니다. 기본값이 있는 옵션에 액세스하려면 get() 메서드를 사용하면 됩니다:
>>> options = Options(opt1=1, opt2=2)
>>> options.get("opt1")
1
>>> options.get("opt3", default="hello")
'hello'모든 옵션의 키-값 쌍은 items() 메서드를 사용하여 검색할 수 있습니다:
>>> list(options.items())
[('opt1', 1), ('opt2', 2)]옵션은 이름별로 업데이트할 수 있습니다:
>>> options["opt1"] = 3
>>> options.get("opt1")
3런타임 유효성 검사기를 등록할 수 있습니다. Set_validator를 참조하세요. Update_옵션 및 인덱싱(__setitem__)을 통한 업데이트는 업데이트를 수행하기 전에 새 값의 유효성을 검사하고 새 값이 유효하지 않은 경우 ValueError 을 발생시킵니다.
>>> options.set_validator("opt1", (1, 5))
>>> options["opt1"] = 4
>>> options["opt1"]
4
>>> options["opt1"] = 10
Traceback (most recent call last):
...
ValueError: ...속성
validator
메소드
get
get(k[, d]) → D[k] if k in D, else d. d defaults to None.
items
items() → a set-like object providing a view on D's items
keys
keys() → a set-like object providing a view on D's keys
set_validator
set_validator(field, validator_value)
옵션에서 필드에 대한 선택적 유효성 검사기를 설정합니다
유효성 검사기를 설정하면 옵션 값에 대한 변경 사항이 호출될 때 update_options() 가 호출될 때 유효성을 검사합니다. 예를 들어 shots 같은 숫자 필드가 있는 경우 다음과 같이 값의 상한과 하한을 설정하는 바운드 튜플을 지정할 수 있습니다:
options.set_validator("shots", (1, 4096))이 경우 사용자가 "shots" 옵션을 업데이트할 때마다 값이 >=1 및 <=4096이 되도록 강제합니다. 해당 범위를 벗어나는 경우 ValueError 이 발생합니다. 지정된 필드에 대해 이미 유효성 검사기가 있는 경우 자동으로 재정의됩니다.
매개변수
- field (str) – 유효성 검사기를 설정할 필드 이름
- validator_value (list ortuple ortype) – 유형에 따라 유효성 검사기에 사용할 값은 해당 필드의 값이 어떻게 검증되는지를 나타냅니다. 튜플이 전달될 경우, 그 길이는 반드시 2여야 하며, 정수 또는 실수 값 옵션에 대해 최소값과 최대값(해당 값 포함)을 강제 적용합니다. 목록인 경우 해당 필드의 유효한 값들이 나열됩니다. 만약 그렇다면,
type검증기는 해당 값이 특정 유형인지 확인하기만 하면 됩니다.
올리기
- KeyError - 옵션 객체에 필드가 없는 경우
- ValueError -
validator_value에 지정된 유형에 대한 유효하지 않은 값이 있는 경우 - TypeError -
validator_value이 유효한 유형이 아닌 경우
update_options
values
values() → an object providing a view on D's values