IonQ Class

  • Reference

IonQ target.

Inheritance
azure.quantum.target.target.Target
IonQ

Constructor

IonQ(workspace: Workspace, name: str = 'ionq.simulator', input_data_format: str = 'ionq.circuit.v1', output_data_format: str = 'ionq.quantum-results.v1', capability: str = 'BasicExecution', provider_id: str = 'IonQ', content_type: str = 'application/json', encoding: str = '', **kwargs)

Parameters

Name Description
workspace
Required
name
default value: ionq.simulator
input_data_format
default value: ionq.circuit.v1
output_data_format
default value: ionq.quantum-results.v1
capability
default value: BasicExecution
provider_id
default value: IonQ
content_type
default value: application/json
encoding

Methods

estimate_cost

Estimate the cost of submitting a circuit to IonQ targets. Optionally, you can provide the number of gate and measurement operations manually. The actual price charged by the provider may differ from this calculation.

Specify pricing details for your area to get most accurate results. By default, this function charges depending on the target:

ionq.qpu: price_1q = 0.00003 USD for a single-qubit gate. price_2q = 0.0003 USD for a two-qubit gate. min_price = 1 USD, total minimum price per circuit.

ionq.qpu.aria-1: price_1q = 0.00022 USD for a single-qubit gate. price_2q = 0.00098 USD for a two-qubit gate. min_price = 1 USD, total minimum price per circuit.

For the most current pricing details, see https://docs.microsoft.com/azure/quantum/provider-ionq#pricing or find your workspace and view pricing options in the "Provider" tab of your workspace: https://aka.ms/aq/myworkspaces
submit

Submit an IonQ circuit (JSON format)

estimate_cost

Estimate the cost of submitting a circuit to IonQ targets. Optionally, you can provide the number of gate and measurement operations manually. The actual price charged by the provider may differ from this calculation.

Specify pricing details for your area to get most accurate results. By default, this function charges depending on the target:

ionq.qpu: price_1q = 0.00003 USD for a single-qubit gate. price_2q = 0.0003 USD for a two-qubit gate. min_price = 1 USD, total minimum price per circuit.

ionq.qpu.aria-1: price_1q = 0.00022 USD for a single-qubit gate. price_2q = 0.00098 USD for a two-qubit gate. min_price = 1 USD, total minimum price per circuit.

For the most current pricing details, see https://docs.microsoft.com/azure/quantum/provider-ionq#pricing or find your workspace and view pricing options in the "Provider" tab of your workspace: https://aka.ms/aq/myworkspaces

estimate_cost(circuit: Dict[str, Any], num_shots: int = None, price_1q: float = None, price_2q: float = None, min_price: float = None, shots: int = None) -> CostEstimate

Parameters

Name Description
circuit
Required
Dict[str, Any]

Quantum circuit in IonQ JSON format (for examples, see: https://docs.ionq.com/#section/Sample-JSON-Circuits)
num_shots
int

Number of shots, defaults to None

default value: None
price_1q
float

The price of running a single-qubit gate for one shot.

default value: None
price_2q
float

The price of running a double-qubit gate for one shot.

default value: None
min_price
float

The minimum price for running a job.

default value: None
shots
int

Number of shots, defaults to None

default value: None

submit

Submit an IonQ circuit (JSON format)

submit(circuit: Dict[str, Any] = None, name: str = 'ionq-job', shots: int = None, input_params: Dict[str, Any] = None, **kwargs) -> Job

Parameters

Name Description
circuit
Dict[str, Any]

Quantum circuit in IonQ JSON format (for examples, see: https://docs.ionq.com/#section/Sample-JSON-Circuits)

default value: None
name
str

Job name

default value: ionq-job
shots
int

Number of shots, defaults to None

default value: None
input_params
Dict[str, Any]

Optional input params dict

default value: None

Returns

Type Description
Job

Azure Quantum job

Attributes

target_names

Tuple of target names.

target_names = ('ionq.qpu', 'ionq.simulator', 'ionq.qpu.aria-1', 'ionq.qpu.aria-2', 'ionq.qpu.forte-1')