Qubit Toaster backend for Qiskit: run Qiskit code on Quantastica "Qubit Toaster" simulator
Project description
Qubit Toaster backend for Qiskit
Allows running Qiskit code on Qubit Toaster - a high performance quantum circuit simulator.
More goodies at https://quantastica.com
Install
pip install quantastica-qiskit-toaster
Usage
Import ToasterBackend into your Qiskit code:
from quantastica.qiskit_toaster import ToasterBackend
Replace Aer.get_backend
with ToasterBackend.get_backend
.
Example
from qiskit import QuantumRegister, ClassicalRegister
from qiskit import QuantumCircuit, execute, Aer
from quantastica.qiskit_toaster import ToasterBackend
qc = QuantumCircuit()
q = QuantumRegister(2, "q")
c = ClassicalRegister(2, "c")
qc.add_register(q)
qc.add_register(c)
qc.h(q[0])
qc.cx(q[0], q[1])
qc.measure(q[0], c[0])
qc.measure(q[1], c[1])
# Instead:
#backend = Aer.get_backend("qasm_simulator")
# Use:
backend = ToasterBackend.get_backend("qasm_simulator")
# OR (to use statevector_simulator backend):
# backend = ToasterBackend.get_backend("statevector_simulator")
# OR (to specify custom toaster_host and toaster_port params
# default values are 127.0.0.1 and 8001 respectively):
# backend = ToasterBackend.get_backend(
# "statevector_simulator",
# toaster_host="192.168.1.2",
# toaster_port=8888,
# )
# OR (to use it directly via CLI instead of HTTP API)
# backend = ToasterBackend.get_backend(
# "qasm_simulator",
# use_cli=True)
job = execute(qc, backend=backend)
# To speed things up a little bit qiskit's optimization can be disabled
# by setting optimization_level to 0 like following:
# job = execute(qc, backend=backend, optimization_level=0)
#
# To pass different optimization level to qubit-toaster use backend_options:
# options = { "toaster_optimization": 3 }
# job = execute(qc, backend=backend, backend_options=options)
job_result = job.result()
print(job_result.get_counts(qc))
Details
Syntax
ToasterBackend.get_backend( backend_name = None,
toaster_host=None,
toaster_port=None,
use_cli=False)
Arguments
backend_name
can be:qasm_simulator
only counts will be returnedstatevector_simulator
both counts and state vector will be returned- If backend name is not provided then it will act as
qasm_simulator
toaster_host
- ip address of machine runningqubit-toaster
simulatortoaster_port
- port thatqubit-toaster
is listening onuse_cli
- if this param is set toTrue
thequbit-toaster
will be used directly (by invoking it as executable) instead via HTTP API. For this to work thequbit-toaster
binary must be available somewhere in system PATH
Toaster's backend_options
toaster_optimization
- integer from 0 to 7- 0 - automatic optimization
- 1 - optimization is off
- 7 - highest optimization
Running unit tests
First start qubit-toaster
in HTTP API mode:
qubit-toaster -S
Running standard set of tests (excluding the slow ones):
python -m unittest -v
Running all tests (including the slow ones):
SLOW=1 python -m unittest -v
Specifying different toaster host/port:
TOASTER_HOST=192.168.1.2 TOASTER_PORT=8001 python -m unittest -v -f
Running tests by using CLI interface instead of HTTP:
USE_CLI=1 python -m unittest -v -f
That's it. Enjoy! :)
Project details
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
Built Distribution
Close
Hashes for quantastica-qiskit-toaster-0.9.25.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | e4e77cb19b22d9f4ae578473bf42ebe7e7577082bf297f7497814d21fcf8931f |
|
MD5 | b58811234eb9fc9aa7849141094f8aa3 |
|
BLAKE2b-256 | cb9c3ebc3ec3a3d786ff8e4da4f2e6065e40553865274e1d5dbdcd83ada6698a |
Close
Hashes for quantastica_qiskit_toaster-0.9.25-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 84f02e74e9276969f4d36da144d09777f7b79339af32973a391baf104803fe33 |
|
MD5 | 67ac8b5077fdb87fe73722e6428905e1 |
|
BLAKE2b-256 | 37545a74c46fbee62e9c985eabe81d15a56d5cc771a076a04b48d2cc6ce7844e |