nojhan/eodev
Archived
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Added the namespace in description of RNGs (and corrected a few broken links)

Browse source
This commit is contained in:
evomarc 2001-01-09 02:17:28 +00:00
commit 5edbc0e98b
1 changed files with 27 additions and 15 deletions
Download patch file Download diff file Expand all files Collapse all files

42
eo/tutorial/html/eoProgramming.html
View file

@ -176,14 +176,15 @@ Template Library</font></b>.
of STL</font> to use EO (like with "hello", "please" and "goodbye" you of STL</font> to use EO (like with "hello", "please" and "goodbye" you
can survive in a foreign country :-) and even to contribute to new EO features. can survive in a foreign country :-) and even to contribute to new EO features.
Moreover, while browsing through EO code, you will gradually learn how Moreover, while browsing through EO code, you will gradually learn how
to use STL, especially if you check at the <a href="http://www.sgi.com/Technology/STL/">SGI&nbsp;STL to use STL, especially if you check at the <a href="http://www.sgi.com/Technology/STL/">SGI
Web site</a> from time to time, where you can not only download STL, but STL Web site</a> from time to time, where you can not only download STL,
also browse in the Programmer's guide&nbsp; for isntance from the <a href="http://www.sgi.com/Technology/STL/table_of_contents.html">Table but also browse in the Programmer's guide&nbsp; for isntance from the <a href="http://www.sgi.com/Technology/STL/table_of_contents.html">Table
of Content</a>. of Content</a>.
<p>Anyway, you will only find here, in EO tutorial, the basics of STL that <p>Anyway, you will only find here, in EO tutorial, the basics of STL that
you will need to understand most of EO code - and to guess what the parts you will need to understand most of EO code - and to guess what the parts
you don't understand are actually doing. Don't worry, <b><font color="#FF6600">I you don't understand are actually doing. Don't worry, <b><font color="#FF6600">I
</font></b>don't understand everything :-) </font></b>don't
understand everything :-)
<p>STL provides the user with <b><font color="#FF6600">container</font></b>s, <p>STL provides the user with <b><font color="#FF6600">container</font></b>s,
<b><font color="#FF6600">iterators</font></b> <b><font color="#FF6600">iterators</font></b>
and <b><font color="#FF6600">algorithms</font></b>. And you can access and <b><font color="#FF6600">algorithms</font></b>. And you can access
@ -306,15 +307,15 @@ numbers who look random (w.r.t. some statistical criteria).
to ensure reproducibility of the results across different platforms, EO to ensure reproducibility of the results across different platforms, EO
has its own RNG, the ``<font color="#FF6600">Mersenne Twister</font>'' has its own RNG, the ``<font color="#FF6600">Mersenne Twister</font>''
random number generator MT19937 (thanks to <font color="#FF0000">Takuji random number generator MT19937 (thanks to <font color="#FF0000">Takuji
Nishimura</font>, see <font face="Arial,Helvetica"><font size=+1><a href="../../../../doc/html/class_eorng.html">eoRNG.h</a></font></font> Nishimura</font>, see <font face="Arial,Helvetica"><font size=+1><a href="../../doc/html/eorng_h-source.html">eoRNG.h</a></font></font>
comments). comments).
<p>Though you can define and use as many RNGs as you wish in EO, the library <p>Though you can define and use as many RNGs as you wish in EO, the library
also provides you with a global RNG termed rng: using only that single also provides you with a global RNG termed <b><tt><font color="#993300">eo::rng</font></tt></b>.
RNG in all calls to random numbers allows one to be able to <b><font color="#FF6600">reproduce Using that single RNG in all calls to random numbers allows one to be able
a given run</font></b>: to <b><font color="#FF6600">reproduce a given run</font></b>:
<ul> <ul>
<li> <li>
as strange it seems for a random algorithm, it is mandatory for debugging as strange as it seems for a random algorithm, it is mandatory for debugging
purposes</li> purposes</li>
<li> <li>
@ -328,16 +329,25 @@ to simulate "true" random runs, you can just seed the RNG with a machine-clock
related number, e.g. calling time(0), as done for instance in <a href="SecondBitEA.html#random">Lesson3</a> related number, e.g. calling time(0), as done for instance in <a href="SecondBitEA.html#random">Lesson3</a>
(and after).</li> (and after).</li>
</ul> </ul>
As RNGs only produce (by definition) numbers that are uniformly distributed As RNGs produce, by definition, integers that are uniformly distributed
integers between 0 and some maximal number, EO provides you with random between 0 and some maximal number, EO provides you with random numbers
numbers following <b><font color="#FF6600">different probability distribution</font></b> following <b><font color="#FF6600">different probability distribution</font></b>
(e.g. floating point following <font face="Arial,Helvetica"><font size=+1><a href="../../doc/html/class_eorng.html#a8">normal (e.g. floating point following <font face="Arial,Helvetica"><font size=+1><a href="../../doc/html/class_eorng.html#a8">normal
distribution</a></font></font>). distribution</a></font></font>). See the <a href="../../doc/html/class_eorng.html">complete
<p>EO also provides <a href="../../doc/html/rnd_generators.h-source.html">random_generators</a> list of RNG primitives</a>.
<p>EO also provides <a href="../../doc/html/rnd_generators_h-source.html">random_generators</a>
that can be used in STL call to generate series of random numbers, as in that can be used in STL call to generate series of random numbers, as in
<a href="eoInit.html">eoPop <a href="eoInit.html">eoPop
initializers</a>. initializers</a>.
<p> <p><b><font color="#FF0000">Note</font></b>: the <b><tt><font color="#993300">eo::</font></tt></b>
prefix indicates that it is in a separate C++ namespace, to avoid collision
with possible variables that would also be named rng in some other library.
As early versions of EO (&lt;= 9.1)&nbsp; did not use a separate namespace
for rng, the compiler directive using eo::rng in eoRNG.h allows you to
use the name rng without the <b><tt><font color="#993300">eo::</font></tt></b>
prefix. However, the notation <b><tt><font color="#993300">eo::rng</font></tt></b>
should be preferred and might become mandatory some day.
<br>
<hr WIDTH="100%"> <hr WIDTH="100%">
<br><a NAME="notations"></a><b><font color="#000099"><font size=+1>EO conventions <br><a NAME="notations"></a><b><font color="#000099"><font size=+1>EO conventions
and naming style</font></font></b> and naming style</font></font></b>
@ -364,6 +374,8 @@ names of the variables they are used to initialize, e.g.</li>
<p>&nbsp; <p>&nbsp;
<br>&nbsp; <br>&nbsp;
<br>&nbsp; <br>&nbsp;
<br>&nbsp;
<br>&nbsp;
<p><b><tt><font color="#993300">class eoMyClass</font></tt></b> <p><b><tt><font color="#993300">class eoMyClass</font></tt></b>
<br><b><tt><font color="#993300">{</font></tt></b> <br><b><tt><font color="#993300">{</font></tt></b>
<br><b><tt><font color="#993300">public:</font></tt></b> <br><b><tt><font color="#993300">public:</font></tt></b>