Skip to content

Commit 68f4ad3

Browse files
authored
📝 Prepare docs for new release (#360)
## Description This PR just fixes up a couple of things throughout the documentation regarding the move from `qmap` to `mqt-qmap` and from the `QFR` library to `MQT Core`. ## Checklist: <!--- This checklist serves as a reminder of a couple of things that ensure your pull request will be merged swiftly. --> - [x] The pull request only contains commits that are related to it. - [x] I have added appropriate tests and documentation. - [x] I have made sure that all CI jobs on GitHub pass. - [x] The pull request introduces no new warnings and follows the project's style guidelines.
2 parents 0a6c08c + 7d1347f commit 68f4ad3

File tree

8 files changed

+34
-34
lines changed

8 files changed

+34
-34
lines changed

.github/contributing.rst

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ We value contributions from people with all levels of experience.
66
In particular if this is your first pull request not everything has to be perfect.
77
We will guide you through the process.
88

9-
We use GitHub to `host code <https://github.com/cda-tum/qmap>`_, to `track issues and feature requests <https://github.com/cda-tum/qmap/issues>`_, as well as accept `pull requests <https://github.com/cda-tum/qmap/pulls>`_.
9+
We use GitHub to `host code <https://github.com/cda-tum/mqt-qmap>`_, to `track issues and feature requests <https://github.com/cda-tum/mqt-qmap/issues>`_, as well as accept `pull requests <https://github.com/cda-tum/mqt-qmap/pulls>`_.
1010
See https://docs.github.com/en/get-started/quickstart for a general introduction to working with GitHub and contributing to projects.
1111

1212
Types of Contributions
@@ -15,19 +15,19 @@ Types of Contributions
1515
You can contribute in several ways:
1616

1717
- 🐛 Report Bugs
18-
Report bugs at https://github.com/cda-tum/qmap/issues using the *🐛 Bug report* issue template. Please make sure to fill out all relevant information in the respective issue form.
18+
Report bugs at https://github.com/cda-tum/mqt-qmap/issues using the *🐛 Bug report* issue template. Please make sure to fill out all relevant information in the respective issue form.
1919

2020
- 🐛 Fix Bugs
21-
Look through the `GitHub Issues <https://github.com/cda-tum/qmap/issues>`_ for bugs. Anything tagged with "bug" is open to whoever wants to try and fix it.
21+
Look through the `GitHub Issues <https://github.com/cda-tum/mqt-qmap/issues>`_ for bugs. Anything tagged with "bug" is open to whoever wants to try and fix it.
2222

2323
- ✨ Propose New Features
24-
Propose new features at https://github.com/cda-tum/qmap/issues using the *✨ Feature request* issue template. Please make sure to fill out all relevant information in the respective issue form.
24+
Propose new features at https://github.com/cda-tum/mqt-qmap/issues using the *✨ Feature request* issue template. Please make sure to fill out all relevant information in the respective issue form.
2525

2626
- ✨ Implement New Features
27-
Look through the `GitHub Issues <https://github.com/cda-tum/qmap/issues>`_ for features. Anything tagged with "feature" is open to whoever wants to implement it. We highly appreciate external contributions to the project.
27+
Look through the `GitHub Issues <https://github.com/cda-tum/mqt-qmap/issues>`_ for features. Anything tagged with "feature" is open to whoever wants to implement it. We highly appreciate external contributions to the project.
2828

2929
- 📝 Write Documentation
30-
QMAP could always use some more `documentation <https://mqtqmap.readthedocs.io/en/latest/>`_, and we appreciate any help with that.
30+
QMAP could always use some more `documentation <https://mqt.readthedocs.io/projects/qmap>`_, and we appreciate any help with that.
3131

3232
🎉 Get Started
3333
##############

.github/support.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
Support
22
=======
33

4-
If you are stuck with a problem using QMAP or are having questions, please do get in touch at our `Issues <https://github.com/cda-tum/qmap/issues>`_ or `Discussions <https://github.com/cda-tum/qmap/discussions>`_. We'd love to help.
4+
If you are stuck with a problem using QMAP or are having questions, please do get in touch at our `Issues <https://github.com/cda-tum/mqt-qmap/issues>`_ or `Discussions <https://github.com/cda-tum/mqt-qmap/discussions>`_. We'd love to help.
55

66
You can save time by following this procedure when reporting a problem:
77

8-
- Do try to solve the problem on your own first. Make sure to consult the `Documentation <https://mqtqmap.readthedocs.io/en/latest/>`_.
9-
- Search through past `Issues <https://github.com/cda-tum/qmap/issues>`_ to see if someone else already had the same problem.
8+
- Do try to solve the problem on your own first. Make sure to consult the `Documentation <https://mqt.readthedocs.io/projects/qmap>`_.
9+
- Search through past `Issues <https://github.com/cda-tum/mqt-qmap/issues>`_ to see if someone else already had the same problem.
1010
- Before filing a bug report, try to create a minimal working example (MWE) that reproduces the problem. It's much easier to identify the cause for the problem if a handful of lines suffice to show that something isn't working.
1111

1212
You can also always reach us at `quantum.cda@xcit.tum.de <mailto:quantum.cda@xcit.tum.de>`_.

LICENSE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
MIT License
22

3-
Copyright (c) 2022 Chair for Design Automation, Technical University of Munich
3+
Copyright (c) 2023 Chair for Design Automation, Technical University of Munich
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

README.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,31 @@
11
[![PyPI](https://img.shields.io/pypi/v/mqt.qmap?logo=pypi&style=flat-square)](https://pypi.org/project/mqt.qmap/)
22
![OS](https://img.shields.io/badge/os-linux%20%7C%20macos%20%7C%20windows-blue?style=flat-square)
33
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT)
4-
[![CI](https://img.shields.io/github/actions/workflow/status/cda-tum/qmap/ci.yml?branch=main&style=flat-square&logo=github&label=c%2B%2B)](https://github.com/cda-tum/qmap/actions/workflows/ci.yml)
5-
[![Python-CI](https://img.shields.io/github/actions/workflow/status/cda-tum/qmap/python-ci.yml?branch=main&style=flat-square&logo=github&label=python)](https://github.com/cda-tum/qmap/actions/workflows/python-ci.yml)
6-
[![Bindings](https://img.shields.io/github/actions/workflow/status/cda-tum/qmap/deploy.yml?branch=main&style=flat-square&logo=github&label=packaging)](https://github.com/cda-tum/qmap/actions/workflows/deploy.yml)
7-
[![Documentation](https://img.shields.io/readthedocs/mqtqmap?logo=readthedocs&style=flat-square)](https://mqtqmap.readthedocs.io/en/latest/)
8-
[![codecov](https://img.shields.io/codecov/c/github/cda-tum/qmap?style=flat-square&logo=codecov)](https://codecov.io/gh/cda-tum/qmap)
4+
[![CI](https://img.shields.io/github/actions/workflow/status/cda-tum/mqt-qmap/ci.yml?branch=main&style=flat-square&logo=github&label=c%2B%2B)](https://github.com/cda-tum/mqt-qmap/actions/workflows/ci.yml)
5+
[![Python-CI](https://img.shields.io/github/actions/workflow/status/cda-tum/mqt-qmap/python-ci.yml?branch=main&style=flat-square&logo=github&label=python)](https://github.com/cda-tum/mqt-qmap/actions/workflows/python-ci.yml)
6+
[![Bindings](https://img.shields.io/github/actions/workflow/status/cda-tum/mqt-qmap/deploy.yml?branch=main&style=flat-square&logo=github&label=packaging)](https://github.com/cda-tum/mqt-qmap/actions/workflows/deploy.yml)
7+
[![Documentation](https://img.shields.io/readthedocs/mqtqmap?logo=readthedocs&style=flat-square)](https://mqt.readthedocs.io/projects/qmap)
8+
[![codecov](https://img.shields.io/codecov/c/github/cda-tum/mqt-qmap?style=flat-square&logo=codecov)](https://codecov.io/gh/cda-tum/mqt-qmap)
99

1010
<p align="center">
1111
<picture>
12-
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/cda-tum/qmap/main/docs/source/_static/mqt_light.png" width="60%">
13-
<img src="https://raw.githubusercontent.com/cda-tum/qmap/main/docs/source/_static/mqt_dark.png" width="60%">
12+
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/cda-tum/mqt-qmap/main/docs/source/_static/mqt_light.png" width="60%">
13+
<img src="https://raw.githubusercontent.com/cda-tum/mqt-qmap/main/docs/source/_static/mqt_dark.png" width="60%">
1414
</picture>
1515
</p>
1616

1717
# MQT QMAP - A tool for Quantum Circuit Compilation
1818

19-
A tool for quantum circuit compilation developed as part of the _Munich Quantum Toolkit_ (_MQT_)[^1] by the [Chair for Design Automation](https://www.cda.cit.tum.de/) at the [Technical University of Munich](https://www.tum.de/).
20-
It builds upon [our quantum functionality representation (QFR)](https://github.com/cda-tum/qfr).
19+
A tool for quantum circuit compilation developed as part of the [_Munich Quantum Toolkit_](https://mqt.readthedocs.io) (_MQT_)[^1] by the [Chair for Design Automation](https://www.cda.cit.tum.de/) at the [Technical University of Munich](https://www.tum.de/).
20+
It builds upon [MQT Core](https://github.com/cda-tum/mqt-core), which forms the backbone of the MQT.
2121

2222
<p align="center">
23-
<a href="https://mqtqmap.readthedocs.io/en/latest/">
23+
<a href="https://mqt.readthedocs.io/projects/qmap">
2424
<img width=30% src="https://img.shields.io/badge/documentation-blue?style=for-the-badge&logo=read%20the%20docs" alt="Documentation" />
2525
</a>
2626
</p>
2727

28-
If 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 on [GitHub](https://github.com/cda-tum/qmap/issues).
28+
If 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 on [GitHub](https://github.com/cda-tum/mqt-qmap/issues).
2929

3030
## Getting Started
3131

@@ -71,12 +71,12 @@ circ.h(1)
7171
circ_opt, results = qmap.optimize_clifford(circ)
7272
```
7373

74-
**Detailed documentation on all available methods, options, and input formats is available at [ReadTheDocs](https://mqtqmap.readthedocs.io/en/latest/).**
74+
**Detailed documentation on all available methods, options, and input formats is available at [ReadTheDocs](https://mqt.readthedocs.io/projects/qmap).**
7575

7676
## System Requirements and Building
7777

7878
The implementation is compatible with any C++17 compiler, a minimum CMake version of 3.19, and Python 3.8+.
79-
Please refer to the [documentation](https://mqtqmap.readthedocs.io/en/latest/) on how to build the project.
79+
Please refer to the [documentation](https://mqt.readthedocs.io/projects/qmap) on how to build the project.
8080

8181
Building (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).
8282

docs/source/DevelopmentGuide.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,13 @@ Ready to contribute to the project? Here is how to set up a local development en
66
Initial Setup
77
#############
88

9-
1. Fork the `cda-tum/qmap <https://github.com/cda-tum/qmap>`_ repository on GitHub (see https://docs.github.com/en/get-started/quickstart/fork-a-repo).
9+
1. Fork the `cda-tum/mqt-qmap <https://github.com/cda-tum/mqt-qmap>`_ repository on GitHub (see https://docs.github.com/en/get-started/quickstart/fork-a-repo).
1010

1111
2. Clone your fork locally
1212

1313
.. code-block:: console
1414
15-
$ git clone git@github.com:your_name_here/qmap --recursive
15+
$ git clone git@github.com:your_name_here/mqt-qmap --recursive
1616
1717
.. warning::
1818

@@ -23,7 +23,7 @@ Initial Setup
2323

2424
.. code-block:: console
2525
26-
$ cd qmap
26+
$ cd mqt-qmap
2727
2828
4. Create a branch for local development
2929

docs/source/Installation.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
Installation
22
============
33

4-
QMAP is mainly developed as a C++ library that builds upon `our quantum functionality representation (QFR) <https://github.com/cda-tum/qfr>`_.
4+
QMAP is mainly developed as a C++ library that builds upon `MQT Core <https://github.com/cda-tum/mqt-core>`_, which forms the backbone of the `MQT <https://mqt.readthedocs.io>`_.
55
In order to make the tool as accessible as possible, it comes with an easy-to-use Python interface.
66

77
We encourage installing QMAP via pip (preferably in a `virtual environment <https://docs.python.org/3/library/venv.html>`_):
@@ -118,7 +118,7 @@ This requires a `C++ compiler <https://en.wikipedia.org/wiki/List_of_compilers#C
118118
- Build Z3 from source and install it to the system
119119

120120
The library is continuously tested under Linux, MacOS, and Windows using the `latest available system versions for GitHub Actions <https://github.com/actions/virtual-environments>`_.
121-
In order to access the latest build logs, visit `qmap/actions/workflows/ci.yml <https://github.com/cda-tum/qmap/actions/workflows/ci.yml>`_.
121+
In order to access the latest build logs, visit `mqt-qmap/actions/workflows/ci.yml <https://github.com/cda-tum/mqt-qmap/actions/workflows/ci.yml>`_.
122122

123123
.. note::
124124
We noticed some issues when compiling with Microsoft's *MSCV* compiler toolchain. If you want to start development on this project under Windows, consider using the *clang* compiler toolchain. A detailed description of how to set this up can be found `here <https://docs.microsoft.com/en-us/cpp/build/clang-support-msbuild?view=msvc-160>`_.

docs/source/index.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
Welcome to QMAP's documentation!
22
================================
33

4-
QMAP is a tool for quantum circuit compilation developed as part of the *Munich Quantum Toolkit* (*MQT*) [#]_ by the `Chair for Design Automation <https://www.cda.cit.tum.de/>`_ at the `Technical University of Munich <https://www.tum.de>`_. It builds upon `our quantum functionality representation (QFR) <https://github.com/cda-tum/qfr>`_.
4+
QMAP is a tool for quantum circuit compilation developed as part of the `Munich Quantum Toolkit <https://mqt.readthedocs.io>`_ (*MQT*) [#]_ by the `Chair for Design Automation <https://www.cda.cit.tum.de/>`_ at the `Technical University of Munich <https://www.tum.de>`_. It builds upon `MQT Core <https://github.com/cda-tum/mqt-core>`_, which forms the backbone of the MQT.
55

66
We recommend you to start with the :doc:`installation instructions <Installation>` or by reading our overview paper :cite:labelpar:`wille2023qmap`.
77
Then proceed to the :doc:`mapping page <Mapping>` or the :doc:`synthesis/optimization page <Synthesis>` and read the :doc:`reference documentation <library/Library>`.

pyproject.toml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ name = "mqt.qmap"
1212
description = "A tool for Quantum Circuit Mapping"
1313
readme = "README.md"
1414
authors = [
15-
{ name = "Lukas Burgholzer", email = "lukas.burgholzer@jku.at" },
15+
{ name = "Lukas Burgholzer", email = "lukas.burgholzer@tum.de" },
1616
{ name = "Sarah Schneider", email = "sarah.schneider@jku.at" },
1717
{ name = "Stefan Hillmich", email = "stefan.hillmich@jku.at" },
1818
{ name = "Tom Peham", email = "tom.peham@tum.de" }
@@ -68,10 +68,10 @@ docs = [
6868
dev = ["mqt.qmap[coverage, docs]"]
6969

7070
[project.urls]
71-
Homepage = "https://github.com/cda-tum/qmap"
72-
Documentation = "https://mqtqmap.readthedocs.io"
73-
"Bug Tracker" = "https://github.com/cda-tum/qmap/issues"
74-
Discussions = "https://github.com/cda-tum/qmap/discussions"
71+
Homepage = "https://github.com/cda-tum/mqt-qmap"
72+
Documentation = "https://mqt.readthedocs.io/projects/qmap"
73+
"Bug Tracker" = "https://github.com/cda-tum/mqt-qmap/issues"
74+
Discussions = "https://github.com/cda-tum/mqt-qmap/discussions"
7575
Research = "https://www.cda.cit.tum.de/research/ibm_qx_mapping/"
7676

7777
[tool.setuptools.packages.find]

0 commit comments

Comments
 (0)