Skip to main content

Hybrid Dependency Hypergraphs for quantum computation: translation, visualization, and partitioning.

Project description

HDH Logo

Hybrid Dependency Hypergraphs for Quantum Computation

PyPI version · [![Documentation](https://img.shields.io/badge/docs-online-blue)](https://grageragarces.github.io/HDH/) · Unitary Foundation · MIT Licensed · · Author: Maria Gragera Garces

Documentation


What is a HDH?

HDH (Hybrid Dependency Hypergraph) is an intermediate directed hypergraph-based representation designed to encode the dependecies arising in any quantum workload. It provides a unified structure that makes it easier to:

  • Translate quantum programs (e.g., a circuit or a mbqc pattern) into a unified hypergraph format
  • Analyze and visualize the logical and temporal dependencies within a computation
  • Partition workloads across devices, taking into account hardware and network constraints

Current Capabilities

  • Qiskit, Braket, Cirq and Pennylane circuit mappings to HDHs
  • OpenQASM 2.0 file parsing
  • Model-specific abstractions for:
    • Quantum Circuits
    • Measurement-Based Quantum Computing (MBQC)
    • Quantum Walks
    • Quantum Cellular Automata (QCA)
  • Capability to partition HDHs and evaluate partitions

Installation

pip install hdh

Quickstart

From Qiskit

from qiskit import QuantumCircuit
from hdh.converters import from_qiskit
from hdh.visualize import plot_hdh

qc = QuantumCircuit(2)
qc.h(0)
qc.cx(0, 1)

hdh = from_qiskit(qc)

plot_hdh(hdh)

From QASM file

from hdh.converters import from_qasm
from hdh.visualize import plot_hdh

qasm_path = os.path.join(os.path.dirname(__file__), 'test_qasm_file.qasm')
hdh = from_qasm('file', qasm_path)

plot_hdh(hdh)

Tests and Demos

All tests are under tests/ and can be run with:

pytest

Contributing

Pull requests welcome. Please open an issue or get in touch if you're interested in:

  • SDK compatibility
  • Frontend tools (visualization, benchmarking)

or if you've found a bug!


Citation

More formal citation and paper preprint coming soon. Stay tuned for updates.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hdh-0.2.6.tar.gz (25.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

hdh-0.2.6-py3-none-any.whl (30.2 kB view details)

Uploaded Python 3

File details

Details for the file hdh-0.2.6.tar.gz.

File metadata

  • Download URL: hdh-0.2.6.tar.gz
  • Upload date:
  • Size: 25.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for hdh-0.2.6.tar.gz
Algorithm Hash digest
SHA256 855a048b95839c6240e82f8e5d2214deb53e38e45961c48db150d2ce44eb5230
MD5 c5fe7cf7a44452f0e336355088fbe329
BLAKE2b-256 cebcaae135295cfe94cacce74cc8a156983a5716e76645a025eb267266890210

See more details on using hashes here.

Provenance

The following attestation bundles were made for hdh-0.2.6.tar.gz:

Publisher: publish.yml on grageragarces/HDH

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file hdh-0.2.6-py3-none-any.whl.

File metadata

  • Download URL: hdh-0.2.6-py3-none-any.whl
  • Upload date:
  • Size: 30.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for hdh-0.2.6-py3-none-any.whl
Algorithm Hash digest
SHA256 6b8059cc687c5df291179d0ad7d920576c81cee441cbd6252ea20946bb28056b
MD5 a938f1c1c609751a333d7bb73f3fbf28
BLAKE2b-256 6ebe57395b064bf1a5a484b2edcedfd1c67bd737bcd2bb8939172c20ad8e3956

See more details on using hashes here.

Provenance

The following attestation bundles were made for hdh-0.2.6-py3-none-any.whl:

Publisher: publish.yml on grageragarces/HDH

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page