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.70
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| supermarq-0.5.70.tar.gz | 86.3 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| supermarq-0.5.70-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 205.3 kB
Release files / supermarq-0.5.70.tar.gz
| Download URL | supermarq-0.5.70.tar.gz |
|---|---|
| Size | 86.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5c65ed9535a58d3c7152fe41873389dd2c294e838cb91a72c19d88bd3709372a
|
|
BLAKE2b-256 checksum How to use checksums |
3f5efa3bdebec93ec5275b6416e581a5b54e3f43b712acc4537260c9a3945787
|
| 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.70-py3-none-any.whl
| Download URL | supermarq-0.5.70-py3-none-any.whl |
|---|---|
| Size | 119.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7058e35c0386dc6b592795f93eb11a0bebe368c1278f6646158f9f0db762ac5e
|
|
BLAKE2b-256 checksum How to use checksums |
1ebc7a4d503f85eb88f350dde7d31333fe6998d9448567ee178af53a9000e64d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
Security for Supermarq 0.5.70
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.