No project description provided
Project description
Quantum Serverless client
Installation
pip install quantum_serverless
Documentation
Full docs can be found at https://qiskit-extensions.github.io/quantum-serverless/
Usage
Step 1: write program
from quantum_serverless import distribute_task, get, get_arguments, save_result
from qiskit import QuantumCircuit
from qiskit.circuit.random import random_circuit
from qiskit.primitives import Sampler
from qiskit.quantum_info import SparsePauliOp
# 1. let's annotate out function to convert it
# to distributed async function
# using `distribute_task` decorator
@distribute_task()
def distributed_sample(circuit: QuantumCircuit):
"""Calculates quasi dists as a distributed function."""
return Sampler().run(circuit).result().quasi_dists[0]
# 2. our program will have one arguments
# `circuits` which will store list of circuits
# we want to sample in parallel.
# Let's use `get_arguments` funciton
# to access all program arguments
arguments = get_arguments()
circuits = arguments.get("circuits", [])
# 3. run our functions in a loop
# and get execution references back
function_references = [
distributed_sample(circuit)
for circuit in circuits
]
# 4. `get` function will collect all
# results from distributed functions
collected_results = get(function_references)
# 5. `save_result` will save results of program execution
# so we can access it later
save_result({
"quasi_dists": collected_results
})
Step 2: run program
from quantum_serverless import QuantumServerless, GatewayProvider
from qiskit.circuit.random import random_circuit
serverless = QuantumServerless(GatewayProvider(
username="<USERNAME>",
password="<PASSWORD>",
host="<GATEWAY_ADDRESS>",
))
# create program
program = Program(
title="Quickstart",
entrypoint="program.py",
working_dir="./src"
)
# create inputs to our program
circuits = []
for _ in range(3):
circuit = random_circuit(3, 2)
circuit.measure_all()
circuits.append(circuit)
# run program
job = serverless.run(
program=program,
arguments={
"circuits": circuits
}
)
Step 3: monitor job status
job.status()
# <JobStatus.SUCCEEDED: 'SUCCEEDED'>
# or get logs
job.logs()
Step 4: get results
job.result()
# {"quasi_dists": [
# {"0": 0.25, "1": 0.25, "2": 0.2499999999999999, "3": 0.2499999999999999},
# {"0": 0.1512273969460124, "1": 0.0400459556274728, "6": 0.1693190975212014, "7": 0.6394075499053132},
# {"0": 0.25, "1": 0.25, "4": 0.2499999999999999, "5": 0.2499999999999999}
# ]}
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
quantum_serverless-0.2.0.tar.gz
(31.9 kB
view details)
Built Distribution
File details
Details for the file quantum_serverless-0.2.0.tar.gz.
File metadata
- Download URL: quantum_serverless-0.2.0.tar.gz
- Upload date:
- Size: 31.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.17
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | adc1b25d86063b14c70ccdc4b22eee54ff636c7ea2d5744814d18ed8bb7d59e6 |
|
| MD5 | 32ad67a53c9ae2ad460b7e5751630125 |
|
| BLAKE2b-256 | 576e8eed5a2aa48ad2d0ead78acdbaf452c32571344f1fd777004a3caad20d8c |
File details
Details for the file quantum_serverless-0.2.0-py3-none-any.whl.
File metadata
- Download URL: quantum_serverless-0.2.0-py3-none-any.whl
- Upload date:
- Size: 48.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.9.17
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 1d645ce74c34907f81a68d7b20e14df2fedc696f1290abe6900c78e119d1037e |
|
| MD5 | 125e7833f4ea8f77c332a90b11e2f755 |
|
| BLAKE2b-256 | e2918fd953341f2ea680b09c08f00b0de2a7f30b8c4b89b579b8bab24e9e7668 |
