Перейти до основного вмісту

Вступ до параметрів

Ти можеш передавати параметри примітивам для їх налаштування відповідно до своїх потреб. Цей розділ присвячений параметрам примітивів Qiskit Runtime. Хоча інтерфейс методу run() примітивів є спільним для всіх реалізацій, їхні параметри відрізняються. Зверни увагу на відповідні довідники API для отримання інформації про параметри qiskit.primitives та qiskit_aer.primitives.

Огляд​

Структура​

При виклику примітивів можна передавати параметри за допомогою класу параметрів або словника. Параметри, що часто використовуються, наприклад resilience_level, знаходяться на першому рівні. Інші параметри згруповані за різними категоріями, наприклад execution. Докладніше дивись у розділі Задання параметрів примітивів.

Значення за замовчуванням​

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

Значення за замовчуванням наведені в таблицях розділу Зведена інформація про класи параметрів.

Задання параметрів​

Параметри можна визначити до створення примітива і передати йому — примітив зробить їх копію. Це можна зробити або у вигляді вкладеного словника, або за допомогою класів параметрів. Крім того, після створення примітива його параметри можна змінити. Використовуй той підхід, який найкраще підходить для твого застосунку. Докладніше дивись у розділі Задання параметрів.

Зведена інформація про класи параметрів​

  • Dynamical decoupling: Параметри динамічного роз'єднання.
  • Environment: Параметри середовища виконання, наприклад рівень журналювання та теги завдань.
  • Execution: Параметри виконання примітивів, включаючи ініціалізацію кубітів і затримку повторення.
  • Resilience: Розширені параметри налаштування методів пом'якшення похибок, таких як пом'якшення похибок вимірювань, ZNE та PEC.
  • Simulator: Параметри симулятора, наприклад базові вентилі, початкове число симулятора та карта зв'язності. Застосовується лише для режиму локального тестування.
  • Twirling: Параметри твірлінгу, наприклад чи застосовувати твірлінг двокубітних вентилів та кількість кадрів для кожного випадкового зразка.

Доступні параметри​

Наступна таблиця документує параметри останньої версії qiskit-ibm-runtime. Щоб переглянути старіші версії параметрів, відвідай довідник API qiskit-ibm-runtime і вибери попередню версію.

default_shots​

Загальна кількість кадрів для використання на схему на конфігурацію.

Варіанти: Ціле число >= 0

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

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

default_precision​

Точність за замовчуванням для використання в будь-якому виклику PUB або run(), що не вказує власної.

Варіанти: Float > 0

За замовчуванням: 0.015625 (1 / sqrt(4096))

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

dynamical_decoupling​

Керування налаштуваннями пом'якшення похибок динамічного роз'єднання.

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

dynamical_decoupling.enable​

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

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

dynamical_decoupling.extra_slack_distribution​

Варіанти: middle, edges

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

dynamical_decoupling.scheduling_method​

Варіанти: asap, alap За замовчуванням: alap

dynamical_decoupling.sequence_type​

Варіанти: XX, XpXm, XY4 За замовчуванням: XX

dynamical_decoupling.skip_reset_qubits​

Варіанти: True, False За замовчуванням: False

environment​

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

environment.callback​

Функція зворотного виклику, що отримує Job ID та Job result.

Варіанти: None

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

environment.job_tags​

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

Варіанти: None

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

environment.log_level​

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

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

environment.private​

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

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

execution​

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

execution.init_qubits​

Чи скидати кубіти до основного стану для кожного кадру.

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

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

execution.rep_delay​

Затримка між вимірюванням і наступною квантовою схемою.

Варіанти: Значення в діапазоні, що задається backend.rep_delay_range

За замовчуванням: Задається backend.default_rep_delay

max_execution_time​

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

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

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

resilience​

Розширені параметри стійкості для тонкого налаштування стратегії стійкості.

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

resilience.layer_noise_learning​

Параметри для навчання на шумі шарів.

Документація API resilience.layer_noise_learning

resilience.layer_noise_learning.layer_pair_depths​

Варіанти: list[int] від 2 до 10 значень у діапазоні [0, 200]

За замовчуванням: (0, 1, 2, 4, 16, 32)

resilience.layer_noise_learning.max_layers_to_learn​

Варіанти: None, Ціле число >= 1

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

resilience.layer_noise_learning.num_randomizations​

Варіанти: Ціле число >= 1

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

resilience.layer_noise_learning.shots_per_randomization​

Варіанти: Ціле число >= 1

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

resilience.layer_noise_model​

Варіанти: NoiseLearnerResult, Sequence[LayerError]

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

resilience.measure_mitigation​

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

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

resilience.measure_noise_learning​

Параметри для навчання на шумі вимірювань.

Документація API resilience.measure_noise_learning

resilience.measure_noise_learning.num_randomizations​

Варіанти: Ціле число >= 1

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

resilience.measure_noise_learning.shots_per_randomization​

Варіанти: Ціле число, auto

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

resilience.pec_mitigation​

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

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

resilience.pec​

Параметри пом'якшення похибок за допомогою імовірнісного скасування похибок.

Документація API resilience.pec

resilience.pec.max_overhead​

Варіанти: None, Ціле число >= 1

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

resilience.pec.noise_gain​

Варіанти: auto, float у діапазоні [0, 1]

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

resilience.zne_mitigation​

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

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

resilience.zne​

resilience.zne.amplifier​

Варіанти: gate_folding, gate_folding_front, gate_folding_back, pea

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

resilience.zne.extrapolated_noise_factors​

Варіанти: Список float

За замовчуванням: [0, *noise_factors]

resilience.zne.extrapolator​

Варіанти: Один або кілька з: exponential, linear, double_exponential, polynomial_degree_(1 <= k <= 7), fallback

За замовчуванням: (exponential, linear)

resilience.zne.noise_factors​

Варіанти: Список float; кожен float >= 1

За замовчуванням: (1, 1.5, 2) для PEA, і (1, 3, 5) в інших випадках

resilience_level​

Наскільки велику стійкість забезпечувати проти похибок. Вищі рівні дають точніші результати за рахунок довшого часу обробки.

Варіанти: 0, 1, 2

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

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

seed_estimator​

Варіанти: Ціле число

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

seed_estimator

simulator​

Параметри для передачі при симуляції бекенда

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

simulator.basis_gates​

Варіанти: Список назв базових вентилів для розгортання

За замовчуванням: Набір усіх базових вентилів, що підтримуються симулятором Qiskit Aer

simulator.coupling_map​

Варіанти: Список спрямованих двокубітних взаємодій

За замовчуванням: None, що означає відсутність обмежень зв'язності (повна зв'язність).

simulator.noise_model​

Варіанти: Qiskit Aer NoiseModel або його представлення

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

simulator.seed_simulator​

Варіанти: Ціле число

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

twirling​

Параметри твірлінгу

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

twirling.enable_gates​

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

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

twirling.enable_measure​

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

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

twirling.num_randomizations​

Варіанти: auto, Ціле число >= 1

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

twirling.shots_per_randomization​

Варіанти: auto, Ціле число >= 1

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

twirling.strategy​

Варіанти: active, active-circuit, active-accum, all

За замовчуванням: active-accum

experimental​

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

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

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

Несумісно з:

  • Gate-folding ZNE
  • PEA
  • PEC
  • Dynamical decoupling

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

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

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

Recommendations