Визначення опцій Executor

Версії пакетів

Код на цій сторінці було розроблено з використанням таких вимог. Рекомендуємо використовувати ці або новіші версії.

qiskit-ibm-runtime~=0.46.1

Ти можеш використовувати опції для налаштування примітиву Executor. На відміну від Sampler та Estimator, Executor має дуже мало опцій, оскільки більшість задумів дизайну закодована в samplex.

Примітки

• Можна переглядати доступні опції та оновлювати їх значення під час або після ініціалізації примітива.

• Використовуй метод update() для застосування змін до атрибуту options.

• • Атрибут options має тип Python dataclass. Можна використовувати вбудований метод asdict для конвертування у словник.

• Executor може обробляти лише інформацію, закодовану в samplex. Зверніться до посібників Samplomatic, щоб зрозуміти обмеження.

Встановлення опцій Executor

Якщо опція вказана як під час, так і після ініціалізації примітива, використовується значення, встановлене після ініціалізації примітива.

Ініціалізація примітива

При ініціалізації Executor можна передати екземпляр класу опцій або словник, після чого він робить копію цих опцій. Таким чином, зміна оригінального словника або екземпляра опцій не впливає на опції, що належать примітиву.

Клас опцій

При створенні екземпляра класу Executor можна передати екземпляр класу опцій. Ці опції потім застосовуються при використанні run() для виконання обчислення. Вкажи опції у такому форматі: options.option.sub-option.sub-sub-option = choice. Наприклад: options.environment.log_level = INFO.

Приклад:

# Added by doQumentation — required packages for this notebook
!pip install -q qiskit-ibm-runtime

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.

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. Щоб переглянути старіші версії опцій, відвідай довідник API qiskit-ibm-runtime та обери попередню версію.

environment

Документація API environment

environment.job_tags

Список тегів.

Варіанти: None

За замовчуванням: None

environment.log_level

Варіанти: DEBUG, INFO, WARNING, ERROR, CRITICAL

За замовчуванням: WARNING

environment.private

Варіанти: True, False

За замовчуванням: False

environment.max_execution_time

Варіанти: Ціле число секунд у діапазоні [1, 10800]

За замовчуванням: 10800 (3 години)

execution

Документація API execution

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

Експериментальні опції, коли доступні.

Наступні кроки

Рекомендації

• Ознайомся з документацією API ExecutionOptionsV2.
• Ознайомся з документацією API EnvironmentOptions.