ציון אפשרויות Executor

Package versions

הקוד בעמוד זה פותח באמצעות הדרישות הבאות. אנחנו ממליצים להשתמש בגרסאות אלה או חדשות יותר.

qiskit-ibm-runtime~=0.50.0

תוכלו להשתמש באפשרויות כדי להתאים אישית את ה-primitive Executor. בניגוד ל-Sampler ול-Estimator, ל-Executor יש מעט מאוד אפשרויות מכיוון שרוב כוונות העיצוב מקודדות ב-samplex.

הערות

• ניתן לראות את האפשרויות הזמינות ולעדכן ערכי אפשרויות במהלך אתחול ה-primitive או אחריו.

• השתמש במתודת update() כדי להחיל שינויים על מאפיין ה-options.

• • מאפיין ה-options הוא מסוג ה-Python dataclass. ניתן להשתמש במתודת ה-asdict המובנית כדי להמיר אותו למילון.

• Executor יכול לעבד רק מידע שמקודד ב-samplexes. עיין במדריכי Samplomatic כדי להבין את המגבלות.

הגדרת אפשרויות Executor

אם אפשרות מצוינת גם במהלך וגם לאחר אתחול ה-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

האם לאפס את ה-Qubits למצב היסוד לכל shot.

אפשרויות: True, False

ברירת מחדל: True

execution.rep_delay

העיכוב בין מדידה למעגל הקוונטי שאחריו.

ערכים אפשריים: ערך בטווח שמסופק על ידי backend.rep_delay_range

ברירת מחדל: נקבע לפי backend.default_rep_delay

execution.meas_type

אפשרויות: classified, kerneled, avg_kerneled

ברירת מחדל: classified

experimental

אפשרויות ניסיוניות, כשזמינות.

השלבים הבאים

המלצות

• עיין בתיעוד API של ExecutionOptionsV2.
• עיין בתיעוד API של EnvironmentOptions.