execute

fireopal.execute(circuits, shot_count, credentials, backend_name, parameters=None, run_options=None)

Submit quantum circuits for execution on a backend.

Runs one or more circuits through Fire Opal’s full error-suppression pipeline and returns immediately with a job handle. Use this function whenever you want to execute circuits on real hardware.

Parameters

• circuits (str or list [ str ]) – Quantum circuit(s) as QASM 2.0 or 3.0 strings. A single string is treated as a batch of one circuit. Convert Qiskit QuantumCircuit objects using qiskit.qasm2.dumps or qiskit.qasm3.dumps.
• shot_count (int) – Number of measurements (shots) to take per circuit.
• credentials (Credentials) – Credentials for the target hardware provider, created using the appropriate helper from the fireopal.credentials module. For example, use make_credentials_for_ibm_cloud() for IBM backends.
• backend_name (str) – Name of the target backend device (for example, "ibm_boston"). Call show_supported_devices() to list available names for your credentials.
• parameters (dict [ str , float ] or list [ dict [ str , float ] ] or None , optional) – Parameter bindings for parametric circuits. Provide a single dict to apply the same bindings to every circuit, or a list with one dict per circuit. Defaults to None.
• run_options (RunOptions or None , optional) – Provider-specific execution options, for example, IbmRunOptions). See the fireopal.run_options module for available classes. Defaults to None.

Returns

FireOpalJob – A job object whose result() method returns a dictionary containing:

results (list[str]) : Validation errors. If empty, the circuits can be submitted for execution.

warnings (list[str]) : Warnings about the circuits that do not prevent execution, but may impact performance. For example, a warning will be issued if a circuit’s duration is approaching the requested backend’s T1 limit.