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.15.2.tar.gz (71.3 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.15.2-py313-none-android_16_arm64_v8a.whl (17.0 MB view details)

Uploaded Android API level 16+ ARM64 v8aPython 3.13

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

Uploaded Python 3Windows x86-64

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

Uploaded Python 3manylinux: glibc 2.39+ x86-64

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

Uploaded Python 3manylinux: glibc 2.35+ x86-64

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

Uploaded Python 3macOS 15.0+ x86-64

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

Uploaded Python 3macOS 15.0+ ARM64

pyqrack-2.15.2-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.15.2.tar.gz.

File metadata

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

File hashes

Hashes for pyqrack-2.15.2.tar.gz
Algorithm Hash digest
SHA256 ddb89cd469c42707dd13773fb6c64bcc6c2d08968bfdcdc387f3e7b9a483a8a7
MD5 70bfe12b0c370c5f635ece7e2df86816
BLAKE2b-256 073c9f4a9b74d4ed0f729e324e9cd26c762c8c4b05090b06b960b96ba5d3a46e

See more details on using hashes here.

File details

Details for the file pyqrack-2.15.2-py313-none-android_16_arm64_v8a.whl.

File metadata

File hashes

Hashes for pyqrack-2.15.2-py313-none-android_16_arm64_v8a.whl
Algorithm Hash digest
SHA256 ad019d3651781c20e432d5551ae6da568f1cbcb0df13b1aa1da7133f6513919d
MD5 4815a2cbed78c7ce2c056025c651a224
BLAKE2b-256 de32d36020c5fc6ff971165fd57b71ff4e64edc6cfde072dc9ec2110681aab38

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyqrack-2.15.2-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.15.2-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 d2c338e96fe007f2355d534c28f9a68369e109366fbb7547d720f51750ba5816
MD5 b674ff5d309627feb939da7d41516fd3
BLAKE2b-256 b0354c7b6f3467336a3b8c0f6a587b90083f32cbeb976fbadc3a220534e02a8f

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.15.2-py3-none-manylinux_2_39_x86_64.whl
Algorithm Hash digest
SHA256 b2e2bb3d25dd005d629d006db0418d19f121666d6ed9dfd475e3e76b2d20fb11
MD5 06386e7efa588d23140306012e79801a
BLAKE2b-256 23fb76954e9f5fd5e48c2ed5011eda67d301578ece7c85197b248a7542f25f9e

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.15.2-py3-none-manylinux_2_35_x86_64.whl
Algorithm Hash digest
SHA256 473ec88a287daea302cce64228096b480b1a4eb8b32a24079bdd775e7688e44d
MD5 1957aa370b9d2daecff10da2d9a2087b
BLAKE2b-256 0a290cdd21f3d7ad875c71b9554c125a6edf8dcb634a40b4726e33bace1e0dce

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.15.2-py3-none-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 1fa5533bb2ba57c1cd389d8b788560c7580f15abf53024aa117dea9ef38f7c5a
MD5 432bc1c89fd926fa537fce1f47aaaf50
BLAKE2b-256 869dc4a096144637a437cf6271a6d06d499271705f6bd42273e43e899757a807

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.15.2-py3-none-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 3a05fec1e30067faefbb7c8e917f32546a580c509f3c43628a9c4716c16c95d7
MD5 5d02a8504b3a991b45aa806d6a1108a2
BLAKE2b-256 7eb47a7e43ecc2fda623dce8ad5e91a1a5f39d7fe03e452ac0593d178e40d49a

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.15.2-py3-none-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 49633d14c84c23dcc7d352543d3d675fe3cf9e4790eca3447d38f04522d7e708
MD5 a5b031cb4b957c266f5d4857c54230c9
BLAKE2b-256 c7b026b3ed7f27cf597f377a243d5657175b8f0dba4fb956742c1d8a78be72af

See more details on using hashes here.

Release history Release notifications | RSS feed

2.17.2

2.17.1

2.17.0

This release

2.15.2

2.15.1

2.15.0

2.14.0

2.13.2

2.13.1

2.13.0

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