pyqrack

Downloads Downloads Downloads

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

(PyQrack is just pure Qrack.)

This is the purely CPU-based variant of PyQrack (with module name pyqrack-cpu). This alternate build of PyQrack is provided so that systems that won't use OpenCL or CUDA anyway (such as because they lack any GPUs or other accelerators like the Intel HD) do not need to install the OpenCL library in order to use PyQrack. In this form, both the PyQrack module and the underlying C++ Qrack library are entirely external dependency-free.

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."

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_cpu-2.13.1.tar.gz (67.2 kB view details)

Uploaded Source

Built Distributions

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

pyqrack_cpu-2.13.1-py3-none-win_amd64.whl (827.3 kB view details)

Uploaded Python 3Windows x86-64

pyqrack_cpu-2.13.1-py3-none-manylinux_2_39_x86_64.whl (3.1 MB view details)

Uploaded Python 3manylinux: glibc 2.39+ x86-64

pyqrack_cpu-2.13.1-py3-none-manylinux_2_35_x86_64.whl (3.1 MB view details)

Uploaded Python 3manylinux: glibc 2.35+ x86-64

pyqrack_cpu-2.13.1-py3-none-macosx_15_0_x86_64.whl (2.1 MB view details)

Uploaded Python 3macOS 15.0+ x86-64

pyqrack_cpu-2.13.1-py3-none-macosx_15_0_arm64.whl (1.9 MB view details)

Uploaded Python 3macOS 15.0+ ARM64

pyqrack_cpu-2.13.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_cpu-2.13.1.tar.gz.

File metadata

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

File hashes

Hashes for pyqrack_cpu-2.13.1.tar.gz
Algorithm Hash digest
SHA256 3a6aab73db6fb6c5f228b0dfc2f2acf9d07b3f09cedee0fc3155532bc59e28c6
MD5 36ae78540e1baffe3f5987c0059b7d17
BLAKE2b-256 8fed092286b27e7b69399b3787d0b5d3bc9f219cc7cc1feb9aa1f0b7fd28cd69

See more details on using hashes here.

File details

Details for the file pyqrack_cpu-2.13.1-py3-none-win_amd64.whl.

File metadata

  • Download URL: pyqrack_cpu-2.13.1-py3-none-win_amd64.whl
  • Upload date:
  • Size: 827.3 kB
  • 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_cpu-2.13.1-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 0123a43b65548bae966c554b426b2316275ab4bf718b44577871b00d1b6c10aa
MD5 bc58a995601334045423f5f6840f9b3d
BLAKE2b-256 38c1a82429fd0e2a06e67ffccd9d2408a9cc8cd3edd4084fc25bb91447329718

See more details on using hashes here.

File details

Details for the file pyqrack_cpu-2.13.1-py3-none-manylinux_2_39_x86_64.whl.

File metadata

File hashes

Hashes for pyqrack_cpu-2.13.1-py3-none-manylinux_2_39_x86_64.whl
Algorithm Hash digest
SHA256 c9f0551521a270e0f1355d9d1686cbc38eb08f3fd882130f5a68c98b60873069
MD5 c7c6e4c946115a801f464349ba8141f5
BLAKE2b-256 417f8fd3f7d730ad260f931ffa2daea3b21871a987880b9691693545c7394778

See more details on using hashes here.

File details

Details for the file pyqrack_cpu-2.13.1-py3-none-manylinux_2_35_x86_64.whl.

File metadata

File hashes

Hashes for pyqrack_cpu-2.13.1-py3-none-manylinux_2_35_x86_64.whl
Algorithm Hash digest
SHA256 1f07c2e3eb3d8f5b88e2643c446b9b9d4f172193248d153ce8a900d353cf9516
MD5 0d1ec248cdbd7c64bc3036e27ac8e9c8
BLAKE2b-256 6c4fd33040a6ae3d5cd10c4409a1ed140e354d32397351b837312ee759bd9e3f

See more details on using hashes here.

File details

Details for the file pyqrack_cpu-2.13.1-py3-none-macosx_15_0_x86_64.whl.

File metadata

File hashes

Hashes for pyqrack_cpu-2.13.1-py3-none-macosx_15_0_x86_64.whl
Algorithm Hash digest
SHA256 494e860dcdfae2e372f20439d77a69c71549e44514e062ad519c8d1307de9c25
MD5 27db1b4e590a5e631ca7e832cfc9e011
BLAKE2b-256 73d43d408edd9895b7e952a5e9095929bd7ad70229e5b4a8f9bc0aafc8ef6676

See more details on using hashes here.

File details

Details for the file pyqrack_cpu-2.13.1-py3-none-macosx_15_0_arm64.whl.

File metadata

File hashes

Hashes for pyqrack_cpu-2.13.1-py3-none-macosx_15_0_arm64.whl
Algorithm Hash digest
SHA256 4aadc4c95177c45a339c833323571d5303629bc67c28e4a3329ba36f6db65ba9
MD5 8d82b21023db94ebdc96cf0b34e24515
BLAKE2b-256 234bab392774a9b9219d6fbda46481607925aabb14441a317b20673d10d2f8a8

See more details on using hashes here.

File details

Details for the file pyqrack_cpu-2.13.1-py3-none-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for pyqrack_cpu-2.13.1-py3-none-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 d7750888f2b52727405568d2982843e607c60542e910481599012da85f2246b0
MD5 ec9746afd66a53c245f098fe027fb10d
BLAKE2b-256 f9c1b971e68ac0d1b9bbb362ac585907ad3eccca076f12ac09367bb2b51cb9a7

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

This release

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.4 yanked

Reason this release was yanked:

Empirical results are worse

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.44.32

1.44.31

1.44.30

1.44.29

1.44.28

1.44.27

1.44.26

1.44.25

1.44.24

1.44.23

1.44.22

1.44.21

1.44.20

1.44.19

1.44.18

1.44.17

1.44.16

1.44.15

1.44.14

1.44.13

1.44.12

1.44.11

1.44.10

1.44.9

1.44.8

1.44.7

1.44.6 yanked

Reason this release was yanked:

Potential segfault in mid-circuit measurement

1.44.5

1.44.4

1.44.3

1.44.2

1.44.1

1.44.0

1.43.1

1.43.0

1.42.3

1.42.2

1.42.1

1.42.0

1.41.1

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.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.18 yanked

Reason this release was yanked:

1.32.17 is correct! The erata Qrack commit bc1d5d8 was unnecessary.

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

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