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.6.1.tar.gz (62.6 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.6.1-py3-none-win_amd64.whl (995.0 kB view details)

Uploaded Python 3Windows x86-64

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

Uploaded Python 3manylinux: glibc 2.39+ x86-64

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

Uploaded Python 3manylinux: glibc 2.35+ x86-64

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

Uploaded Python 3macOS 15.0+ x86-64

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

Uploaded Python 3macOS 15.0+ ARM64

pyqrack-2.6.1-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.6.1.tar.gz.

File metadata

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

File hashes

Hashes for pyqrack-2.6.1.tar.gz
Algorithm Hash digest
SHA256 432ed78295ea4c2ffe6c93576dc81113c323e676eac3adb74c2dae7a01e62d76
MD5 7c9d507cab3f3e5b0fe3155c3e40a341
BLAKE2b-256 f2f4aa8a08a122a8e6fffb86122845cffc197809d9a924d27e42e514bed11249

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyqrack-2.6.1-py3-none-win_amd64.whl
  • Upload date:
  • Size: 995.0 kB
  • 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.6.1-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 d79881caa52f559fe86aed96553465c29476a19ab6e202bc1e0436e203d9ffe1
MD5 91197a2bd75b6febf3c5575e1551d7f8
BLAKE2b-256 d8641ffc1081ec9f56294b5e09df49d4597956ae03949bbb55182db56ef7f89a

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.6.1-py3-none-manylinux_2_39_x86_64.whl
Algorithm Hash digest
SHA256 cfb2cd74b2d0701faff84070104f7eacde01c92c17beedf2c5e3719feb36431f
MD5 d07ad001f12492e13f0a48e354d38f8f
BLAKE2b-256 886a933c20aa4f73310de56406451c46232ca18b9d2ab31527e29a8e5b3ea169

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.6.1-py3-none-manylinux_2_35_x86_64.whl
Algorithm Hash digest
SHA256 6dd441bacca4501b231975305d4e69db039bfba0557f0422c32a6fdd17bcf246
MD5 51605d211327a9979e262c1cba65e6ba
BLAKE2b-256 474192e17345cec831072f89f9b4f6a53c25f100a75b82f6135342e9d5ce9064

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.6.1-py3-none-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 24ec017d6aa678c578736d9f201ba481b6d2fbd4b5d7e836fdda359fda6c6d71
MD5 c5d230cc61b8ada19b64f0f0d919733e
BLAKE2b-256 b4a306f5c5fef47ee9566c8cc3c9410486b5743bff535854ab3bfbcbb65b2b66

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.6.1-py3-none-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 7f077ee5b0c8f9133c649deeeee7f3aba43945beae3ba59e203808fec7edc5cd
MD5 47265c71ce9f6486b10dd57e68ea0c3d
BLAKE2b-256 61d488fa3b3cb94453a8a4fe50ab3aca1432084e42a4b54cdc37badd10eea583

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.6.1-py3-none-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 f7394fb2cf91a2412bccf91b5a4a69b71e943bf5c5fa3ea5bef87d8c99de59a6
MD5 f96f0fd9052929e730e3fe939e0c88b3
BLAKE2b-256 e01cbe34e6e145d2e5799f63c345ab3d93ba5552514d18d8461f2762852b1e06

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

2.9.0

2.8.0

2.7.1

2.7.0

This release

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