AQTResource#

class qiskit_aqt_provider.aqt_resource.AQTResource[source]#

Bases: BackendV2

Qiskit backend for AQT quantum computing resources.

__init__(provider: AQTProvider, resource_id: ResourceId)[source]#

Initialize the backend.

Parameters:

  • provider – Qiskit provider that owns this backend.

  • resource_id – description of resource to target.

property max_circuits: int#

The maximum number of circuits (or Pulse schedules) that can be run in a single job.

If there is no limit this will return None

property options: AQTOptions#

Return the options for the backend

The options of a backend are the dynamic parameters defining how the backend is used. These are used to control the run() method.

result(job_id: UUID) → JobResponseRRQueued | JobResponseRROngoing | JobResponseRRFinished | JobResponseRRError | JobResponseRRCancelled[source]#

Query the result for a specific job.

Tip

This is a low-level method. Use the AQTJob.result method to retrieve the result of a job described by a AQTJob handle.

Parameters:

job_id – The unique identifier for the target job.

Returns:

AQT API payload with the job results.

run(circuits: QuantumCircuit | List[QuantumCircuit], **options: Any) → AQTJob[source]#

Submit circuits for execution on this resource.

Parameters:

  • circuits – circuits to execute

  • options – overrides for this resource’s options. Elements should be valid fields of the AQTOptions model. Unknown fields are ignored with a UnknownOptionWarning.

Returns:

A handle to the submitted job.

submit(job: AQTJob) → UUID[source]#

Submit a quantum circuits job to the AQT resource.

Tip

This is a low-level method. Use the run() method to submit a job and retrieve a AQTJob handle.

Parameters:

job – the quantum circuits job to submit to the resource for execution.

Returns:

The unique identifier of the submitted job.

property target: Target#

A qiskit.transpiler.Target object for the backend.

Return type:

Target

class qiskit_aqt_provider.aqt_resource.OfflineSimulatorResource[source]#

Bases: AQTResource

AQT-compatible offline simulator resource.

Offline simulators expose the same interface and restrictions as hardware backends. If with_noise_model is true, a noise model approximating that of AQT hardware backends is used.

Tip

The simulator backend is provided by Qiskit Aer. The Qiskit Aer resource is exposed for detailed detuning as the OfflineSimulatorResource.simulator attribute.

__init__(provider: AQTProvider, resource_id: ResourceId, with_noise_model: bool) → None[source]#

Initialize an offline simulator resource.

Parameters:

  • provider – Qiskit provider that owns this backend.

  • resource_id – identification of the offline simulator resource.

  • with_noise_model – whether to configure a noise model in the simulator backend.

result(job_id: UUID) → JobResponseRRQueued | JobResponseRROngoing | JobResponseRRFinished | JobResponseRRError | JobResponseRRCancelled[source]#

Query results for a simulator job.

Tip

This is a low-level method. Use AQTJob.result() instead.

Parameters:

job_id – identifier of the job to retrieve results for.

Returns:

AQT API payload with the job results.

Raises:

UnknownJobError – job_id doesn’t correspond to a simulator job on this resource.

submit(job: AQTJob) → UUID[source]#

Submit a job for execution on the simulator.

Tip

This is a low-level method. Use the AQTResource.run() method to submit a job and retrieve a AQTJob handle.

Parameters:

job – quantum circuits job to submit to the simulator.

Returns:

Unique identifier of the simulator job.

property with_noise_model: bool#

Whether the simulator includes a noise model.

pydantic model qiskit_aqt_provider.api_models.ResourceId[source]#

Bases: BaseModel

Resource identification and metadata.

field workspace_id: str [Required]#

Workspace containing the resource.

field resource_id: str [Required]#

Unique identifier of the resource in the containing workspace.

field resource_name: str [Required]#

Pretty display name for the resource.

field resource_type: Literal['device', 'simulator', 'offline_simulator'] [Required]#

Resource type, also includes offline simulators.

class qiskit_aqt_provider.aqt_resource.UnknownOptionWarning[source]#

Bases: UserWarning

An unknown option was passed to a backend’s run method.

class qiskit_aqt_provider.api_models.UnknownJobError[source]#

Bases: JobError

An unknown job was requested from the AQT cloud portal.