Supermarq: A Scalable Quantum Benchmark Suite
Supermarq is a suite of application-oriented benchmarks used to measure the performance of quantum computing systems.
Installation
The Supermarq package is available via pip and can be installed in your current Python environment with the command:
pip install supermarq
Install Dev Requirements
This is required if you intend to run checks locally
pip install .[dev]
Using Supermarq
The benchmarks are defined as classes within supermarq/benchmarks/. Each application
defines two methods; circuit and score. These methods are used to generate the benchmarking circuit and evaluate its performance
after execution on hardware.
The quantum benchmarks within Supermarq are designed to be scalable, meaning that the benchmarks can be instantiated and generated for a wide range of circuit sizes and depths.
The Supermarq tutorial notebooks contain an end-to-end example of how to execute the GHZ benchmark using Superstaq. The general workflow is as follows:
import supermarq
ghz = supermarq.benchmarks.ghz.GHZ(num_qubits=3)
ghz_circuit = ghz.circuit()
counts = execute_circuit_on_quantum_hardware(ghz_circuit) # For example, via AWS Braket, IBM Qiskit, or Superstaq
score = ghz.score(counts)
Metadata
Release files for Supermarq 0.5.69
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| supermarq-0.5.69.tar.gz | 86.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| supermarq-0.5.69-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 205.3 kB
Release files / supermarq-0.5.69.tar.gz
| Download URL | supermarq-0.5.69.tar.gz |
|---|---|
| Size | 86.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a1f27c5ca0ef756e136b35eb4396487ddc838fe79e65820557c4a32d55fda64e
|
|
BLAKE2b-256 checksum How to use checksums |
d10d82de08770b881a177a92f934229fe16de8f0798a40013512dc52309eb934
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
Release files / supermarq-0.5.69-py3-none-any.whl
| Download URL | supermarq-0.5.69-py3-none-any.whl |
|---|---|
| Size | 119.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a772df37f6905e024bd0f8b2f314f2be338cdbbbce39dda90af0ed523e91f9ea
|
|
BLAKE2b-256 checksum How to use checksums |
7f9c07c6e6056bd7b025a5621445362f9df9de11987dbd147104c1b890829ada
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|