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

Package versions

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

qiskit-ibm-runtime~=0.46.1

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

הערות

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

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

• • מאפיין ה-options הוא מסוג ה-Python dataclass. ניתן להשתמש במתודת ה-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 — 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)

מילון

ניתן לציין אפשרויות כמילון בעת אתחול 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.