Execute Qiskit Circuits using the PlanQK Quantum SDK

This tutorial describes how you can use the PlanQK Quantum SDK to execute your Qiskit code on different quantum backends supported by PlanQK. The SDK is a wrapper for Qiskit 1.0. Hence, it provides the same functionality and syntax as the original Qiskit SDK.

You can use the SDK either directly from your favorite IDE or in a PlanQK service.

Install the PlanQK Quantum SDK

To install the PlanQK Quantum SDK you need to have Python 3.8 or higher installed. The package is released on PyPI and can be installed via pip:

pip install planqk-quantum

Create an Access Token

To access the quantum backends from your Qiskit code you need to have a valid PlanQK account and a quantum access token. This token is used to authenticate your requests to the PlanQK platform and to track the usage costs of your quantum executions.

Login at platform.planqk.de (opens new window), go to Settings and create a new Personal Access Token with the scopes api and quantum_tokens. Copy your new token and store it in a safe place.

Backend Selection and Execution

In your Qiskit code you can access the PlanQK quantum backends through the PlanqkQuantumProvider object. You need to import this object and pass your access token to it, as shown in the example below.

from planqk.qiskit import PlanqkQuantumProvider

# set your PlanQK access token
planqk_token = "YOUR_ACCESS_TOKEN"
provider = PlanqkQuantumProvider(access_token=planqk_token)

NOTE

If your Qiskit code is executed in a PlanQK service, the access token is automatically set by the platform. In this case the access_token parameter can be omitted. If it is set it is replaced by the service token.

After you have created the provider object you can list all backends supported by the PlanQK platform and select the one you want to use, e.g., the azure.ionq.simulator backend:

# list all available PlanQK quantum backends
backends = planqk_provider.backends()

# select certain backend
backend = provider.get_backend(name="azure.ionq.simulator")

Now you can execute your Qiskit circuit on the selected backend, retrieve its job object, retrieve its results, cancel it etc.

from qiskit.circuit import QuantumCircuit, transpile

# create a qiskit circuit
circuit = QuantumCircuit(3, 3)
circuit.h(0)
circuit.cx(0, 1)
circuit.cx(1, 2)
circuit.measure(range(3), range(3))

# transpile circuit for backend
circuit = transpile(circuit, backend)

# execute circuit on selected backend
job = backend.run(circuit, shots=1000)

NOTE

Executing your Qiskit code on the PlanQK platform may lead to execution costs depending on selected backend and number of shots. Please find an overview about the costs for each backend on our pricing page (opens new window).