# v_quantum_annealing : Framework for the Ising model and QUBO.
[](https://pypi.python.org/pypi/v_quantum_annealing/)
[](https://pypi.python.org/pypi/v_quantum_annealing/)
[](https://pypi.python.org/pypi/v_quantum_annealing/)
[](https://pypi.python.org/pypi/v_quantum_annealing/)
[](https://pypi.python.org/pypi/v_quantum_annealing/)
[](https://pypi.python.org/pypi/v_quantum_annealing/)
[](https://pepy.tech/project/v_quantum_annealing)
[](https://github.com/v_quantum_annealing/v_quantum_annealing/actions/workflows/ci-test-cpp.yml)
[](https://github.com/v_quantum_annealing/v_quantum_annealing/actions/workflows/ci-test-python.yaml)
[](https://github.com/v_quantum_annealing/v_quantum_annealing/actions/workflows/buid-doc.yml)
[](https://github.com/v_quantum_annealing/v_quantum_annealing/actions/workflows/codeql-analysis.yml)
[](https://www.codacy.com/gh/v_quantum_annealing/v_quantum_annealing/dashboard?utm_source=github.com&utm_medium=referral&utm_content=v_quantum_annealing/v_quantum_annealing&utm_campaign=Badge_Grade)
[](https://codeclimate.com/github/v_quantum_annealing/v_quantum_annealing/maintainability)
[](https://codecov.io/gh/v_quantum_annealing/v_quantum_annealing)
## Coverage Graph
| **Sunburst** | **Grid** | **Icicle** |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <a href="https://codecov.io/gh/v_quantum_annealing/v_quantum_annealing"><img src="https://codecov.io/gh/v_quantum_annealing/v_quantum_annealing/branch/main/graphs/sunburst.svg?token=WMSK3GS8E5" width="100%"/></a> | <a href="https://codecov.io/gh/v_quantum_annealing/v_quantum_annealing"><img src="https://codecov.io/gh/v_quantum_annealing/v_quantum_annealing/branch/main/graphs/tree.svg?token=WMSK3GS8E5" width="100%"/></a> | <a href="https://codecov.io/gh/v_quantum_annealing/v_quantum_annealing"><img src="https://codecov.io/gh/v_quantum_annealing/v_quantum_annealing/branch/main/graphs/icicle.svg?token=WMSK3GS8E5" width="100%"/></a> |
- python >= 3.7
- (optional) gcc >= 7.0.0
- (optional) cmake >= 3.22
- (optional) Ninja
### Change **IMPORT**
- v_quantum_annealing >= v0.5.0
```python
import v_quantum_annealing.cxxvqa
```
- v_quantum_annealing <= v0.4.9
```python
import cxxvqa
```
- [Documents](https://v_quantum_annealing.github.io/v_quantum_annealing/)
- [C++ Docs](https://v_quantum_annealing.github.io/v_quantum_annealing-Reference-Page/index.html)
## install
### install via pip
> Note: To use GPGPU algorithms, please follow the section [`install via pip from source codes`](#install-via-pip-from-source-codes) below.
> GPGPU algorithms are automatically enabled once CMake finds CUDA frameworks during installation.
```
# Binary
$ pip install v_quantum_annealing
# From Source (CUDA)
$ pip install --no-binary=v_quantum_annealing v_quantum_annealing
```
### install via pip from source codes
To install v_quantum_annealing from source codes, please install CMake first then install v_quantum_annealing.
#### cmake setup
If you want to use setup.py instead of PIP, You will need to install CMake>=3.22.\
We are Highly recommended install CMake via PYPI.
```
$ pip install -U cmake
```
Make sure the enviroment path for CMake is set correctly.
#### install v_quantum_annealing
```
$ pip install --no-binary=v_quantum_annealing v_quantum_annealing
```
### install from github repository
```
$ git clone git@github.com:v_quantum_annealing/v_quantum_annealing.git
$ cd v_quantum_annealing
$ python -m pip install -vvv .
```
## For Contributor
Use `pre-commit` for auto chech before git commit.
`.pre-commit-config.yaml`
```
# pipx install pre-commit
# or
# pip install pre-commit
pre-commit install
```
## Test
### Python
```sh
$ python -m venv .venv
$ . .venv/bin/activate
$ pip install pip-tools
$ pip-compile setup.cfg
$ pip-compile dev-requirements.in
$ pip-sync requirements.txt dev-requirements.txt
$ source .venv/bin/activate
$ export CMAKE_BUILD_TYPE=Debug
$ python setup.py --force-cmake install --build-type Debug -G Ninja
$ python setup.py --build-type Debug test
$ python -m coverage html
```
### C++
```sh
$ mkdir build
$ cmake -DCMAKE_BUILD_TYPE=Debug -S . -B build
$ cmake --build build --parallel
$ cd build
$ ./tests/cxxvqa_test
# Alternatively Use CTest
$ ctest --extra-verbose --parallel --schedule-random
```
Needs: CMake > 3.22, C++17
- Format
```sh
$ pip-compile format-requirements.in
$ pip-sync format-requirements.txt
```
```sh
$ python -m isort
$ python -m black
```
- Aggressive Format
```sh
$ python -m isort --force-single-line-imports --verbose ./v_quantum_annealing
$ python -m autoflake --in-place --recursive --remove-all-unused-imports --ignore-init-module-imports --remove-unused-variables ./v_quantum_annealing
$ python -m autopep8 --in-place --aggressive --aggressive --recursive ./v_quantum_annealing
$ python -m isort ./v_quantum_annealing
$ python -m black ./v_quantum_annealing
```
- Lint
```sh
$ pip-compile setup.cfg
$ pip-compile dev-requirements.in
$ pip-compile lint-requirements.in
$ pip-sync requirements.txt dev-requirements.txt lint-requirements.txt
```
```sh
$ python -m flake8
$ python -m mypy
$ python -m pyright
```
## Python Documentation
Use Juyter Book for build documentation.
With KaTeX
Need: Graphviz
``` sh
$ pip-compile setup.cfg
$ pip-compile build-requirements.in
$ pip-compile doc-requirements.in
$ pip-sync requirements.txt build-requirements.txt doc-requirements.txt
```
Please place your document to `docs/tutorial`either markdown or jupyter notebook style.
```sh
$ pip install -vvv .
```
```sh
$ jupyter-book build docs --all
```
## How to use
### Python example
```python
import v_quantum_annealing as oj
sampler = oj.SASampler()
response = sampler.sample_ising(h={0: -1}, J={(0,1): -1})
response.states
# [[1,1]]
# with indices
response = sampler.sample_ising(h={'a': -1}, J={('a','b'): 1})
[{index: s for index, s in zip(response.indices, state)} for state in response.states]
# [{'b': -1, 'a': 1}]
```
## Community
- [v_quantum_annealing Slack](https://join.slack.com/t/v_quantum_annealing/shared_invite/enQtNjQyMjIwMzMwNzA4LTQ5MWRjOWYxYmY1Nzk4YzdiYzlmZjIxYjhhMmMxZjAyMzE3MDc1ZWRkYmI1YjhkNjRlOTM1ODE0NTc5Yzk3ZDA)
## About us
This product is maintained by Jij Inc.
**Please visit our website for more information!**
https://www.j-ij.com/
### Licences
Copyright 2023 Jij Inc.
Licensed under the Apache License, Version 2.0 (the "License");\
you may not use this file except in compliance with the License.\
You may obtain a copy of the License at
```
http://www.apache.org/licenses/LICENSE-2.0
```
Unless required by applicable law or agreed to in writing, software\
distributed under the License is distributed on an "AS IS" BASIS,\
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\
See the License for the specific language governing permissions and\
limitations under the License.
Raw data
{
"_id": null,
"home_page": "https://v-quantum-technology.com",
"name": "v-quantum-annealing",
"maintainer": "",
"docs_url": null,
"requires_python": "<3.11,>=3.7",
"maintainer_email": "",
"keywords": "",
"author": "V-Quantum Jsc.",
"author_email": "nqthinh@v-quantum-technology.com",
"download_url": "https://files.pythonhosted.org/packages/98/e4/beba797a0d93cf092ecd3ea1d303f23d8134498f0c97256381bdfdb26ea6/v_quantum_annealing-0.1.2.tar.gz",
"platform": null,
"description": "# v_quantum_annealing : Framework for the Ising model and QUBO.\r\n\r\n[](https://pypi.python.org/pypi/v_quantum_annealing/)\r\n[](https://pypi.python.org/pypi/v_quantum_annealing/)\r\n[](https://pypi.python.org/pypi/v_quantum_annealing/)\r\n[](https://pypi.python.org/pypi/v_quantum_annealing/)\r\n[](https://pypi.python.org/pypi/v_quantum_annealing/)\r\n[](https://pypi.python.org/pypi/v_quantum_annealing/)\r\n[](https://pepy.tech/project/v_quantum_annealing)\r\n\r\n[](https://github.com/v_quantum_annealing/v_quantum_annealing/actions/workflows/ci-test-cpp.yml)\r\n[](https://github.com/v_quantum_annealing/v_quantum_annealing/actions/workflows/ci-test-python.yaml)\r\n[](https://github.com/v_quantum_annealing/v_quantum_annealing/actions/workflows/buid-doc.yml)\r\n[](https://github.com/v_quantum_annealing/v_quantum_annealing/actions/workflows/codeql-analysis.yml)\r\n[](https://www.codacy.com/gh/v_quantum_annealing/v_quantum_annealing/dashboard?utm_source=github.com&utm_medium=referral&utm_content=v_quantum_annealing/v_quantum_annealing&utm_campaign=Badge_Grade)\r\n[](https://codeclimate.com/github/v_quantum_annealing/v_quantum_annealing/maintainability)\r\n[](https://codecov.io/gh/v_quantum_annealing/v_quantum_annealing)\r\n\r\n## Coverage Graph\r\n\r\n| **Sunburst** | **Grid** | **Icicle** |\r\n| -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\r\n| <a href=\"https://codecov.io/gh/v_quantum_annealing/v_quantum_annealing\"><img src=\"https://codecov.io/gh/v_quantum_annealing/v_quantum_annealing/branch/main/graphs/sunburst.svg?token=WMSK3GS8E5\" width=\"100%\"/></a> | <a href=\"https://codecov.io/gh/v_quantum_annealing/v_quantum_annealing\"><img src=\"https://codecov.io/gh/v_quantum_annealing/v_quantum_annealing/branch/main/graphs/tree.svg?token=WMSK3GS8E5\" width=\"100%\"/></a> | <a href=\"https://codecov.io/gh/v_quantum_annealing/v_quantum_annealing\"><img src=\"https://codecov.io/gh/v_quantum_annealing/v_quantum_annealing/branch/main/graphs/icicle.svg?token=WMSK3GS8E5\" width=\"100%\"/></a> |\r\n\r\n- python >= 3.7\r\n- (optional) gcc >= 7.0.0\r\n- (optional) cmake >= 3.22\r\n- (optional) Ninja\r\n\r\n### Change **IMPORT**\r\n\r\n- v_quantum_annealing >= v0.5.0\r\n\r\n ```python\r\n import v_quantum_annealing.cxxvqa\r\n ```\r\n\r\n- v_quantum_annealing <= v0.4.9\r\n\r\n ```python\r\n import cxxvqa\r\n ```\r\n\r\n- [Documents](https://v_quantum_annealing.github.io/v_quantum_annealing/)\r\n\r\n- [C++ Docs](https://v_quantum_annealing.github.io/v_quantum_annealing-Reference-Page/index.html)\r\n\r\n## install\r\n\r\n### install via pip\r\n\r\n> Note: To use GPGPU algorithms, please follow the section [`install via pip from source codes`](#install-via-pip-from-source-codes) below.\r\n> GPGPU algorithms are automatically enabled once CMake finds CUDA frameworks during installation.\r\n\r\n```\r\n# Binary\r\n$ pip install v_quantum_annealing \r\n# From Source (CUDA)\r\n$ pip install --no-binary=v_quantum_annealing v_quantum_annealing\r\n```\r\n\r\n### install via pip from source codes\r\n\r\nTo install v_quantum_annealing from source codes, please install CMake first then install v_quantum_annealing.\r\n\r\n#### cmake setup\r\n\r\nIf you want to use setup.py instead of PIP, You will need to install CMake>=3.22.\\\r\nWe are Highly recommended install CMake via PYPI.\r\n\r\n```\r\n$ pip install -U cmake\r\n```\r\n\r\nMake sure the enviroment path for CMake is set correctly.\r\n\r\n#### install v_quantum_annealing\r\n\r\n```\r\n$ pip install --no-binary=v_quantum_annealing v_quantum_annealing\r\n```\r\n\r\n### install from github repository\r\n\r\n```\r\n$ git clone git@github.com:v_quantum_annealing/v_quantum_annealing.git\r\n$ cd v_quantum_annealing\r\n$ python -m pip install -vvv .\r\n```\r\n\r\n## For Contributor\r\n\r\nUse `pre-commit` for auto chech before git commit.\r\n`.pre-commit-config.yaml`\r\n\r\n```\r\n# pipx install pre-commit \r\n# or \r\n# pip install pre-commit\r\npre-commit install\r\n```\r\n\r\n## Test\r\n\r\n### Python\r\n\r\n```sh\r\n$ python -m venv .venv\r\n$ . .venv/bin/activate\r\n$ pip install pip-tools \r\n$ pip-compile setup.cfg\r\n$ pip-compile dev-requirements.in\r\n$ pip-sync requirements.txt dev-requirements.txt\r\n$ source .venv/bin/activate\r\n$ export CMAKE_BUILD_TYPE=Debug\r\n$ python setup.py --force-cmake install --build-type Debug -G Ninja\r\n$ python setup.py --build-type Debug test \r\n$ python -m coverage html\r\n```\r\n\r\n### C++\r\n\r\n```sh\r\n$ mkdir build \r\n$ cmake -DCMAKE_BUILD_TYPE=Debug -S . -B build\r\n$ cmake --build build --parallel\r\n$ cd build\r\n$ ./tests/cxxvqa_test\r\n# Alternatively Use CTest \r\n$ ctest --extra-verbose --parallel --schedule-random\r\n```\r\n\r\nNeeds: CMake > 3.22, C++17\r\n\r\n- Format\r\n\r\n```sh\r\n$ pip-compile format-requirements.in\r\n$ pip-sync format-requirements.txt\r\n```\r\n\r\n```sh\r\n$ python -m isort \r\n$ python -m black \r\n```\r\n\r\n- Aggressive Format\r\n\r\n```sh\r\n$ python -m isort --force-single-line-imports --verbose ./v_quantum_annealing\r\n$ python -m autoflake --in-place --recursive --remove-all-unused-imports --ignore-init-module-imports --remove-unused-variables ./v_quantum_annealing\r\n$ python -m autopep8 --in-place --aggressive --aggressive --recursive ./v_quantum_annealing\r\n$ python -m isort ./v_quantum_annealing\r\n$ python -m black ./v_quantum_annealing\r\n```\r\n\r\n- Lint\r\n\r\n```sh\r\n$ pip-compile setup.cfg\r\n$ pip-compile dev-requirements.in\r\n$ pip-compile lint-requirements.in\r\n$ pip-sync requirements.txt dev-requirements.txt lint-requirements.txt\r\n```\r\n\r\n```sh\r\n$ python -m flake8\r\n$ python -m mypy\r\n$ python -m pyright\r\n```\r\n\r\n## Python Documentation \r\nUse Juyter Book for build documentation. \r\nWith KaTeX \r\nNeed: Graphviz\r\n\r\n``` sh\r\n$ pip-compile setup.cfg\r\n$ pip-compile build-requirements.in\r\n$ pip-compile doc-requirements.in\r\n$ pip-sync requirements.txt build-requirements.txt doc-requirements.txt\r\n```\r\n\r\nPlease place your document to `docs/tutorial`either markdown or jupyter notebook style.\r\n\r\n```sh\r\n$ pip install -vvv .\r\n```\r\n\r\n```sh \r\n$ jupyter-book build docs --all\r\n```\r\n\r\n\r\n## How to use\r\n\r\n### Python example\r\n\r\n```python\r\nimport v_quantum_annealing as oj\r\nsampler = oj.SASampler()\r\nresponse = sampler.sample_ising(h={0: -1}, J={(0,1): -1})\r\nresponse.states\r\n# [[1,1]]\r\n\r\n# with indices\r\nresponse = sampler.sample_ising(h={'a': -1}, J={('a','b'): 1})\r\n[{index: s for index, s in zip(response.indices, state)} for state in response.states]\r\n# [{'b': -1, 'a': 1}]\r\n```\r\n\r\n## Community\r\n\r\n- [v_quantum_annealing Slack](https://join.slack.com/t/v_quantum_annealing/shared_invite/enQtNjQyMjIwMzMwNzA4LTQ5MWRjOWYxYmY1Nzk4YzdiYzlmZjIxYjhhMmMxZjAyMzE3MDc1ZWRkYmI1YjhkNjRlOTM1ODE0NTc5Yzk3ZDA)\r\n\r\n## About us\r\n\r\nThis product is maintained by Jij Inc.\r\n\r\n**Please visit our website for more information!**\r\nhttps://www.j-ij.com/\r\n\r\n### Licences\r\n\r\nCopyright 2023 Jij Inc.\r\n\r\nLicensed under the Apache License, Version 2.0 (the \"License\");\\\r\nyou may not use this file except in compliance with the License.\\\r\nYou may obtain a copy of the License at\r\n\r\n```\r\n http://www.apache.org/licenses/LICENSE-2.0 \r\n```\r\n\r\nUnless required by applicable law or agreed to in writing, software\\\r\ndistributed under the License is distributed on an \"AS IS\" BASIS,\\\r\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\\\r\nSee the License for the specific language governing permissions and\\\r\nlimitations under the License.\r\n",
"bugtrack_url": null,
"license": "Apache 2",
"summary": "Quantum Computer Library for Everyone",
"version": "0.1.2",
"project_urls": {
"Documentation": "https://v_quantum_annealing.github.io/v_quantum_annealing",
"Homepage": "https://v-quantum-technology.com",
"Reference": "https://ref.v_quantum_annealing.org/index.html",
"Source": "https://github.com/v_quantum_annealing/v_quantum_annealing"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cf9998b28d67716a10b0bd422b2bd89a95c760813736d486b2f0525dd9ca9696",
"md5": "8599ad190567b9ee322b526f27fd36e6",
"sha256": "7f45f6e058e982a5c2685c5bb0a82db1095f3da962fe70946666c273c3f24ca0"
},
"downloads": -1,
"filename": "v_quantum_annealing-0.1.2-cp310-cp310-win_amd64.whl",
"has_sig": false,
"md5_digest": "8599ad190567b9ee322b526f27fd36e6",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": "<3.11,>=3.7",
"size": 2469330,
"upload_time": "2023-09-14T04:20:58",
"upload_time_iso_8601": "2023-09-14T04:20:58.834620Z",
"url": "https://files.pythonhosted.org/packages/cf/99/98b28d67716a10b0bd422b2bd89a95c760813736d486b2f0525dd9ca9696/v_quantum_annealing-0.1.2-cp310-cp310-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "98e4beba797a0d93cf092ecd3ea1d303f23d8134498f0c97256381bdfdb26ea6",
"md5": "f987f247bb78dbee0b064b6a84303364",
"sha256": "ef6ac5f7aa2b865d926b341ae4b44e07b226aab2903b50c46b638c419a48d2ee"
},
"downloads": -1,
"filename": "v_quantum_annealing-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "f987f247bb78dbee0b064b6a84303364",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.11,>=3.7",
"size": 632824,
"upload_time": "2023-09-14T04:21:02",
"upload_time_iso_8601": "2023-09-14T04:21:02.101634Z",
"url": "https://files.pythonhosted.org/packages/98/e4/beba797a0d93cf092ecd3ea1d303f23d8134498f0c97256381bdfdb26ea6/v_quantum_annealing-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-14 04:21:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "v_quantum_annealing",
"github_project": "v_quantum_annealing",
"github_not_found": true,
"lcname": "v-quantum-annealing"
}
JSON
