Organiser et rechercher par étiquettes de job

Package versions

Le code de cette page a été développé avec les dépendances suivantes. Nous recommandons d'utiliser ces versions ou des versions plus récentes.

qiskit[all]~=2.3.1
qiskit-ibm-runtime~=0.45.1

Ce guide explique comment ajouter et mettre à jour des étiquettes de job, ainsi que comment effectuer des recherches par étiquettes, afin que tu puisses mieux organiser, suivre et comprendre tes expériences.

Assigner des étiquettes

Tu peux assigner une ou plusieurs étiquettes à tes jobs lors de leur exécution afin de pouvoir les filtrer par étiquette ultérieurement. Tu peux par exemple utiliser les étiquettes de job pour étiqueter des réglages particuliers d'atténuation des erreurs, des paramètres de circuit, et ainsi de suite.

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

_needed = {"qiskit": "qiskit", "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, Sampler
from qiskit import QuantumCircuit
from qiskit.transpiler import generate_preset_pass_manager

service = QiskitRuntimeService()
backend = service.least_busy(simulator=False, operational=True)

qc = QuantumCircuit(2)
qc.h(0)
qc.cx(0, 1)
qc.measure_all()

sampler = Sampler(backend)

pm = generate_preset_pass_manager(backend=backend, optimization_level=1)
isa_circuit = pm.run(qc)

# Assign tags before executing
sampler.options.environment.job_tags = ["experiment-2025", "sampler-example"]

# Submit
job = sampler.run([isa_circuit])

print(service.job(job.job_id()).tags)

['experiment-2025', 'sampler-example']

Ajouter et mettre à jour des étiquettes

Tu peux ajouter des étiquettes après avoir soumis un job grâce à la méthode update_tags(). Cette méthode écrase les étiquettes actuelles, donc si tu as déjà assigné des étiquettes à un job et que tu souhaites en ajouter d'autres, assure-toi de réassigner les étiquettes d'origine.

# Add a new tag while keeping the previously assigned tags
job.update_tags(["experiment-2025", "sampler-example", "127-qubit"])

# Confirm updated tags
print(job.tags)

['sampler-example', '127-qubit', 'experiment-2025']

Récupérer des jobs par étiquette

Affiche une liste de jobs possédant certaines étiquettes de la façon suivante :

# List jobs with a specific tag or set of tags

service.jobs(job_tags=["experiment-2025", "sampler-example"])

[<RuntimeJobV2('d76cmj5bjrds73edf2og', 'sampler')>,
 <RuntimeJobV2('d6r5u84u243c73a11mug', 'sampler')>,
 <RuntimeJobV2('d6hugq2thhns7392lovg', 'sampler')>,
 <RuntimeJobV2('d68n7qtbujdc73d1b3vg', 'sampler')>,
 <RuntimeJobV2('d674nppv6o8c73d514fg', 'sampler')>,
 <RuntimeJobV2('d61mt5bc4tus73fcf3ng', 'sampler')>,
 <RuntimeJobV2('d61lhfqo8gvs73f15d30', 'sampler')>,
 <RuntimeJobV2('d5vftt1mvbjc73acdgpg', 'sampler')>,
 <RuntimeJobV2('d5k96nv853es738djj30', 'sampler')>,
 <RuntimeJobV2('d5b1s2rht8fs73a66r80', 'sampler')>]