Package: qupulse
qupulse: A Quantum compUting PULse parametrization and SEquencing frameworkThe qupulse project aims to produce a software toolkit facilitating experiments involving pulse driven state manipulation of physical qubits.It provides a high-level hardware-independent representation of pulses as well as means to translate this representation to hardware-specific device instructions and waveforms, execute these instructions and perform corresponding measurements.Pulses can be assembled from previously defined subpulses, allowing easy construction of high-level from low-level pulses and re-use of previous work.
Additionally, all pulses are parameterizable allowing users to fine-tune and adapt pulse templates to specific hardware or functionality without redefining an entire pulse sequence. To ensure meaningful parameter values, constraints can be put on parameters on a per-pulse basis.Status and stabilityThe qupulse library is used productively by the Quantum Technology Group at the 2nd Institute of Physics at the RWTH Aachen University. As such, some features - such as pulse definition - are mostly complete and tested and interfaces are expected to remain largely stable (or changes to be backward compatible). A key goal is that experiments should be repeatable with new versions of qupulse.
However, it is still possible for existing portions of the code base to be redesigned if this will increase the usability long-term.The current feature list is as follows:Definition of complex (arbitrarily deep nested and looped pulses) parameterized pulses in Python (including measurement windows)Mathematical expression evaluation (based on sympy) for parameter values and parameter constraintsSerialization of pulses (to allow storing into permanent storage)Hardware model representationHigh-level pulse to hardware configuration and waveform translation routinesHardware drivers for Tabor Electronics, Tektronix and Zurich Instruments AWGs and AlazarTech DigitizersMATLAB interface to access qupulse functionalityPending changes are tracked in thechanges.dsubdirectory and published inRELEASE_NOTES.rston release using the tooltowncrier.Installationqupulse is available onPyPiand the latest release can be installed by executing:python-mpipinstallqupulse[default]which will install all required and optional dependencies except for hardware support. qupulse version numbers follow theSemantic Versioningconventions.Alternatively, the current development version of qupulse can be installed by executingpython-mpipinstall-egit+https://github.com/qutech/qupulse.git#egg=qupulse[default]which will clone the github repository to./src/qupulseand do an editable/development install.Requirements and dependenciesqupulse requires at least Python 3.8 and is tested on 3.8, 3.9 and 3.10. It relies on some external Python packages as dependencies.
We intentionally did not restrict versions of dependencies in the install scripts to not unnecessarily prevent usage of newer releases of dependencies that might be compatible. However, if qupulse does encounter problems with a particular dependency version please file an issue.The backend for TaborAWGs requires packages that can be foundhere. As a shortcut you can install it from the python interpreter viaqupulse.hardware.awgs.install_requirements('tabor').The data acquisition backend for AlazarTech cards needs a package that unfortunately is not open source (yet). If you need it or have questions contactsimon.humpohl@rwth-aachen.de.DocumentationYou can find documentation on how to use this library onreadthedocsandIPython notebooks with examples in this repo. You can build it locally withpython setup.py build_sphinx.Folder StructureThe repository primarily consists of the foldersqupulse(toolkit core code) andtests(toolkit core tests). Additional parts of the project reside inMATLAB(MATLAB interface) anddoc(configuration and source files to build documentation)qupulsecontains the entire Python source code of the project and is further partitioned the following packages of related modulespulseswhich contains all modules related to pulse representation.hardwarecontaining classes for hardware representation as well as hardware driversutilscontaining miscellaneous utility modules or wrapping code for external libraries_programcontains general and hardware specific representations of instantiated (parameter free) pulses. It is private because there is no stability guarantee.Contents oftestsmirror the structure ofqupulse. For every<module>somewhere inqupulsethere should exist a<module>Tests.pyin the corresponding subdirectory oftests.