{"id":15047906,"url":"https://github.com/shinmorino/sqaod","last_synced_at":"2025-08-21T18:10:02.261Z","repository":{"id":57470415,"uuid":"108132074","full_name":"shinmorino/sqaod","owner":"shinmorino","description":"Solvers/annealers for simulated quantum annealing on CPU and CUDA(NVIDIA GPU).","archived":false,"fork":false,"pushed_at":"2023-06-29T06:54:02.000Z","size":66834,"stargazers_count":85,"open_issues_count":11,"forks_count":21,"subscribers_count":10,"default_branch":"1.0","last_synced_at":"2024-12-18T05:46:05.361Z","etag":null,"topics":["accelearated","cplusplus-11","cuda","gpu","linux","monte-carlo-simulation","nvidia-gpu","python","quantum-annealing","quantum-computing","windows"],"latest_commit_sha":null,"homepage":"https://github.com/shinmorino/sqaod/wiki","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shinmorino.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}},"created_at":"2017-10-24T13:39:16.000Z","updated_at":"2024-12-10T20:17:46.000Z","dependencies_parsed_at":"2022-09-19T10:21:58.066Z","dependency_job_id":null,"html_url":"https://github.com/shinmorino/sqaod","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shinmorino%2Fsqaod","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shinmorino%2Fsqaod/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shinmorino%2Fsqaod/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shinmorino%2Fsqaod/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shinmorino","download_url":"https://codeload.github.com/shinmorino/sqaod/tar.gz/refs/heads/1.0","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230554330,"owners_count":18244234,"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":["accelearated","cplusplus-11","cuda","gpu","linux","monte-carlo-simulation","nvidia-gpu","python","quantum-annealing","quantum-computing","windows"],"created_at":"2024-09-24T21:05:56.634Z","updated_at":"2024-12-20T08:09:01.181Z","avatar_url":"https://github.com/shinmorino.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sqaod\n#### Latest version : v1.0.3 (deb), 1.0.2 (python). (Nov. 11, 2018)\n\nCollections of solvers/annealers for simulated quantum annealing on CPU and CUDA(NVIDIA GPU).\u003cBR\u003e\nPlease visit [sqaod wiki](https://github.com/shinmorino/sqaod/wiki) for more details.\n\nHere's a list of useful links for starters:\n- [Installation](https://github.com/shinmorino/sqaod/wiki/Installation)\n- [sqaod documentation](https://shinmorino.github.io/sqaod/docs/1.0)\n- [sqaod/sqaodpy/examples](https://github.com/shinmorino/sqaod/tree/master/sqaodpy/example)\n\n## Project status\n### Version 1.0.3 Released (2018/11/17)\nVersion 1.0.3 includes one bug fix that was not fixed in 1.0.2.\nPlease update to 1.0.3 if you're using older versions.\n- Fix: QUBO energy was not correctly calculated and in SA algorithms in CUDA-based solver.\n\n### Version 1.0.2 Released (2018/11/11)\n- getSystemE() is added to solvers to calculate system energy during annealing. [[#60]](https://github.com/shinmorino/sqaod/issues/60)\n- sqaod.algorithm.sa_default is added to select default SA algorithms in annealers. [[#61]](https://github.com/shinmorino/sqaod/issues/61)\n- calculate_E() and make_solutions() are not required to get QUBO energy and solutions.  These functions are for caching energies and solutions. [[#63]](https://github.com/shinmorino/sqaod/issues/63)\n- Python solvers return copies of objects.[[#62]](https://github.com/shinmorino/sqaod/issues/62)\n- Fix: anneal_one_step() for SA algorithm did not work, since parameters are not correctly passed. [[#65]](https://github.com/shinmorino/sqaod/issues/65)\n- Fix: QUBO energy was not correctly calculated and beta was not correctly applied in SQA algorithms. [[#64]](https://github.com/shinmorino/sqaod/issues/64)\n- Fix: symmetrize() was not correctly handled. [[#66]](https://github.com/shinmorino/sqaod/issues/66)\n\nPlease visit the '[Release history](https://github.com/shinmorino/sqaod/wiki/Release-history)' page for changes and updates.\n\n#### Future plan\n- Version 1.1 planning is undergoing.  Please file your requests to [Version 1.1 planning [#55]]( https://github.com/shinmorino/sqaod/issues/55).\n\n## Installation  \n\nIf you're using Ubuntu 16.04/18.04 or CentOS(RHEL) 7, please visit [Installation](https://github.com/shinmorino/sqaod/wiki/Installation) page at sqaod wiki.\n\nIf you want to use other Linux distribution, you need to build from source. See wiki, [Build from source](https://github.com/shinmorino/sqaod/wiki/Build-from-source).\nPlease file a request to [Issues](https://github.com/shinmorino/sqaod/issues) if you need binary distribution for your linux distro.  Windows version and/or docker images are possible as well.\n\n\nHere's a quick instruction to install sqaod v1.0 to Ubuntu 16.04/18.04.\n\n\n### 1. Cleaning environment.\n\nIf you installed sqaod from source, clean up native libraries at first.\n~~~\nfind /usr/lib | grep libsqaodc\n# if you find libraries, remove them.\nfind /usr/lib | grep libsqaodc | sudo xargs rm -f\n~~~\n\nIf you installed alpha versions (alpha1, alpha2) of libsqaod, uninstall them first, and remove apt-repository setting.\n~~~\n# removing older packages if you instsalled.\nsudo apt-get remove libsqaodc-cuda-9-0\nsudo apt-get remove libsqaodc-avx2\nsudo apt-get remove libsqaodc\n\n# remove apt-repository setting.\nsudo rm -f /etc/sources.list.d/sqaod.list\n~~~\n\n\n### 2. Installing native libraries\n\n~~~\nsudo apt-get update\nsudo apt-get install apt-transport-https apt-utils\n\n# adding apt repository setting.\n \n. /etc/lsb-release\necho \"deb [arch=amd64] https://shinmorino.github.io/sqaod/ubuntu ${DISTRIB_CODENAME} multiverse\" | \\\n   sudo tee /etc/apt/sources.list.d/sqaod.list\n\n# install repository key.\ncurl -s -L https://shinmorino.github.io/sqaod/gpgkey | sudo apt-key add -\n\n# update and install sqaodc native library.\nsudo apt-get update\nsudo apt-get install libsqaodc\n~~~\n\n### 3. Installing CUDA driver/libraries (if you need CUDA-based solvers.)\n\n~~~\ndistribution=$(. /etc/os-release;echo $ID${VERSION_ID//.})\necho \"deb http://developer.download.nvidia.com/compute/cuda/repos/${distribution}/x86_64 /\" | \\\n   sudo tee /etc/apt/sources.list.d/cuda.list\nsudo apt-key adv --fetch-keys http://developer.download.nvidia.com/compute/cuda/repos/${distribution}/x86_64/7fa2af80.pub\nsudo apt-get update\nsudo apt-get install cuda-drivers\n\nsudo apt-get install libsqaodc-cuda-10-0\n\n# If you prefer CUDA 9.0, run following. (Packages with CUDA 9.0 is available on Ubuntu16.04.)\nsudo apt-get install libsqaodc-cuda-9-0\n\n~~~\n\n### 4. Installing python package\n\n#### Python 2.7/3.5/3.6/3.7.\nTo install sqaod python package, use pip as shown below.\n~~~\npip install -U sqaod\n~~~\n\n### 5. Running examples\n\nPython examples are in [sqaod/sqaodpy/examples](https://github.com/shinmorino/sqaod/tree/master/sqaodpy/example).  The below is an example to run dense graph annealer.\n\n~~~\ncurl -s -L -O https://raw.githubusercontent.com/shinmorino/sqaod/master/sqaodpy/example/dense_graph_annealer.py\npython dense_graph_annealer.py\n~~~\n\n### Dockerfile\n[Dockerfile](https://github.com/shinmorino/sqaod/tree/gh-pages/docker/kato) for Ubuntu-16.04 with CUDA-9.2, contribution from [Kato-san](https://github.com/gyu-don).\n\n\n### Feedback and requests\nI welcome your feedback and requests.\u003cBR\u003e\nPlease file your feedback and/or requests to [Issues](https://github.com/shinmorino/sqaod/issues).\u003cBR\u003e\n\n\n### Opensource software used in sqaod.\n\n- [Eigen](http://eigen.tuxfamily.org/index.php?title=Main_Page) ([MPL2](https://www.mozilla.org/en-US/MPL/2.0/))\n- [CUB](http://nvlabs.github.io/cub/) ([BSD 3-Clause \"New\" or \"Revised\" License](https://github.com/NVlabs/cub/blob/1.8.0/LICENSE.TXT))\n- [libblas](https://packages.ubuntu.com/xenial/libblas3) ([Modified BSD License](http://www.netlib.org/lapack/LICENSE.txt))\n- From Beta1, [aptly](https://www.aptly.info/) is used to manage sqaod repository.\n\n\n### Enjoy !!!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshinmorino%2Fsqaod","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshinmorino%2Fsqaod","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshinmorino%2Fsqaod/lists"}