pyqrack

Downloads Downloads Downloads

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

(PyQrack is just pure Qrack.)

Note: You must also install OpenCL to use this version of Qrack. (There are also CPU-only and CUDA version.)

If you're looking for Mac ARM support, use the package pyqrack, not pyqrack-cpu. Mac officially "deprecated" OpenCL years ago. Hence, accelerator support is not included in ARM-based Mac wheels, and OpenCL installation is not required on these systems, but, if you have a CUDA accelerator on ARM-based Mac, you could try the package pyqrack-cuda instead.

Performance can benefit greatly from following the Qrack repository "Quick Start" and "Power user considerations."

If you use an integrated graphics accelerator, like the Intel HD, setting environment variable PYQRACK_HOST_POINTER_DEFAULT_ON=1 (or to any "truthy" value) will automatically set the default of isHostPointer option of QrackSimulator to True, to engage "zero-copy" mode by default.

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). Your Qrack installation floating-point build option must match this specific value, which might require a custom Qrack build.

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, Or Golan, for CI build pipeline tooling, and to the broader community of Qrack contributors, for years of happy Qracking! You rock!

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.17.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for WrathfulSpatula from gravatar.com WrathfulSpatula

Credits

PyPI data
Data sourced directly from PyPI's database.

Author: Daniel Strano

License

MIT

Provides Extra

dev

Tags

pyqrack qrack simulator quantum gpu

Classifiers

Report project as malware

Download files

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

Source Distribution

pyqrack-2.12.0.tar.gz (66.5 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

pyqrack-2.12.0-py3-none-win_amd64.whl (1.0 MB view details)

Uploaded Python 3Windows x86-64

pyqrack-2.12.0-py3-none-manylinux_2_39_x86_64.whl (3.7 MB view details)

Uploaded Python 3manylinux: glibc 2.39+ x86-64

pyqrack-2.12.0-py3-none-manylinux_2_35_x86_64.whl (3.7 MB view details)

Uploaded Python 3manylinux: glibc 2.35+ x86-64

pyqrack-2.12.0-py3-none-macosx_15_0_x86_64.whl (2.1 MB view details)

Uploaded Python 3macOS 15.0+ x86-64

pyqrack-2.12.0-py3-none-macosx_15_0_arm64.whl (1.9 MB view details)

Uploaded Python 3macOS 15.0+ ARM64

pyqrack-2.12.0-py3-none-macosx_14_0_arm64.whl (1.9 MB view details)

Uploaded Python 3macOS 14.0+ ARM64

File details

Details for the file pyqrack-2.12.0.tar.gz.

File metadata

  • Download URL: pyqrack-2.12.0.tar.gz
  • Upload date:
  • Size: 66.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for pyqrack-2.12.0.tar.gz
Algorithm Hash digest
SHA256 caa36ae5332ab863dc9de67666679acb4830595ab4fc368cbe56d96aaed7a494
MD5 9ba7f68e1f3157899d9613541d05cffc
BLAKE2b-256 c52402e68cf14b784e717ff12dec19928b5474f5a14d2945b6250cda7e7ca8b8

See more details on using hashes here.

File details

Details for the file pyqrack-2.12.0-py3-none-win_amd64.whl.

File metadata

  • Download URL: pyqrack-2.12.0-py3-none-win_amd64.whl
  • Upload date:
  • Size: 1.0 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for pyqrack-2.12.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 875a857fc24b831fd800ea07b4c382bdeeaa15325791fd6bafff5a69df57d16a
MD5 762e0de0c552d37bff64b587237bd582
BLAKE2b-256 30711e9fc5d6a815753a170497670871ebdd76dcd23c4e773a5e3da0e026e050

See more details on using hashes here.

File details

Details for the file pyqrack-2.12.0-py3-none-manylinux_2_39_x86_64.whl.

File metadata

File hashes

Hashes for pyqrack-2.12.0-py3-none-manylinux_2_39_x86_64.whl
Algorithm Hash digest
SHA256 606af0991cc08bcdc4f4712d90ee6bd0b049ee1c57e3f9484b01d284db25890a
MD5 b75013698e33fa3e84d7a31353a045f5
BLAKE2b-256 ab9f3edcd2bd9e6c3b65a3d482f8260b8c7e3bfc544b703041074f36982674f9

See more details on using hashes here.

File details

Details for the file pyqrack-2.12.0-py3-none-manylinux_2_35_x86_64.whl.

File metadata

File hashes

Hashes for pyqrack-2.12.0-py3-none-manylinux_2_35_x86_64.whl
Algorithm Hash digest
SHA256 27521ba8b321d205be5821e81d43df08e5c763ec03dea60a2b0d64733552c428
MD5 ff0d14fd52dfc9ff3d62ac67ec8b9a8a
BLAKE2b-256 d177fea2edf3606a2516f668b34b378e28ce0c5319a7e047ca778463233eb106

See more details on using hashes here.

File details

Details for the file pyqrack-2.12.0-py3-none-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for pyqrack-2.12.0-py3-none-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 8161887fb7be9f79721fb2408e4715a0bb3924307d9294724ffee34dbb16a9c6
MD5 1db38d3f1ac315a993bb42247b3baa48
BLAKE2b-256 d4c43ba9cd347e8bea8c2dd5b8bf03b89600d7c0b101941a7443b9c0f5a8ff03

See more details on using hashes here.

File details

Details for the file pyqrack-2.12.0-py3-none-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for pyqrack-2.12.0-py3-none-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 11cf6a536c522c083efddbb525606a9d87695936aebce328862e58b15ff2551e
MD5 5029d2f83291a4f6fa7ea2c87f351e6a
BLAKE2b-256 89c14a743d445caec9a03304f25596af254a0208c47caa417c3b8e79adcd47f3

See more details on using hashes here.

File details

Details for the file pyqrack-2.12.0-py3-none-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for pyqrack-2.12.0-py3-none-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 dbaced78cbbb7315e7c7902895086a52946c1e7d0041b47d593411479f85fc2e
MD5 9e716f24e268ac14b39b8ac31e21ba47
BLAKE2b-256 7e335345c97dd7e2869947e780b1af92387fa4c67f39f81cced076f084a166d5

See more details on using hashes here.

Release history Release notifications | RSS feed

2.17.2

2.17.1

2.17.0

2.15.2

2.15.1

2.15.0

2.14.0

2.13.2

2.13.1

2.13.0

This release

2.12.0

2.11.1

2.11.0

2.10.1

2.10.0

2.9.0

2.8.0

2.7.1

2.7.0

2.6.1

2.5.1

2.5.0

2.4.0

2.3.1

2.3.0

2.2.4

2.2.3

2.2.2

2.2.1

2.2.0

2.1.2

2.1.1

2.1.0

2.0.2

2.0.1

2.0.0

1.89.0

1.88.1

1.88.0

1.87.5

1.87.4

1.87.3

1.87.2

1.87.1

1.87.0

1.86.0

1.85.0

1.84.14

1.84.13

1.84.12

1.84.11

1.84.10

1.84.9

1.84.8

1.84.7

1.84.6

1.84.5

1.84.3

1.84.2

1.84.1

1.84.0

1.83.1

1.83.0

1.82.3

1.82.2

1.82.1

1.82.0

1.81.0

1.80.8

1.80.7

1.80.6

1.80.5

1.80.4

1.80.3

1.80.2

1.80.1

1.80.0

1.79.0

1.78.5

1.78.4

1.78.3

1.78.2

1.78.1

1.78.0

1.77.0

1.76.0

1.75.9

1.75.1

1.75.0

1.74.0

1.73.0

1.72.6

1.72.5

1.72.4

1.72.3

1.72.2

1.72.1

1.71.2

1.71.1

1.71.0

1.70.4

1.70.3

1.70.2

1.70.1

1.70.0

1.69.1

1.69.0

1.68.1

1.68.0

1.67.0

1.66.8

1.66.7

1.66.6

1.66.0

1.65.6

1.65.5

1.65.4

1.65.3

1.65.2

1.65.1

1.65.0

1.64.2

1.64.1

1.64.0

1.63.0

1.62.0

1.61.3

1.61.2

1.61.1

1.61.0

1.60.0

1.59.0

1.58.10

1.58.9

1.58.8

1.58.7

1.58.6

1.58.5

1.58.0

1.57.1

1.57.0

1.56.0

1.55.4

1.55.3

1.55.2

1.55.1

1.55.0

1.54.5

1.54.4

1.54.3

1.54.2

1.54.1

1.54.0

1.53.3

1.53.2

1.53.1

1.53.0

1.52.8

1.52.7

1.52.6

1.52.5

1.52.4

1.52.3

1.52.2

1.52.1

1.52.0

1.51.0

1.50.1

1.50.0

1.49.9

1.49.8

1.49.6

1.49.5

1.49.4

1.49.3

1.49.2

1.49.1

1.49.0

1.48.3

1.48.2

1.48.1

1.48.0

1.47.1

1.47.0

1.46.7

1.46.6

1.46.5

1.46.4

1.46.3

1.46.2

1.46.1

1.46.0

1.45.2

1.45.1

1.45.0

1.44.35

1.44.34

1.44.33

1.43.1

1.43.0

1.42.3

1.42.2

1.42.1

1.42.0

1.41.1

1.41.0

1.40.3

1.40.2

1.40.1

1.40.0

1.39.0

1.38.3

1.38.2

1.38.1

1.38.0

1.37.0

1.36.1

1.36.0

1.35.10

1.35.9

1.35.8

1.35.6

1.35.5

1.35.4

1.35.0

1.34.9

1.34.8

1.34.7

1.34.6

1.34.5

1.34.4

1.34.0

1.33.1

1.33.0

1.32.31

1.32.29

1.32.28

1.32.27

1.32.26

1.32.25

1.32.21

1.32.20

1.32.19

1.32.17

1.32.16

1.32.15

1.32.14

1.32.13

1.32.12

1.32.11

1.32.10

1.32.9

1.32.8

1.32.7

1.32.6

1.32.5

1.32.0

1.31.1

1.31.0

1.30.31

1.30.30

1.30.29

1.30.28

1.30.26

1.30.25

1.30.24

1.30.23

1.30.22

1.30.20

1.30.16

1.30.15

1.30.13

1.30.11

1.30.8

1.30.7

1.30.2

1.30.1

1.30.0

1.29.14

1.29.10

1.29.9

1.29.8

1.29.6

1.29.5

1.29.4

1.29.3

1.29.2

1.29.1

1.29.0

1.28.0

1.27.8

1.27.1

1.27.0

1.26.16

1.26.13

1.26.11

1.26.8

1.26.5

1.26.0

1.25.2

1.25.1

1.25.0

1.24.11

1.24.10

1.24.9

1.24.8

1.24.7

1.24.6

1.24.1

1.24.0

1.23.1

1.23.0

1.22.0

1.21.4

1.21.3

1.21.2

1.21.1

1.21.0

1.20.10

1.20.9

1.20.8

1.20.7

1.20.6

1.20.5

1.20.4

1.20.3

1.20.2

1.20.1

1.20.0

1.19.3

1.19.2

1.19.1

1.19.0

1.18.6

1.18.5

1.18.4

1.18.3

1.18.2

1.18.1

1.18.0

1.17.11

1.17.10

1.17.9

1.17.8

1.17.7

1.17.6

1.17.5

1.17.4

1.17.3

1.17.2

1.17.1

1.17.0

1.16.5

1.16.4

1.16.3

1.16.2

1.16.1

1.16.0

1.15.1

1.15.0

1.14.2

1.14.1

1.14.0

1.13.5

1.13.4

1.13.3

1.13.2

1.13.1

1.13.0

1.12.3

1.12.2

1.12.1

1.12.0

1.11.4

1.11.3

1.11.2

1.11.1

1.11.0

1.10.7

1.10.6

1.9.5

1.8.4

1.7.0

1.6.4

1.5.2

1.4.3

1.3.0

1.2.1

1.1.1

1.0.7

1.0.0

0.21.20

0.20.6

0.19.6

0.18.9

0.17.7

0.16.4

0.15.3

0.13.1

0.12.1

0.11.4

0.10.15

0.9.2

0.8.8

0.7.13

0.6.0

0.5.3

0.4.4

0.3.4

0.2.0

0.1.3

0.1.0

Supported by

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