LCEE Tutorial     index     one     two     three

## Getting started.

• The following html pages have been prepared for Linux users. However, it is possible using the 'wget' application under windows to get things to work just as well.
• These pages will show you how to migrate from m-file scripts that use the wave equation maths to using m-file scripts that utilise the 'LCEE online engine' which can crunch through 5.5 *10^7 iterations per seconds reducing the overall time from several hours to several seconds.
• Before we start, please check to see if the LCEE engine is online, make sure you get a response with a build date and version number, if there is no response or you see an error, please be patient as the site may be down while undergoing maintenance.
• Assuming LCEE is live, Please open a bash terminal, navigate to a clean working directory (A temporary sandpit for the duration of these tutorials) which can be removed when you finish the last page. Now type the following into the terminal. (you can copy & paste but remember not to include the hash!)

•  # wget http://www.buzwordsalad.com/mfile/www_compare.m

which will download an octave m file which will create a mesh plot, as an alternative, there is a simpler and less cpu intensive version called 'www_compare_sc.m' which you can replace in the wget system call above, now fire up octave by typing the following into the terminal.

 # octave

When the Octave terminal is ready to go, simply execute the m-file by typing

 www_compare

This will begin the first 12288 iterations of Langtons ant and will take 'Octave' about twenty seconds to compute the 'Binary' and 'Occupancy matrix', after which you will see four graphs appear on the desktop.

Figures 1,2 are created by the Octave maths, figures 3,4 are from the LCEE online engine). Figures 1 and 3 are the BINARY lattice (black and white squares which determine rotation). Figures 2 and 4 are the occupancy plot, the taller the spike the more repeat visits there have been on that square, see video's of see mesh and heat map

The plots above are the clasic langtons ant image with the 104 highway, now we will increase the number of iterations and since we are on a bounded surface you can witness what happens when the highway wraps around and re visits the starting square.
To do this we will modify the www_compare.m file by changing the iteration count from 12288 to 131072, this has already been done for you so lets download it, please quit from octave by typing the following

 exit

Now the graphs should have gone and you should be back at the terminal, type in the following to download a new m file and also fire up octave.

 # wget http://www.buzwordsalad.com/mfile/www_lcee_131072.m     # octave

Now execute the new m file and see how quickly it runs.

 www_lcee_131072

Which will produce the following graphs.

Now edit the www_lcee_131072.m file by typing.

 # gedit www_lcee_131072.m &

Now change the '00020000' to '00780000' and save the changes to disk. (these are base 16 'hexadecimal' numbers where 00003000=12,288 and 00020000=131072 and 00780000=7,864,320 in decimal, so the new system call should like like this.

 system ("wget 'http://buzwordsalad.com/lcee/elsee.sh?-d 2 -xy 8050 -g 00780000 -f 0001' -O report.html");

If you prefer working in decimal, there is an alternate system call,

 system ("wget 'http://buzwordsalad.com/lcee/dec_elsee.sh?-d 2 -xy 128,80 -g 7864320 -f 1' -O report.html");

Copy paste this new system call into the current mfile or get a new m-file here
Both of the system calls above, do the same thing.

Leave the 'text editor' open and fire up octave again

 # octave

Execute the script
 www_lcee_131072

Which will plot the following graph. ( Click here to open a new page and see a selected range of plots)

Now change the '780000'in the m-file back to '3000' and note the -g just before it, the -g tells LCEE that it must iterate the following 32 bit number of times hence the 8 digit hexadecimal number, if you look further left you will see '-xy 8050' which tells LCEE where to start the Ant in the matrix, currently this is 80 (128 decimal) across and 50 (80 decimal) down. So lets set this to zero origin by editing the system call so it looks like this.

 system ("wget 'http://buzwordsalad.com/lcee/elsee.sh?-d 2 -xy 0000 -g 00003000 -f 0001' -O report.html");

Save the changes and execute the m-file, this will cause the plot to exist on all four corners since on a bounded surface they are right next to each other.

Now put the xy position back to 8080 and change the direction -d to 0 (0,1,2,3 = North, East, South and West), save the changes and execute the m file, also point your web browser to the directory where the m-file exists and open the 'REPORT.HTML' file which reports the xy position of the last step the ANT took, the final direction and a 48 bit count of the total iterations achieved.

 system ("wget 'http://buzwordsalad.com/lcee/elsee.sh?-d 0 -xy 8080 -g 00003800 -f 0001' -O report.html");

This is how my screen looks after the execution of the script.

• Top left is the binary matrix plot, this is a coiled up (wrapped around) a flat toroidal surface with ALL the elements of Psi_d, note that this is a binary matrix and contains 8 bit signed integers of 1 and -1 which gives an unsigned value of 1 and 255 respectively)
• Top middle is the occupancy matrix, this does not exist in the basic Langtons ant wave equation but it does exists in the extended Langtons ant wave equation, it is a surface amplitude plot of the number of visits to each unique square on the binary lattice thus each element in the binary matrix can be calculated by [Psi_d(N) = (-1)^O(N)] where N= the element number in the matrix ExE
• Top right is the fantastic Octave terminal where you can see all the reporting from the wget system call
• Bottom left is a firefox browser showing the output from the LCEE online engine, what we need to see here is the word 'Success' which means NO errors were found and the data is GOOD.
• Bottom middle is the files in the sandpit directory where you are working.
• Bottom right is the TEXT EDITOR with the m-file open where you can see the system call on line 14.

• Now lets rotate again, this time we will choose 5 as our new starting direction to demonstrate how errors are reported, so type in the following

 system ("wget 'http://buzwordsalad.com/lcee/elsee.sh?-d 5 -xy 8080 -g 00003800 -f 0001' -O report.html");

Save the changes and execute the m-file which will report the following error from within octave.

 error: reshape: can't reshape 1x0 array to 256x256 array     error: evaluating argument list element number 1   error: called from:   error: /home/dakoder/demo/lcee_online.m at line 32, column 1

To understand what went wrong, simply refresh or open the 'report.html' file (you will find it in your current octave working directory). Once opened you will see the following error.

5,
Initial direction invalid [0=UP, 1=RIGHT, 2=DOWN, 3=LEFT]

Now put the -d switch back to 0 and save the changes.

There are two more m-files which are exclusive to the 'Binary matrix' and 'Occupancy matrix' creation.