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

Uploaded Android API level 16+ ARM64 v8aPython 3.13

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

Uploaded Python 3Windows x86-64

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

Uploaded Python 3manylinux: glibc 2.39+ x86-64

pyqrack-2.17.1-py3-none-manylinux_2_35_x86_64.whl (3.8 MB view details)

Uploaded Python 3manylinux: glibc 2.35+ x86-64

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

Uploaded Python 3macOS 15.0+ x86-64

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

Uploaded Python 3macOS 15.0+ ARM64

pyqrack-2.17.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.17.1.tar.gz.

File metadata

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

File hashes

Hashes for pyqrack-2.17.1.tar.gz
Algorithm Hash digest
SHA256 26592050153f97e2ab38614d7d6042b2292beacf1f4f7fe63a9e157cf41b795d
MD5 2dde70b7ec07f9f61518a5a394978efd
BLAKE2b-256 01b21840680c12155f53a3cf808ea28b64ed8c9787fd9fcc42f672e482cbf2f5

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.17.1-py313-none-android_16_arm64_v8a.whl
Algorithm Hash digest
SHA256 a81bc03885eaa802062a234c9d0cbf693553e70c123b8be1ce09615668e1c8b0
MD5 d86d4a86b4c511d93b06632c15dd7663
BLAKE2b-256 e56251523a2e6d0a87545be071b9d4c0767df65c9762fabde1fcc5b5ef0e7cce

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyqrack-2.17.1-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/7.0.0 CPython/3.14.4

File hashes

Hashes for pyqrack-2.17.1-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 20a1ad1df021f2f26bf5aa70813565287494210094bf1f30f001c283271b7594
MD5 856bc16138654f249ca9bbf029bbc7e3
BLAKE2b-256 d2b407b4c6f580c62b2bc13105218486fe3d8b36ecfe9aff51939769d7c6d7f8

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.17.1-py3-none-manylinux_2_39_x86_64.whl
Algorithm Hash digest
SHA256 e3992bb27c1b9fb4aa3bcbd88219c8cf4bd5b0b264fbc0f2a4f67528578b3971
MD5 96ba44ac4c6ed2631e4748453198f9a0
BLAKE2b-256 b02270c349c75326c99c083ca46b796e363928822423f0dd5f9a38335316fbe4

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.17.1-py3-none-manylinux_2_35_x86_64.whl
Algorithm Hash digest
SHA256 f679b71c48552f482144c706a4d7a21564166b62c1e8def0e14841ca5b3b4680
MD5 8f1f48b3edb9c2ecceb18116efcb77cc
BLAKE2b-256 0866f842986926c8aa8d64b70c4d20d9a15d961ac699ab9a9bcd589d60d91568

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.17.1-py3-none-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 bc6541c2d97ac15152374f717e27ce8f1587018698366f97abaca84bcdf98f88
MD5 848c723a7d1230e53f348cc069e23775
BLAKE2b-256 4c4488646e1905c91b2fa864b8c7558c20d18b1f609bbf3683ed60814a412a67

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.17.1-py3-none-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 d99fa68cf276cfc09a7964f0a6a309e55ec5a8c15bdf0d96843f644ede866e2d
MD5 fbf783d3ee3e57ba00092c6544b1aaa2
BLAKE2b-256 0dfca3401ec3ea93e9395b6bee712c02702e1966d9fb55f8683f95294a191ecb

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for pyqrack-2.17.1-py3-none-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 be9fe8c11f11cfd6721ce2d59b501c4262afea4172d8a07a156c530363676855
MD5 6a78dbc6f30892f8b8ddb9548932a013
BLAKE2b-256 c7e5ca4be6872395bfe1a93e42c632901274de7929fea893489572bc843f0235

See more details on using hashes here.

Release history Release notifications | RSS feed

2.17.2

This release

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

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