تحديد خيارات Executor

إصدارات الحزم

تم تطوير الكود في هذه الصفحة باستخدام المتطلبات التالية. نوصي باستخدام هذه الإصدارات أو أحدث.

qiskit-ibm-runtime~=0.50.0

يمكنك استخدام الخيارات لتخصيص الـ Executor primitive. على عكس الـ Sampler والـ Estimator، يمتلك الـ Executor عددًا قليلًا جدًا من الخيارات لأن معظم مقاصد التصميم مُشفَّرة في الـ samplex.

ملاحظات

• يمكنك رؤية الخيارات المتاحة وتحديث قيم الخيارات أثناء تهيئة الـ primitive أو بعدها.

• استخدم الطريقة update() لتطبيق التغييرات على خاصية options.

• خاصية options هي النوع dataclass في Python. يمكنك استخدام الطريقة المضمَّنة asdict لتحويلها إلى قاموس.

• يمكن لـ Executor معالجة المعلومات المُشفَّرة في samplexes فقط. راجع أدلة Samplomatic لفهم القيود.

ضبط خيارات Executor

إذا حُدِّد خيار أثناء تهيئة الـ primitive وبعدها، فإن القيمة المُضبَطة بعد تهيئة الـ primitive هي التي تُستخدَم.

تهيئة الـ Primitive

يمكنك تمرير مثيل من فئة الخيارات أو قاموس عند تهيئة Executor، والذي يُنشئ بعد ذلك نسخة من تلك الخيارات. وبذلك، تغيير القاموس الأصلي أو مثيل الخيارات لا يؤثر على الخيارات التي يمتلكها الـ primitive.

فئة الخيارات

عند إنشاء نسخة من فئة Executor، يمكنك تمرير نسخة من فئة الخيارات. تُطبَّق تلك الخيارات عند استخدام run() لإجراء الحساب. حدِّد الخيارات بهذا التنسيق: options.option.sub-option.sub-sub-option = choice. على سبيل المثال: options.environment.log_level = INFO.

مثال:

# Added by doQumentation — installs the packages this notebook needs if they are missing
import importlib.util

_needed = {"qiskit_ibm_runtime": "qiskit-ibm-runtime"}
_missing = [pip for module, pip in _needed.items()
            if importlib.util.find_spec(module) is None]
# One at a time, so a package that fails to install does not block the others
for _pip in _missing:
    %pip install -q {_pip}
if not _missing:
    print("\u2713 All required packages are installed")

from qiskit_ibm_runtime import QiskitRuntimeService, Executor
from qiskit_ibm_runtime.options_models 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

ما إذا كانت الكيوبتات تُعاد إلى الحالة الأرضية قبل كل لقطة (shot).

الخيارات: True, False

الافتراضي: True

execution.rep_delay

التأخير بين القياس والـ Circuit الكمية اللاحقة.

الخيارات: القيمة في النطاق المُقدَّم بواسطة backend.rep_delay_range

الافتراضي: مُعطَى بواسطة backend.default_rep_delay

execution.meas_type

الخيارات: classified, kerneled, avg_kerneled

الافتراضي: classified

experimental

الخيارات التجريبية، عند توفرها.

الخطوات التالية

توصيات

• راجع وثائق API لـ ExecutionOptionsV2.
• راجع وثائق API لـ EnvironmentOptions.