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.

SDK (IonqBackendPreferences)
IDE

from classiq import IonqBackendPreferences

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

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”

Execution on Intel Backends CUDA-Q Integration

⌘I

​Usage

​IonQ hardware noise simulation (emulate)

​Supported Backends

Usage

IonQ hardware noise simulation (emulate)

Supported Backends