-*- outline -*-
* libquantum2005 - A library for emulating a quantum computer.
* ------------------------------------------------------------

  Copyright (C) 2004  The lambda2005 group.

** Basic instructions **

To install libquantum2005, just run:

./configure
make
make install

Please note that you will not be able to use the library or its python
bindings while it is not installed.

** Installation options **

If you  want to install the  library in a specific  directory, you may
call the configure script that way:

./configure --prefix=/path/to/specific/directory

If  you  do  so, do  not  forget  to  set LD_LIBRARY_PATH,  LPATH  and
PYTHONPATH correctly in  order to link with the  library or use python
bindings.

You may also customize your compilation options like this:

./configure CXX=icc CXXFLAGS=-I/usr/local/include

** Examples **

Once  installed,  just  have  a  look at  our  examples  qtm_shor  and
qtm_grover.  You may also test the python bindings:

$ qtm_python
>>> a = reg(15, 4)
>>> a
Register size: 4 qbits.
1 + 0i  (1)     | 1111>
>>> cnot(a, 0, 1)
>>> a
Register size: 4 qbits.
1 + 0i  (1)     | 1110>
>>> toffoli(a, 3, [1, 2, 3])
>>> a
Register size: 4 qbits.
1 + 0i  (1)     | 0110>
>>> walsh(a, 2)
>>> a
Register size: 4 qbits.
-0.5 + 0i       (0.25)  | 0110>
-0.5 + 0i       (0.25)  | 0111>
0.5 + 0i        (0.25)  | 0100>
0.5 + 0i        (0.25)  | 0101>
>>> a.get()
5
>>> a.get()
7
>>> (a * reg(1, 1)) << 1
Register size: 6 qbits.
-0.5 + 0i       (0.25)  | 011010>
-0.5 + 0i       (0.25)  | 011110>
0.5 + 0i        (0.25)  | 010010>
0.5 + 0i        (0.25)  | 010110>

And so on...