bluequbit 0.0.16b1

Python SDK to BlueQubit app

BlueQubit Python SDK

Usage

Interface with the BlueQubit server

Initialization

import bluequbit

# If you have run the line below once, subsequent initialization no longer
# requires explicit API token, i.e. bluequbit.init() without an argument is
# sufficient. This is because the token is automatically saved to
# ~/.config/bluequbit/config.json.
dq = bluequbit.init(<YOUR_API_TOKEN>)

Estimating how long it takes to simulate a circuit

import qiskit

import bluequbit

bq_client = bluequbit.init()

qc = qiskit.QuantumCircuit(2)
qc.h(0)
qc.x(1)

result = bq_client.estimate_job_runtime(qc)
print(result)
# Output
# {
#   'device': 'qsim_simulator',
#   'estimate_ms': 100,
#   'num_qubits': 2,
#   'qc': 'UUlTS0lUBQAVAgAAAAAAAAABcQAKaQAIAAAAAgAAAAAAAAAAAAAABAAAAAEAAAAAAAAAAmNpcmN1aXQtNzgAAAAAAAAAAG51bGxxAQAAAAIAAQFxAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAUAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAASEdhdGVxAAAAAAAFAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAFhHYXRlcQAAAAEAAA==',
#   'warning_message': 'This is just an estimate; the actual runtime may be less or more.'
# }

Submitting a simulation job and retrieving it

import bluequbit

bq_client = bluequbit.init()

bq_client.submit_job(qc)
result = bq_client.search_jobs()
print(result)
# Output
# {
#   'column_names': ['job_id', 'run_status', 'success', 'worker_runtime_ms', 'created_on'],
#   'data': [['4j2u9lb031YgfPpB', 'QUEUED', None, None, '2022-10-20T07:10:20.316Z']], 'total_count': 1
# }

Circuit serialization

You can decode a quantum circuit of Braket/Cirq/Qiskit to/from JSON string.

import bluequbit.circuit_serialization as circuit_serialization

# Example with Cirq circuit
encoded_cirq = circuit_serialization.encode_circuit(qc_cirq)
decoded_cirq = circuit_serialization.decode_circuit(encoded_cirq)