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

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

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

qiskit-ibm-runtime~=0.46.1

Можна використовувати опції для налаштування примітива Executor.

Примітки

• Можна переглядати доступні опції та оновлювати їх значення під час або після ініціалізації примітива.
• Використовуй метод update() для застосування змін до атрибуту options.
• Атрибут options має тип Python dataclass. Можна використовувати вбудований метод asdict для конвертування у словник.

Встановлення опцій 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

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

Сумісність функцій

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

Динамічні схеми

Несумісно з:

• Gate-folding ZNE
• PEA
• PEC
• Динамічним роз'єднанням

Інші примітки:

• Gate twirling може застосовуватися до динамічних схем, але лише до вентилів, що не знаходяться всередині умовних блоків.
• Measurement twirling може застосовуватися лише до кінцевих вимірювань.
• Measurement twirling несумісний з інструкцією store.
• Сумісно з дробовими вентилями при використанні qiskit-ibm-runtime v0.42.0 або пізнішої версії.

Динамічне роз'єднання

Несумісно з динамічними схемами.

Дробові вентилі

Несумісно з:

• Gate twirling
• PEA
• PEC

Сумісно з динамічними схемами при використанні qiskit-ibm-runtime v0.42.0 або пізнішої версії.

Gate-folding ZNE

Несумісно з:

• Динамічними схемами
• PEA
• PEC

Може не працювати при використанні власних вентилів.

Gate twirling

Несумісно з дробовими вентилями або розтягуваннями.

Інші примітки:

• Gate twirling може застосовуватися до динамічних схем, але лише до вентилів, що не знаходяться всередині умовних блоків. Measurement twirling може застосовуватися лише до кінцевих вимірювань.
• Не працює з не-Кліффордськими заплутуючими вентилями.

PEA

Несумісно з:

• Динамічними схемами
• Дробовими вентилями
• Gate-folding ZNE
• PEC

PEC

Несумісно з:

• Динамічними схемами
• Дробовими вентилями
• Gate-folding ZNE
• PEA

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

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

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