Qiskit Tools

qiskit.tools.parallel_map(task, values, task_args=(), task_kwargs={}, num_processes=2)

Parallel execution of a mapping of values to the function task. This is functionally equivalent to:

result = [task(value, *task_args, **task_kwargs) for value in values]

On Windows this function defaults to a serial implementation to avoid the overhead from spawning processes in Windows.

Parameters

• task (func) – Function that is to be called for each value in values.
• values (array_like) – List or array of values for which the task function is to be evaluated.
• task_args (list(opens in a new tab)) – Optional additional arguments to the task function.
• task_kwargs (dict(opens in a new tab)) – Optional additional keyword argument to the task function.
• num_processes (int(opens in a new tab)) – Number of processes to spawn.

Returns

The result list contains the value of

task(value, *task_args, **task_kwargs) for

each value in values.

Return type

result

Raises

QiskitError – If user interrupts via keyboard.

Events:

terra.parallel.start: The collection of parallel tasks are about to start. terra.parallel.update: One of the parallel task has finished. terra.parallel.finish: All the parallel tasks have finished.

Examples

import time
from qiskit.tools.parallel import parallel_map
def func(_):
        time.sleep(0.1)
        return 0
parallel_map(func, list(range(10)));

qiskit.tools.job_monitor(job, interval=None, quiet=False, output=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='utf-8'>, line_discipline='\r')

Monitor the status of a IBMQJob instance.

Parameters

• job (BaseJob) – Job to monitor.
• interval (int(opens in a new tab)) – Time interval between status queries.
• quiet (bool(opens in a new tab)) – If True, do not print status messages.
• output (file) – The file like object to write status messages to.
• sys.stdout. (By default this is) –
• line_discipline (string) – character emitted at start of a line of job monitor output,
• r. (This defaults to) –

Examples

from qiskit import BasicAer, transpile
from qiskit.circuit import QuantumCircuit
from qiskit.tools.monitor import job_monitor
sim_backend = BasicAer.get_backend("qasm_simulator")
qc = QuantumCircuit(2, 2)
qc.h(0)
qc.cx(0, 1)
qc.measure_all()
tqc = transpile(qc, sim_backend)
job_sim = sim_backend.run(tqc)
job_monitor(job_sim)

qiskit.tools.backend_monitor(backend)

Monitor a single IBMQ backend.

Parameters

backend (IBMQBackend) – Backend to monitor.

Raises

• QiskitError – Input is not a IBMQ backend.
• MissingOptionalLibraryError – If qiskit-ibmq-provider is not installed

Examples: .. code-block:: python

from qiskit.providers.ibmq import IBMQ from qiskit.tools.monitor import backend_monitor provider = IBMQ.get_provider(hub=’ibm-q’) backend_monitor(provider.backends.ibmq_lima)

qiskit.tools.backend_overview()

Gives overview information on all the IBMQ backends that are available.

Examples

from qiskit.providers.ibmq import IBMQ
from qiskit.tools.monitor import backend_overview
provider = IBMQ.get_provider(hub='ibm-q')
backend_overview()