Tools for symbolically analyzing quantum feedback networks.

physics, python, quantum-computing, quantum-mechanics, science
pip install QNET==1.4.3



Build Status Documentation Status

The QNET package is a set of tools created and compiled to aid in the design and analysis of photonic circuit models. Our proposed Quantum Hardware Description Language (cf. QHDL) serves to describe a circuit topology and specification of a larger entity in terms of parametrizable subcomponents. This is strongly analogous to the specification of electric circuitry using the structural description elements of VHDL or Verilog. The physical systems that can be modeled within the framework include quantum optical experiments that can be described as nodes with internal degrees of freedom such as interacting quantum harmonic oscillators and/or N-level quantum systems that, in turn are coupled to a finite number of external bosonic quantum fields.

To get help installing and using QNET, please read this README, visit our homepage which includes the official documentation, sign up to our mailing list, or consult and perhaps contribute to our wiki.

In particular, check out the Roadmap. In the near future, it will be possible to use QNET together with Cirq which allows to edit circuits graphically from within the IPython notebook.


The package consists of the following components:

  1. A symbolic computer algebra package qnet.algebra for Hilbert Space quantum mechanical operators, the Gough-James circuit algebra and also an algebra for Hilbert space Ket-states and Super-operators which themselves act on operators.
  2. The QHDL language definition and parser qnet.qhdl including a front-end located at bin/ that can convert a QHDL-file into a circuit component library file.
  3. A library of existing primitive or composite circuit components qnet.circuit_components that can be embedded into a new circuit definition.


In addition to these core components, the software uses the following existing software packages:

  1. Python version 2.6 or higher. QNET is still officially a Python 2 package, but migration to Python 3 should not be too hard to achieve.
  2. The gEDA toolsuite for its visual tool gschem for the creation of circuits end exporting these to QHDL gnetlist. We have created device symbols for our primitive circuit components to be used with gschem and we have included our own gnetlist plugin for exporting to QHDL.
  3. The SymPy symbolic algebra Python package to implement symbolic 'scalar' algebra, i.e. the coefficients of state, operator or super-operator expressions can be symbolic SymPy expressions as well as pure python numbers.
  4. The QuTiP python package as an extremely useful, efficient and full featured numerical backend. Operator expressions where all symbolic scalar parameters have been replaced by numeric ones, can be converted to (sparse) numeric matrix representations, which are then used to solve for the system dynamics using the tools provided by QuTiP.
  5. The PyX python package for visualizing circuit expressions as box/flow diagrams.
  6. The SciPy and NumPy packages (needed for QuTiP but also by the qnet.algebra package)
  7. The PLY python package as a dependency of our Python Lex/Yacc based QHDL parser.

A convenient way of obtaining Python as well as some of the packages listed here (SymPy, SciPy, NumPy, PLY) is to download the Enthought_ Python Distribution (EPD) or Anaconda which are both free for academic use. A highly recommended way of working with QNET and QuTiP and just scientific python codes in action is to use the excellent IPython shell which comes both with a command-line interface as well as a very polished browser-based notebook interface.


To install QNET you need a working Python installation as well as pip which comes pre-installed with both the Enthought Python distribution and Anaconda. If you have already installed PyX just run: Run:

pip install QNET

If you still need to install PyX, run:

pip install --process-dependency-links QNET


Setting up gEDA/gschem/gnetlist is a bit more involved. To do this, you should download the QNET package manually from github. If you are using Linux or OSX, geda is available via common package managers such as port and homebrew on OSX or apt for Linux.

To configure gEDA to include our special quantum circuit component symbols you will need to copy the following configuration files from the QNET/gEDA_support/config sub-directory to the $HOME/.gEDA directory:

  • ~/.gEDA/gafrc
  • ~/.gEDA/gschemrc

Then install the QHDL netlister plugin within gEDA by creating a symbolic link (or copy the file there) In the shell cd into the QNET directory and then run

ln -s gEDA_support/gnet-qhdl.scm  /path/to/gEDA_resources_folder/scheme/gnet-qhdl.scm

Note that you should replace "/path/to/gEDA_resources_folder" with the full path to the gEDA resources directory!

in my case that path is given by /opt/local/share/gEDA, but in general simply look for the gEDA-directory that contains the file named system-gafrc.

Using QNET in practice

A possible full workflow using QNET is thus:

  1. Use gschem (of gEDA) to graphically design a circuit model.
  2. Export the schematic to QHDL using gnetlist (also part of gEDA)
  3. Parse the QHDL-circuit definition file into a Python circuit library component using the parser front-end bin/
  4. Analyze the model analytically using our symbolic algebra and/or numerically using QuTiP.

This package is still work in progress and as it is developed by a single developer, documentation and comprehensive testing code is still somewhat lacking. Any contributions, bug reports and general feedback from end-users would be highly appreciated. If you have found a bug, it would be extremely helpful if you could try to write a minimal code example that reproduces the bug. Feature requests will definitely be considered. Higher priority will be given to things that many people ask for and that can be implemented efficiently.

To learn of how to carry out each of these steps, we recommend looking at the provided examples and reading the relevant sections in the QNET manual. Also, if you want to implement and add your own primitive device models, please consult the QNET manual.


Hideo Mabuchi had the initial idea for a software package that could exploit the Gough-James SLH formalism to generate an overall open quantum system model for a quantum feedback network based solely on its topology and the component models in analytic form. The actual QNET package was then planned and implemented by Nikolas Tezak. In the Fall of 2015 Michael Goerz joined as a main developer.

In its current form, QNET comprises functionality [1] that goes well beyond what would be necessary to achieve the original goal, but which has proven to be immensely useful. In addition to the authors of the software packages listed under Dependencies that QNET relies on, we would like to acknowledge the following people's direct support to QNET which included their vision, ideas, examples, bug reports and feedback.

  • Michael Armen
  • Armand Niederberger
  • Joe Kerckhoff
  • Dmitri Pavlichin
  • Gopal Sarma
  • Ryan Hamerly
  • Michael Hush

Work on QNET was directly supported by DARPA-MTO under Award No. N66001-11-1-4106. Nikolas Tezak is also supported by a Simons Foundation Math+X fellowship as well as a Stanford Graduate Fellowship.

[1] E.g., all algebras except the operator algebra are not strictly necessary to achieve just the original objective.


QNET is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

QNET is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with QNET. If not, see this page.

Copyright (C) 2012-2016, Nikolas Tezak