examples.html 56 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758
  1. <!DOCTYPE html>
  2. <!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
  3. <!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
  4. <head>
  5. <meta charset="utf-8">
  6. <meta name="viewport" content="width=device-width, initial-scale=1.0">
  7. <title>Some examples &mdash; macop v0.2.3 documentation</title>
  8. <script type="text/javascript" src="_static/js/modernizr.min.js"></script>
  9. <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
  10. <script type="text/javascript" src="_static/jquery.js"></script>
  11. <script type="text/javascript" src="_static/underscore.js"></script>
  12. <script type="text/javascript" src="_static/doctools.js"></script>
  13. <script type="text/javascript" src="_static/language_data.js"></script>
  14. <script type="text/javascript" src="_static/js/theme.js"></script>
  15. <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
  16. <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
  17. <link rel="index" title="Index" href="genindex.html" />
  18. <link rel="search" title="Search" href="search.html" />
  19. <link rel="next" title="Contributing" href="contributing.html" />
  20. <link rel="prev" title="macop.solutions.Solution" href="macop/macop.solutions.Solution.html" />
  21. </head>
  22. <body class="wy-body-for-nav">
  23. <div class="wy-grid-for-nav">
  24. <nav data-toggle="wy-nav-shift" class="wy-nav-side">
  25. <div class="wy-side-scroll">
  26. <div class="wy-side-nav-search" >
  27. <a href="index.html" class="icon icon-home"> macop
  28. </a>
  29. <div class="version">
  30. 0.2.3
  31. </div>
  32. <div role="search">
  33. <form id="rtd-search-form" class="wy-form" action="search.html" method="get">
  34. <input type="text" name="q" placeholder="Search docs" />
  35. <input type="hidden" name="check_keywords" value="yes" />
  36. <input type="hidden" name="area" value="default" />
  37. </form>
  38. </div>
  39. </div>
  40. <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
  41. <p class="caption"><span class="caption-text">Contents:</span></p>
  42. <ul class="current">
  43. <li class="toctree-l1"><a class="reference internal" href="description.html">Description</a></li>
  44. <li class="toctree-l1"><a class="reference internal" href="macop.html">Documentation</a></li>
  45. <li class="toctree-l1 current"><a class="current reference internal" href="#">Some examples</a><ul>
  46. <li class="toctree-l2"><a class="reference internal" href="#mono-objective">1. Mono-objective</a><ul>
  47. <li class="toctree-l3"><a class="reference internal" href="#problem-definition">1.1 Problem definition</a></li>
  48. <li class="toctree-l3"><a class="reference internal" href="#operators-and-policy">1.2 Operators and Policy</a></li>
  49. <li class="toctree-l3"><a class="reference internal" href="#before-running-algorithm">1.3 Before running algorithm</a></li>
  50. </ul>
  51. </li>
  52. <li class="toctree-l2"><a class="reference internal" href="#multi-objective">2. Multi-objective</a><ul>
  53. <li class="toctree-l3"><a class="reference internal" href="#id1">1.1 Problem definition</a></li>
  54. <li class="toctree-l3"><a class="reference internal" href="#id2">1.2 Operators and Policy</a></li>
  55. <li class="toctree-l3"><a class="reference internal" href="#how-works-multi-objective-in-macop">1.3 How works multi-objective in macop ?</a></li>
  56. <li class="toctree-l3"><a class="reference internal" href="#checkpoint-multi-objective-solutions">1.4 Checkpoint multi-objective solutions</a></li>
  57. </ul>
  58. </li>
  59. </ul>
  60. </li>
  61. <li class="toctree-l1"><a class="reference internal" href="contributing.html">Contributing</a></li>
  62. </ul>
  63. </div>
  64. </div>
  65. </nav>
  66. <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
  67. <nav class="wy-nav-top" aria-label="top navigation">
  68. <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
  69. <a href="index.html">macop</a>
  70. </nav>
  71. <div class="wy-nav-content">
  72. <div class="rst-content">
  73. <div role="navigation" aria-label="breadcrumbs navigation">
  74. <ul class="wy-breadcrumbs">
  75. <li><a href="index.html">Docs</a> &raquo;</li>
  76. <li>Some examples</li>
  77. <li class="wy-breadcrumbs-aside">
  78. <a href="https://github.com/prise-3d/macop/blob/master/docs/source/examples.rst" class="fa fa-github"> Edit on GitHub</a>
  79. </li>
  80. </ul>
  81. <hr/>
  82. </div>
  83. <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
  84. <div itemprop="articleBody">
  85. <div class="section" id="some-examples">
  86. <h1>Some examples<a class="headerlink" href="#some-examples" title="Permalink to this headline">¶</a></h1>
  87. <div class="section" id="mono-objective">
  88. <h2>1. Mono-objective<a class="headerlink" href="#mono-objective" title="Permalink to this headline">¶</a></h2>
  89. <p>In this tutorial, we introduce the way of using <cite>macop</cite> and running your algorithm quickly.
  90. First of all we need to define the kind of solution which best represent the problem. As example, we use the well known knapsack problem using 30 objects (solution size of 30).</p>
  91. <div class="section" id="problem-definition">
  92. <h3>1.1 Problem definition<a class="headerlink" href="#problem-definition" title="Permalink to this headline">¶</a></h3>
  93. <p>Hence, we define our problem :</p>
  94. <ul class="simple">
  95. <li><p>value of each component of knapsack</p></li>
  96. <li><p>weight associated to each of these components (objects)</p></li>
  97. </ul>
  98. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">&quot;&quot;&quot;</span>
  99. <span class="sd">imports part</span>
  100. <span class="sd">&quot;&quot;&quot;</span>
  101. <span class="kn">import</span> <span class="nn">random</span>
  102. <span class="sd">&quot;&quot;&quot;</span>
  103. <span class="sd">Problem definition</span>
  104. <span class="sd">&quot;&quot;&quot;</span>
  105. <span class="n">random</span><span class="o">.</span><span class="n">seed</span><span class="p">(</span><span class="mi">42</span><span class="p">)</span>
  106. <span class="n">elements_score</span> <span class="o">=</span> <span class="p">[</span> <span class="n">random</span><span class="o">.</span><span class="n">randint</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">20</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">30</span><span class="p">)</span> <span class="p">]</span> <span class="c1"># value of each object</span>
  107. <span class="n">elements_weight</span> <span class="o">=</span> <span class="p">[</span> <span class="n">random</span><span class="o">.</span><span class="n">randint</span><span class="p">(</span><span class="mi">5</span><span class="p">,</span> <span class="mi">25</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">30</span><span class="p">)</span> <span class="p">]</span> <span class="c1"># weight of each object</span>
  108. </pre></div>
  109. </div>
  110. <p>We can now define the solution representation. In knapsack problem we want to fill our knapsack in an optimization way selecting or not each component (object).
  111. The best way to represent this problem is to use the <cite>BinarySolution</cite> from <cite>macop</cite> which stores solution as a binary array.</p>
  112. <p>Using the solution representation, we need to define multiple elements to fit our algorithm :</p>
  113. <ul class="simple">
  114. <li><p>function which validates or not a solution (based on constraints)</p></li>
  115. <li><p>function which evaluates the solution (in order to obtain fitness)</p></li>
  116. <li><p>initialization solution function</p></li>
  117. </ul>
  118. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">&quot;&quot;&quot;</span>
  119. <span class="sd">imports part</span>
  120. <span class="sd">&quot;&quot;&quot;</span>
  121. <span class="kn">import</span> <span class="nn">random</span>
  122. <span class="kn">from</span> <span class="nn">macop.solutions.BinarySolution</span> <span class="kn">import</span> <span class="n">BinarySolution</span>
  123. <span class="sd">&quot;&quot;&quot;</span>
  124. <span class="sd">Problem definition</span>
  125. <span class="sd">&quot;&quot;&quot;</span>
  126. <span class="n">random</span><span class="o">.</span><span class="n">seed</span><span class="p">(</span><span class="mi">42</span><span class="p">)</span>
  127. <span class="n">elements_score</span> <span class="o">=</span> <span class="p">[</span> <span class="n">random</span><span class="o">.</span><span class="n">randint</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">20</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">30</span><span class="p">)</span> <span class="p">]</span> <span class="c1"># value of each object</span>
  128. <span class="n">elements_weight</span> <span class="o">=</span> <span class="p">[</span> <span class="n">random</span><span class="o">.</span><span class="n">randint</span><span class="p">(</span><span class="mi">5</span><span class="p">,</span> <span class="mi">25</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">30</span><span class="p">)</span> <span class="p">]</span> <span class="c1"># weight of each object</span>
  129. <span class="c1"># 1. validator function (we accept only bag with maximum weight 80kg)</span>
  130. <span class="k">def</span> <span class="nf">validator</span><span class="p">(</span><span class="n">_solution</span><span class="p">):</span>
  131. <span class="n">weight_sum</span> <span class="o">=</span> <span class="mi">0</span>
  132. <span class="k">for</span> <span class="n">index</span><span class="p">,</span> <span class="n">elem</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">_solution</span><span class="o">.</span><span class="n">data</span><span class="p">):</span>
  133. <span class="n">weight_sum</span> <span class="o">+=</span> <span class="n">elements_weight</span><span class="p">[</span><span class="n">index</span><span class="p">]</span> <span class="o">*</span> <span class="n">elem</span>
  134. <span class="k">if</span> <span class="n">weight_sum</span> <span class="o">&lt;=</span> <span class="mi">80</span><span class="p">:</span>
  135. <span class="k">return</span> <span class="kc">True</span>
  136. <span class="k">else</span><span class="p">:</span>
  137. <span class="kc">False</span>
  138. <span class="c1"># 2. function which computes fitness of solution</span>
  139. <span class="k">def</span> <span class="nf">evaluator</span><span class="p">(</span><span class="n">_solution</span><span class="p">):</span>
  140. <span class="n">fitness</span> <span class="o">=</span> <span class="mi">0</span>
  141. <span class="k">for</span> <span class="n">index</span><span class="p">,</span> <span class="n">elem</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">_solution</span><span class="o">.</span><span class="n">data</span><span class="p">):</span>
  142. <span class="n">fitness</span> <span class="o">+=</span> <span class="p">(</span><span class="n">elements_score</span><span class="p">[</span><span class="n">index</span><span class="p">]</span> <span class="o">*</span> <span class="n">elem</span><span class="p">)</span>
  143. <span class="k">return</span> <span class="n">fitness</span>
  144. <span class="c1"># 3. function which here initializes solution ramdomly and check validity of solution</span>
  145. <span class="k">def</span> <span class="nf">init</span><span class="p">():</span>
  146. <span class="k">return</span> <span class="n">BinarySolution</span><span class="p">([],</span> <span class="mi">30</span><span class="p">)</span><span class="o">.</span><span class="n">random</span><span class="p">(</span><span class="n">validator</span><span class="p">)</span>
  147. </pre></div>
  148. </div>
  149. </div>
  150. <div class="section" id="operators-and-policy">
  151. <h3>1.2 Operators and Policy<a class="headerlink" href="#operators-and-policy" title="Permalink to this headline">¶</a></h3>
  152. <p>In our algorithm we need to use some operators in order to improve current best solution found at current <cite>n</cite> evaluations.</p>
  153. <p>In <cite>macop</cite> you have some available operators. In this example, we use 3 of them.</p>
  154. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">&quot;&quot;&quot;</span>
  155. <span class="sd">imports part</span>
  156. <span class="sd">&quot;&quot;&quot;</span>
  157. <span class="o">...</span>
  158. <span class="kn">from</span> <span class="nn">macop.operators.mutators.SimpleMutation</span> <span class="kn">import</span> <span class="n">SimpleMutation</span>
  159. <span class="kn">from</span> <span class="nn">macop.operators.mutators.SimpleBinaryMutation</span> <span class="kn">import</span> <span class="n">SimpleBinaryMutation</span>
  160. <span class="kn">from</span> <span class="nn">macop.operators.crossovers.SimpleCrossover</span> <span class="kn">import</span> <span class="n">SimpleCrossover</span>
  161. <span class="sd">&quot;&quot;&quot;</span>
  162. <span class="sd">Problem definition</span>
  163. <span class="sd">&quot;&quot;&quot;</span>
  164. <span class="o">...</span>
  165. <span class="sd">&quot;&quot;&quot;</span>
  166. <span class="sd">Algorithm parameters</span>
  167. <span class="sd">&quot;&quot;&quot;</span>
  168. <span class="c1"># list of operators instance to use</span>
  169. <span class="n">operators</span> <span class="o">=</span> <span class="p">[</span><span class="n">SimpleBinaryMutation</span><span class="p">(),</span> <span class="n">SimpleMutation</span><span class="p">(),</span> <span class="n">SimpleCrossover</span><span class="p">(),</span> <span class="n">RandomSplitCrossover</span><span class="p">()]</span>
  170. </pre></div>
  171. </div>
  172. <p>As we defined multiple operators, we have to tell how we want to select them into the algorithm. This is why <strong>Policy</strong> classes have been implemented.
  173. <cite>Policy</cite> class implementation enables to select the next operator to use and once new solution is generated, computes its score (in <cite>apply</cite> method). This class requires all the operators use to be instanciate.</p>
  174. <p>Why computing score into <strong>Policy</strong> <cite>apply</cite> method ? Because it’s a way to get some important statistics from solution improvment using specific operator.
  175. <strong>UCBPolicy</strong> as example, based on Upper Confidence Bound (<a class="reference external" href="https://banditalgs.com/2016/09/18/the-upper-confidence-bound-algorithm/">UCB</a>), computes reward each time a new solution is generated from an operator in order to better select next operator later. We use in this example the <cite>UCBPolicy</cite> implementation.</p>
  176. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">&quot;&quot;&quot;</span>
  177. <span class="sd">imports part</span>
  178. <span class="sd">&quot;&quot;&quot;</span>
  179. <span class="o">...</span>
  180. <span class="kn">from</span> <span class="nn">macop.operators.mutators.SimpleMutation</span> <span class="kn">import</span> <span class="n">SimpleMutation</span>
  181. <span class="kn">from</span> <span class="nn">macop.operators.mutators.SimpleBinaryMutation</span> <span class="kn">import</span> <span class="n">SimpleBinaryMutation</span>
  182. <span class="kn">from</span> <span class="nn">macop.operators.crossovers.SimpleCrossover</span> <span class="kn">import</span> <span class="n">SimpleCrossover</span>
  183. <span class="kn">from</span> <span class="nn">macop.operators.policies.UCBPolicy</span> <span class="kn">import</span> <span class="n">UCBPolicy</span>
  184. <span class="sd">&quot;&quot;&quot;</span>
  185. <span class="sd">Problem definition</span>
  186. <span class="sd">&quot;&quot;&quot;</span>
  187. <span class="o">...</span>
  188. <span class="sd">&quot;&quot;&quot;</span>
  189. <span class="sd">Algorithm parameters</span>
  190. <span class="sd">&quot;&quot;&quot;</span>
  191. <span class="c1"># list of operators instance to use</span>
  192. <span class="n">operators</span> <span class="o">=</span> <span class="p">[</span><span class="n">SimpleBinaryMutation</span><span class="p">(),</span> <span class="n">SimpleMutation</span><span class="p">(),</span> <span class="n">SimpleCrossover</span><span class="p">(),</span> <span class="n">RandomSplitCrossover</span><span class="p">()]</span>
  193. <span class="c1"># `policy` instance is created using specific value for Upper Confidence Bound</span>
  194. <span class="n">policy</span> <span class="o">=</span> <span class="n">UCBPolicy</span><span class="p">(</span><span class="n">operators</span><span class="p">,</span> <span class="n">C</span><span class="o">=</span><span class="mf">100.</span><span class="p">)</span>
  195. </pre></div>
  196. </div>
  197. </div>
  198. <div class="section" id="before-running-algorithm">
  199. <h3>1.3 Before running algorithm<a class="headerlink" href="#before-running-algorithm" title="Permalink to this headline">¶</a></h3>
  200. <p>Before running algorithm we can define a logger to keep track of the all algorithm run.</p>
  201. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">&quot;&quot;&quot;</span>
  202. <span class="sd">imports part</span>
  203. <span class="sd">&quot;&quot;&quot;</span>
  204. <span class="o">...</span>
  205. <span class="kn">import</span> <span class="nn">logging</span>
  206. <span class="sd">&quot;&quot;&quot;</span>
  207. <span class="sd">Problem definition</span>
  208. <span class="sd">&quot;&quot;&quot;</span>
  209. <span class="o">...</span>
  210. <span class="sd">&quot;&quot;&quot;</span>
  211. <span class="sd">Algorithm parameters</span>
  212. <span class="sd">&quot;&quot;&quot;</span>
  213. <span class="o">...</span>
  214. <span class="k">if</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="s1">&#39;data&#39;</span><span class="p">):</span>
  215. <span class="n">os</span><span class="o">.</span><span class="n">makedirs</span><span class="p">(</span><span class="s1">&#39;data&#39;</span><span class="p">)</span>
  216. <span class="c1"># logging configuration</span>
  217. <span class="n">logging</span><span class="o">.</span><span class="n">basicConfig</span><span class="p">(</span><span class="nb">format</span><span class="o">=</span><span class="s1">&#39;</span><span class="si">%(asctime)s</span><span class="s1"> </span><span class="si">%(message)s</span><span class="s1">&#39;</span><span class="p">,</span> <span class="n">filename</span><span class="o">=</span><span class="s1">&#39;data/example.log&#39;</span><span class="p">,</span> <span class="n">level</span><span class="o">=</span><span class="n">logging</span><span class="o">.</span><span class="n">DEBUG</span><span class="p">)</span>
  218. </pre></div>
  219. </div>
  220. <p>We can now instanciate our algorithm. We use the Iterated Local Search in this example. It is mainly used to avoid local optima using multiple local search.</p>
  221. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">&quot;&quot;&quot;</span>
  222. <span class="sd">imports part</span>
  223. <span class="sd">&quot;&quot;&quot;</span>
  224. <span class="o">...</span>
  225. <span class="kn">import</span> <span class="nn">logging</span>
  226. <span class="kn">from</span> <span class="nn">macop.algorithms.mono.IteratedLocalSearch</span> <span class="kn">import</span> <span class="n">IteratedLocalSearch</span> <span class="k">as</span> <span class="n">ILS</span>
  227. <span class="sd">&quot;&quot;&quot;</span>
  228. <span class="sd">Problem definition</span>
  229. <span class="sd">&quot;&quot;&quot;</span>
  230. <span class="o">...</span>
  231. <span class="sd">&quot;&quot;&quot;</span>
  232. <span class="sd">Algorithm parameters</span>
  233. <span class="sd">&quot;&quot;&quot;</span>
  234. <span class="o">...</span>
  235. <span class="k">if</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="s1">&#39;data&#39;</span><span class="p">):</span>
  236. <span class="n">os</span><span class="o">.</span><span class="n">makedirs</span><span class="p">(</span><span class="s1">&#39;data&#39;</span><span class="p">)</span>
  237. <span class="c1"># logging configuration</span>
  238. <span class="n">logging</span><span class="o">.</span><span class="n">basicConfig</span><span class="p">(</span><span class="nb">format</span><span class="o">=</span><span class="s1">&#39;</span><span class="si">%(asctime)s</span><span class="s1"> </span><span class="si">%(message)s</span><span class="s1">&#39;</span><span class="p">,</span> <span class="n">filename</span><span class="o">=</span><span class="s1">&#39;data/example.log&#39;</span><span class="p">,</span> <span class="n">level</span><span class="o">=</span><span class="n">logging</span><span class="o">.</span><span class="n">DEBUG</span><span class="p">)</span>
  239. <span class="n">algo</span> <span class="o">=</span> <span class="n">ILS</span><span class="p">(</span><span class="n">init</span><span class="p">,</span> <span class="n">evaluator</span><span class="p">,</span> <span class="n">operators</span><span class="p">,</span> <span class="n">policy</span><span class="p">,</span> <span class="n">validator</span><span class="p">,</span> <span class="n">_maximise</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
  240. </pre></div>
  241. </div>
  242. <p>The algorithm is now well defined and is ready to run ! But one thing can be done, and it’s very interesting to avoid restart from scratch the algorithm run.
  243. The use of checkpoint is available in <cite>macop</cite>. A <cite>BasicCheckpoint</cite> class let the algorithm save at <cite>every</cite> evaluations the best solution found. This class is based on callback process.
  244. A Callback is runned every number of evaluations but can also implement the <cite>load</cite> method in order to do specific instrusctions when initializing algorithm.</p>
  245. <p>It’s important to note, we can add any number of callbacks we want. For tabu search as example, we need to store many solutions.</p>
  246. <p>In our case, we need to specify the use of checkpoint if we prefer to restart from.</p>
  247. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">&quot;&quot;&quot;</span>
  248. <span class="sd">imports part</span>
  249. <span class="sd">&quot;&quot;&quot;</span>
  250. <span class="o">...</span>
  251. <span class="kn">import</span> <span class="nn">logging</span>
  252. <span class="kn">from</span> <span class="nn">macop.algorithms.mono.IteratedLocalSearch</span> <span class="kn">import</span> <span class="n">IteratedLocalSearch</span> <span class="k">as</span> <span class="n">ILS</span>
  253. <span class="kn">from</span> <span class="nn">macop.callbacks.BasicCheckpoint</span> <span class="kn">import</span> <span class="n">BasicCheckpoint</span>
  254. <span class="sd">&quot;&quot;&quot;</span>
  255. <span class="sd">Problem definition</span>
  256. <span class="sd">&quot;&quot;&quot;</span>
  257. <span class="o">...</span>
  258. <span class="sd">&quot;&quot;&quot;</span>
  259. <span class="sd">Algorithm parameters</span>
  260. <span class="sd">&quot;&quot;&quot;</span>
  261. <span class="o">...</span>
  262. <span class="k">if</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="s1">&#39;data&#39;</span><span class="p">):</span>
  263. <span class="n">os</span><span class="o">.</span><span class="n">makedirs</span><span class="p">(</span><span class="s1">&#39;data&#39;</span><span class="p">)</span>
  264. <span class="c1"># logging configuration</span>
  265. <span class="n">logging</span><span class="o">.</span><span class="n">basicConfig</span><span class="p">(</span><span class="nb">format</span><span class="o">=</span><span class="s1">&#39;</span><span class="si">%(asctime)s</span><span class="s1"> </span><span class="si">%(message)s</span><span class="s1">&#39;</span><span class="p">,</span> <span class="n">filename</span><span class="o">=</span><span class="s1">&#39;data/example.log&#39;</span><span class="p">,</span> <span class="n">level</span><span class="o">=</span><span class="n">logging</span><span class="o">.</span><span class="n">DEBUG</span><span class="p">)</span>
  266. <span class="n">algo</span> <span class="o">=</span> <span class="n">ILS</span><span class="p">(</span><span class="n">init</span><span class="p">,</span> <span class="n">evaluator</span><span class="p">,</span> <span class="n">operators</span><span class="p">,</span> <span class="n">policy</span><span class="p">,</span> <span class="n">validator</span><span class="p">,</span> <span class="n">_maximise</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
  267. <span class="c1"># create instance of BasicCheckpoint callback</span>
  268. <span class="n">callback</span> <span class="o">=</span> <span class="n">BasicCheckpoint</span><span class="p">(</span><span class="n">_every</span><span class="o">=</span><span class="mi">5</span><span class="p">,</span> <span class="n">_filepath</span><span class="o">=</span><span class="s1">&#39;data/checkpoint.csv&#39;</span><span class="p">)</span>
  269. <span class="c1"># Add this callback instance into list of callback</span>
  270. <span class="c1"># It tells the algorithm to apply this callback every 5 evaluations</span>
  271. <span class="c1"># And also the algorithm to load checkpoint if exists before running by using `load` method of callback</span>
  272. <span class="n">algo</span><span class="o">.</span><span class="n">addCallback</span><span class="p">(</span><span class="n">callback</span><span class="p">)</span>
  273. </pre></div>
  274. </div>
  275. <p>We can also add the <cite>UCBCheckpoint</cite> callback which keeps track of UCB data obtained during previous run:</p>
  276. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">&quot;&quot;&quot;</span>
  277. <span class="sd">imports part</span>
  278. <span class="sd">&quot;&quot;&quot;</span>
  279. <span class="o">...</span>
  280. <span class="kn">import</span> <span class="nn">logging</span>
  281. <span class="kn">from</span> <span class="nn">macop.callbacks.UCBCheckpoint</span> <span class="kn">import</span> <span class="n">UCBCheckpoint</span>
  282. <span class="sd">&quot;&quot;&quot;</span>
  283. <span class="sd">Problem definition</span>
  284. <span class="sd">&quot;&quot;&quot;</span>
  285. <span class="o">...</span>
  286. <span class="sd">&quot;&quot;&quot;</span>
  287. <span class="sd">Algorithm parameters</span>
  288. <span class="sd">&quot;&quot;&quot;</span>
  289. <span class="o">...</span>
  290. <span class="c1"># add UCB Checkpoint callback to keep track of UCB statistics obtained</span>
  291. <span class="n">algo</span><span class="o">.</span><span class="n">addCallback</span><span class="p">(</span><span class="n">UCBCheckpoint</span><span class="p">(</span><span class="n">_every</span><span class="o">=</span><span class="mi">5</span><span class="p">,</span> <span class="n">_filepath</span><span class="o">=</span><span class="s1">&#39;data/ucbPolicy.csv&#39;</span><span class="p">))</span>
  292. </pre></div>
  293. </div>
  294. <p>In this way, now we can run and obtained the best solution found in <cite>n</cite> evaluations</p>
  295. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">bestSol</span> <span class="o">=</span> <span class="n">algo</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="mi">10000</span><span class="p">)</span>
  296. <span class="nb">print</span><span class="p">(</span><span class="s1">&#39;Solution score is </span><span class="si">{}</span><span class="s1">&#39;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">evaluator</span><span class="p">(</span><span class="n">bestSol</span><span class="p">)))</span>
  297. </pre></div>
  298. </div>
  299. </div>
  300. </div>
  301. <div class="section" id="multi-objective">
  302. <h2>2. Multi-objective<a class="headerlink" href="#multi-objective" title="Permalink to this headline">¶</a></h2>
  303. <div class="section" id="id1">
  304. <h3>1.1 Problem definition<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h3>
  305. <p>In this example we also use the knapsack problem, with here, 2 kinds of value for each object in the knapsack :</p>
  306. <ul class="simple">
  307. <li><p>value 1 of each component of knapsack</p></li>
  308. <li><p>value 2 of each component of knapsack</p></li>
  309. <li><p>weight associated to each of these components (objects)</p></li>
  310. </ul>
  311. <p>In multi-objective algorithm, we do not only found one solution but a set of non-dominated solutions called Pareto front as we have multiple objectives.</p>
  312. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">&quot;&quot;&quot;</span>
  313. <span class="sd">imports part</span>
  314. <span class="sd">&quot;&quot;&quot;</span>
  315. <span class="kn">import</span> <span class="nn">random</span>
  316. <span class="sd">&quot;&quot;&quot;</span>
  317. <span class="sd">Problem definition</span>
  318. <span class="sd">&quot;&quot;&quot;</span>
  319. <span class="n">random</span><span class="o">.</span><span class="n">seed</span><span class="p">(</span><span class="mi">42</span><span class="p">)</span>
  320. <span class="n">elements_score1</span> <span class="o">=</span> <span class="p">[</span> <span class="n">random</span><span class="o">.</span><span class="n">randint</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">20</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">200</span><span class="p">)</span> <span class="p">]</span> <span class="c1"># value 1 of each object</span>
  321. <span class="n">elements_score2</span> <span class="o">=</span> <span class="p">[</span> <span class="n">random</span><span class="o">.</span><span class="n">randint</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">20</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">200</span><span class="p">)</span> <span class="p">]</span> <span class="c1"># value 2 of each object</span>
  322. <span class="n">elements_weight</span> <span class="o">=</span> <span class="p">[</span> <span class="n">random</span><span class="o">.</span><span class="n">randint</span><span class="p">(</span><span class="mi">5</span><span class="p">,</span> <span class="mi">25</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">200</span><span class="p">)</span> <span class="p">]</span> <span class="c1"># weight of each object</span>
  323. </pre></div>
  324. </div>
  325. <p>We can now define the solution representation. In knapsack problem we want to fill our knapsack in an optimization way selecting or not each component (object).
  326. The best way to represent this problem is to use the <cite>BinarySolution</cite> from <cite>macop</cite> which stores solution as a binary array.</p>
  327. <p>Using the solution representation, we need to define multiple elements to fit our algorithm :</p>
  328. <ul class="simple">
  329. <li><p>function which validates or not a solution (based on constraints)</p></li>
  330. <li><p>the first objective function which evaluates the solution (fitness score for objective 1)</p></li>
  331. <li><p>the second objective function which evaluates the solution (fitness score for objective 2)</p></li>
  332. <li><p>initialization solution function</p></li>
  333. </ul>
  334. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">&quot;&quot;&quot;</span>
  335. <span class="sd">imports part</span>
  336. <span class="sd">&quot;&quot;&quot;</span>
  337. <span class="kn">import</span> <span class="nn">random</span>
  338. <span class="kn">from</span> <span class="nn">macop.solutions.BinarySolution</span> <span class="kn">import</span> <span class="n">BinarySolution</span>
  339. <span class="sd">&quot;&quot;&quot;</span>
  340. <span class="sd">Problem definition</span>
  341. <span class="sd">&quot;&quot;&quot;</span>
  342. <span class="n">random</span><span class="o">.</span><span class="n">seed</span><span class="p">(</span><span class="mi">42</span><span class="p">)</span>
  343. <span class="n">elements_score1</span> <span class="o">=</span> <span class="p">[</span> <span class="n">random</span><span class="o">.</span><span class="n">randint</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">20</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">200</span><span class="p">)</span> <span class="p">]</span> <span class="c1"># value 1 of each object</span>
  344. <span class="n">elements_score2</span> <span class="o">=</span> <span class="p">[</span> <span class="n">random</span><span class="o">.</span><span class="n">randint</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">20</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">200</span><span class="p">)</span> <span class="p">]</span> <span class="c1"># value 2 of each object</span>
  345. <span class="n">elements_weight</span> <span class="o">=</span> <span class="p">[</span> <span class="n">random</span><span class="o">.</span><span class="n">randint</span><span class="p">(</span><span class="mi">5</span><span class="p">,</span> <span class="mi">25</span><span class="p">)</span> <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">200</span><span class="p">)</span> <span class="p">]</span> <span class="c1"># weight of each object</span>
  346. <span class="c1"># 1. validator function (we accept only bag with maximum weight 80kg)</span>
  347. <span class="k">def</span> <span class="nf">validator</span><span class="p">(</span><span class="n">_solution</span><span class="p">):</span>
  348. <span class="n">weight_sum</span> <span class="o">=</span> <span class="mi">0</span>
  349. <span class="k">for</span> <span class="n">index</span><span class="p">,</span> <span class="n">elem</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">_solution</span><span class="o">.</span><span class="n">data</span><span class="p">):</span>
  350. <span class="n">weight_sum</span> <span class="o">+=</span> <span class="n">elements_weight</span><span class="p">[</span><span class="n">index</span><span class="p">]</span> <span class="o">*</span> <span class="n">elem</span>
  351. <span class="k">if</span> <span class="n">weight_sum</span> <span class="o">&lt;=</span> <span class="mi">80</span><span class="p">:</span>
  352. <span class="k">return</span> <span class="kc">True</span>
  353. <span class="k">else</span><span class="p">:</span>
  354. <span class="kc">False</span>
  355. <span class="c1"># 2. functions which computes fitness of solution for the two objectives</span>
  356. <span class="k">def</span> <span class="nf">evaluator1</span><span class="p">(</span><span class="n">_solution</span><span class="p">):</span>
  357. <span class="n">fitness</span> <span class="o">=</span> <span class="mi">0</span>
  358. <span class="k">for</span> <span class="n">index</span><span class="p">,</span> <span class="n">elem</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">_solution</span><span class="o">.</span><span class="n">data</span><span class="p">):</span>
  359. <span class="n">fitness</span> <span class="o">+=</span> <span class="p">(</span><span class="n">elements_score1</span><span class="p">[</span><span class="n">index</span><span class="p">]</span> <span class="o">*</span> <span class="n">elem</span><span class="p">)</span>
  360. <span class="k">return</span> <span class="n">fitness</span>
  361. <span class="k">def</span> <span class="nf">evaluator2</span><span class="p">(</span><span class="n">_solution</span><span class="p">):</span>
  362. <span class="n">fitness</span> <span class="o">=</span> <span class="mi">0</span>
  363. <span class="k">for</span> <span class="n">index</span><span class="p">,</span> <span class="n">elem</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">_solution</span><span class="o">.</span><span class="n">data</span><span class="p">):</span>
  364. <span class="n">fitness</span> <span class="o">+=</span> <span class="p">(</span><span class="n">elements_score2</span><span class="p">[</span><span class="n">index</span><span class="p">]</span> <span class="o">*</span> <span class="n">elem</span><span class="p">)</span>
  365. <span class="k">return</span> <span class="n">fitness</span>
  366. <span class="c1"># 3. function which here initializes solution ramdomly and check validity of solution</span>
  367. <span class="k">def</span> <span class="nf">init</span><span class="p">():</span>
  368. <span class="k">return</span> <span class="n">BinarySolution</span><span class="p">([],</span> <span class="mi">200</span><span class="p">)</span><span class="o">.</span><span class="n">random</span><span class="p">(</span><span class="n">validator</span><span class="p">)</span>
  369. </pre></div>
  370. </div>
  371. </div>
  372. <div class="section" id="id2">
  373. <h3>1.2 Operators and Policy<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h3>
  374. <p>In our algorithm we need to use some operators in order to improve current best solution found at current <cite>n</cite> evaluations.</p>
  375. <p>In <cite>macop</cite> you have some available operators. In this example, we use 3 of them.</p>
  376. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">&quot;&quot;&quot;</span>
  377. <span class="sd">imports part</span>
  378. <span class="sd">&quot;&quot;&quot;</span>
  379. <span class="o">...</span>
  380. <span class="kn">from</span> <span class="nn">macop.operators.mutators.SimpleMutation</span> <span class="kn">import</span> <span class="n">SimpleMutation</span>
  381. <span class="kn">from</span> <span class="nn">macop.operators.mutators.SimpleBinaryMutation</span> <span class="kn">import</span> <span class="n">SimpleBinaryMutation</span>
  382. <span class="kn">from</span> <span class="nn">macop.operators.crossovers.SimpleCrossover</span> <span class="kn">import</span> <span class="n">SimpleCrossover</span>
  383. <span class="sd">&quot;&quot;&quot;</span>
  384. <span class="sd">Problem definition</span>
  385. <span class="sd">&quot;&quot;&quot;</span>
  386. <span class="o">...</span>
  387. <span class="sd">&quot;&quot;&quot;</span>
  388. <span class="sd">Algorithm parameters</span>
  389. <span class="sd">&quot;&quot;&quot;</span>
  390. <span class="c1"># list of operators instance to use</span>
  391. <span class="n">operators</span> <span class="o">=</span> <span class="p">[</span><span class="n">SimpleBinaryMutation</span><span class="p">(),</span> <span class="n">SimpleMutation</span><span class="p">(),</span> <span class="n">SimpleCrossover</span><span class="p">(),</span> <span class="n">RandomSplitCrossover</span><span class="p">()]</span>
  392. </pre></div>
  393. </div>
  394. <p>As we defined multiple operators, we have to tell how we want to select them into the algorithm. This is why <strong>Policy</strong> classes have been implemented.
  395. <cite>Policy</cite> class implementation enables to select the next operator to use and once new solution is generated, computes its score (in <cite>apply</cite> method). This class requires all the operators use to be instanciate.</p>
  396. <p>Why computing score into <strong>Policy</strong> <cite>apply</cite> method ? Because it’s a way to get some important statistics from solution improvment using specific operator.
  397. <strong>UCBPolicy</strong> as example, based on Upper Confidence Bound (<a class="reference external" href="https://banditalgs.com/2016/09/18/the-upper-confidence-bound-algorithm/">UCB</a>), computes reward each time a new solution is generated from an operator in order to better select next operator later. We use in this example the <cite>UCBPolicy</cite> implementation.</p>
  398. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">&quot;&quot;&quot;</span>
  399. <span class="sd">imports part</span>
  400. <span class="sd">&quot;&quot;&quot;</span>
  401. <span class="o">...</span>
  402. <span class="kn">from</span> <span class="nn">macop.operators.mutators.SimpleMutation</span> <span class="kn">import</span> <span class="n">SimpleMutation</span>
  403. <span class="kn">from</span> <span class="nn">macop.operators.mutators.SimpleBinaryMutation</span> <span class="kn">import</span> <span class="n">SimpleBinaryMutation</span>
  404. <span class="kn">from</span> <span class="nn">macop.operators.crossovers.SimpleCrossover</span> <span class="kn">import</span> <span class="n">SimpleCrossover</span>
  405. <span class="kn">from</span> <span class="nn">macop.operators.policies.UCBPolicy</span> <span class="kn">import</span> <span class="n">UCBPolicy</span>
  406. <span class="sd">&quot;&quot;&quot;</span>
  407. <span class="sd">Problem definition</span>
  408. <span class="sd">&quot;&quot;&quot;</span>
  409. <span class="o">...</span>
  410. <span class="sd">&quot;&quot;&quot;</span>
  411. <span class="sd">Algorithm parameters</span>
  412. <span class="sd">&quot;&quot;&quot;</span>
  413. <span class="c1"># list of operators instance to use</span>
  414. <span class="n">operators</span> <span class="o">=</span> <span class="p">[</span><span class="n">SimpleBinaryMutation</span><span class="p">(),</span> <span class="n">SimpleMutation</span><span class="p">(),</span> <span class="n">SimpleCrossover</span><span class="p">(),</span> <span class="n">RandomSplitCrossover</span><span class="p">()]</span>
  415. <span class="c1"># `policy` instance is created using specific value for Upper Confidence Bound</span>
  416. <span class="n">policy</span> <span class="o">=</span> <span class="n">UCBPolicy</span><span class="p">(</span><span class="n">operators</span><span class="p">,</span> <span class="n">C</span><span class="o">=</span><span class="mf">100.</span><span class="p">)</span>
  417. </pre></div>
  418. </div>
  419. </div>
  420. <div class="section" id="how-works-multi-objective-in-macop">
  421. <h3>1.3 How works multi-objective in macop ?<a class="headerlink" href="#how-works-multi-objective-in-macop" title="Permalink to this headline">¶</a></h3>
  422. <p>As we have now multiple objectives, we define a new algorithm named MOEAD for <cite>MultiObjective Evolutionary Algorithm with Decomposition</cite> inside <cite>macop.algorithms.multi.MOEAD</cite>.
  423. The principle of this algorithm is to decompose the multi-objective problem into several single-objective problems (see <a class="reference external" href="https://sites.google.com/view/moead/home">MOEAD</a> documentation framework).
  424. To implement this algorithm, we now define the attribute <cite>evaluator</cite> as a list of evaluators. The number of objectives is defined by the length of this list and generated weights for each sub problem too.</p>
  425. <p>The <cite>mu</cite> attribute represent the number of sub problems and hence our current population of solutions.</p>
  426. <p>In order to represent the <cite>mu</cite> mono-objective sub problems (obtained from weighted decomposition), we define the <cite>macop.algorithms.multi.MOSubProblem</cite> class.
  427. This class enables to compute and find best solution from weighted decomposition. The <cite>weights</cite> attribute of this class stores the weight for each objective of this sub problem instance.</p>
  428. <p>The <cite>evaluator</cite> of MOSubProblem is defined as below:</p>
  429. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">moEvaluator</span><span class="p">(</span><span class="n">_solution</span><span class="p">,</span> <span class="n">_evaluator</span><span class="p">,</span> <span class="n">_weights</span><span class="p">):</span>
  430. <span class="n">scores</span> <span class="o">=</span> <span class="p">[</span><span class="nb">eval</span><span class="p">(</span><span class="n">_solution</span><span class="p">)</span> <span class="k">for</span> <span class="nb">eval</span> <span class="ow">in</span> <span class="n">_evaluator</span><span class="p">]</span>
  431. <span class="c1"># associate objectives scores to solution</span>
  432. <span class="n">_solution</span><span class="o">.</span><span class="n">scores</span> <span class="o">=</span> <span class="n">scores</span>
  433. <span class="c1"># return the weighted sum</span>
  434. <span class="k">return</span> <span class="nb">sum</span><span class="p">([</span><span class="n">scores</span><span class="p">[</span><span class="n">i</span><span class="p">]</span> <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">w</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">_weights</span><span class="p">)])</span>
  435. <span class="o">...</span>
  436. <span class="c1"># compute weighted sum from solution using list of evaluators and weights for current sub problem</span>
  437. <span class="n">sub_evaluator</span> <span class="o">=</span> <span class="k">lambda</span> <span class="n">_solution</span><span class="p">:</span> <span class="n">moEvaluator</span><span class="p">(</span><span class="n">_solution</span><span class="p">,</span> <span class="n">_evaluator</span><span class="p">,</span> <span class="n">weights</span><span class="p">[</span><span class="n">i</span><span class="p">])</span>
  438. </pre></div>
  439. </div>
  440. <p>This function computes the weighted sum of objectives (to transform sub problem into mono-objective) and also stores the objectives scores into solution using the dynamic added <cite>scores</cite> attributes.
  441. This is an example, we based our function using classical weighted sum, we can also implement <a class="reference external" href="https://repository.lib.ncsu.edu/handle/1840.16/272">Tchebychev</a> method.</p>
  442. <p>We can now instance our MOEAD algorithm:</p>
  443. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">&quot;&quot;&quot;</span>
  444. <span class="sd">imports part</span>
  445. <span class="sd">&quot;&quot;&quot;</span>
  446. <span class="o">...</span>
  447. <span class="kn">import</span> <span class="nn">logging</span>
  448. <span class="kn">from</span> <span class="nn">macop.algorithms.multi.MOEAD</span> <span class="kn">import</span> <span class="n">MOEAD</span>
  449. <span class="sd">&quot;&quot;&quot;</span>
  450. <span class="sd">Problem definition</span>
  451. <span class="sd">&quot;&quot;&quot;</span>
  452. <span class="o">...</span>
  453. <span class="sd">&quot;&quot;&quot;</span>
  454. <span class="sd">Algorithm parameters</span>
  455. <span class="sd">&quot;&quot;&quot;</span>
  456. <span class="o">...</span>
  457. <span class="k">if</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="s1">&#39;data&#39;</span><span class="p">):</span>
  458. <span class="n">os</span><span class="o">.</span><span class="n">makedirs</span><span class="p">(</span><span class="s1">&#39;data&#39;</span><span class="p">)</span>
  459. <span class="c1"># logging configuration</span>
  460. <span class="n">logging</span><span class="o">.</span><span class="n">basicConfig</span><span class="p">(</span><span class="nb">format</span><span class="o">=</span><span class="s1">&#39;</span><span class="si">%(asctime)s</span><span class="s1"> </span><span class="si">%(message)s</span><span class="s1">&#39;</span><span class="p">,</span> <span class="n">filename</span><span class="o">=</span><span class="s1">&#39;data/example.log&#39;</span><span class="p">,</span> <span class="n">level</span><span class="o">=</span><span class="n">logging</span><span class="o">.</span><span class="n">DEBUG</span><span class="p">)</span>
  461. <span class="n">algo</span> <span class="o">=</span> <span class="n">MOEAD</span><span class="p">(</span><span class="n">init</span><span class="p">,</span> <span class="p">[</span><span class="n">evaluator1</span><span class="p">,</span> <span class="n">evaluator2</span><span class="p">],</span> <span class="n">operators</span><span class="p">,</span> <span class="n">policy</span><span class="p">,</span> <span class="n">validator</span><span class="p">,</span> <span class="n">_maximise</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
  462. </pre></div>
  463. </div>
  464. </div>
  465. <div class="section" id="checkpoint-multi-objective-solutions">
  466. <h3>1.4 Checkpoint multi-objective solutions<a class="headerlink" href="#checkpoint-multi-objective-solutions" title="Permalink to this headline">¶</a></h3>
  467. <p>To keep track of our <cite>mu</cite> population and <cite>pfPop</cite> pareto front set, 2 new callbacks have been defined:</p>
  468. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">&quot;&quot;&quot;</span>
  469. <span class="sd">imports part</span>
  470. <span class="sd">&quot;&quot;&quot;</span>
  471. <span class="o">...</span>
  472. <span class="kn">import</span> <span class="nn">logging</span>
  473. <span class="kn">from</span> <span class="nn">macop.algorithms.multi.MOEAD</span> <span class="kn">import</span> <span class="n">MOEAD</span>
  474. <span class="kn">from</span> <span class="nn">macop.callbacks.MultiCheckpoint</span> <span class="kn">import</span> <span class="n">MultiCheckpoint</span>
  475. <span class="kn">from</span> <span class="nn">macop.callbacks.ParetoCheckpoint</span> <span class="kn">import</span> <span class="n">ParetoCheckpoint</span>
  476. <span class="sd">&quot;&quot;&quot;</span>
  477. <span class="sd">Problem definition</span>
  478. <span class="sd">&quot;&quot;&quot;</span>
  479. <span class="o">...</span>
  480. <span class="sd">&quot;&quot;&quot;</span>
  481. <span class="sd">Algorithm parameters</span>
  482. <span class="sd">&quot;&quot;&quot;</span>
  483. <span class="o">...</span>
  484. <span class="k">if</span> <span class="ow">not</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="s1">&#39;data&#39;</span><span class="p">):</span>
  485. <span class="n">os</span><span class="o">.</span><span class="n">makedirs</span><span class="p">(</span><span class="s1">&#39;data&#39;</span><span class="p">)</span>
  486. <span class="c1"># logging configuration</span>
  487. <span class="n">logging</span><span class="o">.</span><span class="n">basicConfig</span><span class="p">(</span><span class="nb">format</span><span class="o">=</span><span class="s1">&#39;</span><span class="si">%(asctime)s</span><span class="s1"> </span><span class="si">%(message)s</span><span class="s1">&#39;</span><span class="p">,</span> <span class="n">filename</span><span class="o">=</span><span class="s1">&#39;data/example.log&#39;</span><span class="p">,</span> <span class="n">level</span><span class="o">=</span><span class="n">logging</span><span class="o">.</span><span class="n">DEBUG</span><span class="p">)</span>
  488. <span class="n">algo</span> <span class="o">=</span> <span class="n">ILS</span><span class="p">(</span><span class="n">init</span><span class="p">,</span> <span class="n">evaluator</span><span class="p">,</span> <span class="n">operators</span><span class="p">,</span> <span class="n">policy</span><span class="p">,</span> <span class="n">validator</span><span class="p">,</span> <span class="n">_maximise</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
  489. <span class="c1"># Add this callback instance into list of callback</span>
  490. <span class="c1"># It tells the algorithm to apply this callback every 5 evaluations</span>
  491. <span class="c1"># And also the algorithm to load checkpoint if exists before running by using `load` method of callback</span>
  492. <span class="n">algo</span><span class="o">.</span><span class="n">addCallback</span><span class="p">(</span><span class="n">MultiCheckpoint</span><span class="p">(</span><span class="n">_every</span><span class="o">=</span><span class="mi">5</span><span class="p">,</span> <span class="n">_filepath</span><span class="o">=</span><span class="s1">&#39;data/checkpointMOEAD.csv&#39;</span><span class="p">))</span>
  493. <span class="c1"># add Pareto Checkpoint callback instance too</span>
  494. <span class="n">algo</span><span class="o">.</span><span class="n">addCallback</span><span class="p">(</span><span class="n">ParetoCheckpoint</span><span class="p">(</span><span class="n">_every</span><span class="o">=</span><span class="mi">5</span><span class="p">,</span> <span class="n">_filepath</span><span class="o">=</span><span class="s1">&#39;data/paretoMOEAD.csv&#39;</span><span class="p">))</span>
  495. </pre></div>
  496. </div>
  497. <p>These callbacks only stores the last states of <cite>mu</cite> population and <cite>pfPop</cite>.</p>
  498. <p>We can also add the <cite>UCBCheckpoint</cite> callback which keeps track of UCB data obtained during previous run:</p>
  499. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="sd">&quot;&quot;&quot;</span>
  500. <span class="sd">imports part</span>
  501. <span class="sd">&quot;&quot;&quot;</span>
  502. <span class="o">...</span>
  503. <span class="kn">import</span> <span class="nn">logging</span>
  504. <span class="kn">from</span> <span class="nn">macop.callbacks.UCBCheckpoint</span> <span class="kn">import</span> <span class="n">UCBCheckpoint</span>
  505. <span class="sd">&quot;&quot;&quot;</span>
  506. <span class="sd">Problem definition</span>
  507. <span class="sd">&quot;&quot;&quot;</span>
  508. <span class="o">...</span>
  509. <span class="sd">&quot;&quot;&quot;</span>
  510. <span class="sd">Algorithm parameters</span>
  511. <span class="sd">&quot;&quot;&quot;</span>
  512. <span class="o">...</span>
  513. <span class="c1"># add UCB Checkpoint callback to keep track of UCB statistics obtained</span>
  514. <span class="n">algo</span><span class="o">.</span><span class="n">addCallback</span><span class="p">(</span><span class="n">UCBCheckpoint</span><span class="p">(</span><span class="n">_every</span><span class="o">=</span><span class="mi">5</span><span class="p">,</span> <span class="n">_filepath</span><span class="o">=</span><span class="s1">&#39;data/ucbPolicy.csv&#39;</span><span class="p">))</span>
  515. </pre></div>
  516. </div>
  517. <p>We can now run the MOEAD algorithm instance:</p>
  518. <div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="n">paretoFront</span> <span class="o">=</span> <span class="n">algo</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="mi">10000</span><span class="p">)</span>
  519. <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;Pareto front is composed of&quot;</span><span class="p">,</span> <span class="nb">len</span><span class="p">(</span><span class="n">paretoFront</span><span class="p">),</span> <span class="s2">&quot;solutions&quot;</span><span class="p">)</span>
  520. </pre></div>
  521. </div>
  522. </div>
  523. </div>
  524. </div>
  525. </div>
  526. </div>
  527. <footer>
  528. <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
  529. <a href="contributing.html" class="btn btn-neutral float-right" title="Contributing" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
  530. <a href="macop/macop.solutions.Solution.html" class="btn btn-neutral float-left" title="macop.solutions.Solution" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
  531. </div>
  532. <hr/>
  533. <div role="contentinfo">
  534. <p>
  535. &copy; Copyright 2020, Jérôme BUISINE
  536. </p>
  537. </div>
  538. Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
  539. </footer>
  540. </div>
  541. </div>
  542. </section>
  543. </div>
  544. <script type="text/javascript">
  545. jQuery(function () {
  546. SphinxRtdTheme.Navigation.enable(true);
  547. });
  548. </script>
  549. </body>
  550. </html>