Skip to content

Execution on IonQ Quantum Cloud

The Classiq executor supports execution on IonQ hardware and simulator.

Usage

Execution on IonQ requires a valid IonQ API key.

IonQ Backend Preferences configuration options are summarized below; see IonQ hardware noise simulation (emulate) for the emulate flag.

  • Error mitigation: bool — valid for IonQ hardware; defaults to False.
from classiq import IonqBackendPreferences

preferences = IonqBackendPreferences(
    backend_name="qpu.forte-1",
    api_key="A Valid IonQ API key",
    error_mitigation=True,
    emulate=False,
)

Opening info tab

IonQ hardware noise simulation (emulate)

Set emulate=True on IonqBackendPreferences to run on the IonQ cloud simulator while applying a hardware noise profile derived from your QPU backend name (for example qpu.forte-1 → noise model forte-1). Classiq resolves the simulator backend and passes the appropriate run options to the IonQ provider.

Requirements

  • backend_name must be a QPU id (prefix qpu., e.g. qpu.aria-2, qpu.forte-1). If emulate=True with a non-QPU backend name, preferences validation fails.

Usage

from classiq import IonqBackendPreferences

preferences = IonqBackendPreferences(
    backend_name="qpu.forte-1",
    api_key="…",
    error_mitigation=False,
    emulate=True,
)

Supported Backends

Included hardware:

  • "qpu.aria-2"
  • "qpu.forte-1"
  • "qpu.forte-enterprise-1"
  • "qpu.forte-enterprise-2"

Included simulators:

  • "simulator"