Importer for parsing OpenQASM 2 strings into Qiskit circuits

Project description

Importer from OpenQASM 2 to Qiskit

This repository provides the Python package qiskit_qasm2, which provides a fast parser of OpenQASM 2 into Qiskit's QuantumCircuit. It is often 10x or more faster than Qiskit's native parser. The API is simple:

qiskit_qasm2.load takes a filename, and returns QuantumCircuit;
qiskit_qasm2.loads takes an OpenQASM 2 program in a string, and returns QuantumCircuit.

The full documentation is published to https://jakelishman.github.io/qiskit-qasm2.

A simple parsing example:

import qiskit_qasm2
program = """
    OPENQASM 2.0;
    include "qelib1.inc";
    qreg q[2];
    creg c[2];

    h q[0];
    cx q[0], q[1];

    measure q -> c;
"""
qiskit_qasm2.loads(program).draw()

     ┌───┐     ┌─┐
q_0: ┤ H ├──■──┤M├───
     └───┘┌─┴─┐└╥┘┌─┐
q_1: ─────┤ X ├─╫─┤M├
          └───┘ ║ └╥┘
c: 2/═══════════╩══╩═
                0  1

Features

The parser supports almost all of the OpenQASM 2 specification, including:

register definitions and usage (qreg and creg);
the qelib1.inc as a special builtin include, precisely as described in the paper;
general includes, with an option to specify the search path;
custom gate and opaque declarations;
gate, measurement and reset broadcasting;
conditioned gate applications, measurements and reset;
constant folding with the scientific calculator functions in gate parameter lists;
mathematical expressions on parameters within custom gate bodies.

In addition, the parser also includes options to:

modify the search path for include statements in OpenQASM 2;
define overrides for how some named OpenQASM 2 gate applications should be converted into Qiskit form;
define new builtin instructions for OpenQASM 2.

Qiskit's builtin parser makes some extra-spec additions by default, with no option to disable them. This mostly takes the form of custom gate overrides, and various additional gates in Terra's vendored version of qelib1.inc compared to the description in the paper. This parser is more type-safe than Qiskit's, but does include a compatibilty mode to ease the transition from using Qiskit's parser.

Installation

Install the latest release of the qiskit_qasm2 package from pip:

pip install qiskit_qasm2

Developing

If you're looking to contribute to this project, please first read our contributing guidelines.

Set up your development environment by installing the development requirements with pip:

pip install -r requirements-dev.txt tox

This installs a few more packages than the dependencies of the package at runtime, because there are some tools we use for testing also included, such as tox and pytest.

You will also need a working Rust toolchain. The easiest way to install one is by using rustup on Linux, macOS or Windows.

After the development requirements are installed, you can install an editable version of the package with

pip install -e .

After this, any changes you make to the library code will immediately be present when you open a new Python interpreter session.

This package was mostly an excuse for me to learn a bit more about how lexers are written at a low level. This is why the Rust crate doesn't use any lexer-generation libraries. You can read a bit more about the architecture and some of the design decisions in the developer section of the documentation.

Building documentation

After the development requirements have been installed, the command

tox -e docs

will build the HTML documentation, and place it in docs/_build/html. The documentation state of the main branch of this repository is published to https://jakelishman.github.io/qiskit-qasm2.

Code style and linting

The Python components of this repository are formatted using black, and the Rust components with rustfmt. You can run these on the required files by running

tox -e style

The full lint suite can be run with

tox -e lint

License

This project is licensed under version 2.0 of the Apache License.

Project details

Release history Release notifications | RSS feed

0.5.3.1

Apr 11, 2024

0.5.3

Mar 11, 2023

0.5.2

Mar 10, 2023

0.5.1

Mar 10, 2023

0.5.0

Mar 8, 2023

This version

0.4.0

Jan 24, 2023

0.3.2

Jan 23, 2023

0.3.1

Jan 20, 2023

0.3.0

Jan 20, 2023

0.2.0

Jan 9, 2023

0.1.0

Jan 8, 2023

0.0.1

Jan 8, 2023

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qiskit_qasm2-0.4.0.tar.gz (46.3 kB view details)

Uploaded Jan 24, 2023 Source

Built Distributions

qiskit_qasm2-0.4.0-cp311-cp311-win_amd64.whl (252.5 kB view details)

Uploaded Jan 24, 2023 CPython 3.11 Windows x86-64

qiskit_qasm2-0.4.0-cp311-cp311-win32.whl (242.0 kB view details)

Uploaded Jan 24, 2023 CPython 3.11 Windows x86

qiskit_qasm2-0.4.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (701.6 kB view details)

Uploaded Jan 24, 2023 CPython 3.11 manylinux: glibc 2.17+ x86-64

qiskit_qasm2-0.4.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (723.1 kB view details)

Uploaded Jan 24, 2023 CPython 3.11 manylinux: glibc 2.17+ i686 manylinux: glibc 2.5+ i686

qiskit_qasm2-0.4.0-cp311-cp311-macosx_11_0_arm64.whl (352.9 kB view details)

Uploaded Jan 24, 2023 CPython 3.11 macOS 11.0+ ARM64

qiskit_qasm2-0.4.0-cp311-cp311-macosx_10_9_x86_64.whl (361.8 kB view details)

Uploaded Jan 24, 2023 CPython 3.11 macOS 10.9+ x86-64

qiskit_qasm2-0.4.0-cp310-cp310-win_amd64.whl (252.5 kB view details)

Uploaded Jan 24, 2023 CPython 3.10 Windows x86-64

qiskit_qasm2-0.4.0-cp310-cp310-win32.whl (242.0 kB view details)

Uploaded Jan 24, 2023 CPython 3.10 Windows x86

qiskit_qasm2-0.4.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (701.6 kB view details)

Uploaded Jan 24, 2023 CPython 3.10 manylinux: glibc 2.17+ x86-64

qiskit_qasm2-0.4.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (723.1 kB view details)

Uploaded Jan 24, 2023 CPython 3.10 manylinux: glibc 2.17+ i686 manylinux: glibc 2.5+ i686

qiskit_qasm2-0.4.0-cp310-cp310-macosx_11_0_arm64.whl (352.9 kB view details)

Uploaded Jan 24, 2023 CPython 3.10 macOS 11.0+ ARM64

qiskit_qasm2-0.4.0-cp310-cp310-macosx_10_9_x86_64.whl (361.8 kB view details)

Uploaded Jan 24, 2023 CPython 3.10 macOS 10.9+ x86-64

qiskit_qasm2-0.4.0-cp39-cp39-win_amd64.whl (252.6 kB view details)

Uploaded Jan 24, 2023 CPython 3.9 Windows x86-64

qiskit_qasm2-0.4.0-cp39-cp39-win32.whl (242.2 kB view details)

Uploaded Jan 24, 2023 CPython 3.9 Windows x86

qiskit_qasm2-0.4.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (702.1 kB view details)

Uploaded Jan 24, 2023 CPython 3.9 manylinux: glibc 2.17+ x86-64

qiskit_qasm2-0.4.0-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (723.4 kB view details)

Uploaded Jan 24, 2023 CPython 3.9 manylinux: glibc 2.17+ i686 manylinux: glibc 2.5+ i686

qiskit_qasm2-0.4.0-cp39-cp39-macosx_11_0_arm64.whl (353.2 kB view details)

Uploaded Jan 24, 2023 CPython 3.9 macOS 11.0+ ARM64

qiskit_qasm2-0.4.0-cp39-cp39-macosx_10_9_x86_64.whl (362.2 kB view details)

Uploaded Jan 24, 2023 CPython 3.9 macOS 10.9+ x86-64

qiskit_qasm2-0.4.0-cp38-cp38-win_amd64.whl (252.6 kB view details)

Uploaded Jan 24, 2023 CPython 3.8 Windows x86-64

qiskit_qasm2-0.4.0-cp38-cp38-win32.whl (242.3 kB view details)

Uploaded Jan 24, 2023 CPython 3.8 Windows x86

qiskit_qasm2-0.4.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (702.1 kB view details)

Uploaded Jan 24, 2023 CPython 3.8 manylinux: glibc 2.17+ x86-64

qiskit_qasm2-0.4.0-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl (723.4 kB view details)

Uploaded Jan 24, 2023 CPython 3.8 manylinux: glibc 2.17+ i686 manylinux: glibc 2.5+ i686

qiskit_qasm2-0.4.0-cp38-cp38-macosx_11_0_arm64.whl (353.4 kB view details)

Uploaded Jan 24, 2023 CPython 3.8 macOS 11.0+ ARM64

qiskit_qasm2-0.4.0-cp38-cp38-macosx_10_9_x86_64.whl (362.4 kB view details)

Uploaded Jan 24, 2023 CPython 3.8 macOS 10.9+ x86-64

File details

Details for the file qiskit_qasm2-0.4.0.tar.gz.

File metadata

Download URL: qiskit_qasm2-0.4.0.tar.gz
Upload date: Jan 24, 2023
Size: 46.3 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/4.0.2 CPython/3.11.1

File hashes

Hashes for qiskit_qasm2-0.4.0.tar.gz
Algorithm	Hash digest
SHA256	`bf1b8430c2a8ccba7a13b2adb04cddc75e39adc90ffdc86dbe3941d5fc093870`
MD5	`78348e87a3669e149635d002e56a2287`
BLAKE2b-256	`01e831a4f6d858724a41631cbe9b7dfaed21de37554d234ecc1ee0e5c4b9eb4d`

Algorithm	Hash digest
SHA256	`94136024610b065df4c5f74da5c4945c348f994f74bd68909555f3885b67435b`
MD5	`846012cb28d33d3f6e6745dfcdc69c34`
BLAKE2b-256	`c5a3267a6ba078dfe96154fa2ce6ac12ccfb95affd232952b662f60a38c78511`

Algorithm	Hash digest
SHA256	`45d943970acf94823d12e324ae8bad9dbeaa4f9082054c2dcc0defce403226ab`
MD5	`6976067a271d5ea393f0222b467845d0`
BLAKE2b-256	`e153950dfdfc4cd71959efbd0f52f0303b8ffd37dc38fe621b8867f3e9622ce5`

Algorithm	Hash digest
SHA256	`f90b4a6774e3feb7ef3eb1163c38159a30715a189cf132256a45c9cf581ac39d`
MD5	`b7543757b4c6712dbc47865edba44d44`
BLAKE2b-256	`7063ff3c007637da36d99d44813088089883067fcb67106a6d0c47d27e936d9e`

Algorithm	Hash digest
SHA256	`3f17f9607a03d62948be29f91403aa8612ed680e7927e30a19098a22132cde72`
MD5	`41cce97d794ae9af88898dee613ccc1e`
BLAKE2b-256	`1ebe04fd2336a6c448d0961d0bf0cb953b5ef3fc48f310fbf09513a8ede6c005`

Algorithm	Hash digest
SHA256	`614f54b53016068d3835706df984c4c27787606b5e1089f4fd888e0fbbeaeb30`
MD5	`bcdcc24351f8d9dac49fd6ee7996ce9f`
BLAKE2b-256	`10c61c679b13946f842da265a6f987ade0c64f7508703a38665f4b30d5d8f1e7`

Algorithm	Hash digest
SHA256	`b1e4ab4547210de8ce7e6628ff032d94be4d800a98ac054b367cbb7d6643112e`
MD5	`4fffe3d2cc88a9984ea9726026ccfa07`
BLAKE2b-256	`41e73e8bfa368763f0816f7efbb5e5a18473921d5ea8e07fda0ae4e7bd0cc7ff`

Algorithm	Hash digest
SHA256	`bac9a213cf5c4610151fe53dcb2de8bdd62bcf010ad3f7fa5118fff2a2934fdf`
MD5	`8c45e14ec55689b4ff687ac8f49bb5d7`
BLAKE2b-256	`97d1fc7b9c1da9edfe9398bbe394db461f096cf34412044a7775029bed9fff5c`

Algorithm	Hash digest
SHA256	`99ef2c7137997c31a15e735d2b1d26407baabfcd78205a6f4b84ff040a3b622d`
MD5	`36326ca23ce8481b0245d0bd570c54d4`
BLAKE2b-256	`11c7ede45dbfcf771359ae0b1fe02698e953f9545f25e08756debd25eb083c41`

Algorithm	Hash digest
SHA256	`70a8bcbd5181984d53dce6b226743bf91d5de8ed70be91dea31bfac65fca224d`
MD5	`168db41cf377039805538fe29265ce4a`
BLAKE2b-256	`7cd853692bc83fb01b8219bd562f9b24416f1630ba661e1a6956002035218dc2`

Algorithm	Hash digest
SHA256	`59bc1866c917b570a4cf55be136a3a4d0f1531ce72f80d7af0fa53b2ad7bc5b4`
MD5	`5ff3e925ef43d70d6f36e1754bc8cfea`
BLAKE2b-256	`dbf60c2c27745c8a172a4996ee63a20bf39d7e728e0889fbaccc5683b479d04b`

Algorithm	Hash digest
SHA256	`c7cb4e13b6aaa11be8ff3a88e165758c75723da6882fff3985ba3e32c0f746da`
MD5	`073edcc89e87d79a9026ba23856ec870`
BLAKE2b-256	`cc1a26c726e2e3a0f02d71d2c4bd8ca5a9dd405a45d31a78f03826d57d04c09f`

Algorithm	Hash digest
SHA256	`5c2a655d3c5a178ec4d478551894892fa5cc9d1517e3486803710042a653b03d`
MD5	`3ab9b8bd5308fe7d19cfde08d662f939`
BLAKE2b-256	`8010d5135428d0b1b34b80409c2a36724cec8d0695484a5b1841780a691aab48`

Algorithm	Hash digest
SHA256	`dfb5da0a1df8df97b7b9a3dec51aa891032bd4be35727cbaf6c4d1c574f82993`
MD5	`87571ae27b7170a810b5823147adc8b5`
BLAKE2b-256	`bb0b9ac397efab5059f6ca8c44fa04a0fb657fdf693a99582ea429b3984e51e5`

Algorithm	Hash digest
SHA256	`9f38597eee35bf2af1b067943e82719a9dd012d5153de349f89a41eaa50cf281`
MD5	`44ed54987e0f46039d8f6be92ed8d98c`
BLAKE2b-256	`54caebe918a7a7c3a3e853bb4906b1f3272bfc3a1783094dcff308afdb387296`

Algorithm	Hash digest
SHA256	`b8c3abe1cd17704c835087ac92aa34cb2cafbca002a8ea1d5feedf08ff02d408`
MD5	`72c9d51a1116bf622db52b904b776f1e`
BLAKE2b-256	`31b32f95b9465256bfdf4bf58b1e9069a116f6daf2d86c197fcb45b7affbffdd`

Algorithm	Hash digest
SHA256	`019d329026796f1274f2158d1ae9c3fcdc8a82cd68923cc131da7ffc8e966aa5`
MD5	`c21918a425e86b0cdfa1ed3b3ee73027`
BLAKE2b-256	`ddd457c2bebb9bd4681f02cfef0446f5e1c57cc6b2770145e4f616fcab64f51d`

Algorithm	Hash digest
SHA256	`8e8406c736fe467e33598449338817d1bd7260e165ce43f8d6d12fc7a6e65d43`
MD5	`3592dc3f2ea0edb92277a6b47d97f116`
BLAKE2b-256	`4d457b0253e398c12414fec27eae8f2db2de37b9ba3ad986ba3839946ebd61ae`

Algorithm	Hash digest
SHA256	`3706e0941d84e64f2e8dc857bc2808d6178dbb0e3c4077c8922ac6cfe2e88026`
MD5	`eaaf0aafb6af99f367638cc130246beb`
BLAKE2b-256	`e89627e6e6829c8978a0aba904dfdfd9aec4ea08a844773e1cc3a0dd7bae1d43`

Algorithm	Hash digest
SHA256	`996619923403909c5a306c16dfe9e8818335772c7d296afde2c4610959fa1460`
MD5	`997c68a22a68b39c6268772baa14ace0`
BLAKE2b-256	`ef0d35c03e1b1869aef468d1a380af3779622955c31cd9b69a7db37df067c406`

Algorithm	Hash digest
SHA256	`f0420c3c9865a454b9b591d180ef081d48b60530c9afa8c5d2771c09a878bac3`
MD5	`ce9783cf4dbe7f51137bcf4e5b866b21`
BLAKE2b-256	`c5e0567b6ff5bc119d5762dd4901e7df86c387b10a755ecab2cb925b1ee813a6`

qiskit-qasm2 0.4.0

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Project description

Importer from OpenQASM 2 to Qiskit

Features

Installation

Developing

Building documentation

Code style and linting

License

Project details

Verified details

Maintainers

Unverified details

Project links

Meta

Release history Release notifications | RSS feed

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

Algorithm	Hash digest
SHA256	`5658e8cae7d042c961265fc8d281e0f0ebed27530e68cede30986d1c5513623d`
MD5	`4cb1b94efa5431ae0ad88a4e921d0b23`
BLAKE2b-256	`4bceea86750976ee906c750489ae56467523fa70622c2719e52f56eccab27669`

Algorithm	Hash digest
SHA256	`635a8ff23716e07dc56300a6ca89ee28e96fb58ad2ee04a91c82e9870153c283`
MD5	`5a42b5df9892c895fde904947e66c522`
BLAKE2b-256	`dbd27a5539882cd7ab10989890c23b6348ff6bdf23933ec395376a0e6f29e0f5`

Algorithm	Hash digest
SHA256	`39fa3dbd27b98b5870fd9d8c41b649f353ec88d085d804e444832c1d5340c001`
MD5	`f700f95d53e4151ef082c82ea4973f10`
BLAKE2b-256	`129ec5cbfe3db3a1424c40449441996e9b27f0b24074a9e7e357179794250ead`

Algorithm	Hash digest
SHA256	`ae88c036bcd11c73a0657c6f625649544aad23d7c6e151202b6eae561a03d934`
MD5	`057613a0309bf56a0060540567e0f9d1`
BLAKE2b-256	`131e30faee161365520243f0777e15467390ca0812e22650d7a95b6b37e65fde`