/* *********************************************************************
   | The Q language - A C++ extension for programming quantum machines |
   | Copyright (C) 2000 2001 2002 2003 Stefano Bettelli                |
   | <bettelli@irsamc.ups-tlse.fr>                                     |
   | See the COPYING and LICENSE files for license terms.              |
   ********************************************************************* */

	This is our implementation of a quantum programming
	language through C++ classes. Not finished yet.
	See the file LICENSE for the license terms.

CREDITS:
	Stefano Bettelli	(coding & design)
	Luciano Serafini	(design - computer science)
	Tommaso Calarco		(design - physics)
	Klaus   Frahm		(circuit for 2-controlled phase gates)
	Alexei  Chepelianskii   (inspiration for the quantum simulator)
	Chris   Lomont          (suggestions and testing)

BUILD:
	Simply type "make". You must have the g++ (or equivalent
	C++ compiler, but you should modify the Makefile) and the
	standard C++ library installed. The output consists in three
	shared libraries "libquantum.so.V", "libqprimitives.so.V"
	and "libqstdlib.so.V" where V is the version number,
	and a test program.

RUN:
	Remember to point dynamic library loader to the correct
	directory, that is, if <DIR> is the directory where
	libquantum resides, type:

	export LD_LIBRARY_PATH=<DIR>

	the run the test program with ./test or compile your own
	classical/quantum program by linking to the library through
	the switches -lquantum -lqstdlib -lqprimitives.
	The test program currently reproduces the oscillations in the
	second picture of quant-ph/0202113 (chaos assisted quantum
	tunnelling in a double well map). If you have gnuplot installed
	you can try with the following command line:
	echo "plot [] [0:1] '< ./test' w lines" | gnuplot -persist

DOCUMENTATION:
	Read lots of comments inside the source files or:

	S.Bettelli, L.Serafini, T.Calarco, 23 Nov 2001,
	"Toward an architecture for quantum programming"
	Eur. Phys. J. D, Vol. 25, No. 2, pp. 181-200 (2003)
	arXiv: cs.PL/0103009, version 3

	Version 0.5.8 of the code is described in S.Bettelli's
	PhD thesis, 18th Feb 2002, University of Trento.

CONTACS:
	(new)	S.Bettelli	Labo de Physique Quantique,
                                IRSAMC, Universite Paul Sabatier,
                                118 Route de Narbonne,
				31062 Cedex Toulouse,
                                Tel.: +33 05 61 55 65 73
                                email: bettelli@irsamc.ups-tlse.fr
	(old)	S.Bettelli	Dipartimento di Fisica,
                                Universita' di Trento,
                                Via Sommarive 14,
                                38050 Povo (Italy),
                                Tel.: +39 461 881504 (Room 1530),
                                Fax: +39 461 881696,
                                email: bettelli@science.unitn.it
                                Also associated to INFN (Istituto Nazionale
                                di Fisica Nucleare), Gruppo Collegato di
                                Trento, Italy,
                                email: bettelli@tn.infn.it.
        	T.Calarco	Institute of Theoretical Physics,
                                Universitat Innsbruck,
                                Technikerstrasse 25,
                                6020 Innsbruck (Austria),
                                Tel.: +43 512 507 6217 (Room 2/03),
                                Fax: +43 512 507 2919,
                                email: Tommaso.Calarco@uibk.ac.at.
                                Also at: ECT*,
                                European Centre for Theoretical Studies
                                in Nuclear Physics and Related Areas,
                                Villa Tambosi, Strada delle Tabarelle 286,
                                38050 Villazzano (Italy),
                                Tel.: +39 0461 314738 (Room I/04),
                                Fax: +39 0461 935007,
                                email: calarco@ect.it
        	L.Serafini	Istituto Trentino di Cultura,
				Istituto per la Ricerca Scientifica
                                e Tecnologica (ITC-IRST),
                                Via Sommarive 18 - Loc. Pant\`e,
                                38050 Povo (Italy),
                                Tel.: +39 461 314319,
                                Fax: +39 461 302040,
                                email: serafini@itc.it
