Tentukan pilihan Executor

Versi pakej

Kod di halaman ini dibangunkan menggunakan keperluan berikut. Kami syorkan menggunakan versi ini atau yang lebih baru.

qiskit-ibm-runtime~=0.46.1

Anda boleh menggunakan pilihan untuk menyesuaikan primitif Executor.

Nota

• Anda boleh melihat pilihan yang tersedia dan mengemaskini nilai pilihan semasa atau selepas permulaan primitif.
• Gunakan kaedah update() untuk menerapkan perubahan kepada atribut options.
• Atribut options adalah jenis Python dataclass. Anda boleh menggunakan kaedah asdict terbina dalam untuk menukarnya kepada kamus.

Tetapkan pilihan Executor

Jika pilihan ditentukan semasa dan selepas permulaan primitif, nilai yang ditetapkan selepas memulakan primitif digunakan.

Permulaan primitif

Anda boleh menghantar instans kelas pilihan atau kamus apabila memulakan Executor, yang kemudian membuat salinan pilihan tersebut. Oleh itu, menukar kamus asal atau instans pilihan tidak mempengaruhi pilihan yang dimiliki oleh primitif.

Kelas pilihan

Apabila mencipta instans kelas Executor, anda boleh menghantar instans kelas pilihan. Pilihan-pilihan tersebut kemudian diterapkan apabila anda menggunakan run() untuk melakukan pengiraan. Tentukan pilihan dalam format ini: options.option.sub-option.sub-sub-option = choice. Sebagai contoh: options.environment.log_level = INFO.

Contoh:

# 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)

Kamus

Anda boleh menentukan pilihan sebagai kamus apabila memulakan 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},
    },
)

Pilihan yang tersedia

Jadual berikut mendokumentasikan pilihan dari versi terbaru qiskit-ibm-runtime. Untuk melihat versi pilihan yang lebih lama, layari rujukan API qiskit-ibm-runtime dan pilih versi sebelumnya.

environment

Dokumentasi API environment

environment.job_tags

Senarai tag.

Pilihan: None

Lalai: None

environment.log_level

Pilihan: DEBUG, INFO, WARNING, ERROR, CRITICAL

Lalai: WARNING

environment.private

Pilihan: True, False

Lalai: False

environment.max_execution_time

Pilihan: Nombor integer saat dalam julat [1, 10800]

Lalai: 10800 (3 jam)

execution

Dokumentasi API execution

execution.init_qubits

Sama ada untuk menetapkan semula qubit ke keadaan asas untuk setiap tembakan.

Pilihan: True, False

Lalai: True

execution.rep_delay

Kelewatan antara ukuran dan litar kuantum berikutnya.

Pilihan: Nilai dalam julat yang disediakan oleh backend.rep_delay_range

Lalai: Diberikan oleh backend.default_rep_delay

execution.meas_type

Pilihan: classified, kerneled, avg_kerneled

Lalai: classified

experimental

Pilihan eksperimen, apabila tersedia.

Keserasian ciri

Ciri runtime tertentu tidak boleh digunakan bersama dalam satu kerja. Klik tab yang sesuai untuk senarai ciri yang tidak serasi dengan ciri yang dipilih:

Litar dinamik

Tidak serasi dengan:

• ZNE lipatan get
• PEA
• PEC
• Dynamical decoupling

Nota lain:

• Twirling get boleh diterapkan pada litar dinamik, tetapi hanya pada get yang tidak berada di dalam blok bersyarat.
• Twirling ukuran hanya boleh diterapkan pada ukuran terminal.
• Twirling ukuran tidak serasi dengan arahan store.
• Serasi dengan get pecahan apabila menggunakan qiskit-ibm-runtime v0.42.0 atau lebih baru.

Dynamical decoupling

Tidak serasi dengan litar dinamik.

Get pecahan

Tidak serasi dengan:

• Twirling get
• PEA
• PEC

Serasi dengan litar dinamik apabila menggunakan qiskit-ibm-runtime v0.42.0 atau lebih baru.

ZNE lipatan get

Tidak serasi dengan:

• Litar dinamik
• PEA
• PEC

Mungkin tidak berfungsi apabila menggunakan get tersuai.

Twirling get

Tidak serasi dengan get pecahan atau dengan regangan.

Nota lain:

• Twirling get boleh diterapkan pada litar dinamik, tetapi hanya pada get yang tidak berada di dalam blok bersyarat. Twirling ukuran hanya boleh diterapkan pada ukuran terminal.
• Tidak berfungsi dengan penjalin bukan-Clifford.

PEA

Tidak serasi dengan:

• Litar dinamik
• Get pecahan
• ZNE lipatan get
• PEC

PEC

Tidak serasi dengan:

• Litar dinamik
• Get pecahan
• ZNE lipatan get
• PEA

Langkah seterusnya

Cadangan

• Semak dokumentasi API ExecutionOptionsV2.
• Semak dokumentasi API EnvironmentOptions.