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. Tidak seperti Sampler dan Estimator, Executor mempunyai sangat sedikit pilihan kerana majoriti niat reka bentuk dikodkan dalam samplex.

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.

• Executor hanya boleh memproses maklumat yang dikodkan dalam samplex. Rujuk panduan Samplomatic untuk memahami sekatan.

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.

Langkah seterusnya

Cadangan

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