Southampton Wireless Group - Resources

Using Matlab on Lyceum4

rm — Wed, 08 Jul 2009 09:45:45 +0000

Lyceum4 is a cluster of Linux computers that students can use in their Matlab projects.

1a. Uploads, downloads and logging in on Linux or Mac computers

You can upload a file by opening a terminal program and using the command

scp <SourcePath&FileName> <YourUserName>@iridis4_a.soton.ac.uk:<DestinationPath&FileName>

Note that it is your iSolutions password that you need to input when prompted. For example, I might type

scp main.m rm@iridis4_a.soton.ac.uk:MySimulations/BPSKinAWGN/

You can download using the command

scp <YourUserName>@iridis4_a.soton.ac.uk:<SourcePath&FileName> <DestinationPath&FileName>

and you can log in using the command

ssh -X <YourUserName>@iridis4_a.soton.ac.uk

Again, it is your iSolutions password that you need to input when prompted.

1b. Uploads, downloads and logging in on Windows computers

You can upload and download files using PSCP. You should save this to your My Documents folder. Next, you should open a command window by clicking Start, then Run... and then typing

cmd

You can change to your My Documents folder by typing

cd "My Documents"

You can upload a file by typing

pscp <SourcePath&FileName> <YourUserName>@iridis4_a.soton.ac.uk:<DestinationPath&FileName>

Note that it is your iSolutions password that you need to input when prompted. For example, I might type

pscp main.cpp rm@iridis4_a.soton.ac.uk:MySimulations/BPSKinAWGN/

You can download using the command

pscp <YourUserName>@iridis4_a.soton.ac.uk:<SourcePath&FileName> <DestinationPath&FileName>

In order to log in to Lyceum4, you need to save PuTTY to your My Documents folder. From within the My Documents folder in the command window, you should type

putty <YourUserName>@iridis4_a.soton.ac.uk

Again, it is your iSolutions password that you need to input when prompted. You can find out more about PuTTY and PSCP here.

2. Installing the Matlab project template on Lyceum4

The first step is to log in to Lyceum4 and then download the Matlab project template. You can do this by giving Lyceum4 the command

wget http://users.ecs.soton.ac.uk/rm/MatlabLyceumProject.tgz

You can extract the template by typing

tar -xzvf MatlabLyceumProject.tgz

This will create a directory named MatlabLyceumProject, which you should go into by typing

cd MatlabLyceumProject

If you type

ls

you'll see that the MatlabLyceumProject directory contains a job file and a couple of Matlab files. You can edit main.m using the emacs editor by typing

emacs main.m

3. Running jobs on Lyceum4

Once you have written your Matlab code, you can get Lyceum4 to run it by submitting a job file. The Matlab project template includes an example job file called 'job', which you can edit using the command

emacs job

from within the MatlabLyceumProject directory. This job file will request sixteen processors on one of Lyceum4's nodes, for one minute. It will run sixteen instances of main.m. You can request a different number of nodes or a different number of processors per node by changing the following line in the job file

#PBS -l nodes=1:ppn=16

Likewise, you can request more than one minute of processor time by changing the following line in the job file

#PBS -l walltime=00:01:00

In the job file, the ampersands (&) at the end of each line that runs the executable are required in order to get them to run in parallel. Each of the sixteen instances uses different command line parameters, which specify the SNRs to consider. The job can be submitted to Lyceum4 by issuing the command

qsub job

from within the MatlabLyceumProject directory. You can see the state of your jobs (Queued or Running) by using the command

qstat

This will tell you the Job ID number, which you need in order to cancel a job using the command

qdel <JobID>

You can see how busy Lyceum4 is using the command

showq

When the example job has finished running, you should find that some results files have been created. You can consolidate these files into one by running the consolidate.m script on Lyceum4's login node. You can do this using the commands

module load matlab
matlab -r "consolidate"

Note that it is okay to run quick scripts like this on the login node. However, long simulations should always be run by submitting them as jobs, as described above.

Have fun, Rob Maunder.

University of Southampton:

Resources

Using IT++ on Lyceum2

rm — Tue, 17 Feb 2009 18:52:20 +0000

Lyceum2 is a cluster of Linux computers for students to use in their projects. You can get more help with using Lyceum2 here. It has version 4.0.6 of the IT++ libraries installed. These libraries provide a number of useful mathematical, signal processing and communication routines. You can find out more about these routines in the IT++ documentation.

1a. Uploads, downloads and logging in on Linux or Mac computers

You can upload a file by opening a terminal program and using the command

scp <SourcePath&FileName> <YourUserName>@lyceum2.soton.ac.uk:<DestinationPath&FileName>

Note that it is your iSolutions password that you need to input when prompted. For example, I might type

scp main.cpp rm@lyceum2.soton.ac.uk:MySimulations/BPSKinAWGN/

You can download using the command

scp <YourUserName>@lyceum2.soton.ac.uk:<SourcePath&FileName> <DestinationPath&FileName>

and you can log in using the command

ssh -X <YourUserName>@lyceum2.soton.ac.uk

Again, it is your iSolutions password that you need to input when prompted.

1b. Uploads, downloads and logging in on Windows computers

You can upload and download files using PSCP. You should save this to your My Documents folder. Next, you should open a command window by clicking Start, then Run... and then typing

cmd

You can change to your My Documents folder by typing

cd "My Documents"

You can upload a file by typing

pscp <SourcePath&FileName> <YourUserName>@lyceum2.soton.ac.uk:<DestinationPath&FileName>

Note that it is your iSolutions password that you need to input when prompted. For example, I might type

pscp main.cpp rm@lyceum2.soton.ac.uk:MySimulations/BPSKinAWGN/

You can download using the command

pscp <YourUserName>@lyceum2.soton.ac.uk:<SourcePath&FileName> <DestinationPath&FileName>

In order to log in to Lyceum2, you need to save PuTTY to your My Documents folder. From within the My Documents folder in the command window, you should type

putty <YourUserName>@lyceum2.soton.ac.uk

Again, it is your iSolutions password that you need to input when prompted. You can find out more about PuTTY and PSCP here.

2. Installing the IT++ project template on Lyceum2

The first step is to log in to Lyceum2 and then download the IT++ project template. You can do this by giving Lyceum2 the command

wget http://users.ecs.soton.ac.uk/rm/itppLyceumProject.tgz

You can extract the template by typing

tar -xzvf itppLyceumProject.tgz

This will create a directory named itppLyceumProject, which you should go into by typing

cd itppLyceumProject

If you type

ls

you'll see that the itppLyceumProject directory contains a Makefile, a job file and three subdirectories. You should write your .cpp and .h files in the src subdirectory. This comes with an example main.cpp to get you started. You can edit this using the emacs editor by typing

emacs src/main.cpp

3. Compiling on Lyceum2

When logged on to Lyceum2, you can compile your code using the commands

module load itpp
make

from within the itppLyceumProject directory.

4. Running jobs on Lyceum2

Once you have compiled your code, you can get Lyceum2 to run it by submitting a job file. The IT++ project template includes an example job file called 'job', which you can edit using the command

emacs job

from within the itppLyceumProject directory. This job file will request eight processors on one of Lyceum2's nodes, for one minute. It will run eight instances of the executable a.out, which is created in the bin directory when the example main.cpp is compiled. In the job file, the ampersands (&) at the end of each line that runs the executable are required in order to get them to run in parallel. Each of the eight instances uses different command line parameters, which specify the SNRs to consider. The job can be submitted to Lyceum2 by issuing the command

qsub job

from within the itppLyceumProject directory. You can see the state of your jobs (Queued or Running) by using the command

qstat

This will tell you the Job ID number, which you need in order to cancel a job using the command

qdel <JobID>

You can see how busy Lyceum2 is using the command

showq

When the example job has finished running, you should find that some results files have been created in the itppLyceumProject directory.

There is more information on how to run jobs on Lyceum2 here.

Note that simulations should always be run by submitting them as jobs. However, it is okay to edit files and compile on the login node. You can also run short programs that collect all your results together into a single file, for example.

Have fun, Rob Maunder.

University of Southampton:

Resources

Useful resources for students, staff and visitors

admin — Tue, 14 Oct 2008 17:09:09 +0000

Using IT++ in the students computer room
Using IT++ on Lyceum
Using Matlab on Lyceum
Printer setup File needed, right-click to save: KOC360UX.ppd

University of Southampton:

Resources