Installation and Run Guides
GNU Scientific Library Installation
In order to compile successfully the Quantum Ligth Propagator you must have the GNU Scientific Library installed on your system. If the library is installed on your system you can skip to the next section (Notice that the library is installed on TAMNUN). I recommend to follow the README and INSTALL instructions included with the GSL package since the installation procedure can change in newer versions. The following installation procedure is written for GSL version which I used (2.1 - can be downloaded from Program Files section). Notice - you must have full permissions to /usr/local/lib and /usr/local/include directories on your system in order to properly install the library.
After downloading the GSL follow these steps:
- Change directory to the folder where you downloaded the gsl-2.1.tar.gz file
$ cd Your/Downaload/Dir
- Extarct the archive
$ tar -zxvf gsl-2.1.tar.gz
- Change direcory to the extracted gsl-2.1 folder
$ cd gsl-2.1
- Configure the package
- Compile the package
- Install the package on your system
$ make install
- Optionally, check the installation success
$ make installcheck
If the library was installed sucessfuly you'll find a "gsl" folder at your /usr/local/include folder and libraries named "libgsl" and "libgslcblas" at your /usr/local/lib directory.
Quantum Light Propagator Installation
After downloading the QLP, follow these steps:
- Change directory to the folder where you downloaded the qlp.tar.gz file
$ cd Your/Download/Dir
- Extract the archive
$ tar -zxvf qlp.tar.gz
- Change directory to the qlp folder
$ cd qlp
- Compile (and link) the main program
If the last step succeed you should get an executable named "qlp" in your curent folder.
Quantum Light Propagator Execution
To run the program enter the following command:
Notice - the program requieres 3 input files -
- "PSI.txt" - contains information about the input state to the waveguide array
- "H.txt" - contains the information about the propagation constants and coupling coefficients of the waveguide array
- "Z.txt" - contains the information about the $z$ values at which the intensities and correlations are wished to be calculated
The format of these files is specified in Input Files/Formatting section. Running the program without those input files will run the program with default input (2 photons injeced in the middle of an array of 15 identical "nearest neighbour" coupled waveguides, measured at 100 equaly spaced $z$ values in the range of 0-20)
The output of the main program is written to the file "PROPAGATION_DATA.txt". The format of this file is specified in Output Files/Formatting section.
To generate a gif file from the main program's output enter the following command:
$ make gif
alternatively, run the "make_gif.m" script in MATLAB. The output of this script is a gif file named "PROPAGATION_VIS.gif"