RubyGems - evosynth - Versions diffs - 0.1.0 - Mend

evosynth 0.1.0

Files changed (390) hide show

data/docs/rdoc/classes/EvoSynth/Evolvers/RoundRobinCoevolutionary.html ADDED

@@ -0,0 +1,383 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Class: EvoSynth::Evolvers::RoundRobinCoevolutionary [EvoSynth Documentation]</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+    elemStyle = elem.style;
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+    return true;
+  }
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }<\/style>" )
+  // ]]>
+  </script>
+</head>
+<body>
+    <div id="classHeader">
+        <table class="header-table">
+        <tr class="top-aligned-row">
+          <td><strong>Class</strong></td>
+          <td class="class-name-in-header">EvoSynth::Evolvers::RoundRobinCoevolutionary</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../../../files/lib/evosynth/evolvers/coevolutionary/round_robin_coevolutionary_rb.html">
+                lib/evosynth/evolvers/coevolutionary/round_robin_coevolutionary.rb
+                </a>
+        <br />
+            </td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>Parent:</strong></td>
+            <td>
+                Object
+            </td>
+        </tr>
+        </table>
+    </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+    <div id="description">
+      <p>
+based on CCGA-1/2 (Mitchell A. Potter and Kenneth A. De Jong)
+</p>
+    </div>
+   </div>
+    <div id="method-list">
+      <h3 class="section-bar">Methods</h3>
+      <div class="name-list">
+        <a href="#M000135">best_solution</a>&nbsp;&nbsp;
+        <a href="#M000133">new</a>&nbsp;&nbsp;
+        <a href="#M000138">next_generation</a>&nbsp;&nbsp;
+        <a href="#M000137">return_result</a>&nbsp;&nbsp;
+        <a href="#M000134">to_s</a>&nbsp;&nbsp;
+        <a href="#M000136">worst_solution</a>&nbsp;&nbsp;
+      </div>
+    </div>
+  </div>
+    <!-- if includes -->
+    <div id="includes">
+      <h3 class="section-bar">Included Modules</h3>
+      <div id="includes-list">
+        <span class="include-name"><a href="Evolver.html">EvoSynth::Evolvers::Evolver</a></span>
+      </div>
+    </div>
+    <div id="section">
+    <div id="constants-list">
+      <h3 class="section-bar">Constants</h3>
+      <div class="name-list">
+        <table summary="Constants">
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">DEFAULT_SUBEVOLVERS_CREATOR</td>
+          <td>=</td>
+          <td class="context-item-value">-&gt;(profile) { evolver = EvoSynth::Evolvers::GeneticAlgorithm.new(profile);</td>
+        </tr>
+        </table>
+      </div>
+    </div>
+    <div id="attribute-list">
+      <h3 class="section-bar">Attributes</h3>
+      <div class="name-list">
+        <table>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">subevolvers</td>
+          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
+          <td class="context-item-desc"></td>
+        </tr>
+        </table>
+      </div>
+    </div>
+    <!-- if method_list -->
+    <div id="methods">
+      <h3 class="section-bar">Public Class methods</h3>
+      <div id="method-M000133" class="method-detail">
+        <a name="M000133"></a>
+        <div class="method-heading">
+          <a href="#M000133" class="method-signature">
+          <span class="method-name">new</span><span class="method-args">(profile)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000133-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000133-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/evosynth/evolvers/coevolutionary/round_robin_coevolutionary.rb, line 38</span>
+38:                         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">profile</span>)
+39:                                 <span class="ruby-identifier">init_profile</span> <span class="ruby-identifier">:populations</span>,
+40:                                     <span class="ruby-identifier">:subevolvers_creator</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-constant">DEFAULT_SUBEVOLVERS_CREATOR</span>
+41:
+42:                                 <span class="ruby-identifier">use_profile</span> <span class="ruby-identifier">profile</span>
+43:                                 <span class="ruby-identifier">initialize_sub_evolvers</span>(<span class="ruby-identifier">profile</span>)
+44:                                 <span class="ruby-ivar">@next_index</span> = <span class="ruby-value">0</span>
+45:                         <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+      <h3 class="section-bar">Public Instance methods</h3>
+      <div id="method-M000135" class="method-detail">
+        <a name="M000135"></a>
+        <div class="method-heading">
+          <a href="#M000135" class="method-signature">
+          <span class="method-name">best_solution</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000135-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000135-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/evosynth/evolvers/coevolutionary/round_robin_coevolutionary.rb, line 51</span>
+51:                         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">best_solution</span>
+52:                                 <span class="ruby-identifier">best</span> = []
+53:                                 <span class="ruby-ivar">@populations</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">pop</span><span class="ruby-operator">|</span> <span class="ruby-identifier">best</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">pop</span>.<span class="ruby-identifier">best</span> }
+54:                                 <span class="ruby-identifier">best</span>
+55:                         <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+      <div id="method-M000138" class="method-detail">
+        <a name="M000138"></a>
+        <div class="method-heading">
+          <a href="#M000138" class="method-signature">
+          <span class="method-name">next_generation</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000138-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000138-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/evosynth/evolvers/coevolutionary/round_robin_coevolutionary.rb, line 67</span>
+67:                         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">next_generation</span>
+68:                                 <span class="ruby-ivar">@subevolvers</span>[<span class="ruby-ivar">@next_index</span>].<span class="ruby-identifier">next_generation</span>
+69:                                 <span class="ruby-ivar">@next_index</span> = (<span class="ruby-ivar">@next_index</span> <span class="ruby-operator">+</span> <span class="ruby-value">1</span>) <span class="ruby-operator">%</span> <span class="ruby-ivar">@populations</span>.<span class="ruby-identifier">size</span>
+70:                         <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+      <div id="method-M000137" class="method-detail">
+        <a name="M000137"></a>
+        <div class="method-heading">
+          <a href="#M000137" class="method-signature">
+          <span class="method-name">return_result</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000137-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000137-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/evosynth/evolvers/coevolutionary/round_robin_coevolutionary.rb, line 63</span>
+63:                         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">return_result</span>
+64:                                 <span class="ruby-ivar">@populations</span>
+65:                         <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+      <div id="method-M000134" class="method-detail">
+        <a name="M000134"></a>
+        <div class="method-heading">
+          <a href="#M000134" class="method-signature">
+          <span class="method-name">to_s</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000134-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000134-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/evosynth/evolvers/coevolutionary/round_robin_coevolutionary.rb, line 47</span>
+47:                         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_s</span>
+48:                                 <span class="ruby-value str">&quot;cooperative coevolutionary algorithm&quot;</span>
+49:                         <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+      <div id="method-M000136" class="method-detail">
+        <a name="M000136"></a>
+        <div class="method-heading">
+          <a href="#M000136" class="method-signature">
+          <span class="method-name">worst_solution</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000136-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000136-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/evosynth/evolvers/coevolutionary/round_robin_coevolutionary.rb, line 57</span>
+57:                         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">worst_solution</span>
+58:                                 <span class="ruby-identifier">worst</span> = []
+59:                                 <span class="ruby-ivar">@populations</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">pop</span><span class="ruby-operator">|</span> <span class="ruby-identifier">worst</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">pop</span>.<span class="ruby-identifier">worst</span> }
+60:                                 <span class="ruby-identifier">worst</span>
+61:                         <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+</body>
+</html>

data/docs/rdoc/classes/EvoSynth/Evolvers/RunnableEvolver.html ADDED

@@ -0,0 +1,279 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Module: EvoSynth::Evolvers::RunnableEvolver [EvoSynth Documentation]</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+    elemStyle = elem.style;
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+    return true;
+  }
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }<\/style>" )
+  // ]]>
+  </script>
+</head>
+<body>
+    <div id="classHeader">
+        <table class="header-table">
+        <tr class="top-aligned-row">
+          <td><strong>Module</strong></td>
+          <td class="class-name-in-header">EvoSynth::Evolvers::RunnableEvolver</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../../../files/lib/evosynth/evolvers/runnable_evolver_rb.html">
+                lib/evosynth/evolvers/runnable_evolver.rb
+                </a>
+        <br />
+            </td>
+        </tr>
+        </table>
+    </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+    <div id="description">
+      <p>
+This module provides different termination strategies for evolvers as well
+as the observable property (observers will get notified each generation)
+</p>
+    </div>
+   </div>
+    <div id="method-list">
+      <h3 class="section-bar">Methods</h3>
+      <div class="name-list">
+        <a href="#M000126">run_until</a>&nbsp;&nbsp;
+        <a href="#M000128">run_until_fitness_reached</a>&nbsp;&nbsp;
+        <a href="#M000127">run_until_generations_reached</a>&nbsp;&nbsp;
+      </div>
+    </div>
+  </div>
+    <!-- if includes -->
+    <div id="includes">
+      <h3 class="section-bar">Included Modules</h3>
+      <div id="includes-list">
+        <span class="include-name">Observable</span>
+      </div>
+    </div>
+    <div id="section">
+    <div id="class-list">
+      <h3 class="section-bar">Classes and Modules</h3>
+      Class <a href="RunnableEvolver/Goal.html" class="link">EvoSynth::Evolvers::RunnableEvolver::Goal</a><br />
+    </div>
+    <div id="attribute-list">
+      <h3 class="section-bar">Attributes</h3>
+      <div class="name-list">
+        <table>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">generations_computed</td>
+          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
+          <td class="context-item-desc"></td>
+        </tr>
+        </table>
+      </div>
+    </div>
+    <!-- if method_list -->
+    <div id="methods">
+      <h3 class="section-bar">Public Instance methods</h3>
+      <div id="method-M000126" class="method-detail">
+        <a name="M000126"></a>
+        <div class="method-heading">
+          <a href="#M000126" class="method-signature">
+          <span class="method-name">run_until</span><span class="method-args">() {|generations computed, best solution| ...}</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000126-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000126-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/evosynth/evolvers/runnable_evolver.rb, line 39</span>
+39:                         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">run_until</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">condition</span>) <span class="ruby-comment cmt"># :yields: generations computed, best solution</span>
+40:                                 <span class="ruby-ivar">@generations_computed</span> = <span class="ruby-value">0</span>
+41:                                 <span class="ruby-identifier">changed</span>
+42:                                 <span class="ruby-identifier">notify_observers</span> <span class="ruby-keyword kw">self</span>, <span class="ruby-ivar">@generations_computed</span>
+43:
+44:                                 <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">condition</span>.<span class="ruby-identifier">arity</span>
+45:                                         <span class="ruby-keyword kw">when</span> <span class="ruby-value">0</span>
+46:                                                 <span class="ruby-identifier">loop_condition</span> = <span class="ruby-identifier">condition</span>
+47:                                         <span class="ruby-keyword kw">when</span> <span class="ruby-value">1</span>
+48:                                                 <span class="ruby-identifier">loop_condition</span> = <span class="ruby-identifier">lambda</span> { <span class="ruby-operator">!</span><span class="ruby-keyword kw">yield</span> <span class="ruby-ivar">@generations_computed</span> }
+49:                                         <span class="ruby-keyword kw">when</span> <span class="ruby-value">2</span>
+50:                                                 <span class="ruby-identifier">loop_condition</span> = <span class="ruby-identifier">lambda</span> { <span class="ruby-operator">!</span><span class="ruby-keyword kw">yield</span> <span class="ruby-ivar">@generations_computed</span>, <span class="ruby-identifier">best_solution</span> }
+51:                                 <span class="ruby-keyword kw">else</span>
+52:                                         <span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;please provide a block with the arity of 0, 1 or 2&quot;</span>
+53:                                 <span class="ruby-keyword kw">end</span>
+54:
+55:                                 <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">loop_condition</span>.<span class="ruby-identifier">call</span>
+56:                                         <span class="ruby-identifier">next_generation</span>
+57:                                         <span class="ruby-ivar">@generations_computed</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
+58:                                         <span class="ruby-identifier">changed</span>
+59:                                         <span class="ruby-identifier">notify_observers</span> <span class="ruby-keyword kw">self</span>, <span class="ruby-ivar">@generations_computed</span>
+60:                                 <span class="ruby-keyword kw">end</span>
+61:
+62:                                 <span class="ruby-identifier">return_result</span>
+63:                         <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+      <div id="method-M000128" class="method-detail">
+        <a name="M000128"></a>
+        <div class="method-heading">
+          <a href="#M000128" class="method-signature">
+          <span class="method-name">run_until_fitness_reached</span><span class="method-args">(fitness)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000128-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000128-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/evosynth/evolvers/runnable_evolver.rb, line 69</span>
+69:                         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">run_until_fitness_reached</span>(<span class="ruby-identifier">fitness</span>)
+70:                                 <span class="ruby-identifier">goal</span> = <span class="ruby-constant">Goal</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">fitness</span>)
+71:                                 <span class="ruby-identifier">run_until</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">gen</span>, <span class="ruby-identifier">best</span><span class="ruby-operator">|</span> <span class="ruby-identifier">best</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-identifier">goal</span> }
+72:                         <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+      <div id="method-M000127" class="method-detail">
+        <a name="M000127"></a>
+        <div class="method-heading">
+          <a href="#M000127" class="method-signature">
+          <span class="method-name">run_until_generations_reached</span><span class="method-args">(max_generations)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000127-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000127-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/evosynth/evolvers/runnable_evolver.rb, line 65</span>
+65:                         <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">run_until_generations_reached</span>(<span class="ruby-identifier">max_generations</span>)
+66:                                 <span class="ruby-identifier">run_until</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">gen</span><span class="ruby-operator">|</span> <span class="ruby-identifier">gen</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">max_generations</span> }
+67:                         <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+</body>
+</html>