<?php include("thintable.php"); ?>
<html>
<head>
</head>
<body bgcolor=white link=blue alink=blue vlink=blue>
<h2>Adaptive Reading Agent (Reinforcement Learning)</h2>
<table border=0>
<tr>
<td width=500>
<b>Replicating Reichle & Laurent (2006)</b>
<P>

In Reichle & Laurent (2006), we instantiated some very simple assumptions about saccadic eye movements in order to observe the kinds of eye movement behavior that emerge when an agent is given the task to read as efficiently as possible.  
<P>
<b>Requirements</b>

<ul>
<li>Simulator binaries: <a href=http://rl.pakl.net/rev67/RLFramework.jar>RLFramework.jar</a></li>
<li>Simulation settings: <a href=http://rl.pakl.net/RL2006.zip>RL2006.zip</a></li>
</ul>
<font size=-1>(Links to other files: <a href=http://rl.pakl.net/rev67/RLFramework_Source.zip>source code</a> -- <a href=http://rl.pakl.net/rev67/javadoc>JavaDoc</a> --  <a href=http://rl.pakl.net/rev67/NeuralNet_Source.zip>neural network lib source code</a>)</font>
<P>
When you unzip RL2006.zip, you will find the following directory structures:<P>

<?
echo thintable("
<pre>

     Sim1/     (no saccadic error)        
           01
           02
           ...
           20
     Sim2/     (saccadic error)
           01
           02
           ...
           20

</pre>
");
?>

<P>
Each directory contains a <i>reading.prop</i> file which specifies settings for a single-sentence simulation.  To run a simulation, place RLFramework.jar on your CLASSPATH, change into one of the subdirectories, and execute the simulator.  For example:
<P>
<?
echo thintable("
<pre>

$ export CLASSPATH=~/Desktop/RLFramework.jar
$ cd Sim1/01
$ java org.eyelanguage.rl.ReadingMain >& log.txt    

</pre>
");
?>
<P>
If you get an OutOfMemoryError, increase the memory that Java is permitted to use:
<P>
<?
echo thintable("
<pre>

$ java -Xmx700m org.eyelanguage.rl.ReadingMain >& log.txt   

</pre>
");
?>
<P>
The output (which is stored to log.txt) will contain the sequences of actions selected by each agent.  For example, "ReqSacc3" means that the agent requested a saccade of 3 character spaces at that point in time.

<P>
In order to convert the output into a format suitable for analysis in another program such as Excel, you may use:
<P>
<?
echo thintable("
<pre>

$ java org.eyelangauge.rl.analysis.LogAnalyzer log.txt > excelready.txt   

</pre>
");
?>

</td></tr></table>
<hr>
Updated: Apr 25, 2011 -- questions? float-at-pakl dot net

</body>
</html>
