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 (if you use QNET, please cite our QHDL paper) 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.


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) which is 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.


Please refer to the documentation for information on how to install QNET.


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 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, Nikolas Tezak