Skip to main content

pyqrack - Pure Python vm6502q/qrack Wrapper

Project description

pyqrack

Downloads Downloads Downloads

Pure Python bindings for the pure C++11 Qrack quantum computer simulator library

(PyQrack is just pure Qrack.)

<<<<<<< HEAD This is the purely CPU-based variant of PyQrack (with module name pyqrack-cpu). This alternate build of PyQrack is provided so that systems that won't use OpenCL anyway (such as because they lack any GPUs or other accelerators like the Intel HD) do not need to install the OpenCL library in order to use PyQrack. In this form, both the PyQrack module and the underlying C++ Qrack library are entirely external dependency-free.

(If you installing from source, it doesn't matter whether you use pyqrack or pyqrack-cpu, because the build version of C++ Qrack you intend to use must already be installed locally.)

Note, if building from source: You must build and install unitaryfund/qrack to build the main branch from source. CI/CD builds wheels that contain pre-compiled Qrack binaries, and that is the form published on PyPi. You must also install OpenCL.

main

Import and instantiate QrackSimulator instances. This simulator can perform arbitrary single qubit and controlled-single-qubit gates, as well as other specific gates like SWAP.

Any 2x2 bit operator matrix is represented by a list of 4 complex floating point numbers, in row-major order.

Single and array "b" parameters represent Pauli operator bases. They are specified according to the enumeration of the Pauli class.

MC[x] and MAC[x] methods are controlled single bit gates, with as many control qubits as you specify via Python list c argument. MCX is multiply-controlled Pauli X, and MACX is "anti-"controlled Pauli X, i.e. "anti-control" activates the gate if all control bits are specifically off, as opposed to on.

To load the required unitaryfund/qrack libraries from a different location, set the PYQRACK_SHARED_LIB_PATH environment variable.

PyQrack has experimental support for PyZX Circuit definitions as an intermediate representation for QrackSimulator. To try this, load a Circuit in PyZX, (use that module to optimize your circuit, as you like,) and create a QrackSimulator() instance using the pyzxCircuit named argument of the constructor, like so:

sim = QrackSimulator(pyzxCircuit=c)

where c is a PyZX circuit object. The circuit will automatically be simulated in the constructed QrackSimulator instance. This also allows loading from QASM and other intermediate representations supported by PyZX.

See https://pyqrack.readthedocs.io/en/latest/ for an API reference.

For custom Qrack build floating-point precision, where options are half, float, double, and quad, set an environment variable via export QRACK_FPPOW=[n] (or as appropriate to your shell) where [n] is the logarithm base 2 of the number of bits in the systemic floating point type (4, 5, 6, or 7, with 5 or float as default, i.e. 2**5=32 for 32-bit float).

Please feel welcome to open an issue, if you'd like help. 😃

Special thanks go to Zeeshan Ahmed, for bug fixes and design suggestions, Ashish Panigrahi, for documentation and design suggestions, WingCode, for documentation, and to the broader community of Qrack contributors, for years of happy Qracking! You rock!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyqrack_cpu-1.32.21.tar.gz (34.6 kB view details)

Uploaded Source

Built Distributions

pyqrack_cpu-1.32.21-py3-none-win_amd64.whl (688.3 kB view details)

Uploaded Python 3 Windows x86-64

pyqrack_cpu-1.32.21-py3-none-manylinux_2_39_x86_64.whl (2.2 MB view details)

Uploaded Python 3 manylinux: glibc 2.39+ x86-64

pyqrack_cpu-1.32.21-py3-none-manylinux_2_35_x86_64.whl (2.2 MB view details)

Uploaded Python 3 manylinux: glibc 2.35+ x86-64

pyqrack_cpu-1.32.21-py3-none-manylinux_2_31_x86_64.whl (2.1 MB view details)

Uploaded Python 3 manylinux: glibc 2.31+ x86-64

pyqrack_cpu-1.32.21-py3-none-macosx_13_0_x86_64.whl (1.7 MB view details)

Uploaded Python 3 macOS 13.0+ x86-64

pyqrack_cpu-1.32.21-py3-none-macosx_12_0_x86_64.whl (1.6 MB view details)

Uploaded Python 3 macOS 12.0+ x86-64

File details

Details for the file pyqrack_cpu-1.32.21.tar.gz.

File metadata

  • Download URL: pyqrack_cpu-1.32.21.tar.gz
  • Upload date:
  • Size: 34.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for pyqrack_cpu-1.32.21.tar.gz
Algorithm Hash digest
SHA256 10ed49cd3f30866bd4725703f7c7c5ac91a4d2f8f31d467a4a819b3a3e83c122
MD5 992313b794d4e58fef9f16b9af35159b
BLAKE2b-256 2cde1727b4754b5016d26cc76798d556bdb3b24a290013833a272e0470ac5640

See more details on using hashes here.

File details

Details for the file pyqrack_cpu-1.32.21-py3-none-win_amd64.whl.

File metadata

File hashes

Hashes for pyqrack_cpu-1.32.21-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 db01f7f5158930f23ba287abb0febb54940223dddb320eecc923cfc4e43ade9a
MD5 c0d96f73d3e592e4e10d9cbfe215b505
BLAKE2b-256 15a4a156941cd6feffb082caa9d35614368e4fd43b60a46a5f91a674d1e92e60

See more details on using hashes here.

File details

Details for the file pyqrack_cpu-1.32.21-py3-none-manylinux_2_39_x86_64.whl.

File metadata

File hashes

Hashes for pyqrack_cpu-1.32.21-py3-none-manylinux_2_39_x86_64.whl
Algorithm Hash digest
SHA256 e084ad131d4b884e378c199bb8e61520dd297c3911b4f6bc3d10f3f2d735452a
MD5 e312d4c7bdec78a51068b0a941b82b50
BLAKE2b-256 162126c32d178372c19f912f517c130389d381cba8f66cd5af0efc1ff3cde529

See more details on using hashes here.

File details

Details for the file pyqrack_cpu-1.32.21-py3-none-manylinux_2_35_x86_64.whl.

File metadata

File hashes

Hashes for pyqrack_cpu-1.32.21-py3-none-manylinux_2_35_x86_64.whl
Algorithm Hash digest
SHA256 13a534204bbdc1098d26d4b8c47a8e0120398f405acb4735ca1951c13223bba2
MD5 0690346213680eaa5e4be872340beeb4
BLAKE2b-256 14e862c211b73a28195bf7eeb0895f91d2e6b0381aeabebfea0b1a5570fd488c

See more details on using hashes here.

File details

Details for the file pyqrack_cpu-1.32.21-py3-none-manylinux_2_31_x86_64.whl.

File metadata

File hashes

Hashes for pyqrack_cpu-1.32.21-py3-none-manylinux_2_31_x86_64.whl
Algorithm Hash digest
SHA256 d9c8d3129364cbe1a24699e42148b05468e28394f5910b6b730e4868e1ade845
MD5 cca201ebed4a5ae466cd73817cc6e536
BLAKE2b-256 144485a755f0234934dcb443b3e4f6a91d530265589b4250ade4c0814e8037a3

See more details on using hashes here.

File details

Details for the file pyqrack_cpu-1.32.21-py3-none-macosx_13_0_x86_64.whl.

File metadata

File hashes

Hashes for pyqrack_cpu-1.32.21-py3-none-macosx_13_0_x86_64.whl
Algorithm Hash digest
SHA256 2d3ff140dd8c07fa35e650af8e0d4f51a8fd7b78bdd4f75a0fdd259317e1fba8
MD5 180a0ce9284296d003c0b7f61d0664eb
BLAKE2b-256 2556f0f1d7108580c7b0a7a508604ee684ddddfeccf9334d45a7215cdf15d21c

See more details on using hashes here.

File details

Details for the file pyqrack_cpu-1.32.21-py3-none-macosx_12_0_x86_64.whl.

File metadata

File hashes

Hashes for pyqrack_cpu-1.32.21-py3-none-macosx_12_0_x86_64.whl
Algorithm Hash digest
SHA256 36c064675e46b8670e1e9f3fbeef83666258823761081e50ea46c58343f9292e
MD5 184648f9742268aedd80655d2079af08
BLAKE2b-256 948a59982b0f260833995279486fafd2832195de6315cfdc65ae8b1caf6a78a4

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page