{"id":19663443,"url":"https://github.com/lanl-ansi/dwisc","last_synced_at":"2025-10-03T22:21:59.500Z","repository":{"id":26724734,"uuid":"109600092","full_name":"lanl-ansi/dwisc","owner":"lanl-ansi","description":"D-Wave Ising Sample Collector (D-WISC)","archived":false,"fork":false,"pushed_at":"2023-08-23T00:38:14.000Z","size":130,"stargazers_count":4,"open_issues_count":2,"forks_count":2,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-05T11:22:55.323Z","etag":null,"topics":["aqc","d-wave","ising-model","quantum-annealing","sampler"],"latest_commit_sha":null,"homepage":"","language":"Python","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/lanl-ansi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2017-11-05T17:22:50.000Z","updated_at":"2025-01-29T16:53:49.000Z","dependencies_parsed_at":"2022-07-16T00:16:18.034Z","dependency_job_id":null,"html_url":"https://github.com/lanl-ansi/dwisc","commit_stats":{"total_commits":30,"total_committers":4,"mean_commits":7.5,"dds":0.1333333333333333,"last_synced_commit":"88bedf387242c801e363a91e9b8a8408e0812401"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lanl-ansi%2Fdwisc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lanl-ansi%2Fdwisc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lanl-ansi%2Fdwisc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lanl-ansi%2Fdwisc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lanl-ansi","download_url":"https://codeload.github.com/lanl-ansi/dwisc/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251391323,"owners_count":21582149,"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":["aqc","d-wave","ising-model","quantum-annealing","sampler"],"created_at":"2024-11-11T16:14:38.812Z","updated_at":"2025-10-03T22:21:54.443Z","avatar_url":"https://github.com/lanl-ansi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# D-Wave Ising Sample Collector (D-WISC)\n\nThe D-WISC toolset is used to collect larger numbers of samples, on the order of millions, from a specific D-Wave QPU.  The `dwisc.py` collection script takes a [bqpjson](http://bqpjson.readthedocs.io/en/stable/) file as input (typically generated by [D-WIG](https://github.com/lanl-ansi/dwig)) and outputs a _solution_ json document that provides detailing the collected samples.  The helper script `combis.py` can be used to combine many _solution_ documents from repeated runs of `dwisc.py`.\n\nThe remainder of this documentation assumes that,\n\n1. You have access to a D-Wave QPU\n2. You have installed the dwave-cloud-client\n2. You are using a bash terminal\n\n### Basic Usage\n\nThe primary entry point of the D-WISC toolset is `dwisc.py` this script is used to collect samples from a D-Wave QPU.  For example, the following command will collect 25000 samples of from the bqpjson file `ran1_1.json` and send the resulting sample data to standard output,\n```\n./dwisc.py -f test/data/ran1_1.json \n```\nBash stream redirection can be used to save the standard output to a file, for example,\n```\n./dwisc.py -f test/data/ran1_1.json \u003e ran1_1_is_1.json\n```\nA detailed list of all command line options can be viewed via,\n```\n./dwisc.py --help\n```\n\nIt is fairly common to combine results from several runs of `dwisc.py`.  If multiple sample files are placed in a directory, `combis.py` can be used to quickly combine those files and send the resulting sample data to standard output,\n```\n./combis.py -sd test/result\n```\nAgain, bash stream redirection can be used to save the standard output to a file, for example,\n```\n./combis.py -sd test/result \u003e result.json\n```\n\n### Connecting to a QPU\n\nD-WISC uses the `dwave-cloud-client` for connecting to the QPU and will use your `dwave.conf` file for the configuration details.  A specific profile can be selected with the command line argument `--profile \u003clabel\u003e`.  If no configuration details are found, D-WISC will produce an error.\n\n\n### Solution JSON File\n\nThe solution file output by D-WISC is a JSON document with has the following structure,\n```\n{\n  \"collection_start\": \"\u003cUTC start time of sample collection\u003e\",\n  \"collection_end\": \"\u003cUTC end time of sample collection\u003e\",\n  \"metadata\": {\u003cQPU identification data\u003e},\n  \"solve_ising_args\": {\u003carguments passed to solve_ising\u003e},\n  \"timing\": {\u003caggregate QPU timing information\u003e}\n  \"variable_ids\": [\u003can ordered list of QPU variable ids\u003e],\n  \"solutions\":[\n    {\n      \"solution\":[\u003cvariable assignments of -1 and 1\u003e],\n      \"num_occurrences\":\u003cint\u003e,\n      \"energy\":\u003cfloat\u003e\n    },\n    ...\n  ]\n}\n```\nThe `metadata` and `solve_ising_args` fields are optional, all other fields are required.\n\n## License\nD-WISC is provided under a BSD-ish license with a \"modifications must be indicated\" clause.  See the `LICENSE.md` file for the full text.\nThis package is part of the Hybrid Quantum-Classical Computing suite, known internally as LA-CC-16-032.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flanl-ansi%2Fdwisc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flanl-ansi%2Fdwisc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flanl-ansi%2Fdwisc/lists"}