실행자 옵션 지정

• 패키지 버전

  이 페이지의 코드는 다음 요구 사항을 바탕으로 개발되었습니다. 이 버전 이상을 사용하시기를 권장합니다.

  qiskit-ibm-runtime~=0.46.1
  

옵션을 사용하여 Executor 기본 객체를 사용자 정의할 수 있습니다. 샘플러(Sampler)나 에스티메이터(Estimator)와 달리, 익스큐터(Executor)는 설계 의도의 대부분이 샘플렉스(samplex)에 반영되어 있기 때문에 옵션이 매우 적습니다.

실행기 옵션 설정

기본형 초기화 과정 중과 초기화 후 모두에 옵션이 지정된 경우, 기본형 초기화 후에 설정된 값이 사용됩니다.

기본 초기화

Executor를 초기화할 때 옵션 클래스의 인스턴스나 딕셔너리를 전달할 수 있으며, 이때 해당 옵션의 복사본이 생성됩니다. 따라서 원래의 사전이나 옵션 인스턴스를 변경하더라도, 해당 기본 객체가 소유한 옵션에는 영향을 미치지 않습니다.

옵션 수업

클래스의 Executor 인스턴스를 생성할 때, 옵션 클래스의 인스턴스를 전달할 수 있습니다. 이러한 옵션들은 을 사용하여 run() 계산을 수행할 때 적용됩니다. 옵션을 다음 형식으로 지정하십시오: options.option.sub-option.sub-sub-option = choice. 예를 들어, options.environment.log_level = INFO입니다.

예:

from qiskit_ibm_runtime import QiskitRuntimeService, Executor
from qiskit_ibm_runtime.options import ExecutorOptions

service = QiskitRuntimeService()
backend = service.least_busy(operational=True, simulator=False)

options = ExecutorOptions(
    environment={"log_level": "INFO"},
    execution={"init_qubits": True},
)

# or use the following instead:

options = ExecutorOptions()
options.environment.log_level = "INFO"
options.execution.init_qubits = True

executor = Executor(mode=backend, options=options)

사전

Executor를 초기화할 때 옵션을 사전(dictionary) 형태로 지정할 수 있습니다.

from qiskit_ibm_runtime import QiskitRuntimeService, Executor

service = QiskitRuntimeService()
backend = service.least_busy(operational=True, simulator=False)

# Setting options during primitive initialization
executor = Executor(
    backend,
    options={
        "environment": {"log_level": "INFO"},
        "execution": {"init_qubits": True},
    },
)

사용 가능 옵션

qiskit-ibm-runtime다음 표는 최신 버전의 옵션을 정리한 것입니다. 이전 버전의 옵션을 보려면 를 qiskit-ibm-runtime API 참조 방문하여 이전 버전을 선택하세요.

• environment

  environment API 문서

  • environment.job_tags

    태그 목록.

    선택 사항 : 없음

    기본값 : 없음

  • environment.log_level

    선택 항목 : DEBUG, INFO, WARNING, ERROR, CRITICAL

    기본값 : 경고

  • environment.private

    선택 사항 : True, False

    기본값 : False

  • environment.max_execution_time

    선택 사항 : [1] 에서 10800 사이의 초 단위 정수

    기본값 : 10800 (3시간)

• execution

  execution API 문서

  • execution.init_qubits

    각 샷마다 큐비트를 기저 상태로 재설정할지 여부.

    선택 사항 : True, False

    기본값 : True

  • execution.rep_delay

    측정 후 다음 양자 회로가 실행되기까지의 시간 간격.

    선택 사항 : 다음 범위 내의 값 backend.rep_delay_range

    기본값 : 다음에서 지정됨 backend.default_rep_delay

  • execution.meas_type

    선택 사항 : classified, kerneled, avg_kerneled

    기본값 : classified

• experimental

  가능한 경우 실험적 옵션.

다음 단계