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.

Parâmetros

• 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.

Parâmetros

• 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.

Tipo de retorno

None

error_messages()

Provide details about job failures.

This call will block until all jobs finish.

Tipo de retorno

Optional[str]

Retorna

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).

Parâmetros

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.

Tipo de retorno

Tuple[Optional[IBMQJob], int]

Retorna

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

Levanta

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

job_set_id()

Return the ID of this job set.

Tipo de retorno

str

Retorna

ID of this job set.

jobs()

Return jobs in this job set.

Tipo de retorno

List[Optional[IBMQJob]]

Retorna

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.

Tipo de retorno

List[ManagedJob]

Retorna

A list of managed jobs.

name()

Return the name of this job set.

Tipo de retorno

str

Retorna

Name of this job set.

qobjs()

Return the Qobjs for the jobs in this set.

Tipo de retorno

List[Union[QasmQobj, PulseQobj]]

Retorna

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.

Parâmetros

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

Tipo de retorno

str

Retorna

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.

Nota

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.

Nota

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!")

Parâmetros

• 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.

Tipo de retorno

ManagedResults

Retorna

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

Levanta

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

retrieve_jobs(provider, refresh=False)

Retrieve previously submitted jobs in this set.

Parâmetros

• 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.

Levanta

• IBMQJobManagerUnknownJobSet – If the job set cannot be found.

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

Tipo de retorno

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.

Parâmetros

• 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.

Levanta

IBMQJobManagerInvalidStateError – If the jobs were already submitted.

Tipo de retorno

None

statuses()

Return the status of each job in this set.

Tipo de retorno

List[Optional[JobStatus]]

Retorna

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.

Tipo de retorno

List[str]

Retorna

Tags assigned to this job set.

update_name(name)

Update the name of this job set.

Parâmetros

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

Tipo de retorno

str

Retorna

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.

Nota

• 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.

Parâmetros

• 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.

Tipo de retorno

List[str]

Retorna

The new tags associated with this job set.

Levanta

IBMQJobManagerInvalidStateError – If none of the input parameters are specified.