qiskit.providers.ibmq.managed.ManagedJobSet

class ManagedJobSet(name=None, short_id=None)

A set of managed jobs.

An instance of this class is returned when you submit experiments using IBMQJobManager.run(). It provides methods that allow you to interact with the jobs as a single entity. For example, you can retrieve the results for all of the jobs using results() and cancel all jobs using cancel().

ManagedJobSet constructor.

パラメータ

• name (Optional[str]) – Name for this set of jobs. If not specified, the current date and time is used.

• short_id (Optional[str]) – Short ID for this set of jobs.

__init__(name=None, short_id=None)

ManagedJobSet constructor.

パラメータ

• name (Optional[str]) – Name for this set of jobs. If not specified, the current date and time is used.

• short_id (Optional[str]) – Short ID for this set of jobs.

Methods

__init__([name, short_id])	ManagedJobSet constructor.
cancel()	Cancel all jobs in this job set.
error_messages()	Provide details about job failures.
job(experiment)	Retrieve the job used to submit the specified experiment and its index.
job_set_id()	Return the ID of this job set.
jobs()	Return jobs in this job set.
managed_jobs()	Return the managed jobs in this set.
name()	Return the name of this job set.
qobjs()	Return the Qobjs for the jobs in this set.
report([detailed])	Return a report on current job statuses.
results([timeout, partial, refresh])	Return the results of the jobs.
retrieve_jobs(provider[, refresh])	Retrieve previously submitted jobs in this set.
run(experiment_list, backend, executor, …)	Execute a list of circuits or pulse schedules on a backend.
statuses()	Return the status of each job in this set.
tags()	Return the tags assigned to this job set.
update_name(name)	Update the name of this job set.
update_tags([replacement_tags, …])	Update the tags assigned to this job set.

cancel()

Cancel all jobs in this job set.

戻り値の型

None

error_messages()

Provide details about job failures.

This call will block until all jobs finish.

戻り値の型

Optional[str]

戻り値

An error report if one or more jobs failed or None otherwise.

job(experiment)

Retrieve the job used to submit the specified experiment and its index.

For example, if IBMQJobManager is used to submit 1000 experiments, and IBMQJobManager divides them into 2 jobs: job 1 has experiments 0-499, and job 2 has experiments 500-999. In this case job_set.job(501) will return (job2, 1).

パラメータ

experiment (Union[str, QuantumCircuit, Schedule, int]) –

Retrieve the job used to submit this experiment. Several types are accepted for convenience:

• str: The name of the experiment.

• QuantumCircuit: The name of the circuit instance will be used.

• Schedule: The name of the schedule instance will be used.

• int: The position of the experiment.

戻り値の型

Tuple[Optional[IBMQJob], int]

戻り値

A tuple of the job used to submit the experiment, or None if the job submit failed, and the experiment index.

例外

IBMQJobManagerJobNotFound – If the job for the experiment could not be found.

job_set_id()

Return the ID of this job set.

戻り値の型

str

戻り値

ID of this job set.

jobs()

Return jobs in this job set.

戻り値の型

List[Optional[IBMQJob]]

戻り値

A list of IBMQJob instances that represents the submitted jobs. An entry in the list is None if the job failed to be submitted.

managed_jobs()

Return the managed jobs in this set.

戻り値の型

List[ManagedJob]

戻り値

A list of managed jobs.

name()

Return the name of this job set.

戻り値の型

str

戻り値

Name of this job set.

qobjs()

Return the Qobjs for the jobs in this set.

戻り値の型

List[Union[QasmQobj, PulseQobj]]

戻り値

A list of Qobjs for the jobs. An entry in the list is None if the Qobj could not be retrieved.

report(detailed=True)

Return a report on current job statuses.

パラメータ

detailed (bool) – If True, return a detailed report. Otherwise return a summary report.

戻り値の型

str

戻り値

A report on job statuses.

results(timeout=None, partial=False, refresh=False)

Return the results of the jobs.

This call will block until all job results become available or the timeout is reached.

注釈

Some IBM Quantum Experience job results can only be read once. A second attempt to query the server for the same job will fail, since the job has already been 「consumed」.

The first call to this method in a ManagedJobSet instance will query the server and consume any available job results. Subsequent calls to that instance’s method will also return the results, since they are cached. However, attempting to retrieve the results again in another instance or session might fail due to the job results having been consumed.

注釈

When partial=True, this method will attempt to retrieve partial results of failed jobs. In this case, precaution should be taken when accessing individual experiments, as doing so might cause an exception. The success attribute of the returned ManagedResults instance can be used to verify whether it contains partial results.

For example, if one of the experiments failed, trying to get the counts of the unsuccessful experiment would raise an exception since there are no counts to return:

try:
    counts = managed_results.get_counts("failed_experiment")
except QiskitError:
    print("Experiment failed!")

パラメータ

• timeout (Optional[float]) – Number of seconds to wait for job results.

• partial (bool) – If True, attempt to retrieve partial job results.

• refresh (bool) – If True, re-query the server for the result. Otherwise return the cached value.

戻り値の型

ManagedResults

戻り値

A ManagedResults instance that can be used to retrieve results for individual experiments.

例外

IBMQJobManagerTimeoutError – if unable to retrieve all job results before the specified timeout.

retrieve_jobs(provider, refresh=False)

Retrieve previously submitted jobs in this set.

パラメータ

• provider (AccountProvider) – Provider used for this job set.

• refresh (bool) – If True, re-query the server for the job set. Otherwise return the cached value.

例外

• IBMQJobManagerUnknownJobSet – If the job set cannot be found.

• IBMQJobManagerInvalidStateError – If jobs for this job set are found but have unexpected attributes.

戻り値の型

None

run(experiment_list, backend, executor, job_share_level, job_tags=None, **assemble_config)

Execute a list of circuits or pulse schedules on a backend.

パラメータ

• experiment_list (Union[List[List[QuantumCircuit]], List[List[Schedule]]]) – Circuit(s) or pulse schedule(s) to execute.

• backend (IBMQBackend) – Backend to execute the experiments on.

• executor (ThreadPoolExecutor) – The thread pool used to submit jobs asynchronously.

• job_share_level (ApiJobShareLevel) – Job share level.

• job_tags (Optional[List[str]]) – Tags to be assigned to the job.

• assemble_config (Any) – Additional arguments used to configure the Qobj assembly. Refer to the qiskit.compiler.assemble() documentation for details on these arguments.

例外

IBMQJobManagerInvalidStateError – If the jobs were already submitted.

戻り値の型

None

statuses()

Return the status of each job in this set.

戻り値の型

List[Optional[JobStatus]]

戻り値

A list of job statuses. An entry in the list is None if the job status could not be retrieved due to a server error.

tags()

Return the tags assigned to this job set.

戻り値の型

List[str]

戻り値

Tags assigned to this job set.

update_name(name)

Update the name of this job set.

パラメータ

name (str) – The new name for this job set.

戻り値の型

str

戻り値

The new name associated with this job set.

update_tags(replacement_tags=None, additional_tags=None, removal_tags=None)

Update the tags assigned to this job set.

When multiple parameters are specified, the parameters are processed in the following order:

1. replacement_tags

2. additional_tags

3. removal_tags

For example, if 『new_tag』 is specified for both additional_tags and removal_tags, then it is added and subsequently removed from the tags list, making it a 「do nothing」 operation.

注釈

• Some tags, such as those starting with ibmq_jobset, are used internally by ibmq-provider and therefore cannot be modified.

• When removing tags, if the job does not have a specified tag, it will be ignored.

パラメータ

• replacement_tags (Optional[List[str]]) – The tags that should replace the current tags associated with this job set.

• additional_tags (Optional[List[str]]) – The new tags that should be added to the current tags associated with this job set.

• removal_tags (Optional[List[str]]) – The tags that should be removed from the current tags associated with this job set.

戻り値の型

List[str]

戻り値

The new tags associated with this job set.

例外

IBMQJobManagerInvalidStateError – If none of the input parameters are specified.