# Quantum Circuit Synthesis Environment for Reinforcement Learning
This project provides a quantum circuit synthesis environment for reinforcement learning. The environment is built on top of the Gymnasium framework.
## Installation
To install the environment, you need to have Python and pip installed on your system. If you don't have them installed, you can download them from the official Python website.
Once you have Python and pip installed, you can install the environment by running the following command in your terminal:
```sh
pip install qc_syn
```
## Usage
To create a new instance of the environment, you can use the `gym.make` function:
```python
import gymnasium as gym
import qc_syn
env = gym.make("qc_syn/QuantumCircuit-v0", qubit_count=4)
observation, info = env.reset()
for _ in range(1000):
action = env.action_space.sample() # agent policy that uses the observation and info
observation, reward, terminated, truncated, info = env.step(action)
if terminated or truncated:
observation, info = env.reset()
env.close()
```
## Contributing
Contributions are welcome! Please feel free to submit a pull request.
## License
This project is licensed under the terms of the MIT license.
Raw data
{
"_id": null,
"home_page": "https://github.com/michaelkoelle/rl-qc-syn",
"name": "qc-syn",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "",
"author": "Michael K\u00f6lle",
"author_email": "michael.koelle@ifi.lmu.de",
"download_url": "https://files.pythonhosted.org/packages/29/64/f6c62d10dad8037ecb90960b9ab58c8f0daf90f726218953c7daf9945abf/qc_syn-0.1.0.tar.gz",
"platform": null,
"description": "# Quantum Circuit Synthesis Environment for Reinforcement Learning\n\nThis project provides a quantum circuit synthesis environment for reinforcement learning. The environment is built on top of the Gymnasium framework.\n\n## Installation\n\nTo install the environment, you need to have Python and pip installed on your system. If you don't have them installed, you can download them from the official Python website.\n\nOnce you have Python and pip installed, you can install the environment by running the following command in your terminal:\n\n```sh\npip install qc_syn\n```\n\n## Usage\n\nTo create a new instance of the environment, you can use the `gym.make` function:\n\n```python\nimport gymnasium as gym\nimport qc_syn\n\nenv = gym.make(\"qc_syn/QuantumCircuit-v0\", qubit_count=4)\nobservation, info = env.reset()\n\nfor _ in range(1000):\n action = env.action_space.sample() # agent policy that uses the observation and info\n observation, reward, terminated, truncated, info = env.step(action)\n\n if terminated or truncated:\n observation, info = env.reset()\n\nenv.close()\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a pull request.\n\n## License\n\nThis project is licensed under the terms of the MIT license.\n",
"bugtrack_url": null,
"license": "",
"summary": "A quantum circuit synthesis environment for reinforcement learning",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/michaelkoelle/rl-qc-syn"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f05ce99f0ba85a7d30af34bf1d9bfe9accf69d19e7cb4b443c303ec0b07744cd",
"md5": "be7271fecdb5a413e730073007a2e17a",
"sha256": "c5819871df6bac74337dbd71736ea6dc7bf7bc3be3ff9cb350d1c0adaedbe9f5"
},
"downloads": -1,
"filename": "qc_syn-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "be7271fecdb5a413e730073007a2e17a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 6040,
"upload_time": "2024-02-14T12:14:54",
"upload_time_iso_8601": "2024-02-14T12:14:54.452082Z",
"url": "https://files.pythonhosted.org/packages/f0/5c/e99f0ba85a7d30af34bf1d9bfe9accf69d19e7cb4b443c303ec0b07744cd/qc_syn-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2964f6c62d10dad8037ecb90960b9ab58c8f0daf90f726218953c7daf9945abf",
"md5": "933d924745f4147dea74223b29804987",
"sha256": "58ea02f92c21c87ea9a285e73873f9a2e318231b1e885fe0ebd8824b14050f35"
},
"downloads": -1,
"filename": "qc_syn-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "933d924745f4147dea74223b29804987",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 5679,
"upload_time": "2024-02-14T12:14:56",
"upload_time_iso_8601": "2024-02-14T12:14:56.344796Z",
"url": "https://files.pythonhosted.org/packages/29/64/f6c62d10dad8037ecb90960b9ab58c8f0daf90f726218953c7daf9945abf/qc_syn-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-14 12:14:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "michaelkoelle",
"github_project": "rl-qc-syn",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "qc-syn"
}