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.9.0.tar.gz (62.7 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.9.0-py3-none-win_amd64.whl (1.0 MB view details)

Uploaded Python 3Windows x86-64

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

Uploaded Python 3manylinux: glibc 2.39+ x86-64

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

Uploaded Python 3manylinux: glibc 2.35+ x86-64

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

Uploaded Python 3macOS 15.0+ x86-64

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

Uploaded Python 3macOS 15.0+ ARM64

pyqrack-2.9.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.9.0.tar.gz.

File metadata

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

File hashes

Hashes for pyqrack-2.9.0.tar.gz
Algorithm Hash digest
SHA256 447083c5c816cf6b6e12550be0f3341cf929f495c948d70d2ddcf22144a09ee6
MD5 d0d2109497c64ff3b8090966c13e872f
BLAKE2b-256 d27a4ae90b0d5f60cb18fc78b5ed1ed3313fdc91c0f651bd08e15973ba06e737

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyqrack-2.9.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.14.4

File hashes

Hashes for pyqrack-2.9.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 1ddced62f93a7c7bee220e31d410bab36e2b792067a25ae710c1c82d0dbd5cd9
MD5 15bc3591a312b3a22eeb9bd8a2e020df
BLAKE2b-256 c77f20d64de8642fb89fd2cb343961ef72ac521580d4985e682a4efde079ec63

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.9.0-py3-none-manylinux_2_39_x86_64.whl
Algorithm Hash digest
SHA256 ad92c64726e3281f3da7ddddc33d17ff2345a2e11e34bf4127710e2f77460cc4
MD5 264345500c73dcc5edf64bad30920f8b
BLAKE2b-256 a6c6f7b6d175264b9798d7937376cb3dc5f73591a4724e76c7b0a9795710e731

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.9.0-py3-none-manylinux_2_35_x86_64.whl
Algorithm Hash digest
SHA256 5046059caadd6e91f7ad5608150ebbfffdab8865f5a342f10c9ace185af62c02
MD5 2acf5e28ee404d15048a9e5ffb9d8403
BLAKE2b-256 45f1af082af3dd5f92c5c20dafdce7d7465eeaa098f1d8bc06d97619d711d971

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.9.0-py3-none-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 d82e784717d72e0ce9846f46518bc93417c47ef7e84bf2abe76741bca69ef884
MD5 3567ce1dd8a79267c3497bd394610ed1
BLAKE2b-256 1d6a1c1962ccb7160fa3fadadf569810ee42917b202786ffaf39217d42854139

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.9.0-py3-none-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 3ea3ef95c2871a864722dd57a591d681d81c5e0f1123b64da547923d5a7def1c
MD5 eba63e5bdf0bc1aafb66075418157f90
BLAKE2b-256 b46226134289526bcd4fd89f6c131800a7aa2585f0a639d26fe8d0d6e11df161

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.9.0-py3-none-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 a31ad11d250da9463f4c941633d53ef11e5161837b44dca99a915b9b7349a8d4
MD5 47f5c298846b2a28d5132513548e0565
BLAKE2b-256 2b3e0b1db85c5d7e272f8452ec249a4608021f85569f2ca3f070aef891d4c7a0

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

2.12.0

2.11.1

2.11.0

2.10.1

2.10.0

This release

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