{"id":27465105,"url":"https://github.com/cda-tum/ddsim","last_synced_at":"2025-04-16T00:01:56.518Z","repository":{"id":37098082,"uuid":"239731195","full_name":"cda-tum/mqt-ddsim","owner":"cda-tum","description":"MQT DDSIM - A quantum circuit simulator based on decision diagrams written in C++","archived":false,"fork":false,"pushed_at":"2025-04-07T17:24:55.000Z","size":3004,"stargazers_count":145,"open_issues_count":16,"forks_count":33,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-09T17:01:54.752Z","etag":null,"topics":["decision-diagrams","jku","mqt","python","quantum","quantum-circuit-simulator","quantum-circuits","quantum-computing","tum"],"latest_commit_sha":null,"homepage":"https://mqt.readthedocs.io/projects/ddsim","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cda-tum.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-02-11T10:08:51.000Z","updated_at":"2025-03-24T04:28:38.000Z","dependencies_parsed_at":"2023-12-11T19:28:30.402Z","dependency_job_id":"4a8f8645-78be-46b6-9347-4aa0243a960e","html_url":"https://github.com/cda-tum/mqt-ddsim","commit_stats":{"total_commits":445,"total_committers":14,"mean_commits":"31.785714285714285","dds":0.7078651685393258,"last_synced_commit":"af65305b1ce55d04ddf8120220dcc4b67890193b"},"previous_names":["cda-tum/mqt-ddsim","cda-tum/ddsim"],"tags_count":40,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cda-tum%2Fmqt-ddsim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cda-tum%2Fmqt-ddsim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cda-tum%2Fmqt-ddsim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cda-tum%2Fmqt-ddsim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cda-tum","download_url":"https://codeload.github.com/cda-tum/mqt-ddsim/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249173071,"owners_count":21224483,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["decision-diagrams","jku","mqt","python","quantum","quantum-circuit-simulator","quantum-circuits","quantum-computing","tum"],"created_at":"2025-04-16T00:01:21.662Z","updated_at":"2025-04-16T00:01:56.496Z","avatar_url":"https://github.com/cda-tum.png","language":"C++","funding_links":[],"categories":["Quantum SDKs"],"sub_categories":[],"readme":"[![PyPI](https://img.shields.io/pypi/v/mqt.ddsim?logo=pypi\u0026style=flat-square)](https://pypi.org/project/mqt.ddsim/)\n![OS](https://img.shields.io/badge/os-linux%20%7C%20macos%20%7C%20windows-blue?style=flat-square)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT)\n[![CI](https://img.shields.io/github/actions/workflow/status/cda-tum/mqt-ddsim/ci.yml?branch=main\u0026style=flat-square\u0026logo=github\u0026label=ci)](https://github.com/cda-tum/mqt-ddsim/actions/workflows/ci.yml)\n[![CD](https://img.shields.io/github/actions/workflow/status/cda-tum/mqt-ddsim/cd.yml?style=flat-square\u0026logo=github\u0026label=cd)](https://github.com/cda-tum/mqt-ddsim/actions/workflows/cd.yml)\n[![Documentation](https://img.shields.io/readthedocs/ddsim?logo=readthedocs\u0026style=flat-square)](https://mqt.readthedocs.io/projects/ddsim)\n[![codecov](https://img.shields.io/codecov/c/github/cda-tum/mqt-ddsim?style=flat-square\u0026logo=codecov)](https://codecov.io/gh/cda-tum/mqt-ddsim)\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://mqt.readthedocs.io\"\u003e\n   \u003cpicture\u003e\n     \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/munich-quantum-toolkit/.github/refs/heads/main/docs/_static/mqt-banner-dark.svg\" width=\"90%\"\u003e\n     \u003cimg src=\"https://raw.githubusercontent.com/munich-quantum-toolkit/.github/refs/heads/main/docs/_static/mqt-banner-light.svg\" width=\"90%\" alt=\"MQT Banner\"\u003e\n   \u003c/picture\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n# MQT DDSIM - A quantum circuit simulator based on decision diagrams written in C++\n\nA tool for classical quantum circuit simulation developed as part of the [_Munich Quantum Toolkit (MQT)_](https://mqt.readthedocs.io) by the [Chair for Design Automation](https://www.cda.cit.tum.de/) at the [Technical University of Munich](https://www.tum.de/).\nIt builds upon [MQT Core](https://github.com/cda-tum/mqt-core), which forms the backbone of the MQT.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://mqt.readthedocs.io/projects/ddsim\"\u003e\n  \u003cimg width=30% src=\"https://img.shields.io/badge/documentation-blue?style=for-the-badge\u0026logo=read%20the%20docs\" alt=\"Documentation\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\nIf you have any questions, feel free to contact us via [quantum.cda@xcit.tum.de](mailto:quantum.cda@xcit.tum.de) or by creating an [issue](https://github.com/cda-tum/mqt-ddsim/issues) on GitHub.\n\n## Getting Started\n\nDDSIM bundled with the provider and backends for Qiskit is available via [PyPI](https://pypi.org/project/mqt.ddsim/) for Linux, macOS, and Windows and supports Python 3.9 to 3.13.\n\n```console\n(venv) $ pip install mqt.ddsim\n```\n\nThe following code gives an example on the usage:\n\n```python3\nfrom qiskit import QuantumCircuit\nfrom mqt import ddsim\n\ncirc = QuantumCircuit(3)\ncirc.h(0)\ncirc.cx(0, 1)\ncirc.cx(0, 2)\n\nprint(circ.draw(fold=-1))\n\nbackend = ddsim.DDSIMProvider().get_backend(\"qasm_simulator\")\n\njob = backend.run(circ, shots=10000)\ncounts = job.result().get_counts(circ)\nprint(counts)\n```\n\n**Detailed documentation on all available methods, options, and input formats is available at [ReadTheDocs](https://mqt.readthedocs.io/projects/ddsim).**\n\n## System Requirements and Building\n\nThe implementation is compatible with any C++17 compiler and a minimum CMake version of 3.19.\nPlease refer to the [documentation](https://mqt.readthedocs.io/projects/ddsim) on how to build the project.\n\nBuilding (and running) is continuously tested under Linux, macOS, and Windows using the [latest available system versions for GitHub Actions](https://github.com/actions/virtual-environments).\n\n## References\n\nDDSIM has been developed based on methods proposed in the following papers:\n\n- A. Zulehner and R. Wille, \"[Advanced Simulation of Quantum Computations](https://www.cda.cit.tum.de/files/eda/2018_tcad_advanced_simulation_quantum_computation.pdf),\" Transactions on CAD of Integrated Circuits and Systems (TCAD), 2019\n- S. Hillmich, I.L. Markov, and R. Wille, \"[Just Like the Real Thing: Fast Weak Simulation of Quantum Computation](https://www.cda.cit.tum.de/files/eda/2020_dac_weak_simulation_quantum_computation.pdf),\" in Design Automation Conference (DAC), 2020\n- S. Hillmich, R. Kueng, I. L. Markov, and R. Wille, \"[As Accurate as Needed, as Efficient as Possible: Approximations in DD-based Quantum Circuit Simulation](https://www.cda.cit.tum.de/files/eda/2021_date_approximations_dd_baed_quantum_circuit_simulation.pdf),\" in Design, Automation and Test in Europe (DATE), 2021\n- L. Burgholzer, H. Bauer, and R. Wille, \"[Hybrid Schrödinger-Feynman Simulation of Quantum Circuits With Decision Diagrams](https://www.cda.cit.tum.de/files/eda/2021_qce_hybrid_schrodinger_feynman_simulation_with_decision_diagrams.pdf),\" Conference on Quantum Computing and Engineering (QCE), 2021\n- L. Burgholzer, A.Ploier, and R. Wille, \"[Exploiting Arbitrary Paths for the Simulation of Quantum Circuits with Decision Diagrams](https://www.cda.cit.tum.de/files/eda/2022_date_exploiting_arbitrary_paths_simulation_quantum_circuits_decision_diagrams.pdf),\" in Design, Automation and Test in Europe (DATE), 2022\n- T. Grurl, J. Fuß, and R. Wille, \"[Noise-aware Quantum Circuit Simulation With Decision Diagrams](https://www.cda.cit.tum.de/files/eda/2022_tcad_noise-aware_quantum_circuit_simulation_with_decision_diagrams.pdf),\" Transactions on CAD of Integrated Circuits and Systems (TCAD), 2022.\n\n---\n\n## Acknowledgements\n\nThe Munich Quantum Toolkit has been supported by the European\nResearch Council (ERC) under the European Union's Horizon 2020 research and innovation program (grant agreement\nNo. 101001318), the Bavarian State Ministry for Science and Arts through the Distinguished Professorship Program, as well as the\nMunich Quantum Valley, which is supported by the Bavarian state government with funds from the Hightech Agenda Bayern Plus.\n\n\u003cp align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/munich-quantum-toolkit/.github/refs/heads/main/docs/_static/mqt-funding-footer-dark.svg\" width=\"90%\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/munich-quantum-toolkit/.github/refs/heads/main/docs/_static/mqt-funding-footer-light.svg\" width=\"90%\" alt=\"MQT Funding Footer\"\u003e\n  \u003c/picture\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcda-tum%2Fddsim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcda-tum%2Fddsim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcda-tum%2Fddsim/lists"}