46d9671e05
tutorial/html dir to doc/ dir: it's simpler, and I was not able to do the same thing in Windows anyway!
531 lines
30 KiB
HTML
531 lines
30 KiB
HTML
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
|
<meta name="GENERATOR" content="Mozilla/4.75 [en] (X11; U; Linux 2.2.17-21mdksmp i686) [Netscape]">
|
|
<title>Tutorial: Lesson 3</title>
|
|
</head>
|
|
<body text="#000000" link="#0000EE" vlink="#551A8B" alink="#FF0000" background="beige009.jpg">
|
|
<a href="eoLesson2.html">Lesson 2</a> -
|
|
<a href="eoLesson4.html">Lesson
|
|
4</a> -
|
|
<a href="eoTutorial.html">Main page</a> -
|
|
<a href="eoTopDown.html">Top-Down</a>
|
|
- <a href="eoBottomUp.html">Bottom-up</a> - <a href="eoProgramming.html">Hints</a>
|
|
- <b><font face="Arial,Helvetica"><a href="../../doc/html/index.html">EO documentation</a></font></b>
|
|
<br>
|
|
<hr WIDTH="100%"><!-- -------------- End of header ------------------ --><!-- ----------------------------------------------- -->
|
|
<center>
|
|
<h1>
|
|
<font color="#FF0000">Tutorial Lesson 3: input/output</font></h1></center>
|
|
In this lesson, you will still use the same Evolutionary Algorithm, BUT
|
|
in a much more <b><font color="#FF6600">user-friendly</font></b> way. You
|
|
will discover how to
|
|
<ul>
|
|
<li>
|
|
<a href="#parser">input parameters</a> on the command-line or from a text
|
|
file</li>
|
|
|
|
<li>
|
|
<a href="#state">save</a> the population to disk, together with every part
|
|
of the algorithm you could think of - so you can decide to <font color="#FF6600">reload</font>
|
|
everything later to continue the same run, eventually with different parameters.</li>
|
|
|
|
<li>
|
|
<a href="#stats">generate statistics</a> on the populations, and <a href="#monitor">output
|
|
them</a> to the screen, text or graphic, or to a file (or to any other
|
|
device you might want to use).</li>
|
|
</ul>
|
|
First, but you should now have done it without being told, go into the
|
|
<font color="#FF6600">Lesson3
|
|
sub-dir</font> of the tutorial dir and type
|
|
<b><tt><font color="#990000"><font size=+1>make</font></font></tt></b>.
|
|
This will compile the <b><tt><font color="#660000"><font size=+1>SecondBitEA</font></font></tt></b>
|
|
program (and, some day, SecondRealEA).
|
|
<p>You can then either
|
|
<ul>
|
|
<li>
|
|
browse the corresponding code (only <a href="SecondBitEA.html">SecondBitEA</a>
|
|
available right now, but you can figure out how SecondRealEA will look
|
|
like),</li>
|
|
|
|
<li>
|
|
look at the <a href="#changes">summary of changes</a>,</li>
|
|
|
|
<li>
|
|
or find out directly explanations about the new features: the <a href="#parser">eoParser</a>,
|
|
<a href="#state">eoState</a>
|
|
and <a href="#checkpoint">eoCheckpoint</a> classes.</li>
|
|
</ul>
|
|
|
|
<p><br>
|
|
<hr WIDTH="100%">
|
|
<br><a NAME="changes"></a><b><font color="#000099"><font size=+2>Changes</font></font></b>
|
|
<br><font color="#000000">As already said, the behavior of the algorithm
|
|
will be exactly the same as the previous one as far as optimization is
|
|
concerned. Only the input (of algorithm parameters) and output (of program
|
|
results) will be very different.</font>
|
|
<br><font color="#000000">Hence, the sections corresponding to the <a href="SecondBitEA.html#eval">fitness
|
|
function</a>, the <a href="SecondBitEA.html#init">initialization</a>, the
|
|
<a href="SecondBitEA.html#operators">variation
|
|
operators</a>, the <a href="SecondBitEA.html#engine">evolution engine</a>
|
|
and the <a href="SecondBitEA.html#generation">algorithm</a> itself are
|
|
almost identical (apart from variable name changes).</font>
|
|
<ul>
|
|
<li>
|
|
<font color="#000000"><a href="SecondBitEA.html#eval">Fitness function</a>:
|
|
there is an </font><font color="#FF6600">additional line</font><font color="#000000">
|
|
after the encapsulation of our </font><font color="#CC0000">binary_function</font><font color="#000000">
|
|
into an </font><b><tt><font color="#CC0000"><font size=+1>eoEvalFunc</font></font></tt></b><font color="#000000">
|
|
object, which again encapsulate the </font><b><tt><font color="#CC0000"><font size=+1>eoEvalFunc</font></font></tt></b><font color="#000000">
|
|
into an </font><b><tt><font color="#CC0000"><font size=+1>eoEvalFuncCounter</font></font></tt></b><font color="#000000">.
|
|
As its name says, this object will, in addition to computing the fitness,
|
|
count the </font><b><font color="#FF6600">actual</font></b><font color="#000000">
|
|
number of evaluations: the fitness of non-modified individuals is of course
|
|
not recomputed - and this is taken care of by this object. Moreover, it
|
|
can be later </font><font color="#FF6600">used for displays</font><font color="#000000">
|
|
in <a href="#monitor">eoMonitor</a> objects, as done in the <a href="SecondBitEA.html#eval_monitor">checkpoint
|
|
section</a>.</font></li>
|
|
|
|
<li>
|
|
<font color="#000000">The <a href="SecondBitEA.html#init">initialization</a>
|
|
section has been extended to account for the possibility to </font><font color="#CC33CC">re-load
|
|
a previously saved population</font><font color="#000000">. This is achieved
|
|
through an <a href="#state">eoState</a> object, if the corresponding program
|
|
parameter is set.</font></li>
|
|
|
|
<li>
|
|
<font color="#000000">The
|
|
<a href="SecondBitEA.html#operators">variation
|
|
operators</a> and the <a href="SecondBitEA.html#engine">evolution engine</a>
|
|
sections are similar to the ones in Lesson2</font></li>
|
|
|
|
<li>
|
|
<font color="#000000">The </font><b><font color="#3366FF">parameter section</font></b><font color="#000000">
|
|
is completely different from the previous one. All variables corresponding
|
|
to </font><font color="#3366FF">program parameters</font><font color="#000000">
|
|
are now </font><a href="SecondBitEA.html#seed_declare">declared</a><font color="#000000">
|
|
in the </font><b><tt><font color="#990000"><font size=+1>main_function</font></font></tt></b><font color="#000000">
|
|
(as before), but their values are set in a <a href="SecondBitEA.html#parametres">new
|
|
function</a>, called </font><b><tt><font color="#660000">read_param.</font></tt></b><font color="#000000">
|
|
See the <a href="#parser">eoParser</a> description for more details.</font></li>
|
|
|
|
<li>
|
|
<font color="#000000">The <a href="SecondBitEA.html#stop">stopping criterion
|
|
section</a>, has in fact now become the checkpoint section, as it involves
|
|
much more than just stopping criteria. See all details in the <a href="#checkpoint">eoCheckpoint
|
|
paragraph below</a>.</font></li>
|
|
</ul>
|
|
|
|
<hr WIDTH="100%"><a NAME="parser"></a><b><font color="#000099"><font size=+2>eoParser:
|
|
parameter input</font></font></b>
|
|
<br><font color="#000000">The first two examples of Lessons 1 and 2 had
|
|
a very crude way to set parameter values: they were hard-coded, and you
|
|
had to recompile the whole program to change a single value. We shall now
|
|
see now to set parameter values in a flexible way (though we're still looking
|
|
for volunteers to create a Graphical User Interface :-)</font>
|
|
<br><font color="#000000">Two base classes are used for that purpose:</font>
|
|
<ul>
|
|
<li>
|
|
<font color="#000000">The </font><b><tt><font color="#3366FF">eoValueParam</font></tt></b><font color="#000000">
|
|
class, </font><font color="#FF6600">templatized by the type of the variable</font><font color="#000000">
|
|
you want to handle (i.e. i</font><b><tt><font color="#660000">integer, double,
|
|
yourPrivateClass</font></tt></b><font color="#000000">, ...). In this lesson,
|
|
we will not go into details: e.g. we will not tell you that the
|
|
<b><font face="Arial,Helvetica"><font size=+1><a href="../../doc/html/class_eovalueparam.html">eoValueParam</a></font></font></b>
|
|
is actually a templatized sub-class of abstract class eoParam (oops, I
|
|
said it!), nor will we deal with parameters outside their use from an eoParser.
|
|
See the parameter section of the Bottom-up tutorial, or wait until <a href="eoLesson4.html">lesson
|
|
4</a>).</font></li>
|
|
|
|
<li>
|
|
<font color="#000000">The </font><b><tt><font color="#3366FF">eoParser</font></tt></b><font color="#000000">
|
|
class, whose only purpose is the input of parameters.</font></li>
|
|
</ul>
|
|
<b><font color="#FF0000">Modifying parameter values at run-time:</font></b>
|
|
<br><font color="#000000">Using an eoParser object, the parameter values
|
|
are read, by order of priority</font>
|
|
<ol>
|
|
<li>
|
|
<font color="#000000">from the command-line</font></li>
|
|
|
|
<li>
|
|
<font color="#000000">from a text file</font></li>
|
|
|
|
<li>
|
|
<font color="#000000">from the environment</font></li>
|
|
|
|
<li>
|
|
<font color="#000000">from default values</font></li>
|
|
</ol>
|
|
The syntax of parameter reading is a <b><font color="#FF6600">keyword</font></b>-based
|
|
syntax, now traditional in the Unix world:
|
|
<ul>
|
|
<li>
|
|
in EO, each parameter is designated by <font color="#FF6600">a (long) keyword</font>,
|
|
and optionally by a <font color="#FF6600">short (1 character) keyword</font>.</li>
|
|
|
|
<br>
|
|
<li>
|
|
the general syntax to modify parameter value at run-time is (either from
|
|
the command-line or in a text file)</li>
|
|
|
|
<br>
|
|
<b><tt><font color="#660000">--longKeyword=value</font></tt></b>
|
|
or <b><tt><font color="#660000">-c=value</font></tt></b>
|
|
if 'c' is the short keyword
|
|
<br>
|
|
<li>
|
|
so, after compiling the executable for Lesson 3 (<b><tt><font color="#FF6666">make
|
|
lesson3</font></tt></b> at system prompt in Unix), you can try to type
|
|
in</li>
|
|
|
|
<br>
|
|
<b><tt><font color="#FF6666">SecondBitEA</font></tt></b>
|
|
<br>and see the algorithm run as before (OneMax optimized on 8-bits bitstrings).
|
|
But you can now type in
|
|
<br>
|
|
<b><tt><font color="#FF6666">SecondBitEA --vecSize=100</font></tt></b>
|
|
<br>and see the output of the optimization of OneMax on 100-bit bitstrings.
|
|
<br>
|
|
<li>
|
|
Take a look at all available parameters by typing in</li>
|
|
|
|
<br>
|
|
<b><tt><font color="#FF6666">SecondBitEA --help</font></tt></b>
|
|
<br>or by going into the code: all parameter inputs have been grouped in
|
|
the
|
|
<a href="SecondBitEA.html#parametres">read_param</a> function.
|
|
<br>
|
|
<li>
|
|
After running the algorithm, a new file has been created, named <b><tt><font color="#990000">SecondBitEA.status</font></tt></b>:
|
|
it contains the list of all actual parameters used, and can directly be
|
|
used as parameter input file: change the file name (e.g. to <b><tt><font color="#660000">SecondBitEA.param</font></tt></b>),
|
|
edit it, change whichever parameter you want, and type in</li>
|
|
|
|
<br>
|
|
|
|
<b><tt><font color="#FF6666">SecondBitEA @SecondBitEA.param</font></tt></b>
|
|
<br>and you will see all values that you defined into the file taken into
|
|
account.
|
|
<br>
|
|
<li>
|
|
The <font color="#FF6600">priority</font> remains to the <font color="#FF6600">command-line</font>,
|
|
so you can still override the values in the parameter file by giving a
|
|
new value directly on the command-line.</li>
|
|
</ul>
|
|
<b><font color="#FF0000">Programming parameter input:</font></b>
|
|
<br>the code of SeconBitEA provides examples of parameters reading. Lets
|
|
take the example of the random number generator <b><tt><font color="#660000">seed</font></tt></b>.
|
|
<ul>
|
|
<li>
|
|
You first need to <a href="SecondBitEA.html#seed_declare">declare</a> it
|
|
in the <b><tt><font color="#660000">main_function</font></tt></b>. As parameter
|
|
reading will be done in the <b><tt><font color="#660000">read_param</font></tt></b>
|
|
function, you need to pass it the variable seed. Note that read_param receives
|
|
it <a href="SecondBitEA.html#seed_passing">by reference</a>, as it is going
|
|
to modify its value!</li>
|
|
|
|
<li>
|
|
In read_param, you need first to <a href="SecondBitEA.html#parser_declare">declare
|
|
an eoParser object</a> (it needs the standard argc and argv in its constructor).</li>
|
|
|
|
<br>Then, <a href="SecondBitEA.html#_seed_declare">declare a parameter</a>
|
|
of type <b><tt><font color="#660000">uint32</font></tt></b> (32-bits integer),
|
|
and read it directly from the parser, using method <b><tt><font color="#660000">create_param</font></tt></b>.
|
|
The arguments are obvious: default value, long keyword, comment (that will
|
|
appear in the help message and in the output "status" file if any).
|
|
<li>
|
|
Finally, you need to <a href="SecondBitEA.html#seed_assign">assign the
|
|
value</a> to the variable _seed (hence modifying the original seed variable).</li>
|
|
</ul>
|
|
|
|
<hr WIDTH="100%">
|
|
<br><a NAME="state"></a><b><font color="#000099"><font size=+2>eoState:
|
|
saving and loading</font></font></b>
|
|
<br><font color="#000000">You might have noticed in the </font><b><tt><font color="#660000">read_param</font></tt></b><font color="#000000">
|
|
described above a </font><font color="#FF6600">new parameter</font><font color="#000000">
|
|
named </font><b><tt><font color="#660000"><a href="SecondBitEA.html#_load_name">load_name.</a></font></tt></b><font color="#000000">
|
|
Now if you go to the <a href="SecondBitEA.html#init">init section</a> of
|
|
the code, you will see an alternative way of </font><font color="#CC33CC">initializing
|
|
the population</font><font color="#000000">: if load_name is an empty string,
|
|
then we do as in the preceding example and use an eoInitFixedLength object.
|
|
However, if a load_name name was entered, the population is read through
|
|
the </font><b><tt><font color="#660000"><a href="SecondBitEA.html#instate.load">inState.load(load_name)</a></font></tt></b><font color="#000000">
|
|
instruction. Moreover, the comment says "Loading pop </font><font color="#FF6600">and
|
|
rng</font><font color="#000000">".</font>
|
|
<p><font color="#000000">This is made possible using the </font><b><tt><font color="#3366FF">eoState</font></tt></b><font color="#000000">
|
|
class. </font><b><tt><font color="#3366FF">eoState</font></tt></b><font color="#000000">
|
|
objects maintain references to </font><b><tt><font color="#660000">eoObjects</font></tt></b><font color="#000000">
|
|
that have both an input method (</font><b><tt><font color="#3366FF">readFrom</font></tt></b><font color="#000000">)
|
|
and an output method (</font><b><tt><font color="#3366FF">printOn</font></tt></b><font color="#000000">),
|
|
i.e. that derive from the base class </font><b><font face="Arial,Helvetica"><font color="#660000"><font size=+1><a href="../../doc/html/class_eopersistent.html">eoPersistent</a></font></font></font></b><font color="#000000">.
|
|
You must first </font><b><tt><font color="#3366FF"><a href="SecondBitEA.html#register">register</a></font></tt></b><font color="#000000">
|
|
object into a state, and can then save them to a (text) file, and later
|
|
read them from that file using the </font><b><tt><font color="#3366FF">load</font></tt></b><font color="#000000">
|
|
method, as done <a href="SecondBitEA.html#loadstate">here</a>.</font>
|
|
<br><font color="#000000">Of course, you can call the </font><b><tt><font color="#3366FF">save</font></tt></b><font color="#000000">
|
|
method for an </font><b><tt><font color="#3366FF">eoState</font></tt></b><font color="#000000">
|
|
object anywhere in the code. But the <a href="#statesaver">checkpointing</a>
|
|
mechanism offers you better ways to do that - and it's so easy ....</font>
|
|
<p>
|
|
<hr WIDTH="100%"><a NAME="checkpoint"></a><b><font color="#000099"><font size=+2>eoCheckpoint:
|
|
every generation I'd like to ...</font></font></b>
|
|
<br><font color="#000000">The checkpointing mechanism is a very powerful
|
|
construct to perform some </font><b><font color="#FF6600">systematic actions</font></b><font color="#000000">
|
|
every generation - like </font><font color="#FF6600">saving things</font><font color="#000000">
|
|
(using eoState objects described above), computing </font><font color="#FF6600">statistics</font><font color="#000000">
|
|
on the population, </font><font color="#FF6600">updating</font><font color="#000000">
|
|
dynamical parameters or </font><font color="#FF6600">displaying</font><font color="#000000">
|
|
information.</font>
|
|
<p><b><tt><font color="#3366FF">eoCheckpoint</font></tt></b><font color="#000000">
|
|
objects are </font><b><tt><font color="#3366FF">eoContinue</font></tt></b><font color="#000000">
|
|
objects that contain </font><font color="#FF6600">pointers to different
|
|
types</font><font color="#000000"> of objects. When their </font><b><tt><font color="#660000">operator()</font></tt></b><font color="#000000">
|
|
method is called (i.e. every generation in the examples up to now), they
|
|
first call the </font><b><tt><font color="#660000">operator()</font></tt></b><font color="#000000">
|
|
methods of all object they contain, and then return their result as an
|
|
</font><b><tt><font color="#3366FF">eoContinue</font></tt></b><font color="#000000">
|
|
object (i.e. should we continue or stop).</font>
|
|
<br><b><font color="#FF0000">Programming: </font></b><font color="#000000">To
|
|
do something every generation, you simply need to </font><b><tt><font color="#3366FF">add</font></tt></b><font color="#000000">
|
|
an object whose </font><b><tt><font color="#660000">operator()</font></tt></b><font color="#000000">
|
|
does what you want to the eoState that you will use as continuator in the
|
|
algorithm.</font>
|
|
<br>
|
|
<hr WIDTH="100%"><a NAME="stop"></a><b><font color="#000099">eoCheckpoint:
|
|
Stopping</font></b>
|
|
<br><font color="#000000">The </font><b><tt><font color="#3366FF">eoContinue</font></tt></b><font color="#000000">
|
|
part of an </font><b><tt><font color="#3366FF">eoCheckpoint</font></tt></b><font color="#000000">
|
|
is a single object, <a href="SecondBitEA.html#checkpoint">passed to the
|
|
constructor</a>. If you want more that one stopping criterion, use an <a href="SecondBitEA.html#stop">eoCombinedContinue</a>
|
|
object as described in <a href="eoLesson2.html#combinedContinue">Lesson2</a>.</font>
|
|
<br>
|
|
<hr WIDTH="100%">
|
|
<br><a NAME="stats"></a><b><font color="#000099">eoCheckpoint: Computing
|
|
statistics</font></b>
|
|
<br><font color="#000000">Statistics are computed using </font><b><tt><font color="#3366FF">eoStat</font></tt></b><font color="#000000">
|
|
objects, i.e. functor objects whose </font><b><tt><font color="#660000">operator()</font></tt></b><font color="#000000">
|
|
receives as argument a reference to a population as argument, and can hence
|
|
compute whatever is needed over that population. </font><b><tt><font color="#3366FF">eoStat</font></tt></b><font color="#000000">
|
|
objects are </font><font color="#FF6600">templatized</font><font color="#000000">
|
|
over the type of what they compute (e.g. </font><b><tt><font color="#660000">double</font></tt></b><font color="#000000">,
|
|
or </font><b><tt><font color="#660000">pair<double></font></tt></b><font color="#000000">,
|
|
or ...). But looking at the <a href="../../doc/html/class_eostat.html">inheritance
|
|
diagram</a> of the </font><b><tt><font color="#3366FF">eoStat</font></tt></b><font color="#000000">
|
|
class, you find that </font><b><tt><font color="#3366FF">eoStat</font></tt></b><font color="#000000">
|
|
objects are also </font><b><tt><font color="#3366FF">eoValueParam</font></tt></b><font color="#000000">
|
|
objects. And this allows </font><b><tt><font color="#3366FF">eoStat</font></tt></b><font color="#000000">
|
|
to be used within </font><b><tt><font color="#3366FF">eoMonitor</font></tt></b><font color="#000000">
|
|
object, and hence </font><b><font color="#FF6600">displayed</font></b><font color="#000000">
|
|
to the user!</font>
|
|
<p><b><font color="#FF0000">Available statistics</font></b>: Some widely
|
|
used statistics are already available (and of course you can build you
|
|
own!).
|
|
<ul>
|
|
<li>
|
|
<b><tt><font color="#3366FF">eoBestFitnessStat</font></tt></b> returns
|
|
the fitness value of the best individual in the population (of type <b><tt><font color="#660000">FitnessType</font></tt></b>,
|
|
whatever this is).</li>
|
|
|
|
<li>
|
|
<b><tt><font color="#3366FF">eoAverageStat</font></tt></b> and <b><tt><font color="#3366FF">eoSecondMomentStat</font></tt></b>
|
|
respectively return the average (type double, assumes that <b><tt><font color="#660000">FitnessType</font></tt></b>
|
|
is castable to a double) and a pair made of the average and the standard
|
|
deviation (type <b><tt><font color="#660000">pair<double></font></tt></b>)
|
|
of the fitnesses in the populations.</li>
|
|
|
|
<li>
|
|
<b><tt><font color="#3366FF">eoDiversityStat</font></tt></b> returns the
|
|
diversity in the population: assuming that there is a distance function
|
|
defined among individuals, it returns the average inter-individuals distance.
|
|
See also Exercise 2.</li>
|
|
</ul>
|
|
<b><font color="#FF0000">Programming</font></b>: To compute some statistics
|
|
within your algorithm, simply <a href="SecondBitEA.html#stat_declare">declare</a>
|
|
the corresponding eoStat objects, and <a href="SecondBitEA.html#stat_pass">add</a>
|
|
them to the <b><tt><font color="#3366FF">eoCheckpoint</font></tt></b> you
|
|
use in the algorithm.
|
|
<p><b><font color="#FF0000">Note</font></b>: actually, there are 2 distinct
|
|
classes that compute and give access to statistics: <b><tt><font color="#3366FF">eoStat</font></tt></b>
|
|
and <b><tt><font color="#3366FF">eoSortedStat</font></tt></b>. As its name
|
|
indicate, the latter is used whenever computing the statistics require
|
|
a sorted population: not only this avoids to sort the population many times,
|
|
but also it avoids changing the order of the population at all as eoSortedStat
|
|
work on a temporary vector of fitnesses . But <font color="#FF6600">as
|
|
far as their usage is concerned, its makes no difference</font>.
|
|
<br>
|
|
<hr WIDTH="100%">
|
|
<br><a NAME="monitor"></a><b><font color="#000099">eoCheckpoint: Displaying
|
|
eoParameters</font></b>
|
|
<br><font color="#000000">The </font><b><tt><font color="#3366FF">eoMonitor</font></tt></b><font color="#000000">
|
|
objects are used to display a set of </font><b><tt><font color="#3366FF">eoValueParam</font></tt></b><font color="#000000">
|
|
objects.</font>
|
|
<p><b><font color="#FF0000">Available monitors</font></b>: A few monitors
|
|
are available in th eEO distribution:
|
|
<ul>
|
|
<li>
|
|
<b><tt><font color="#3366FF">eoStdoutMonitor</font></tt></b> displays its
|
|
parameters in <font color="#FF6600">text format on the screen</font>. The
|
|
(optional) boolean value in the constructor modifies the output: when true
|
|
(the default), verbose output is used, with one line per parameter. When
|
|
false, parsimonious output displays one line for all parameters.</li>
|
|
|
|
<li>
|
|
<b><tt><font color="#3366FF">eoStdoutMonitor</font></tt></b> writes its
|
|
parameters in <font color="#FF6600">text format in a file</font>. A file
|
|
name is required in the constructor, and an optional separator character
|
|
can be added (default is ','). Note that the file is overwritten by next
|
|
call to the same program.</li>
|
|
|
|
<li>
|
|
<b><tt><font color="#3366FF">eoGnuplot1DMonitor</font></tt></b> displays
|
|
its parameters in <font color="#FF6600">graphical format on the screen</font>
|
|
by calling the <b><tt><font color="#660000">gnuplot</font></tt></b> program,
|
|
and as of today, only works in the Unix version of EO (as always, volunteers
|
|
are welcome to port that to MS Windows). It takes an optional filename
|
|
as input, as communication of data with <b><tt><font color="#660000">gnuplot</font></tt></b>
|
|
is done through a file. If no filename is provided, the file will be erased
|
|
at the end of the run, while it is otherwise kept (though it will be overwritten
|
|
by next call to the same program).</li>
|
|
</ul>
|
|
|
|
<p><br><b><font color="#FF0000">Programming:</font></b> To display something
|
|
while the algorithm is running, you need to <a href="SecondBitEA.html#monitor_declare">declare</a>
|
|
an <b><tt><font color="#3366FF">eoMonitor</font></tt></b> object, <a href="SecondBitEA.html#monitor_add">add</a>
|
|
some objects (that must be <b><tt><font color="#3366FF">eoValueParam</font></tt></b>
|
|
objects) to that monitor, and of course <a href="SecondBitEA.html#monitor_pass">add</a>
|
|
the monitor to the <b><tt><font color="#3366FF">eoCheckpoint</font></tt></b>
|
|
you use in the algorithm.
|
|
<br>
|
|
<hr WIDTH="100%">
|
|
<br><a NAME="update"></a><b><font color="#000099">eoCheckpoint: Updating
|
|
things</font></b>
|
|
<br><font color="#000000">The last type of objects that </font><b><tt><font color="#3366FF">eoCheckpoint</font></tt></b><font color="#000000">
|
|
can handle are </font><b><tt><font color="#3366FF">eoUpdater</font></tt></b><font color="#000000">
|
|
objects. You should simply encapsulate in an </font><b><tt><font color="#3366FF">eoUpdater</font></tt></b><font color="#000000">
|
|
anything you wish to do which does not fit into one of the above category.
|
|
Note that their </font><b><tt><font color="#660000">operator() method</font></tt></b><font color="#000000">
|
|
does not receive any argument.</font>
|
|
<p><b><font color="#FF0000">Available monitors</font></b>: A few updaters
|
|
are available in the EO distribution:
|
|
<ul>
|
|
<li>
|
|
<b><tt><font color="#3366FF">eoIncrementor</font></tt></b> A simple updater
|
|
which maintains a <font color="#FF6600">counter</font> (an <b><tt><font color="#3366FF">eoValueParam</font></tt></b>
|
|
that needs to be created beforehand, and passed in the constructor). It
|
|
is incremented every time the <b><tt><font color="#660000">operator()</font></tt></b>
|
|
method is called (every generation at the moment). You can of course also
|
|
give an increment in the constructor (1 by default).</li>
|
|
|
|
<li>
|
|
<a NAME="statesaver"></a><b><tt><font color="#3366FF">eoCountedStateSaver</font></tt></b>
|
|
and <b><tt><font color="#3366FF">eoTimedStateSaver</font></tt></b> can
|
|
be used to <font color="#FF6600">save</font> some existing <b><tt><font color="#3366FF">eoState</font></tt></b>
|
|
(see <a href="#state">above</a>) to a file regularly, either based on the
|
|
generation count (e.g. every 4 generations) or based on the clock (e.g.
|
|
every 5 seconds).</li>
|
|
</ul>
|
|
<b><font color="#FF0000">Programming:</font></b>
|
|
<br>A very simple example of using an <b><tt><font color="#3366FF">eoUpdater</font></tt></b>
|
|
is given in the code for SecondBitEA: First <a href="SecondBitEA.html#param_declare">declare</a>
|
|
an <b><tt><font color="#3366FF">eoValueParam</font></tt></b> object, then
|
|
<a href="SecondBitEA.html#param_pass">use
|
|
it to construct</a> an <b><tt><font color="#3366FF">eoIncrementor</font></tt></b>
|
|
that you must <a href="SecondBitEA.html#updater_pass">add</a> to the <b><tt><font color="#3366FF">eoCheckpoint</font></tt></b>
|
|
in order to activate its update. You can then use the parameter for your
|
|
purpose, for instance as a first coordinate for a monitor.
|
|
<br>Note also how to use the statesavers: first <a href="SecondBitEA.html#outstate_declare">declare</a>
|
|
a state, then <a href="SecondBitEA.html#outstate_register">register</a>
|
|
whatever you think necessary to that state, then <a href="SecondBitEA.html#statesaver_declare">pass</a>
|
|
the state to some state-saver - and don't forget to <a href="SecondBitEA.html#statesaver_pass">add</a>
|
|
the statesavers to the current <b><tt><font color="#3366FF">eoCheckpoint</font></tt></b>.
|
|
<br>
|
|
<hr WIDTH="100%">
|
|
<br><b><font color="#000099"><font size=+2>Exercise 1:</font></font></b>
|
|
<ul>
|
|
<li>
|
|
<font color="#000000">The code of </font><b><tt><font color="#660000"><font size=+1>SecondBitEA</font></font></tt></b><font color="#000000">
|
|
display things in the current window in text format. Replace the </font><b><tt><font color="#3366FF">eoFileMonitor</font></tt></b><font color="#000000">
|
|
by an </font><b><tt><font color="#3366FF">eoGnuplot1DMonitor</font></tt></b><font color="#000000">
|
|
and watch the </font><b><font color="#FF6600">graphical output </font></b><font color="#000000">(</font><font color="#FF6600">Unix</font><font color="#000000">
|
|
systems with </font><font color="#FF6600">gnuplot</font><font color="#000000">
|
|
installed only, sorry).</font></li>
|
|
|
|
<li>
|
|
<font color="#000000">Note that you must also replace the </font><b><tt><font color="#3366FF">eoSecondMomentStat</font></tt></b><font color="#000000">
|
|
by an </font><b><tt><font color="#3366FF">eoAverageStat</font></tt></b><font color="#000000">,
|
|
otherwise the standard deviations won't make any sense here.</font></li>
|
|
|
|
<li>
|
|
<font color="#000000">Please try to understand why the average is always
|
|
0 before taking a look at the solution (file <a href="NoWay.html">exercise1.cpp</a>).</font></li>
|
|
|
|
<li>
|
|
<font color="#000000">Then run</font></li>
|
|
|
|
<br><b><tt><font color="#660000"><font size=+1>
|
|
exercise1 --vecSize=1000 --maxGen=1000</font></font></tt></b>
|
|
<br><font color="#000000">to get a chance to see something happening before
|
|
the program ends!</font></ul>
|
|
|
|
<hr WIDTH="100%"><b><font color="#000099"><font size=+2>Exercise 2:</font></font></b>
|
|
<br><font color="#000000">Write the </font><b><tt><font color="#3366FF">eoDiversityStat</font></tt></b><font color="#000000">
|
|
stat computation and test it. Thanks to send us the code!</font>
|
|
<br>
|
|
<hr WIDTH="100%">
|
|
<br><b><font color="#000099"><font size=+2>Exercise 3:</font></font></b>
|
|
<br><font color="#000000">Write the code for an </font><b><tt><font color="#3366FF"><font size=+1>eoGnuplot1DwithErrorbarsMonitor</font></font></tt></b><font color="#000000">
|
|
that would take into account the standard deviations and display them as
|
|
error-bars.</font>
|
|
<br><font color="#000000">Again, send us the code afterwards, thanks :-)</font>
|
|
<br>
|
|
<hr WIDTH="100%">
|
|
<br><b><font color="#000099"><font size=+2>Lessons learned:</font></font></b>
|
|
<ul>
|
|
<li>
|
|
Value of program parameters can be set <b><font color="#FF6600">at run-time</font></b>
|
|
using the <b><tt><font color="#3366FF"><font size=+1>eoParser</font></font></tt></b>
|
|
class.</li>
|
|
|
|
<li>
|
|
<b><font color="#FF6600">Snapshots</font></b> of the algorithms can easily
|
|
be <font color="#FF6600">saved</font> (and <font color="#FF6600">restored</font>)
|
|
thanks to the <b><tt><font color="#3366FF"><font size=+1>eoState</font></font></tt></b>
|
|
class.</li>
|
|
|
|
<li>
|
|
The <b><tt><font color="#3366FF"><font size=+1>eoCheckpoint</font></font></tt></b>
|
|
mechanism let you <b><font color="#FF6600">do things every generation</font></b>
|
|
without modifying existing algorithms, by simply writing the necessary
|
|
code and encapsulating it into an object that <b><tt><font color="#3366FF"><font size=+1>eoCheckpoint</font></font></tt></b>
|
|
is aware of, that are at the moment the following:</li>
|
|
|
|
<li>
|
|
computing <b><font color="#FF6600">statistics</font></b>, <b><font color="#FF6600">displaying
|
|
</font></b>parameters
|
|
(e.g. statistics), <b><font color="#FF6600">saving</font></b> the
|
|
<b><tt><font color="#3366FF"><font size=+1>(eo)State</font></font></tt></b>
|
|
of the program.</li>
|
|
</ul>
|
|
In next lesson you will find out that many <a href="intro.html#adaptive">adaptive
|
|
techniques</a> (the state-of-the-art in Evolutionary Computation) can easily
|
|
be programmed through the <b><tt><font color="#3366FF"><font size=+1>eoUpdater</font></font></tt></b>
|
|
construct.
|
|
<br>
|
|
<hr WIDTH="100%"><a href="eoLesson2.html">Lesson 2</a> -
|
|
<a href="eoLesson4.html">Lesson
|
|
4</a> -
|
|
<a href="eoTutorial.html">Main page</a> -
|
|
<a href="eoTopDown.html">Top-Down</a>
|
|
- <a href="eoBottomUp.html">Bottom-up</a> - <a href="eoProgramming.html">Hints</a>
|
|
-<b> <font face="Arial,Helvetica"><a href="../../doc/html/index.html">EO documentation</a></font></b>
|
|
<br>
|
|
<hr>
|
|
<address>
|
|
<a href="mailto:Marc.Schoenauer@polytechnique.fr">Marc Schoenauer</a></address>
|
|
|
|
<br><!-- Created: Fri Nov 3 18:49:12 CET 2000 --><!-- hhmts start -->Last
|
|
modified: Mon Nov 27 8:49:12 CET 2000<!-- hhmts end -->
|
|
</body>
|
|
</html>
|