{"id":13776740,"url":"https://github.com/USCCACS/MISTIQS","last_synced_at":"2025-05-11T10:31:13.524Z","repository":{"id":50156511,"uuid":"291330966","full_name":"USCCACS/MISTIQS","owner":"USCCACS","description":"A full-stack, cross-platform software for generating, compiling, and executing quantum circuits for simulating quantum many-body dynamics of systems governed by Heisenberg Hamiltonians","archived":false,"fork":false,"pushed_at":"2021-06-02T06:50:46.000Z","size":1093,"stargazers_count":15,"open_issues_count":1,"forks_count":5,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-02-15T10:33:03.823Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/USCCACS.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":"2020-08-29T18:55:42.000Z","updated_at":"2023-12-22T13:25:53.000Z","dependencies_parsed_at":"2022-09-12T23:22:09.521Z","dependency_job_id":null,"html_url":"https://github.com/USCCACS/MISTIQS","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/USCCACS%2FMISTIQS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/USCCACS%2FMISTIQS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/USCCACS%2FMISTIQS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/USCCACS%2FMISTIQS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/USCCACS","download_url":"https://codeload.github.com/USCCACS/MISTIQS/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253551662,"owners_count":21926332,"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":[],"created_at":"2024-08-03T18:00:32.351Z","updated_at":"2025-05-11T10:31:12.539Z","avatar_url":"https://github.com/USCCACS.png","language":"Python","funding_links":[],"categories":["Quantum simulators"],"sub_categories":[],"readme":"# MISTIQS: Multiplatform Software for Time-dependent Quantum Simulation\n![MISTIQS top](docs/MISTIQS_top.png)\n\nA full-stack, cross-platform software for generating, compiling, and executing quantum circuits for simulating quantum many-body dynamics of systems governed by Heisenberg Hamiltonians.\n\nMISTIQS provides the following primary capabilities:\n\n1) Generation of quantum circuits for performing quantum simulations of the dynamics of spin chains governed by input Heisenberg Hamiltonians\n\n2) Translation of these quantum circuits into executable circuit objects for IBM, Rigetti, and Googele quantum devices (Qiskit circuit objects, Pyquil programs, and Cirq circuit objects respectively)\n\n3) Compilation of circuits, either using the compilers native to the quantum computing platform of choice or using the domain-specific IBM and Rigetti compilers developed for TFIM simulations (more information [here](https://arxiv.org/abs/2004.07418))\n\n4) Execution of these circuits on IBM or Rigetti quantum processors\n\n5) Post-processing and plotting of simulation results (limited to average magnetization data)\n\nMISTIQS provides the user with extensive flexibility across its functionalities. Some examples include support for user-defined time dependence functions for external fields, full XYZ model support in Hamiltonian constructions, and options to only use portions of the code functionality (such as only generating the quantum circuits without execution or running existing quantum circuits through the integrated domain-specific compilers for optimization purposes).\n\n\n# I. Getting Started\nThe core code of MISTIQS only requires numpy to run. Executing quantum circuits requires glob, and plotting them requires matplotlib. For generating and/or plotting quantum circuits for IBM hardware, qiskit is required (0.21.0 currently supported). Similarly, pyquil is required for Rigetti use cases (qvm 1.17.1 and quilc 1.21.0 current supported), and cirq is required for generating circuits for the Cirq platform (0.9.1 current supported).\n\n# II. Importing the Software For Use\n\nFor full use of the software, simply add the **MISTIQS/src** directory to your path and run\n\n    from Heisenberg import Heisenberg\n\nNow you can create Heisenberg objects, which contain the full functionality of the software.\n\nIf you only want to use the domain-specific compilers, add the MISTIQS/src directory to your path and run\n\n    from Heisenberg import ds_compiler\n\nNow you can call **ds_compile()** on existing IBM or Rigetti quantum circuit objects.\n\n\nPlease see [documentation](https://github.com/USCCACS/MISTIQS/blob/master/docs/MISTIQS%20User's%20Guide.md), as well as [examples](https://github.com/USCCACS/MISTIQS/tree/master/examples) provided.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FUSCCACS%2FMISTIQS","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FUSCCACS%2FMISTIQS","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FUSCCACS%2FMISTIQS/lists"}