- IBMBackend.run(circuits, dynamic=False, job_tags=None, init_circuit=None, init_num_resets=None, header=None, shots=None, memory=None, qubit_lo_freq=None, meas_lo_freq=None, schedule_los=None, meas_level=None, meas_return=None, rep_delay=None, init_qubits=None, use_measure_esp=None, noise_model=None, seed_simulator=None, **run_config)[source]¶
Run on the backend. If a keyword specified here is also present in the
optionsattribute/object, the value specified here will be used for this run.
Schedule]]]) – An individual or a list of
Scheduleobject to run on the backend.
bool) – Whether the circuit is dynamic (uses in-circuit conditionals)
str]]) – Tags to be assigned to the job. The tags can subsequently be used as a filter in the
QuantumCircuit]) – A quantum circuit to execute for initializing qubits before each circuit. If specified,
init_num_resetsis ignored. Applicable only if
int]) – The number of qubit resets to insert before each circuit execution.
or (The following parameters are applicable only if dynamic=False is specified) –
to. (defaulted) –
Dict]) – User input that will be attached to the job and will be copied to the corresponding result header. Headers do not affect the run. This replaces the old
None]) – Number of repetitions of each circuit, for sampling. Default: 4000 or
max_shotsfrom the backend configuration, whichever is smaller.
bool]) – If
True, per-shot measurement bitstrings are returned as well (provided the backend supports it). For OpenPulse jobs, only measurement level 2 supports this option.
int]]) – List of default qubit LO frequencies in Hz. Will be overridden by
int]]) – List of default measurement LO frequencies in Hz. Will be overridden by
None]) – Experiment LO configurations, frequencies are given in Hz.
None]) – Set the appropriate level of the measurement output for pulse experiments.
Level of measurement data for the backend to return.
meas_level0 and 1: *
singlereturns information from every shot. *
avgreturns average measurement output (averaged over number of shots).
float]) – Delay between programs in seconds. Only supported on certain backends (if
backend.configuration().dynamic_reprate_enabled=True). If supported,
rep_delaymust be from the range supplied by the backend (
backend.configuration().rep_delay_range). Default is given by
bool]) – Whether to reset the qubits to the ground state for each shot. Default:
bool]) – Whether to use excited state promoted (ESP) readout for measurements which are the terminal instruction to a qubit. ESP readout can offer higher fidelity than standard measurement sequences. See here. Default:
Trueif backend supports ESP readout, else
False. Backend support for ESP readout is determined by the flag
Any]) – Noise model. (Simulators only)
int]) – Random seed to control sampling. (Simulators only)
**run_config – Extra arguments used to configure the run.
- Return type:
The job to be executed.
IBMBackendApiError – If an unexpected error occurred while submitting the job.
IBMBackendApiProtocolError – If an unexpected value received from the server.
If an input parameter value is not valid. - If ESP readout is used and the backend does not support this.