org.soulspace.qclojure.adapter.backend.device — org.soulspace/qclojure-braket 0.3.0

Functions for managing and querying AWS Braket quantum devices, including QPUs and simulators.

braket-device clj

(braket-device braket-device)

braket-devices clj

(braket-devices backend)

Call AWS Braket API to list available devices

device clj

(device backend)

device-cost clj

(device-cost device-or-capabilities)

Extract device-cost pricing from a device's capabilities.

Reads the device-cost map from the capabilities service properties returned by the GetDevice API. The cost map contains :price and :unit (either "shot" for QPUs or "minute" for simulators).

Parameters:

• device-or-capabilities: Either a device map with :capabilities key, or a capabilities map directly

Returns: {:price <number>, :unit <string>} or nil if not available.

Examples: {:price 0.03, :unit "shot"} ;; IonQ Aria QPU {:price 0.075, :unit "minute"} ;; SV1 simulator

device-info clj

(device-info backend)

(device-info backend device-arn)

Get detailed device information from AWS Braket GetDevice API.

Fetches device details including capabilities with parsed device-cost data. The result includes the full capabilities map with service properties such as device-cost, execution-windows, and shots-range.

Parameters:

• backend: BraketBackend instance
• device-arn: (optional) Device ARN string; defaults to current device

Returns: Device info map with :capabilities key containing parsed JSON capabilities, or {:error ...} on failure.

device-list clj

device-properties clj

device-status clj

device-type clj

devices clj

(devices backend)

Fetch available devices from AWS Braket and update backend state.

Calls SearchDevices API and stores the device list in backend state.

Parameters:

• backend: BraketBackend instance

Returns: Collection of device maps.

fetch-device-cost clj

(fetch-device-cost backend device-arn)

Fetch device-cost pricing for a device ARN via the GetDevice API.

Calls device-info to get the full capabilities and extracts the device-cost. Returns nil on API errors.

Parameters:

• backend: BraketBackend instance
• device-arn: Device ARN string

Returns: {:price <number>, :unit <string>} or nil on failure.

parse-device-info clj

(parse-device-info device-arn)

Parse device information from AWS Braket device ARN

select-device clj

(select-device backend device)

Select a device for circuit execution on this backend.

When a device ARN string is provided, looks up the device from the cached device list. Fetches device capabilities via GetDevice API if not already present, caching the device-cost for pricing.

Parameters:

• backend: BraketBackend instance
• device: Device map or device ARN string

Returns: The selected device map (now stored in backend state as :current-device).