From 6e281c2e17d42435ee0539d7468490693eca86d9 Mon Sep 17 00:00:00 2001
From: IsaacLera <isaac.lera@gmail.com>
Date: Mon, 2 Sep 2019 16:27:49 +0200
Subject: [PATCH] fixing doc

---
 .../api_reference/yafs.application.doctree    | Bin 40781 -> 40776 bytes
 .../doctrees/api_reference/yafs.core.doctree  | Bin 55164 -> 60736 bytes
 .../build/doctrees/api_reference/yafs.doctree | Bin 25463 -> 29344 bytes
 .../api_reference/yafs.selection.doctree      | Bin 22796 -> 26587 bytes
 docs/build/doctrees/environment.pickle        | Bin 128852 -> 142486 bytes
 docs/build/doctrees/index.doctree             | Bin 24780 -> 25696 bytes
 .../build/doctrees/introduction/basic.doctree | Bin 59126 -> 59130 bytes
 docs/build/html/_modules/yafs/core.html       | 302 +++++++++++++++---
 docs/build/html/_modules/yafs/placement.html  |  29 +-
 docs/build/html/_modules/yafs/selection.html  |  29 +-
 docs/build/html/_modules/yafs/topology.html   |  58 +++-
 docs/build/html/api_reference/yafs.core.html  |  38 ++-
 docs/build/html/api_reference/yafs.html       |  21 ++
 .../html/api_reference/yafs.selection.html    |  39 ++-
 .../html/api_reference/yafs.topology.html     |  24 +-
 docs/build/html/api_reference/yafs.utils.html |  22 +-
 docs/build/html/contents.html                 |   1 +
 docs/build/html/genindex.html                 |   8 +-
 docs/build/html/index.html                    |  24 +-
 docs/build/html/introduction/basic.html       |   2 +-
 docs/build/html/objects.inv                   | Bin 1447 -> 1479 bytes
 docs/build/html/searchindex.js                |   2 +-
 docs/index.rst                                |  21 +-
 23 files changed, 489 insertions(+), 131 deletions(-)

diff --git a/docs/build/doctrees/api_reference/yafs.application.doctree b/docs/build/doctrees/api_reference/yafs.application.doctree
index 31606f43b50d54e105e3ed6636d439df83e82fb0..679df55854fa504139a61209df01757b78a6cd03 100644
GIT binary patch
delta 221
zcmX@RkLkodrVW$lI){p-W#**DXXX{B7L{b?=f$VyB_`#hrW6UVF)(z5au+3*!-WKa
zLf(v_yeXx*1@XnHB_)}8>BU7tlW)(J;}!<VF=Xi07Kuz|nHOLu3gl}x7Ks6=+9Giv
zsga=+%8;R)p^%}H;hCWp%2twCl%85rBmtDm(5Nkv1gp`C&Crc4lA1heUYxKrSg#C7
pUM<5Iq(*i!^L#A@IiN^vkvxzLWh+We%S<UQQUEJe1d^pmdH@27J@x<q

delta 188
zcmX@HkLm0_rVW$l8Wjn!F))ORrDf)%#%JagrxulD=I6zy<|QWOq^1-J0wp^_xr-9Z
z;X*=_56l&16rOx-t{k@rP}-XzL$|g_bn^eX0eoUWzGh>QIFPC>l9(JjPg+zG$j;EH
zEs_G#8W~!#8M?7W(vy4V#R<!RRmp<n)iR7hYUC#Wo2R894-|<lQUH>nY(=SQnJL9Z
NieRNmK(aJR4*&vZHWB~;

diff --git a/docs/build/doctrees/api_reference/yafs.core.doctree b/docs/build/doctrees/api_reference/yafs.core.doctree
index 4bf87598a4e88dbead21a33f8ee50c671c87ab19..428732202ce883b6a42f135de891e3916fb91f2c 100644
GIT binary patch
literal 60736
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

literal 55164
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
COldO!

diff --git a/docs/build/doctrees/api_reference/yafs.doctree b/docs/build/doctrees/api_reference/yafs.doctree
index 6f5c297edb57f55eb9b7aa48218581a6dae9843e..0746a1723addba5f2ce2dc2c7721bd3763bcd8e6 100644
GIT binary patch
literal 29344
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
P@(>EXJdEGkP|yDWHZAZ%

literal 25463
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
bM|2&P#rVzfGFJR`1KA0MK$hUQIX3t|&?Q<L

diff --git a/docs/build/doctrees/api_reference/yafs.selection.doctree b/docs/build/doctrees/api_reference/yafs.selection.doctree
index 0560ae9c2e9898b0709dfdb94c30b66ad94ba7ed..205b948809f9857a1817c0e49be763199e3493ff 100644
GIT binary patch
literal 26587
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
X0eKQnz0sB~&QpkBi5SnyV9);moy0i$

literal 22796
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
DgKSMh

diff --git a/docs/build/doctrees/environment.pickle b/docs/build/doctrees/environment.pickle
index e2bd52166ff6f94d77bbd677dbd993640fff868f..c607939c21c7e87c9a88c3454a318bf98c0deeb7 100644
GIT binary patch
delta 42841
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

delta 30941
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
E2i37;2mk;8

diff --git a/docs/build/doctrees/index.doctree b/docs/build/doctrees/index.doctree
index d039c4cab9ed339cb4be4f501ce1780b87275952..b8d54086679c6f4569ec2ada780bcfa059ddd82b 100644
GIT binary patch
literal 25696
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

literal 24780
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

diff --git a/docs/build/doctrees/introduction/basic.doctree b/docs/build/doctrees/introduction/basic.doctree
index 3abb8532071ad44d1b7c9bd8527ef19978ac25a3..0abdb75e582c33f99401e5a3e6581d501cf4ddbe 100644
GIT binary patch
delta 108
zcmex%migCN<_%3EjDC~(MU5CWCOe9XFgt~7PCg^zG`UH{7)c~TbU%w70|UckMNtKa
luoO_Cg0@0HkY?eh*2comwS`|aGBhGk6@g6Kyg)4M0sz?OA9w%&

delta 158
zcmex$migOR<_%3ElleuB#eGwYixbmR^@=mAQuUHDONtfr6*Qc}C!ZB@V)U6TAZmnD
vMU?1%M%&3!V#?Y$%uvu)2nf<F{M6c5__?<5i$;b<1Xw*T6E`mr3%dXS3X?Xb

diff --git a/docs/build/html/_modules/yafs/core.html b/docs/build/html/_modules/yafs/core.html
index d07679c0..efd806b7 100644
--- a/docs/build/html/_modules/yafs/core.html
+++ b/docs/build/html/_modules/yafs/core.html
@@ -51,7 +51,9 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
 <span class="kn">import</span> <span class="nn">copy</span>
 
 <span class="kn">import</span> <span class="nn">simpy</span>
+<span class="kn">import</span> <span class="nn">scipy.spatial</span>
 <span class="kn">from</span> <span class="nn">tqdm</span> <span class="k">import</span> <span class="n">tqdm</span>
+<span class="kn">import</span> <span class="nn">networkx</span> <span class="k">as</span> <span class="nn">nx</span>
 
 <span class="kn">from</span> <span class="nn">yafs.topology</span> <span class="k">import</span> <span class="n">Topology</span>
 <span class="kn">from</span> <span class="nn">yafs.application</span> <span class="k">import</span> <span class="n">Application</span>
@@ -59,7 +61,11 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
 <span class="kn">from</span> <span class="nn">yafs.distribution</span> <span class="k">import</span> <span class="o">*</span>
 <span class="kn">from</span> <span class="nn">yafs</span> <span class="k">import</span> <span class="n">utils</span>
 
+<span class="kn">from</span> <span class="nn">trackanimation.animation</span> <span class="k">import</span> <span class="n">AnimationTrack</span>
+
 <span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+<span class="kn">import</span> <span class="nn">smopy</span>
+<span class="kn">from</span> <span class="nn">PIL</span> <span class="k">import</span> <span class="n">Image</span> <span class="k">as</span> <span class="n">pimg</span>
 
 <span class="n">EVENT_UP_ENTITY</span> <span class="o">=</span> <span class="s2">&quot;node_up&quot;</span>
 <span class="n">EVENT_DOWN_ENTITY</span> <span class="o">=</span> <span class="s2">&quot;node_down&quot;</span>
@@ -206,10 +212,25 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
 
 
 
+
+        <span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">        MOBILE ADAPTATIONS</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">service_coverage</span> <span class="o">=</span> <span class="p">{}</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">tolerance</span> <span class="o">=</span> <span class="mf">0.0001</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">user_tracks</span> <span class="o">=</span> <span class="kc">None</span>
+
+        <span class="c1">#v2</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">endpoints</span> <span class="o">=</span> <span class="p">[]</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">user_tracks</span> <span class="o">=</span> <span class="kc">None</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">map</span> <span class="o">=</span> <span class="kc">None</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">coverage</span> <span class="o">=</span> <span class="kc">None</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">control_movement_class</span> <span class="o">=</span> <span class="kc">None</span>
+
     <span class="c1"># self.__send_message(app_name, message, idDES, self.SOURCE_METRIC)</span>
     <span class="k">def</span> <span class="nf">__send_message</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app_name</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="n">idDES</span><span class="p">,</span> <span class="nb">type</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        Any exchange of messages is done with this function. It is responsible for updating the metrics</span>
+<span class="sd">        Any exchange of messages between modules is done with this function and updates the metrics when the message achieves the destination module</span>
 
 <span class="sd">        Args:</span>
 <span class="sd">            app_name (string)º</span>
@@ -221,12 +242,21 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
 <span class="sd">        &quot;&quot;&quot;</span>
         <span class="c1">#TODO IMPROVE asignation of topo = alloc_DES(IdDES) , It has to move to the get_path process</span>
         <span class="k">try</span><span class="p">:</span>
-            <span class="n">paths</span><span class="p">,</span><span class="n">DES_dst</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">selector_path</span><span class="p">[</span><span class="n">app_name</span><span class="p">]</span><span class="o">.</span><span class="n">get_path</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span><span class="n">app_name</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">alloc_DES</span><span class="p">[</span><span class="n">idDES</span><span class="p">],</span> <span class="bp">self</span><span class="o">.</span><span class="n">alloc_DES</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">alloc_module</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">last_busy_time</span><span class="p">)</span>
+            <span class="n">paths</span><span class="p">,</span><span class="n">DES_dst</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">selector_path</span><span class="p">[</span><span class="n">app_name</span><span class="p">]</span><span class="o">.</span><span class="n">get_path</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span><span class="n">app_name</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">alloc_DES</span><span class="p">[</span><span class="n">idDES</span><span class="p">],</span> <span class="bp">self</span><span class="o">.</span><span class="n">alloc_DES</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">alloc_module</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">last_busy_time</span><span class="p">,</span><span class="n">from_des</span><span class="o">=</span><span class="n">idDES</span><span class="p">)</span>
 
             <span class="k">if</span> <span class="n">DES_dst</span> <span class="o">==</span> <span class="p">[</span><span class="kc">None</span><span class="p">]</span> <span class="ow">or</span> <span class="n">DES_dst</span><span class="o">==</span><span class="p">[[]]:</span>
                 <span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
                     <span class="s2">&quot;(#DES:</span><span class="si">%i</span><span class="s2">)</span><span class="se">\t</span><span class="s2">--- Unreacheable DST:</span><span class="se">\t</span><span class="si">%s</span><span class="s2">: PATH:</span><span class="si">%s</span><span class="s2"> &quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">idDES</span><span class="p">,</span> <span class="n">message</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="n">paths</span><span class="p">))</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">print_debug_assignaments</span><span class="p">()</span>
+
+                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">isEnabledFor</span><span class="p">(</span><span class="s2">&quot;Debug&quot;</span><span class="p">):</span>
+                    <span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;From __send_message function: &quot;</span><span class="p">)</span>
+                    <span class="c1"># self.print_debug_assignaments()</span>
+                    <span class="c1"># print &quot;NODES (%i): %s&quot;%(len(self.topology.G.nodes()),self.topology.G.nodes())</span>
+                    <span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;NODES (</span><span class="si">%i</span><span class="s2">)&quot;</span> <span class="o">%</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">topology</span><span class="o">.</span><span class="n">G</span><span class="o">.</span><span class="n">nodes</span><span class="p">()))</span>
+
+                    <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">control_movement_class</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+                        <span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;STEP : &quot;</span><span class="p">,</span><span class="bp">self</span><span class="o">.</span><span class="n">control_movement_class</span><span class="o">.</span><span class="n">current_step</span><span class="p">)</span>
+
             <span class="k">else</span><span class="p">:</span>
 
                 <span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;(#DES:</span><span class="si">%i</span><span class="s2">)</span><span class="se">\t</span><span class="s2">--- SENDING Message:</span><span class="se">\t</span><span class="si">%s</span><span class="s2">: PATH:</span><span class="si">%s</span><span class="s2">  DES:</span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">idDES</span><span class="p">,</span> <span class="n">message</span><span class="o">.</span><span class="n">name</span><span class="p">,</span><span class="n">paths</span><span class="p">,</span><span class="n">DES_dst</span><span class="p">))</span>
@@ -243,6 +273,7 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
         <span class="k">except</span> <span class="ne">KeyError</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="s2">&quot;(#DES:</span><span class="si">%i</span><span class="s2">)</span><span class="se">\t</span><span class="s2">--- Unreacheable DST:</span><span class="se">\t</span><span class="si">%s</span><span class="s2"> &quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">idDES</span><span class="p">,</span> <span class="n">message</span><span class="o">.</span><span class="n">name</span><span class="p">))</span>
 
+
     <span class="k">def</span> <span class="nf">__network_process</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">        This is an internal DES-process who manages the latency of messages sent in the network.</span>
@@ -250,7 +281,8 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
 <span class="sd">        In this way, the message has a transmission latency.</span>
 <span class="sd">        &quot;&quot;&quot;</span>
         <span class="n">edges</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">topology</span><span class="o">.</span><span class="n">get_edges</span><span class="p">()</span><span class="o">.</span><span class="n">keys</span><span class="p">()</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">last_busy_time</span> <span class="o">=</span> <span class="p">{}</span> <span class="c1"># dict(zip(edges, [0.0] * len(edges)))</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">last_busy_time</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># dict(zip(edges, [0.0] * len(edges)))</span>
+
         <span class="k">while</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">stop</span><span class="p">:</span>
             <span class="n">message</span> <span class="o">=</span> <span class="k">yield</span> <span class="bp">self</span><span class="o">.</span><span class="n">network_ctrl_pipe</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
 
@@ -323,9 +355,9 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
                     <span class="bp">self</span><span class="o">.</span><span class="n">env</span><span class="o">.</span><span class="n">process</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">__wait_message</span><span class="p">(</span><span class="n">message</span><span class="p">,</span> <span class="n">latency_msg_link</span><span class="p">,</span> <span class="n">shift_time</span><span class="p">))</span>
                 <span class="k">except</span><span class="p">:</span>
                     <span class="c1">#This fact is produced when a node or edge the topology is changed or disappeared</span>
-                    <span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="s2">&quot;The initial path assigned is unreachabled. Link: (</span><span class="si">%i</span><span class="s2">,</span><span class="si">%i</span><span class="s2">). Routing a new one. &quot;</span><span class="o">%</span><span class="p">(</span><span class="n">link</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="n">link</span><span class="p">[</span><span class="mi">1</span><span class="p">]))</span>
+                    <span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="s2">&quot;The initial path assigned is unreachabled. Link: (</span><span class="si">%i</span><span class="s2">,</span><span class="si">%i</span><span class="s2">). Routing a new one. </span><span class="si">%i</span><span class="s2">&quot;</span><span class="o">%</span><span class="p">(</span><span class="n">link</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span><span class="n">link</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span><span class="bp">self</span><span class="o">.</span><span class="n">env</span><span class="o">.</span><span class="n">now</span><span class="p">))</span>
 
-                    <span class="n">paths</span><span class="p">,</span> <span class="n">DES_dst</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">selector_path</span><span class="p">[</span><span class="n">message</span><span class="o">.</span><span class="n">app_name</span><span class="p">]</span><span class="o">.</span><span class="n">get_path_from_failure</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="n">link</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">alloc_DES</span><span class="p">,</span><span class="bp">self</span><span class="o">.</span><span class="n">alloc_module</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">last_busy_time</span><span class="p">,</span><span class="bp">self</span><span class="o">.</span><span class="n">env</span><span class="o">.</span><span class="n">now</span><span class="p">)</span>
+                    <span class="n">paths</span><span class="p">,</span> <span class="n">DES_dst</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">selector_path</span><span class="p">[</span><span class="n">message</span><span class="o">.</span><span class="n">app_name</span><span class="p">]</span><span class="o">.</span><span class="n">get_path_from_failure</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="n">link</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">alloc_DES</span><span class="p">,</span><span class="bp">self</span><span class="o">.</span><span class="n">alloc_module</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">last_busy_time</span><span class="p">,</span><span class="bp">self</span><span class="o">.</span><span class="n">env</span><span class="o">.</span><span class="n">now</span><span class="p">,</span><span class="n">from_des</span><span class="o">=</span><span class="n">message</span><span class="o">.</span><span class="n">idDES</span><span class="p">)</span>
 
                     <span class="k">if</span> <span class="n">DES_dst</span> <span class="o">==</span> <span class="p">[]</span> <span class="ow">and</span> <span class="n">paths</span><span class="o">==</span><span class="p">[]:</span>
                         <span class="c1">#Message communication ending:</span>
@@ -427,7 +459,6 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
 
     <span class="k">def</span> <span class="nf">__update_node_metrics</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app</span><span class="p">,</span> <span class="n">module</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="n">des</span><span class="p">,</span> <span class="nb">type</span><span class="p">):</span>
         <span class="k">try</span><span class="p">:</span>
-
             <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">            It computes the service time in processing a message and record this event</span>
 <span class="sd">            &quot;&quot;&quot;</span>
@@ -443,7 +474,9 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
 <span class="sd">                &quot;&quot;&quot;</span>
                 <span class="n">id_node</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">alloc_DES</span><span class="p">[</span><span class="n">des</span><span class="p">]</span>
 
-                <span class="n">att_node</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">topology</span><span class="o">.</span><span class="n">get_nodes_att</span><span class="p">()[</span><span class="n">id_node</span><span class="p">]</span>
+                <span class="c1"># att_node = self.topology.get_nodes_att()[id_node] # WARNING DEPRECATED from V1.0</span>
+                <span class="n">att_node</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">topology</span><span class="o">.</span><span class="n">G</span><span class="o">.</span><span class="n">nodes</span><span class="p">[</span><span class="n">id_node</span><span class="p">]</span>
+
                 <span class="n">time_service</span> <span class="o">=</span> <span class="n">message</span><span class="o">.</span><span class="n">inst</span> <span class="o">/</span> <span class="nb">float</span><span class="p">(</span><span class="n">att_node</span><span class="p">[</span><span class="s2">&quot;IPT&quot;</span><span class="p">])</span>
 
 
@@ -454,21 +487,24 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
             <span class="c1">#     from_id_source = id_node  # same src like dst</span>
             <span class="c1"># else:</span>
             <span class="c1">#     from_id_source = message.path[0]</span>
-
-            <span class="c1"># print &quot;-&quot;*50</span>
-            <span class="c1"># print &quot;Module: &quot;,module # module that receives the request (RtR)</span>
-            <span class="c1"># print &quot;DES &quot;,des # DES process who RtR</span>
-            <span class="c1"># print &quot;ID MODULE: &quot;,id_node  #Topology entity who RtR</span>
-            <span class="c1"># print &quot;Message.name &quot;,message.name # Message name</span>
-            <span class="c1"># print &quot;Message.id &quot;, message.id #Message generator id</span>
-            <span class="c1"># print &quot;Message.path &quot;,message.path #enrouting path</span>
-            <span class="c1"># print &quot;Message src &quot;,message.src #module source who send the request</span>
-            <span class="c1"># print &quot;Message dst &quot;,message.dst #module dst (the entity that RtR)</span>
-            <span class="c1"># print &quot;Message idDEs &quot;,message.idDES #DES intermediate process that process the request</span>
-            <span class="c1"># print &quot;TOPO.src &quot;, message.path[0] #entity that RtR</span>
-            <span class="c1"># print &quot;TOPO.dst &quot;, int(self.alloc_DES[des]) #DES process that RtR</span>
-
             <span class="c1">#</span>
+     <span class="c1"># # if message.id == 1072:</span>
+     <span class="c1">#        print &quot;-&quot;*50</span>
+     <span class="c1">#        print &quot;Module: &quot;,module # module that receives the request (RtR)</span>
+     <span class="c1">#        print &quot;DES &quot;,des # DES process who RtR</span>
+     <span class="c1">#        print &quot;ID MODULE: &quot;,id_node  #Topology entity who RtR</span>
+     <span class="c1">#        print &quot;Message.name &quot;,message.name # Message name</span>
+     <span class="c1">#        print &quot;Message.id &quot;, message.id #Message generator id</span>
+     <span class="c1">#        print &quot;Message.path &quot;,message.path #enrouting path</span>
+     <span class="c1">#        print &quot;Message src &quot;,message.src #module source who send the request</span>
+     <span class="c1">#        print &quot;Message dst &quot;,message.dst #module dst (the entity that RtR)</span>
+     <span class="c1">#        print &quot;Message idDEs &quot;,message.idDES #DES intermediate process that process the request</span>
+     <span class="c1">#        print &quot;TOPO.src &quot;, message.path[0] #entity that RtR</span>
+     <span class="c1">#        print &quot;TOPO.dst &quot;, int(self.alloc_DES[des]) #DES process that RtR</span>
+     <span class="c1">#        print &quot;time service &quot;,time_service</span>
+     <span class="c1">#        exit()</span>
+
+     <span class="c1">#</span>
             <span class="c1"># # print &quot;MODULE: &quot;,self.alloc_module[app][module]</span>
             <span class="c1"># # tmp = []</span>
             <span class="c1"># # for it in self.alloc_module[app][module]:</span>
@@ -507,8 +543,10 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
             <span class="k">return</span> <span class="n">time_service</span>
         <span class="k">except</span> <span class="ne">KeyError</span><span class="p">:</span>
             <span class="c1"># The node can be removed</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Updating node metrics - Node removed: DES:</span><span class="si">%i</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="n">des</span><span class="p">)</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">critical</span><span class="p">(</span><span class="s2">&quot;Make sure that this node has been removed or it has all mandatory attributes - Node: DES:</span><span class="si">%i</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="n">des</span><span class="p">)</span>
             <span class="k">return</span> <span class="mi">0</span>
+
+
         <span class="c1"># self.logger.debug(&quot;TS[%s] - DES: %i - %d&quot;%(module,des,time_service))</span>
         <span class="c1"># except:</span>
         <span class="c1">#     self.logger.warning(&quot;This module has been removed previously to the arrival time of this message. DES: %i&quot;%des)</span>
@@ -585,23 +623,27 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
                         <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">                        Processing the message</span>
 <span class="sd">                        &quot;&quot;&quot;</span>
-
-                        <span class="c1"># print &quot;Consumer Message: %d &quot; % self.env.now</span>
-                        <span class="c1"># print &quot;MODULE DES: &quot;,ides</span>
-                        <span class="c1"># print &quot;id &quot;,msg.id</span>
-                        <span class="c1"># print &quot;name &quot;,msg.name</span>
-                        <span class="c1"># print msg.path</span>
-                        <span class="c1"># print msg.dst_int</span>
-                        <span class="c1"># print msg.timestamp</span>
-                        <span class="c1"># print msg.dst</span>
+                        <span class="c1"># if ides == 3:</span>
+                        <span class="c1">#     print &quot;Consumer Message: %d &quot; % self.env.now</span>
+                        <span class="c1">#     print &quot;MODULE DES: &quot;,ides</span>
+                        <span class="c1">#     print &quot;id &quot;,msg.id</span>
+                        <span class="c1">#     print &quot;name &quot;,msg.name</span>
+                        <span class="c1">#     print msg.path</span>
+                        <span class="c1">#     print msg.dst_int</span>
+                        <span class="c1">#     print msg.timestamp</span>
+                        <span class="c1">#     print msg.dst</span>
                         <span class="c1">#</span>
-                        <span class="c1"># print &quot;-&quot; * 30</span>
+                        <span class="c1">#     print &quot;-&quot; * 30</span>
 
                         <span class="c1">#The module only computes this type of message one time.</span>
                         <span class="c1">#It records once</span>
                         <span class="k">if</span> <span class="ow">not</span> <span class="n">doBefore</span><span class="p">:</span>
+                            <span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
+                                <span class="s2">&quot;(App:</span><span class="si">%s</span><span class="s2">#DES:</span><span class="si">%i</span><span class="s2">#</span><span class="si">%s</span><span class="s2">)</span><span class="se">\t</span><span class="s2">Module - Recording the message:</span><span class="se">\t</span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">app_name</span><span class="p">,</span> <span class="n">ides</span><span class="p">,</span> <span class="n">module</span><span class="p">,</span> <span class="n">msg</span><span class="o">.</span><span class="n">name</span><span class="p">))</span>
                             <span class="nb">type</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">NODE_METRIC</span>
+
                             <span class="n">service_time</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">__update_node_metrics</span><span class="p">(</span><span class="n">app_name</span><span class="p">,</span> <span class="n">module</span><span class="p">,</span> <span class="n">msg</span><span class="p">,</span> <span class="n">ides</span><span class="p">,</span> <span class="nb">type</span><span class="p">)</span>
+
                             <span class="k">yield</span> <span class="bp">self</span><span class="o">.</span><span class="n">env</span><span class="o">.</span><span class="n">timeout</span><span class="p">(</span><span class="n">service_time</span><span class="p">)</span>
                             <span class="n">doBefore</span> <span class="o">=</span> <span class="kc">True</span>
 
@@ -662,10 +704,11 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
 <span class="sd">            Processing the message</span>
 <span class="sd">            &quot;&quot;&quot;</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
-                <span class="s2">&quot;(App:</span><span class="si">%s</span><span class="s2">#DES:</span><span class="si">%i</span><span class="s2">#</span><span class="si">%s</span><span class="s2">)</span><span class="se">\t</span><span class="s2">Module - Sink Message:</span><span class="se">\t</span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">app_name</span><span class="p">,</span> <span class="n">ides</span><span class="p">,</span> <span class="n">module</span><span class="p">,</span> <span class="n">msg</span><span class="o">.</span><span class="n">name</span><span class="p">))</span>
+                <span class="s2">&quot;(App:</span><span class="si">%s</span><span class="s2">#DES:</span><span class="si">%i</span><span class="s2">#</span><span class="si">%s</span><span class="s2">)</span><span class="se">\t</span><span class="s2">Module Pure - Sink Message:</span><span class="se">\t</span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">app_name</span><span class="p">,</span> <span class="n">ides</span><span class="p">,</span> <span class="n">module</span><span class="p">,</span> <span class="n">msg</span><span class="o">.</span><span class="n">name</span><span class="p">))</span>
             <span class="nb">type</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">SINK_METRIC</span>
             <span class="n">service_time</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">__update_node_metrics</span><span class="p">(</span><span class="n">app_name</span><span class="p">,</span> <span class="n">module</span><span class="p">,</span> <span class="n">msg</span><span class="p">,</span> <span class="n">ides</span><span class="p">,</span> <span class="nb">type</span><span class="p">)</span>
             <span class="k">yield</span> <span class="bp">self</span><span class="o">.</span><span class="n">env</span><span class="o">.</span><span class="n">timeout</span><span class="p">(</span><span class="n">service_time</span><span class="p">)</span>  <span class="c1"># service time is 0</span>
+
         <span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;STOP_Process - Module Pure Sink: </span><span class="si">%s</span><span class="se">\t</span><span class="s2">#DES:</span><span class="si">%i</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">module</span><span class="p">,</span> <span class="n">ides</span><span class="p">))</span>
 
 
@@ -857,6 +900,7 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
 <span class="sd">        Add a DES process for deploy pure SINK modules (actuators)</span>
 <span class="sd">        This function its used by (:mod:`Placement`): algorithm</span>
 <span class="sd">        Internatlly, there is not a DES PROCESS for this type of behaviour</span>
+
 <span class="sd">        Args:</span>
 <span class="sd">            app_name (str): application name</span>
 
@@ -936,11 +980,17 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
         <span class="c1"># Add Selection control to the App</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">selector_path</span><span class="p">[</span><span class="n">app</span><span class="o">.</span><span class="n">name</span><span class="p">]</span> <span class="o">=</span> <span class="n">selector</span></div>
 
-    <span class="k">def</span> <span class="nf">get_alloc_entities</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+
+<div class="viewcode-block" id="Sim.get_alloc_entities"><a class="viewcode-back" href="../../api_reference/yafs.core.html#yafs.core.Sim.get_alloc_entities">[docs]</a>    <span class="k">def</span> <span class="nf">get_alloc_entities</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+        <span class="sd">&quot;&quot;&quot; It returns a dictionary of deployed services</span>
+<span class="sd">        key : id-node</span>
+<span class="sd">        value: a list of deployed services</span>
+<span class="sd">        &quot;&quot;&quot;</span>
         <span class="n">alloc_entities</span> <span class="o">=</span> <span class="p">{}</span>
-        <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">topology</span><span class="o">.</span><span class="n">nodeAttributes</span><span class="o">.</span><span class="n">keys</span><span class="p">():</span>
+        <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">topology</span><span class="o">.</span><span class="n">G</span><span class="o">.</span><span class="n">nodes</span><span class="p">:</span>
             <span class="n">alloc_entities</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="p">[]</span>
 
+
         <span class="k">for</span> <span class="n">id_des_process</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">alloc_source</span><span class="p">:</span>
             <span class="n">src_deployed</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">alloc_source</span><span class="p">[</span><span class="n">id_des_process</span><span class="p">]</span>
             <span class="c1"># print &quot;Module (SRC): %s(%s) - deployed at entity.id: %s&quot; %(src_deployed[&quot;module&quot;],src_deployed[&quot;app&quot;],src_deployed[&quot;id&quot;])</span>
@@ -952,7 +1002,7 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
                 <span class="k">for</span> <span class="n">idDES</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">alloc_module</span><span class="p">[</span><span class="n">app</span><span class="p">][</span><span class="n">module</span><span class="p">]:</span>
                     <span class="n">alloc_entities</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">alloc_DES</span><span class="p">[</span><span class="n">idDES</span><span class="p">]]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">app</span><span class="o">+</span><span class="s2">&quot;#&quot;</span><span class="o">+</span><span class="n">module</span><span class="p">)</span>
 
-        <span class="k">return</span> <span class="n">alloc_entities</span>
+        <span class="k">return</span> <span class="n">alloc_entities</span></div>
 
 
     <span class="k">def</span> <span class="nf">deploy_module</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span><span class="n">app_name</span><span class="p">,</span><span class="n">module</span><span class="p">,</span> <span class="n">services</span><span class="p">,</span><span class="n">ids</span><span class="p">):</span>
@@ -991,6 +1041,25 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
 
         <span class="k">return</span> <span class="n">id_DES</span>
 
+
+<div class="viewcode-block" id="Sim.undeploy_module"><a class="viewcode-back" href="../../api_reference/yafs.core.html#yafs.core.Sim.undeploy_module">[docs]</a>    <span class="k">def</span> <span class="nf">undeploy_module</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app_name</span><span class="p">,</span><span class="n">service_name</span><span class="p">,</span> <span class="n">idtopo</span><span class="p">):</span>
+        <span class="sd">&quot;&quot;&quot; removes all modules deployed in a node</span>
+<span class="sd">        modules with the same name = service_name</span>
+<span class="sd">        from app_name</span>
+<span class="sd">        deployed in id_topo</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="n">all_des</span> <span class="o">=</span> <span class="p">[]</span>
+        <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">alloc_DES</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+            <span class="k">if</span> <span class="n">v</span> <span class="o">==</span> <span class="n">idtopo</span><span class="p">:</span>
+                <span class="n">all_des</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">k</span><span class="p">)</span>
+
+        <span class="c1"># Clearing related structures</span>
+        <span class="k">for</span> <span class="n">des</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">alloc_module</span><span class="p">[</span><span class="n">app_name</span><span class="p">][</span><span class="n">service_name</span><span class="p">]:</span>
+            <span class="k">if</span> <span class="n">des</span> <span class="ow">in</span> <span class="n">all_des</span><span class="p">:</span>
+                <span class="bp">self</span><span class="o">.</span><span class="n">alloc_module</span><span class="p">[</span><span class="n">app_name</span><span class="p">][</span><span class="n">service_name</span><span class="p">]</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">des</span><span class="p">)</span>
+                <span class="bp">self</span><span class="o">.</span><span class="n">stop_process</span><span class="p">(</span><span class="n">des</span><span class="p">)</span>
+                <span class="k">del</span> <span class="bp">self</span><span class="o">.</span><span class="n">alloc_DES</span><span class="p">[</span><span class="n">des</span><span class="p">]</span></div>
+
     <span class="k">def</span> <span class="nf">remove_node</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">id_node_topology</span><span class="p">):</span>
         <span class="c1"># Stopping related processes deployed in the module and clearing main structure: alloc_DES</span>
         <span class="n">des_tmp</span><span class="o">=</span><span class="p">[]</span>
@@ -1053,8 +1122,150 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
         <span class="nb">print</span> <span class="s2">&quot;-&quot;</span> <span class="o">*</span> <span class="mi">40</span></div>
         <span class="c1"># exit()</span>
 
+    <span class="c1">#</span>
+    <span class="c1"># ### MOBILE ADAPTATION SECTION</span>
+    <span class="c1"># def update_service_coverage(self):</span>
+    <span class="c1">#     if self.street_network is not None:</span>
+    <span class="c1">#         points = utils.create_points(self.topology.G)</span>
+    <span class="c1">#         point_streets = utils.create_points(self.street_network)</span>
+    <span class="c1">#</span>
+    <span class="c1">#         tree = scipy.spatial.KDTree(points.values())</span>
+    <span class="c1">#         points_within_tolerance = tree.query_ball_point(point_streets.values(), self.tolerance)</span>
+    <span class="c1">#</span>
+    <span class="c1">#         # key = node network</span>
+    <span class="c1">#         # value = id - module SW</span>
+    <span class="c1">#</span>
+    <span class="c1">#         self.service_coverage = {}</span>
+    <span class="c1">#         for idx, pt in enumerate(points_within_tolerance):</span>
+    <span class="c1">#             ## MODULE SW</span>
+    <span class="c1">#             key2 = point_streets.keys()[idx]</span>
+    <span class="c1">#             nG2 = self.street_network.nodes[key2]</span>
+    <span class="c1">#             # print &quot;%s is close to &quot; % nG2[&quot;model&quot;]</span>
+    <span class="c1">#             ## Street coverage</span>
+    <span class="c1">#             for p in pt:</span>
+    <span class="c1">#                 key = points.keys()[p]</span>
+    <span class="c1">#                 # service_coverage[(G.nodes[key][&#39;x&#39;],G.nodes[key][&#39;y&#39;])]=nG2[&quot;model&quot;]</span>
+    <span class="c1">#                 self.service_coverage[key] = nG2[&quot;id&quot;]</span>
+
+
+
+    <span class="c1"># def setMobilityUserBehaviour(self,dataPopulation):</span>
+    <span class="c1">#     self.user_behaviour = dataPopulation #TODO CHECK SYNTAX</span>
+
+    <span class="k">def</span> <span class="nf">__add_mobile_agent</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span><span class="n">ides</span><span class="p">,</span> <span class="n">gme</span><span class="p">):</span>
+        <span class="c1">#The mobile starts</span>
+
+        <span class="k">yield</span> <span class="bp">self</span><span class="o">.</span><span class="n">env</span><span class="o">.</span><span class="n">timeout</span><span class="p">(</span><span class="n">gme</span><span class="o">.</span><span class="n">start</span><span class="p">)</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;(#DES:</span><span class="si">%i</span><span class="s2">)</span><span class="se">\t</span><span class="s2">--- Mobile Entity STARTS :</span><span class="se">\t</span><span class="si">%s</span><span class="s2"> &quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">ides</span><span class="p">,</span> <span class="n">gme</span><span class="o">.</span><span class="n">_id</span><span class="p">))</span>
+        <span class="k">while</span> <span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">gme</span><span class="o">.</span><span class="n">path</span><span class="p">)</span> <span class="o">-</span> <span class="mi">1</span> <span class="o">&gt;</span> <span class="n">gme</span><span class="o">.</span><span class="n">current_position</span><span class="p">)</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">stop</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">des_process_running</span><span class="p">[</span><span class="n">ides</span><span class="p">]:</span>
+            <span class="n">e</span> <span class="o">=</span> <span class="p">(</span><span class="n">gme</span><span class="o">.</span><span class="n">path</span><span class="p">[</span><span class="n">gme</span><span class="o">.</span><span class="n">current_position</span><span class="p">],</span> <span class="n">gme</span><span class="o">.</span><span class="n">path</span><span class="p">[</span><span class="n">gme</span><span class="o">.</span><span class="n">current_position</span> <span class="o">+</span> <span class="mi">1</span><span class="p">])</span>
+            <span class="n">data</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">street_network</span><span class="o">.</span><span class="n">get_edge_data</span><span class="p">(</span><span class="o">*</span><span class="n">e</span><span class="p">)</span>
+            <span class="k">try</span><span class="p">:</span>
+                <span class="n">next_time</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="n">utils</span><span class="o">.</span><span class="n">toMeters</span><span class="p">(</span><span class="n">data</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="s2">&quot;geometry&quot;</span><span class="p">])</span> <span class="o">/</span> <span class="n">gme</span><span class="o">.</span><span class="n">speed</span><span class="p">)</span>
+            <span class="k">except</span> <span class="ne">KeyError</span><span class="p">:</span>
+                <span class="n">next_time</span> <span class="o">=</span> <span class="mi">1</span>  <span class="c1"># default time by roundabout or other Spatial THINGS</span>
+
+            <span class="c1"># take an action?</span>
+            <span class="n">gme</span><span class="o">.</span><span class="n">next_time</span> <span class="o">=</span> <span class="n">next_time</span>
+
+            <span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;(#DES:</span><span class="si">%i</span><span class="s2">)</span><span class="se">\t</span><span class="s2">--- DO ACTION :</span><span class="se">\t</span><span class="si">%s</span><span class="s2"> &quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">ides</span><span class="p">,</span> <span class="n">gme</span><span class="o">.</span><span class="n">_id</span><span class="p">))</span>
+            <span class="n">gme</span><span class="o">.</span><span class="n">do</span><span class="o">.</span><span class="n">action</span><span class="p">(</span><span class="n">gme</span><span class="p">)</span>
+
+            <span class="c1">#TODO Can the MA wait more time in that node?</span>
+
+            <span class="k">yield</span> <span class="bp">self</span><span class="o">.</span><span class="n">env</span><span class="o">.</span><span class="n">timeout</span><span class="p">(</span><span class="n">next_time</span><span class="p">)</span>
+            <span class="n">gme</span><span class="o">.</span><span class="n">current_position</span> <span class="o">+=</span> <span class="mi">1</span>
+
+        <span class="c1"># Last movement</span>
+        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">des_process_running</span><span class="p">[</span><span class="n">ides</span><span class="p">]</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">stop</span><span class="p">:</span>
+            <span class="n">gme</span><span class="o">.</span><span class="n">do</span><span class="o">.</span><span class="n">action</span><span class="p">(</span><span class="n">gme</span><span class="p">)</span>
+
+        <span class="bp">self</span><span class="o">.</span><span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;(#DES:</span><span class="si">%i</span><span class="s2">)</span><span class="se">\t</span><span class="s2">--- Mobile Entity ENDS :</span><span class="se">\t</span><span class="si">%s</span><span class="s2"> &quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">ides</span><span class="p">,</span> <span class="n">gme</span><span class="o">.</span><span class="n">_id</span><span class="p">))</span>
+        <span class="c1"># print &quot;Mobile agent: %s ends &quot; % gme.plate</span>
+
+
+
+    <span class="k">def</span> <span class="nf">add_mobile_agent</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span><span class="n">gme</span><span class="p">):</span>
+        <span class="n">ides</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">__get_id_process</span><span class="p">()</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">des_process_running</span><span class="p">[</span><span class="n">ides</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">env</span><span class="o">.</span><span class="n">process</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">__add_mobile_agent</span><span class="p">(</span><span class="n">ides</span><span class="p">,</span> <span class="n">gme</span><span class="p">))</span>
+
+        <span class="c1">### ATENCION COONTROLAR VAR: INTERNAS</span>
+        <span class="c1">#self.alloc_DES[ides] = id_node</span>
+
+        <span class="k">return</span> <span class="n">ides</span>
+
+    <span class="k">def</span> <span class="nf">load_user_tracks</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span><span class="n">tracks</span><span class="p">):</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">user_tracks</span> <span class="o">=</span> <span class="n">tracks</span>
+
+        <span class="c1"># self.user_tracks = AnimationTrack(df_points=tracks, dpi=300, bg_map=False, map_transparency=0.5)</span>
+
+        <span class="c1"># for i, (point, nextpoint) in enumerate(fig.compute_points()):</span>
+        <span class="c1">#     print i, point, nextpoint</span>
+        <span class="c1">#     if i == 2: break</span>
+        <span class="c1"># exit()</span>
+
+    <span class="k">def</span> <span class="nf">generate_animation</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span><span class="n">pathFile</span><span class="p">):</span>
+        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">endpoints</span><span class="p">)</span><span class="o">==</span><span class="mi">0</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">__update_connection_points</span><span class="p">()</span>
+        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span> <span class="o">==</span> <span class="kc">None</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">__load_map</span><span class="p">()</span>
+
+        <span class="c1">#map_endpoints = [self.map.to_pixels(i[0], i[1]) for i in self.endpoints]</span>
+        <span class="c1">#map_endpoints = np.array(map_endpoints)</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="o">.</span><span class="n">img</span><span class="o">.</span><span class="n">save</span><span class="p">(</span><span class="n">pathFile</span><span class="o">+</span><span class="s2">&quot;_map_background.png&quot;</span><span class="p">)</span>
 
-<div class="viewcode-block" id="Sim.run"><a class="viewcode-back" href="../../api_reference/yafs.core.html#yafs.core.Sim.run">[docs]</a>    <span class="k">def</span> <span class="nf">run</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">until</span><span class="p">,</span><span class="n">test_initial_deploy</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span><span class="n">show_progress_monitor</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
+        <span class="n">animation</span> <span class="o">=</span> <span class="n">AnimationTrack</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">dpi</span><span class="o">=</span><span class="mi">100</span><span class="p">,</span> <span class="n">bg_map</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">aspect</span><span class="o">=</span><span class="s1">&#39;equal&#39;</span><span class="p">)</span>
+        <span class="n">animation</span><span class="o">.</span><span class="n">make_video</span><span class="p">(</span><span class="n">output_file</span><span class="o">=</span><span class="n">pathFile</span><span class="p">,</span> <span class="n">framerate</span><span class="o">=</span><span class="mi">10</span><span class="p">,</span> <span class="n">linewidth</span><span class="o">=</span><span class="mf">1.0</span><span class="p">,</span><span class="n">G</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">topology</span><span class="o">.</span><span class="n">G</span><span class="p">)</span>
+
+
+    <span class="c1"># def generate_snapshot(self, pathFile,event):</span>
+    <span class="c1">#     if len(self.endpoints) == 0: self.__update_connection_points()</span>
+    <span class="c1">#     if self.map == None: self.__load_map()</span>
+    <span class="c1">#</span>
+    <span class="c1">#     #map_endpoints = [self.map.to_pixels(i[0], i[1]) for i in self.endpoints]</span>
+    <span class="c1">#     #map_endpoints = np.array(map_endpoints)</span>
+    <span class="c1">#</span>
+    <span class="c1">#     animation = AnimationTrack(self, dpi=100, bg_map=True, aspect=&#39;equal&#39;)</span>
+    <span class="c1">#     animation.make_video(output_file=pathFile, framerate=10, linewidth=1.0)</span>
+
+    <span class="k">def</span> <span class="nf">__load_map</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+        <span class="n">trk_bounds</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">user_tracks</span><span class="o">.</span><span class="n">get_bounds</span><span class="p">()</span>
+        <span class="n">min_lat</span> <span class="o">=</span> <span class="n">trk_bounds</span><span class="o">.</span><span class="n">min_latitude</span>
+        <span class="n">max_lat</span> <span class="o">=</span> <span class="n">trk_bounds</span><span class="o">.</span><span class="n">max_latitude</span>
+        <span class="n">min_lng</span> <span class="o">=</span> <span class="n">trk_bounds</span><span class="o">.</span><span class="n">min_longitude</span>
+        <span class="n">max_lng</span> <span class="o">=</span> <span class="n">trk_bounds</span><span class="o">.</span><span class="n">max_longitude</span>
+
+        <span class="bp">self</span><span class="o">.</span><span class="n">map</span> <span class="o">=</span> <span class="n">smopy</span><span class="o">.</span><span class="n">Map</span><span class="p">((</span><span class="n">min_lat</span><span class="p">,</span> <span class="n">min_lng</span><span class="p">,</span> <span class="n">max_lat</span><span class="p">,</span> <span class="n">max_lng</span><span class="p">),</span> <span class="n">z</span><span class="o">=</span><span class="mi">12</span><span class="p">)</span>
+
+
+    <span class="k">def</span> <span class="nf">__update_connection_points</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+        <span class="n">level</span> <span class="o">=</span> <span class="n">nx</span><span class="o">.</span><span class="n">get_node_attributes</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">topology</span><span class="o">.</span><span class="n">G</span><span class="p">,</span> <span class="s1">&#39;level&#39;</span><span class="p">)</span>
+        <span class="n">lat</span> <span class="o">=</span> <span class="n">nx</span><span class="o">.</span><span class="n">get_node_attributes</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">topology</span><span class="o">.</span><span class="n">G</span><span class="p">,</span> <span class="s1">&#39;lat&#39;</span><span class="p">)</span>
+        <span class="n">lng</span> <span class="o">=</span> <span class="n">nx</span><span class="o">.</span><span class="n">get_node_attributes</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">topology</span><span class="o">.</span><span class="n">G</span><span class="p">,</span> <span class="s1">&#39;lng&#39;</span><span class="p">)</span>
+
+        <span class="bp">self</span><span class="o">.</span><span class="n">endpoints</span> <span class="o">=</span> <span class="p">[]</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">name_endpoints</span> <span class="o">=</span> <span class="p">{}</span>
+        <span class="n">pos</span> <span class="o">=</span> <span class="mi">0</span>
+        <span class="k">for</span> <span class="n">n</span> <span class="ow">in</span> <span class="n">level</span><span class="p">:</span>
+            <span class="k">if</span> <span class="n">level</span><span class="p">[</span><span class="n">n</span><span class="p">]</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+                <span class="bp">self</span><span class="o">.</span><span class="n">endpoints</span><span class="o">.</span><span class="n">append</span><span class="p">([</span><span class="n">lat</span><span class="p">[</span><span class="n">n</span><span class="p">],</span> <span class="n">lng</span><span class="p">[</span><span class="n">n</span><span class="p">]])</span>
+                <span class="bp">self</span><span class="o">.</span><span class="n">name_endpoints</span><span class="p">[</span><span class="n">pos</span><span class="p">]</span><span class="o">=</span><span class="n">n</span>
+                <span class="n">pos</span> <span class="o">+=</span><span class="mi">1</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">endpoints</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">endpoints</span><span class="p">)</span>
+
+
+    <span class="k">def</span> <span class="nf">set_coverage_class</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">class_name</span><span class="p">,</span><span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">endpoints</span><span class="p">)</span><span class="o">==</span><span class="mi">0</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">__update_connection_points</span><span class="p">()</span>
+        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">map</span> <span class="o">==</span> <span class="kc">None</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">__load_map</span><span class="p">()</span>
+
+        <span class="bp">self</span><span class="o">.</span><span class="n">coverage</span> <span class="o">=</span> <span class="n">class_name</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">map</span><span class="p">,</span><span class="bp">self</span><span class="o">.</span><span class="n">endpoints</span><span class="p">,</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+
+    <span class="k">def</span> <span class="nf">set_mobile_fog_entities</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span><span class="n">mobile_fog_entities</span><span class="p">):</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">mobile_fog_entities</span> <span class="o">=</span> <span class="n">mobile_fog_entities</span>
+
+    <span class="k">def</span> <span class="nf">set_movement_control</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span><span class="n">evol</span><span class="p">):</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">control_movement_class</span> <span class="o">=</span> <span class="n">evol</span>
+
+<div class="viewcode-block" id="Sim.run"><a class="viewcode-back" href="../../api_reference/yafs.core.html#yafs.core.Sim.run">[docs]</a>    <span class="k">def</span> <span class="nf">run</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">until</span><span class="p">,</span><span class="n">test_initial_deploy</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span><span class="n">show_progress_monitor</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span><span class="n">mobile_behaviour</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">        Start the simulation</span>
 
@@ -1074,17 +1285,24 @@ <h1>Source code for yafs.core</h1><div class="highlight"><pre>
 <span class="sd">        Creating initial deploy of services</span>
 <span class="sd">        &quot;&quot;&quot;</span>
         <span class="k">for</span> <span class="n">place</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">placement_policy</span><span class="o">.</span><span class="n">itervalues</span><span class="p">():</span>
-            <span class="n">place</span><span class="p">[</span><span class="s2">&quot;placement_policy&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">initial_allocation</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app_name</span><span class="p">)</span>  <span class="c1"># internally consideres the apps in charge</span>
+            <span class="k">for</span> <span class="n">app_name</span> <span class="ow">in</span> <span class="n">place</span><span class="p">[</span><span class="s2">&quot;apps&quot;</span><span class="p">]:</span>
+
+                <span class="nb">print</span> <span class="s2">&quot;APP_NAME &quot;</span><span class="p">,</span><span class="n">app_name</span>
+                <span class="n">place</span><span class="p">[</span><span class="s2">&quot;placement_policy&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">initial_allocation</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">app_name</span><span class="p">)</span>  <span class="c1"># internally consideres the apps in charge</span>
 
         <span class="sd">&quot;&quot;&quot;</span>
-<span class="sd">        A internal DES process to stop the simulation,</span>
+<span class="sd">        A internal DES process will stop the simulation,</span>
 <span class="sd">        *Simpy.run.until* wait to all pipers are empty. So, hundreds of messages should be service... We force with the stop</span>
 <span class="sd">        &quot;&quot;&quot;</span>
         <span class="n">time_shift</span> <span class="o">=</span> <span class="mi">200</span>
-        <span class="n">distribution</span> <span class="o">=</span> <span class="n">deterministicDistribution</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="s2">&quot;Deterministic&quot;</span><span class="p">,</span> <span class="n">time</span><span class="o">=</span><span class="n">time_shift</span><span class="p">)</span>
+        <span class="n">distribution</span> <span class="o">=</span> <span class="n">deterministic_distribution</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="s2">&quot;SIM_Deterministic&quot;</span><span class="p">,</span> <span class="n">time</span><span class="o">=</span><span class="n">time_shift</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">env</span><span class="o">.</span><span class="n">process</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">__add_stop_monitor</span><span class="p">(</span><span class="s2">&quot;Stop_Control_Monitor&quot;</span><span class="p">,</span><span class="bp">self</span><span class="o">.</span><span class="n">__ctrl_progress_monitor</span><span class="p">,</span><span class="n">distribution</span><span class="p">,</span><span class="n">show_progress_monitor</span><span class="p">,</span><span class="n">time_shift</span><span class="o">=</span><span class="n">time_shift</span><span class="p">))</span>
 
-
+        <span class="c1"># if mobile_behaviour:</span>
+        <span class="c1">#     &quot;&quot;&quot;</span>
+        <span class="c1">#     Updating control variables of mobile environment</span>
+        <span class="c1">#     &quot;&quot;&quot;</span>
+        <span class="c1">#     self.update_service_coverage()</span>
 
 
         <span class="bp">self</span><span class="o">.</span><span class="n">print_debug_assignaments</span><span class="p">()</span>
diff --git a/docs/build/html/_modules/yafs/placement.html b/docs/build/html/_modules/yafs/placement.html
index 3e913948..af7531b4 100644
--- a/docs/build/html/_modules/yafs/placement.html
+++ b/docs/build/html/_modules/yafs/placement.html
@@ -112,18 +112,14 @@ <h1>Source code for yafs.placement</h1><div class="highlight"><pre>
         <span class="bp">self</span><span class="o">.</span><span class="n">data</span> <span class="o">=</span> <span class="n">json</span>
 
     <span class="k">def</span> <span class="nf">initial_allocation</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">sim</span><span class="p">,</span> <span class="n">app_name</span><span class="p">):</span>
-
         <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">data</span><span class="p">[</span><span class="s2">&quot;initialAllocation&quot;</span><span class="p">]:</span>
-            <span class="c1">#print item</span>
-            <span class="n">app_name</span> <span class="o">=</span> <span class="n">item</span><span class="p">[</span><span class="s2">&quot;app&quot;</span><span class="p">]</span>
-            <span class="n">module</span> <span class="o">=</span> <span class="n">item</span><span class="p">[</span><span class="s2">&quot;module_name&quot;</span><span class="p">]</span>
-            <span class="n">idtopo</span> <span class="o">=</span> <span class="n">item</span><span class="p">[</span><span class="s2">&quot;id_resource&quot;</span><span class="p">]</span>
-
-            <span class="n">app</span> <span class="o">=</span> <span class="n">sim</span><span class="o">.</span><span class="n">apps</span><span class="p">[</span><span class="n">app_name</span><span class="p">]</span>
-            <span class="n">services</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">services</span>
-            <span class="c1">#print services[module]</span>
-            <span class="n">idDES</span> <span class="o">=</span> <span class="n">sim</span><span class="o">.</span><span class="n">deploy_module</span><span class="p">(</span><span class="n">app_name</span><span class="p">,</span> <span class="n">module</span><span class="p">,</span> <span class="n">services</span><span class="p">[</span><span class="n">module</span><span class="p">],[</span><span class="n">idtopo</span><span class="p">])</span>
-
+            <span class="k">if</span> <span class="n">app_name</span> <span class="o">==</span> <span class="n">item</span><span class="p">[</span><span class="s2">&quot;app&quot;</span><span class="p">]:</span>
+                <span class="c1"># app_name = item[&quot;app&quot;]</span>
+                <span class="n">module</span> <span class="o">=</span> <span class="n">item</span><span class="p">[</span><span class="s2">&quot;module_name&quot;</span><span class="p">]</span>
+                <span class="n">idtopo</span> <span class="o">=</span> <span class="n">item</span><span class="p">[</span><span class="s2">&quot;id_resource&quot;</span><span class="p">]</span>
+                <span class="n">app</span> <span class="o">=</span> <span class="n">sim</span><span class="o">.</span><span class="n">apps</span><span class="p">[</span><span class="n">app_name</span><span class="p">]</span>
+                <span class="n">services</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">services</span>
+                <span class="n">idDES</span> <span class="o">=</span> <span class="n">sim</span><span class="o">.</span><span class="n">deploy_module</span><span class="p">(</span><span class="n">app_name</span><span class="p">,</span> <span class="n">module</span><span class="p">,</span> <span class="n">services</span><span class="p">[</span><span class="n">module</span><span class="p">],[</span><span class="n">idtopo</span><span class="p">])</span>
 
 
 <span class="k">class</span> <span class="nc">JSONPlacementOnCloud</span><span class="p">(</span><span class="n">Placement</span><span class="p">):</span>
@@ -135,12 +131,13 @@ <h1>Source code for yafs.placement</h1><div class="highlight"><pre>
     <span class="k">def</span> <span class="nf">initial_allocation</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">sim</span><span class="p">,</span> <span class="n">app_name</span><span class="p">):</span>
 
         <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">data</span><span class="p">[</span><span class="s2">&quot;initialAllocation&quot;</span><span class="p">]:</span>
-            <span class="n">app_name</span> <span class="o">=</span> <span class="n">item</span><span class="p">[</span><span class="s2">&quot;app&quot;</span><span class="p">]</span>
-            <span class="n">module</span> <span class="o">=</span> <span class="n">item</span><span class="p">[</span><span class="s2">&quot;module_name&quot;</span><span class="p">]</span>
+            <span class="k">if</span> <span class="n">app_name</span> <span class="o">==</span> <span class="n">item</span><span class="p">[</span><span class="s2">&quot;app&quot;</span><span class="p">]:</span>
+                <span class="n">app_name</span> <span class="o">=</span> <span class="n">item</span><span class="p">[</span><span class="s2">&quot;app&quot;</span><span class="p">]</span>
+                <span class="n">module</span> <span class="o">=</span> <span class="n">item</span><span class="p">[</span><span class="s2">&quot;module_name&quot;</span><span class="p">]</span>
 
-            <span class="n">app</span> <span class="o">=</span> <span class="n">sim</span><span class="o">.</span><span class="n">apps</span><span class="p">[</span><span class="n">app_name</span><span class="p">]</span>
-            <span class="n">services</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">services</span>
-            <span class="n">idDES</span> <span class="o">=</span> <span class="n">sim</span><span class="o">.</span><span class="n">deploy_module</span><span class="p">(</span><span class="n">app_name</span><span class="p">,</span> <span class="n">module</span><span class="p">,</span> <span class="n">services</span><span class="p">[</span><span class="n">module</span><span class="p">],[</span><span class="bp">self</span><span class="o">.</span><span class="n">idCloud</span><span class="p">])</span>
+                <span class="n">app</span> <span class="o">=</span> <span class="n">sim</span><span class="o">.</span><span class="n">apps</span><span class="p">[</span><span class="n">app_name</span><span class="p">]</span>
+                <span class="n">services</span> <span class="o">=</span> <span class="n">app</span><span class="o">.</span><span class="n">services</span>
+                <span class="n">idDES</span> <span class="o">=</span> <span class="n">sim</span><span class="o">.</span><span class="n">deploy_module</span><span class="p">(</span><span class="n">app_name</span><span class="p">,</span> <span class="n">module</span><span class="p">,</span> <span class="n">services</span><span class="p">[</span><span class="n">module</span><span class="p">],[</span><span class="bp">self</span><span class="o">.</span><span class="n">idCloud</span><span class="p">])</span>
 
 
 
diff --git a/docs/build/html/_modules/yafs/selection.html b/docs/build/html/_modules/yafs/selection.html
index e0e6f00b..a2131f2e 100644
--- a/docs/build/html/_modules/yafs/selection.html
+++ b/docs/build/html/_modules/yafs/selection.html
@@ -65,19 +65,21 @@ <h1>Source code for yafs.selection</h1><div class="highlight"><pre>
         <span class="bp">self</span><span class="o">.</span><span class="n">lat_acc</span> <span class="o">=</span> <span class="mf">0.0</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">propagation</span> <span class="o">=</span> <span class="mf">0.0</span>
 
-<div class="viewcode-block" id="Selection.get_path"><a class="viewcode-back" href="../../api_reference/yafs.selection.html#yafs.selection.Selection.get_path">[docs]</a>    <span class="k">def</span> <span class="nf">get_path</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">sim</span><span class="p">,</span> <span class="n">app_name</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="n">topology_src</span><span class="p">,</span><span class="n">alloc_DES</span><span class="p">,</span> <span class="n">alloc_module</span><span class="p">,</span> <span class="n">traffic</span><span class="p">):</span>
+<div class="viewcode-block" id="Selection.get_path"><a class="viewcode-back" href="../../api_reference/yafs.selection.html#yafs.selection.Selection.get_path">[docs]</a>    <span class="k">def</span> <span class="nf">get_path</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">sim</span><span class="p">,</span> <span class="n">app_name</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="n">topology_src</span><span class="p">,</span><span class="n">alloc_DES</span><span class="p">,</span> <span class="n">alloc_module</span><span class="p">,</span> <span class="n">traffic</span><span class="p">,</span> <span class="n">from_des</span><span class="p">):</span>
+
         <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">        Args:</span>
 
-<span class="sd">            sim (yafs.core.Sim)</span>
-
-<span class="sd">            src (int): the node source</span>
-
-<span class="sd">            dst (dst): the node destiny</span>
-
-<span class="sd">            message (yafs.application.Message)</span>
-
-<span class="sd">            traffic (dict): the current occupation of the network</span>
+<span class="sd">        :param sim:</span>
+<span class="sd">        :param message:</span>
+<span class="sd">        :param link:</span>
+<span class="sd">        :param alloc_DES:</span>
+<span class="sd">        :param alloc_module:</span>
+<span class="sd">        :param traffic:</span>
+<span class="sd">        :param ctime:</span>
+<span class="sd">        :param from_des</span>
+<span class="sd">        :return:</span>
+<span class="sd">           both empty arrays implies that the message will not send to the destination.</span>
 
 <span class="sd">        Returns:</span>
 
@@ -96,7 +98,7 @@ <h1>Source code for yafs.selection</h1><div class="highlight"><pre>
         <span class="sd">&quot;&quot;&quot; END Selection &quot;&quot;&quot;</span>
         <span class="k">return</span> <span class="n">path</span><span class="p">,</span><span class="n">ids</span></div>
 
-<div class="viewcode-block" id="Selection.get_path_from_failure"><a class="viewcode-back" href="../../api_reference/yafs.selection.html#yafs.selection.Selection.get_path_from_failure">[docs]</a>    <span class="k">def</span> <span class="nf">get_path_from_failure</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">sim</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="n">link</span><span class="p">,</span> <span class="n">alloc_DES</span><span class="p">,</span> <span class="n">alloc_module</span><span class="p">,</span> <span class="n">traffic</span><span class="p">,</span> <span class="n">ctime</span><span class="p">):</span>
+<div class="viewcode-block" id="Selection.get_path_from_failure"><a class="viewcode-back" href="../../api_reference/yafs.selection.html#yafs.selection.Selection.get_path_from_failure">[docs]</a>    <span class="k">def</span> <span class="nf">get_path_from_failure</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">sim</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="n">link</span><span class="p">,</span> <span class="n">alloc_DES</span><span class="p">,</span> <span class="n">alloc_module</span><span class="p">,</span> <span class="n">traffic</span><span class="p">,</span> <span class="n">ctime</span><span class="p">,</span> <span class="n">from_des</span><span class="p">):</span>
         <span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">        This function is call when some link of a message path is broken or unavailable. A new one from that point should be calculated.</span>
 
@@ -107,6 +109,7 @@ <h1>Source code for yafs.selection</h1><div class="highlight"><pre>
 <span class="sd">        :param alloc_module:</span>
 <span class="sd">        :param traffic:</span>
 <span class="sd">        :param ctime:</span>
+<span class="sd">        :param from_des</span>
 <span class="sd">        :return:</span>
 <span class="sd">           both empty arrays implies that the message will not send to the destination.</span>
 
@@ -124,7 +127,7 @@ <h1>Source code for yafs.selection</h1><div class="highlight"><pre>
 <span class="sd">    Among all the possible options, it returns a random path.</span>
 <span class="sd">    &quot;&quot;&quot;</span>
 
-    <span class="k">def</span> <span class="nf">get_path</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">sim</span><span class="p">,</span> <span class="n">app_name</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="n">topology_src</span><span class="p">,</span><span class="n">alloc_DES</span><span class="p">,</span> <span class="n">alloc_module</span><span class="p">,</span> <span class="n">traffic</span><span class="p">):</span>
+    <span class="k">def</span> <span class="nf">get_path</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">sim</span><span class="p">,</span> <span class="n">app_name</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="n">topology_src</span><span class="p">,</span><span class="n">alloc_DES</span><span class="p">,</span> <span class="n">alloc_module</span><span class="p">,</span> <span class="n">traffic</span><span class="p">,</span><span class="n">from_des</span><span class="p">):</span>
         <span class="n">paths</span> <span class="o">=</span> <span class="p">[]</span>
         <span class="n">dst_idDES</span> <span class="o">=</span> <span class="p">[]</span>
         <span class="n">src_node</span> <span class="o">=</span> <span class="n">topology_src</span>
@@ -142,7 +145,7 @@ <h1>Source code for yafs.selection</h1><div class="highlight"><pre>
 <div class="viewcode-block" id="First_ShortestPath"><a class="viewcode-back" href="../../api_reference/yafs.selection.html#yafs.selection.First_ShortestPath">[docs]</a><span class="k">class</span> <span class="nc">First_ShortestPath</span><span class="p">(</span><span class="n">Selection</span><span class="p">):</span>
     <span class="sd">&quot;&quot;&quot;Among all possible shorter paths, returns the first.&quot;&quot;&quot;</span>
 
-    <span class="k">def</span> <span class="nf">get_path</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">sim</span><span class="p">,</span> <span class="n">app_name</span><span class="p">,</span><span class="n">message</span><span class="p">,</span> <span class="n">topology_src</span><span class="p">,</span> <span class="n">alloc_DES</span><span class="p">,</span> <span class="n">alloc_module</span><span class="p">,</span> <span class="n">traffic</span><span class="p">):</span>
+    <span class="k">def</span> <span class="nf">get_path</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">sim</span><span class="p">,</span> <span class="n">app_name</span><span class="p">,</span><span class="n">message</span><span class="p">,</span> <span class="n">topology_src</span><span class="p">,</span> <span class="n">alloc_DES</span><span class="p">,</span> <span class="n">alloc_module</span><span class="p">,</span> <span class="n">traffic</span><span class="p">,</span><span class="n">from_des</span><span class="p">):</span>
         <span class="n">paths</span> <span class="o">=</span> <span class="p">[]</span>
         <span class="n">dst_idDES</span> <span class="o">=</span> <span class="p">[]</span>
 
diff --git a/docs/build/html/_modules/yafs/topology.html b/docs/build/html/_modules/yafs/topology.html
index c4dd532c..c003f47e 100644
--- a/docs/build/html/_modules/yafs/topology.html
+++ b/docs/build/html/_modules/yafs/topology.html
@@ -44,8 +44,8 @@ <h1>Source code for yafs.topology</h1><div class="highlight"><pre>
 
 
 <span class="kn">import</span> <span class="nn">networkx</span> <span class="k">as</span> <span class="nn">nx</span>
-
-
+<span class="kn">import</span> <span class="nn">matplotlib.pyplot</span> <span class="k">as</span> <span class="nn">plt</span>
+<span class="kn">import</span> <span class="nn">warnings</span>
 
 
 <div class="viewcode-block" id="Topology"><a class="viewcode-back" href="../../api_reference/yafs.topology.html#yafs.topology.Topology">[docs]</a><span class="k">class</span> <span class="nc">Topology</span><span class="p">:</span>
@@ -70,15 +70,26 @@ <h1>Source code for yafs.topology</h1><div class="highlight"><pre>
     <span class="k">def</span> <span class="nf">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">logger</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 
         <span class="bp">self</span><span class="o">.</span><span class="n">__idNode</span> <span class="o">=</span> <span class="o">-</span><span class="mi">1</span>
+        <span class="c1"># G is a nx.networkx graph</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">G</span> <span class="o">=</span> <span class="kc">None</span>
-        <span class="c1">#G is a networkx graph</span>
 
+
+        <span class="c1"># TODO VERSION 2. THIS VALUE SHOULD BE REMOVED</span>
+        <span class="c1"># INSTEAD USE NX.G. attributes</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">nodeAttributes</span> <span class="o">=</span> <span class="p">{}</span>
+
+
+        <span class="c1"># A simple *cache* to have all cloud  nodes</span>
+        <span class="c1"># TODO VERSION 2. THIS VALUE SHOULD BE REMOVED</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">cloudNodes</span> <span class="o">=</span> <span class="p">[]</span>
-        <span class="c1">#A simple *cache* to have all cloud  nodes</span>
+
+
 
         <span class="bp">self</span><span class="o">.</span><span class="n">logger</span> <span class="o">=</span> <span class="n">logger</span> <span class="ow">or</span> <span class="n">logging</span><span class="o">.</span><span class="n">getLogger</span><span class="p">(</span><span class="vm">__name__</span><span class="p">)</span>
 
+
+
+
     <span class="k">def</span> <span class="nf">__init_uptimes</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
         <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">nodeAttributes</span><span class="p">:</span>
             <span class="bp">self</span><span class="o">.</span><span class="n">nodeAttributes</span><span class="p">[</span><span class="n">key</span><span class="p">][</span><span class="s2">&quot;uptime&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
@@ -167,7 +178,35 @@ <h1>Source code for yafs.topology</h1><div class="highlight"><pre>
         <span class="bp">self</span><span class="o">.</span><span class="n">__idNode</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">G</span><span class="o">.</span><span class="n">nodes</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">__init_uptimes</span><span class="p">()</span></div>
 
+    <span class="k">def</span> <span class="nf">load_all_node_attr</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span><span class="n">data</span><span class="p">):</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">G</span> <span class="o">=</span> <span class="n">nx</span><span class="o">.</span><span class="n">Graph</span><span class="p">()</span>
+        <span class="k">for</span> <span class="n">edge</span> <span class="ow">in</span> <span class="n">data</span><span class="p">[</span><span class="s2">&quot;link&quot;</span><span class="p">]:</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">G</span><span class="o">.</span><span class="n">add_edge</span><span class="p">(</span><span class="n">edge</span><span class="p">[</span><span class="s2">&quot;s&quot;</span><span class="p">],</span> <span class="n">edge</span><span class="p">[</span><span class="s2">&quot;d&quot;</span><span class="p">],</span> <span class="n">BW</span><span class="o">=</span><span class="n">edge</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">LINK_BW</span><span class="p">],</span> <span class="n">PR</span><span class="o">=</span><span class="n">edge</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">LINK_PR</span><span class="p">])</span>
+
+        <span class="n">dc</span> <span class="o">=</span> <span class="p">{</span><span class="nb">str</span><span class="p">(</span><span class="n">x</span><span class="p">):</span> <span class="p">{}</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">data</span><span class="p">[</span><span class="s2">&quot;entity&quot;</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">keys</span><span class="p">()}</span>
+        <span class="k">for</span> <span class="n">ent</span> <span class="ow">in</span> <span class="n">data</span><span class="p">[</span><span class="s2">&quot;entity&quot;</span><span class="p">]:</span>
+            <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">ent</span><span class="o">.</span><span class="n">keys</span><span class="p">():</span>
+                <span class="n">dc</span><span class="p">[</span><span class="n">key</span><span class="p">][</span><span class="n">ent</span><span class="p">[</span><span class="s2">&quot;id&quot;</span><span class="p">]]</span> <span class="o">=</span> <span class="n">ent</span><span class="p">[</span><span class="n">key</span><span class="p">]</span>
+        <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="n">data</span><span class="p">[</span><span class="s2">&quot;entity&quot;</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">keys</span><span class="p">():</span>
+            <span class="n">nx</span><span class="o">.</span><span class="n">set_node_attributes</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">G</span><span class="p">,</span> <span class="n">values</span><span class="o">=</span><span class="n">dc</span><span class="p">[</span><span class="n">x</span><span class="p">],</span> <span class="n">name</span><span class="o">=</span><span class="nb">str</span><span class="p">(</span><span class="n">x</span><span class="p">))</span>
+
+        <span class="k">for</span> <span class="n">node</span> <span class="ow">in</span> <span class="n">data</span><span class="p">[</span><span class="s2">&quot;entity&quot;</span><span class="p">]:</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">nodeAttributes</span><span class="p">[</span><span class="n">node</span><span class="p">[</span><span class="s2">&quot;id&quot;</span><span class="p">]]</span> <span class="o">=</span> <span class="n">node</span>
+
+        <span class="bp">self</span><span class="o">.</span><span class="n">__idNode</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">G</span><span class="o">.</span><span class="n">nodes</span><span class="p">)</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">__init_uptimes</span><span class="p">()</span>
+
+
+
+
     <span class="k">def</span> <span class="nf">load_graphml</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span><span class="n">filename</span><span class="p">):</span>
+        <span class="n">warnings</span><span class="o">.</span><span class="n">warn</span><span class="p">(</span><span class="s2">&quot;The load_graphml function is deprecated and &quot;</span>
+                      <span class="s2">&quot;will be removed in version 2.0.0. &quot;</span>
+                      <span class="s2">&quot;Use NX.READ_GRAPHML function instead.&quot;</span><span class="p">,</span>
+                      <span class="ne">FutureWarning</span><span class="p">,</span>
+                      <span class="n">stacklevel</span><span class="o">=</span><span class="mi">8</span>
+                      <span class="p">)</span>
+
         <span class="bp">self</span><span class="o">.</span><span class="n">G</span> <span class="o">=</span> <span class="n">nx</span><span class="o">.</span><span class="n">read_graphml</span><span class="p">(</span><span class="n">filename</span><span class="p">)</span>
         <span class="n">attEdges</span> <span class="o">=</span> <span class="p">{}</span>
         <span class="k">for</span> <span class="n">k</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">G</span><span class="o">.</span><span class="n">edges</span><span class="p">():</span>
@@ -244,7 +283,16 @@ <h1>Source code for yafs.topology</h1><div class="highlight"><pre>
 
 
     <span class="k">def</span> <span class="nf">write</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span><span class="n">path</span><span class="p">):</span>
-        <span class="n">nx</span><span class="o">.</span><span class="n">write_gexf</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">G</span><span class="p">,</span> <span class="n">path</span><span class="p">)</span></div>
+        <span class="n">nx</span><span class="o">.</span><span class="n">write_gexf</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">G</span><span class="p">,</span> <span class="n">path</span><span class="p">)</span>
+
+
+    <span class="k">def</span> <span class="nf">draw_png</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span><span class="n">path_file</span><span class="p">):</span>
+        <span class="n">fig</span><span class="p">,</span> <span class="n">ax</span> <span class="o">=</span> <span class="n">plt</span><span class="o">.</span><span class="n">subplots</span><span class="p">(</span><span class="n">nrows</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="n">ncols</span><span class="o">=</span><span class="mi">1</span><span class="p">)</span>
+        <span class="n">pos</span> <span class="o">=</span> <span class="n">nx</span><span class="o">.</span><span class="n">spring_layout</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">G</span><span class="p">)</span>
+        <span class="n">nx</span><span class="o">.</span><span class="n">draw</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">G</span><span class="p">,</span> <span class="n">pos</span><span class="p">)</span>
+        <span class="n">labels</span> <span class="o">=</span> <span class="n">nx</span><span class="o">.</span><span class="n">draw_networkx_labels</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">G</span><span class="p">,</span> <span class="n">pos</span><span class="p">)</span>
+        <span class="n">fig</span><span class="o">.</span><span class="n">savefig</span><span class="p">(</span><span class="n">path_file</span><span class="p">)</span>  <span class="c1"># save the figure to file</span>
+        <span class="n">plt</span><span class="o">.</span><span class="n">close</span><span class="p">(</span><span class="n">fig</span><span class="p">)</span>  <span class="c1"># close the figure</span></div>
 </pre></div>
 
           </div>
diff --git a/docs/build/html/api_reference/yafs.core.html b/docs/build/html/api_reference/yafs.core.html
index b1f9a5f4..6785d0fc 100644
--- a/docs/build/html/api_reference/yafs.core.html
+++ b/docs/build/html/api_reference/yafs.core.html
@@ -122,13 +122,14 @@
 <code class="descname">deploy_sink</code><span class="sig-paren">(</span><em>app_name</em>, <em>node</em>, <em>module</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/yafs/core.html#Sim.deploy_sink"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#yafs.core.Sim.deploy_sink" title="Permalink to this definition">¶</a></dt>
 <dd><p>Add a DES process for deploy pure SINK modules (actuators)
 This function its used by (<code class="xref py py-mod docutils literal"><span class="pre">Placement</span></code>): algorithm
-Internatlly, there is not a DES PROCESS for this type of behaviour
-Args:</p>
-<blockquote>
-<div><p>app_name (str): application name</p>
+Internatlly, there is not a DES PROCESS for this type of behaviour</p>
+<dl class="docutils">
+<dt>Args:</dt>
+<dd><p class="first">app_name (str): application name</p>
 <p>node (int): entity.id of the topology who will create the messages</p>
-<p>module (str): module</p>
-</div></blockquote>
+<p class="last">module (str): module</p>
+</dd>
+</dl>
 </dd></dl>
 
 <dl class="method">
@@ -161,6 +162,20 @@
 <dd><p>the discrete-event simulator (aka DES)</p>
 </dd></dl>
 
+<dl class="method">
+<dt id="yafs.core.Sim.get_alloc_entities">
+<code class="descname">get_alloc_entities</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/yafs/core.html#Sim.get_alloc_entities"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#yafs.core.Sim.get_alloc_entities" title="Permalink to this definition">¶</a></dt>
+<dd><p>It returns a dictionary of deployed services
+key : id-node
+value: a list of deployed services</p>
+</dd></dl>
+
+<dl class="attribute">
+<dt id="yafs.core.Sim.last_busy_time">
+<code class="descname">last_busy_time</code><em class="property"> = None</em><a class="headerlink" href="#yafs.core.Sim.last_busy_time" title="Permalink to this definition">¶</a></dt>
+<dd><p>MOBILE ADAPTATIONS</p>
+</dd></dl>
+
 <dl class="method">
 <dt id="yafs.core.Sim.print_debug_assignaments">
 <code class="descname">print_debug_assignaments</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="../_modules/yafs/core.html#Sim.print_debug_assignaments"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#yafs.core.Sim.print_debug_assignaments" title="Permalink to this definition">¶</a></dt>
@@ -175,7 +190,7 @@
 
 <dl class="method">
 <dt id="yafs.core.Sim.run">
-<code class="descname">run</code><span class="sig-paren">(</span><em>until</em>, <em>test_initial_deploy=False</em>, <em>show_progress_monitor=True</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/yafs/core.html#Sim.run"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#yafs.core.Sim.run" title="Permalink to this definition">¶</a></dt>
+<code class="descname">run</code><span class="sig-paren">(</span><em>until</em>, <em>test_initial_deploy=False</em>, <em>show_progress_monitor=True</em>, <em>mobile_behaviour=False</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/yafs/core.html#Sim.run"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#yafs.core.Sim.run" title="Permalink to this definition">¶</a></dt>
 <dd><p>Start the simulation</p>
 <dl class="docutils">
 <dt>Args:</dt>
@@ -211,6 +226,15 @@
 </dl>
 </dd></dl>
 
+<dl class="method">
+<dt id="yafs.core.Sim.undeploy_module">
+<code class="descname">undeploy_module</code><span class="sig-paren">(</span><em>app_name</em>, <em>service_name</em>, <em>idtopo</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/yafs/core.html#Sim.undeploy_module"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#yafs.core.Sim.undeploy_module" title="Permalink to this definition">¶</a></dt>
+<dd><p>removes all modules deployed in a node
+modules with the same name = service_name
+from app_name
+deployed in id_topo</p>
+</dd></dl>
+
 <dl class="attribute">
 <dt id="yafs.core.Sim.unreachabled_links">
 <code class="descname">unreachabled_links</code><em class="property"> = None</em><a class="headerlink" href="#yafs.core.Sim.unreachabled_links" title="Permalink to this definition">¶</a></dt>
diff --git a/docs/build/html/api_reference/yafs.html b/docs/build/html/api_reference/yafs.html
index 6f9794da..ea70dc1c 100644
--- a/docs/build/html/api_reference/yafs.html
+++ b/docs/build/html/api_reference/yafs.html
@@ -157,6 +157,26 @@ <h2>Metrics<a class="headerlink" href="#metrics" title="Permalink to this headli
 </tbody>
 </table>
 </div>
+<div class="section" id="distribution">
+<h2>Distribution<a class="headerlink" href="#distribution" title="Permalink to this headline">¶</a></h2>
+<table border="1" class="longtable docutils">
+<colgroup>
+<col width="10%" />
+<col width="90%" />
+</colgroup>
+<tbody valign="top">
+<tr class="row-odd"><td><code class="xref py py-obj docutils literal"><span class="pre">Distribution</span></code>(name)</td>
+<td>Abstract class</td>
+</tr>
+<tr class="row-even"><td><code class="xref py py-obj docutils literal"><span class="pre">deterministic_distribution</span></code>(time,&nbsp;**kwargs)</td>
+<td></td>
+</tr>
+<tr class="row-odd"><td><code class="xref py py-obj docutils literal"><span class="pre">exponential_distribution</span></code>(lambd[,&nbsp;seed])</td>
+<td></td>
+</tr>
+</tbody>
+</table>
+</div>
 </div>
 
 
@@ -181,6 +201,7 @@ <h3><a href="../contents.html">Table Of Contents</a></h3>
 <li class="toctree-l3"><a class="reference internal" href="#placement">Placement</a></li>
 <li class="toctree-l3"><a class="reference internal" href="#selection">Selection</a></li>
 <li class="toctree-l3"><a class="reference internal" href="#metrics">Metrics</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#distribution">Distribution</a></li>
 </ul>
 </li>
 <li class="toctree-l2"><a class="reference internal" href="yafs.core.html"><code class="docutils literal"><span class="pre">yafs.core</span></code> — Simulator engine</a></li>
diff --git a/docs/build/html/api_reference/yafs.selection.html b/docs/build/html/api_reference/yafs.selection.html
index 7e40c327..c5d3ee03 100644
--- a/docs/build/html/api_reference/yafs.selection.html
+++ b/docs/build/html/api_reference/yafs.selection.html
@@ -55,15 +55,29 @@
 </div>
 <dl class="method">
 <dt id="yafs.selection.Selection.get_path">
-<code class="descname">get_path</code><span class="sig-paren">(</span><em>sim</em>, <em>app_name</em>, <em>message</em>, <em>topology_src</em>, <em>alloc_DES</em>, <em>alloc_module</em>, <em>traffic</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/yafs/selection.html#Selection.get_path"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#yafs.selection.Selection.get_path" title="Permalink to this definition">¶</a></dt>
+<code class="descname">get_path</code><span class="sig-paren">(</span><em>sim</em>, <em>app_name</em>, <em>message</em>, <em>topology_src</em>, <em>alloc_DES</em>, <em>alloc_module</em>, <em>traffic</em>, <em>from_des</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/yafs/selection.html#Selection.get_path"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#yafs.selection.Selection.get_path" title="Permalink to this definition">¶</a></dt>
 <dd><p>Args:</p>
+<table class="docutils field-list" frame="void" rules="none">
+<col class="field-name" />
+<col class="field-body" />
+<tbody valign="top">
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
+<li><strong>sim</strong> – </li>
+<li><strong>message</strong> – </li>
+<li><strong>link</strong> – </li>
+<li><strong>alloc_DES</strong> – </li>
+<li><strong>alloc_module</strong> – </li>
+<li><strong>traffic</strong> – </li>
+<li><strong>ctime</strong> – </li>
+</ul>
+</td>
+</tr>
+</tbody>
+</table>
+<p>:param from_des
+:return:</p>
 <blockquote>
-<div><p>sim (yafs.core.Sim)</p>
-<p>src (int): the node source</p>
-<p>dst (dst): the node destiny</p>
-<p>message (yafs.application.Message)</p>
-<p>traffic (dict): the current occupation of the network</p>
-</div></blockquote>
+<div>both empty arrays implies that the message will not send to the destination.</div></blockquote>
 <p>Returns:</p>
 <blockquote>
 <div><p>a path among nodes</p>
@@ -77,13 +91,13 @@
 
 <dl class="method">
 <dt id="yafs.selection.Selection.get_path_from_failure">
-<code class="descname">get_path_from_failure</code><span class="sig-paren">(</span><em>sim</em>, <em>message</em>, <em>link</em>, <em>alloc_DES</em>, <em>alloc_module</em>, <em>traffic</em>, <em>ctime</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/yafs/selection.html#Selection.get_path_from_failure"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#yafs.selection.Selection.get_path_from_failure" title="Permalink to this definition">¶</a></dt>
+<code class="descname">get_path_from_failure</code><span class="sig-paren">(</span><em>sim</em>, <em>message</em>, <em>link</em>, <em>alloc_DES</em>, <em>alloc_module</em>, <em>traffic</em>, <em>ctime</em>, <em>from_des</em><span class="sig-paren">)</span><a class="reference internal" href="../_modules/yafs/selection.html#Selection.get_path_from_failure"><span class="viewcode-link">[source]</span></a><a class="headerlink" href="#yafs.selection.Selection.get_path_from_failure" title="Permalink to this definition">¶</a></dt>
 <dd><p>This function is call when some link of a message path is broken or unavailable. A new one from that point should be calculated.</p>
 <table class="docutils field-list" frame="void" rules="none">
 <col class="field-name" />
 <col class="field-body" />
 <tbody valign="top">
-<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first simple">
+<tr class="field-odd field"><th class="field-name">Parameters:</th><td class="field-body"><ul class="first last simple">
 <li><strong>sim</strong> – </li>
 <li><strong>message</strong> – </li>
 <li><strong>link</strong> – </li>
@@ -94,11 +108,12 @@
 </ul>
 </td>
 </tr>
-<tr class="field-even field"><th class="field-name">Returns:</th><td class="field-body"><p class="first last">both empty arrays implies that the message will not send to the destination.</p>
-</td>
-</tr>
 </tbody>
 </table>
+<p>:param from_des
+:return:</p>
+<blockquote>
+<div>both empty arrays implies that the message will not send to the destination.</div></blockquote>
 <div class="admonition attention">
 <p class="first admonition-title">Attention</p>
 <p class="last">this function is optional</p>
diff --git a/docs/build/html/api_reference/yafs.topology.html b/docs/build/html/api_reference/yafs.topology.html
index dddc3893..219393dc 100644
--- a/docs/build/html/api_reference/yafs.topology.html
+++ b/docs/build/html/api_reference/yafs.topology.html
@@ -23,8 +23,8 @@
     <script type="text/javascript" src="../_static/doctools.js"></script>
     <link rel="index" title="Index" href="../genindex.html" />
     <link rel="search" title="Search" href="../search.html" />
-    <link rel="next" title="yafs.application" href="yafs.application.html" />
-    <link rel="prev" title="yafs.core — Simulator engine" href="yafs.core.html" />
+    <link rel="next" title="application" href="yafs.application.html" />
+    <link rel="prev" title="core — Simulator engine" href="yafs.core.html" />
    
   <link rel="stylesheet" href="../_static/custom.css" type="text/css" />
   
@@ -207,15 +207,15 @@ <h3><a href="../contents.html">Table Of Contents</a></h3>
 <li class="toctree-l1"><a class="reference internal" href="../examples/index.html">Examples</a></li>
 <li class="toctree-l1 current"><a class="reference internal" href="index.html">API REFERENCE</a><ul class="current">
 <li class="toctree-l2"><a class="reference internal" href="yafs.html"><code class="docutils literal"><span class="pre">yafs</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="yafs.core.html"><code class="docutils literal"><span class="pre">yafs.core</span></code> — Simulator engine</a></li>
+<li class="toctree-l2"><a class="reference internal" href="yafs.core.html"><code class="docutils literal"><span class="pre">core</span></code> — Simulator engine</a></li>
 <li class="toctree-l2 current"><a class="current reference internal" href="#"><code class="docutils literal"><span class="pre">yafs.topology</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="yafs.application.html"><code class="docutils literal"><span class="pre">yafs.application</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="yafs.population.html"><code class="docutils literal"><span class="pre">yafs.population</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="yafs.placement.html"><code class="docutils literal"><span class="pre">yafs.placement</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="yafs.selection.html"><code class="docutils literal"><span class="pre">yafs.selection</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="yafs.distribution.html"><code class="docutils literal"><span class="pre">yafs.distribution</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="yafs.stats.html"><code class="docutils literal"><span class="pre">yafs.stats</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="yafs.metrics.html"><code class="docutils literal"><span class="pre">yafs.metrics</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="yafs.application.html"><code class="docutils literal"><span class="pre">application</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="yafs.population.html"><code class="docutils literal"><span class="pre">population</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="yafs.placement.html"><code class="docutils literal"><span class="pre">placement</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="yafs.selection.html"><code class="docutils literal"><span class="pre">selection</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="yafs.distribution.html"><code class="docutils literal"><span class="pre">distribution</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="yafs.stats.html"><code class="docutils literal"><span class="pre">stats</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="yafs.metrics.html"><code class="docutils literal"><span class="pre">metrics</span></code></a></li>
 <li class="toctree-l2"><a class="reference internal" href="yafs.utils.html"><code class="docutils literal"><span class="pre">yafs.utils</span></code></a></li>
 </ul>
 </li>
@@ -226,8 +226,8 @@ <h3>Related Topics</h3>
 <ul>
   <li><a href="../contents.html">Documentation overview</a><ul>
   <li><a href="index.html">API REFERENCE</a><ul>
-      <li>Previous: <a href="yafs.core.html" title="previous chapter"><code class="docutils literal"><span class="pre">yafs.core</span></code> — Simulator engine</a></li>
-      <li>Next: <a href="yafs.application.html" title="next chapter"><code class="docutils literal"><span class="pre">yafs.application</span></code></a></li>
+      <li>Previous: <a href="yafs.core.html" title="previous chapter"><code class="docutils literal"><span class="pre">core</span></code> — Simulator engine</a></li>
+      <li>Next: <a href="yafs.application.html" title="next chapter"><code class="docutils literal"><span class="pre">application</span></code></a></li>
   </ul></li>
   </ul></li>
 </ul>
diff --git a/docs/build/html/api_reference/yafs.utils.html b/docs/build/html/api_reference/yafs.utils.html
index 53f12cbb..0adf59af 100644
--- a/docs/build/html/api_reference/yafs.utils.html
+++ b/docs/build/html/api_reference/yafs.utils.html
@@ -24,7 +24,7 @@
     <link rel="index" title="Index" href="../genindex.html" />
     <link rel="search" title="Search" href="../search.html" />
     <link rel="next" title="ABOUT" href="../about/index.html" />
-    <link rel="prev" title="yafs.metrics" href="yafs.metrics.html" />
+    <link rel="prev" title="metrics" href="yafs.metrics.html" />
    
   <link rel="stylesheet" href="../_static/custom.css" type="text/css" />
   
@@ -60,15 +60,15 @@ <h3><a href="../contents.html">Table Of Contents</a></h3>
 <li class="toctree-l1"><a class="reference internal" href="../examples/index.html">Examples</a></li>
 <li class="toctree-l1 current"><a class="reference internal" href="index.html">API REFERENCE</a><ul class="current">
 <li class="toctree-l2"><a class="reference internal" href="yafs.html"><code class="docutils literal"><span class="pre">yafs</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="yafs.core.html"><code class="docutils literal"><span class="pre">yafs.core</span></code> — Simulator engine</a></li>
-<li class="toctree-l2"><a class="reference internal" href="yafs.topology.html"><code class="docutils literal"><span class="pre">yafs.topology</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="yafs.application.html"><code class="docutils literal"><span class="pre">yafs.application</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="yafs.population.html"><code class="docutils literal"><span class="pre">yafs.population</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="yafs.placement.html"><code class="docutils literal"><span class="pre">yafs.placement</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="yafs.selection.html"><code class="docutils literal"><span class="pre">yafs.selection</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="yafs.distribution.html"><code class="docutils literal"><span class="pre">yafs.distribution</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="yafs.stats.html"><code class="docutils literal"><span class="pre">yafs.stats</span></code></a></li>
-<li class="toctree-l2"><a class="reference internal" href="yafs.metrics.html"><code class="docutils literal"><span class="pre">yafs.metrics</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="yafs.core.html"><code class="docutils literal"><span class="pre">core</span></code> — Simulator engine</a></li>
+<li class="toctree-l2"><a class="reference internal" href="yafs.topology.html"><code class="docutils literal"><span class="pre">topology</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="yafs.application.html"><code class="docutils literal"><span class="pre">application</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="yafs.population.html"><code class="docutils literal"><span class="pre">population</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="yafs.placement.html"><code class="docutils literal"><span class="pre">placement</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="yafs.selection.html"><code class="docutils literal"><span class="pre">selection</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="yafs.distribution.html"><code class="docutils literal"><span class="pre">distribution</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="yafs.stats.html"><code class="docutils literal"><span class="pre">stats</span></code></a></li>
+<li class="toctree-l2"><a class="reference internal" href="yafs.metrics.html"><code class="docutils literal"><span class="pre">metrics</span></code></a></li>
 <li class="toctree-l2 current"><a class="current reference internal" href="#"><code class="docutils literal"><span class="pre">yafs.utils</span></code></a></li>
 </ul>
 </li>
@@ -79,7 +79,7 @@ <h3>Related Topics</h3>
 <ul>
   <li><a href="../contents.html">Documentation overview</a><ul>
   <li><a href="index.html">API REFERENCE</a><ul>
-      <li>Previous: <a href="yafs.metrics.html" title="previous chapter"><code class="docutils literal"><span class="pre">yafs.metrics</span></code></a></li>
+      <li>Previous: <a href="yafs.metrics.html" title="previous chapter"><code class="docutils literal"><span class="pre">metrics</span></code></a></li>
       <li>Next: <a href="../about/index.html" title="next chapter">ABOUT</a></li>
   </ul></li>
   </ul></li>
diff --git a/docs/build/html/contents.html b/docs/build/html/contents.html
index 62ed9bd3..287d7d52 100644
--- a/docs/build/html/contents.html
+++ b/docs/build/html/contents.html
@@ -85,6 +85,7 @@ <h1>Documentation for YAFS<a class="headerlink" href="#documentation-for-yafs" t
 <li class="toctree-l3"><a class="reference internal" href="api_reference/yafs.html#placement">Placement</a></li>
 <li class="toctree-l3"><a class="reference internal" href="api_reference/yafs.html#selection">Selection</a></li>
 <li class="toctree-l3"><a class="reference internal" href="api_reference/yafs.html#metrics">Metrics</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api_reference/yafs.html#distribution">Distribution</a></li>
 </ul>
 </li>
 <li class="toctree-l2"><a class="reference internal" href="api_reference/yafs.core.html"><code class="docutils literal"><span class="pre">yafs.core</span></code> — Simulator engine</a></li>
diff --git a/docs/build/html/genindex.html b/docs/build/html/genindex.html
index f6e38979..2dc1a677 100644
--- a/docs/build/html/genindex.html
+++ b/docs/build/html/genindex.html
@@ -157,6 +157,8 @@ <h2 id="F">F</h2>
 <h2 id="G">G</h2>
 <table style="width: 100%" class="indextable genindextable"><tr>
   <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api_reference/yafs.core.html#yafs.core.Sim.get_alloc_entities">get_alloc_entities() (yafs.core.Sim method)</a>
+</li>
       <li><a href="api_reference/yafs.stats.html#yafs.stats.Stats.get_df_service_utilization">get_df_service_utilization() (yafs.stats.Stats method)</a>
 </li>
       <li><a href="api_reference/yafs.topology.html#yafs.topology.Topology.get_edge">get_edge() (yafs.topology.Topology method)</a>
@@ -205,6 +207,8 @@ <h2 id="I">I</h2>
 <h2 id="L">L</h2>
 <table style="width: 100%" class="indextable genindextable"><tr>
   <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api_reference/yafs.core.html#yafs.core.Sim.last_busy_time">last_busy_time (yafs.core.Sim attribute)</a>
+</li>
       <li><a href="api_reference/yafs.topology.html#yafs.topology.Topology.LINK_BW">LINK_BW (yafs.topology.Topology attribute)</a>
 </li>
   </ul></td>
@@ -331,10 +335,12 @@ <h2 id="T">T</h2>
 <h2 id="U">U</h2>
 <table style="width: 100%" class="indextable genindextable"><tr>
   <td style="width: 33%; vertical-align: top;"><ul>
-      <li><a href="api_reference/yafs.distribution.html#yafs.distribution.uniformDistribution">uniformDistribution (class in yafs.distribution)</a>
+      <li><a href="api_reference/yafs.core.html#yafs.core.Sim.undeploy_module">undeploy_module() (yafs.core.Sim method)</a>
 </li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="api_reference/yafs.distribution.html#yafs.distribution.uniformDistribution">uniformDistribution (class in yafs.distribution)</a>
+</li>
       <li><a href="api_reference/yafs.core.html#yafs.core.Sim.unreachabled_links">unreachabled_links (yafs.core.Sim attribute)</a>
 </li>
   </ul></td>
diff --git a/docs/build/html/index.html b/docs/build/html/index.html
index 2b0565f1..ae9ea772 100644
--- a/docs/build/html/index.html
+++ b/docs/build/html/index.html
@@ -43,8 +43,6 @@
   <div class="figure align-center" id="id1">
 <img alt="_images/yafs_logo.png" src="_images/yafs_logo.png" />
 <p class="caption"><span class="caption-text">Yet Another Fog Simulator for Python</span></p>
-<div class="legend">
-<a class="reference external" href="https://pypi.python.org/pypi/yafs">PyPI</a></div>
 </div>
 <div class="sidebar">
 <p class="first sidebar-title">Documentation</p>
@@ -88,13 +86,27 @@ <h2>Installation<a class="headerlink" href="#installation" title="Permalink to t
 <div class="section" id="cite-this-work">
 <h2>Cite this work<a class="headerlink" href="#cite-this-work" title="Permalink to this headline">¶</a></h2>
 <p>Please, consider including this reference in your works or publications:</p>
-<div class="highlight-python"><div class="highlight"><pre><span></span><span class="n">PENDING</span>
-</pre></div>
-</div>
-<div class="highlight-python"><div class="highlight"><pre><span></span><span class="n">PENDING</span>
+<div class="highlight-python"><div class="highlight"><pre><span></span><span class="n">Isaac</span> <span class="n">Lera</span><span class="p">,</span> <span class="n">Carlos</span> <span class="n">Guerrero</span><span class="p">,</span> <span class="n">Carlos</span> <span class="n">Juiz</span><span class="o">.</span> <span class="n">YAFS</span><span class="p">:</span> <span class="n">A</span> <span class="n">simulator</span> <span class="k">for</span> <span class="n">IoT</span> <span class="n">scenarios</span> <span class="ow">in</span> <span class="n">fog</span> <span class="n">computing</span><span class="o">.</span> <span class="n">IEEE</span> <span class="n">Access</span><span class="o">.</span> <span class="n">Vol</span><span class="o">.</span> <span class="mi">7</span><span class="p">(</span><span class="mi">1</span><span class="p">),</span> <span class="n">pages</span> <span class="mi">91745</span><span class="o">-</span><span class="mi">91758</span><span class="p">,</span>
+<span class="mf">10.1109</span><span class="o">/</span><span class="n">ACCESS</span><span class="o">.</span><span class="mf">2019.2927895</span><span class="p">,</span> <span class="n">Jul</span> <span class="mi">10</span> <span class="mf">2019.</span>
+
+<span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">ieeexplore</span><span class="o">.</span><span class="n">ieee</span><span class="o">.</span><span class="n">org</span><span class="o">/</span><span class="n">document</span><span class="o">/</span><span class="mi">8758823</span>
+
+<span class="nd">@ARTICLE</span><span class="p">{</span><span class="mi">8758823</span><span class="p">,</span>
+<span class="n">author</span><span class="o">=</span><span class="p">{</span><span class="n">I</span><span class="o">.</span> <span class="p">{</span><span class="n">Lera</span><span class="p">}</span> <span class="ow">and</span> <span class="n">C</span><span class="o">.</span> <span class="p">{</span><span class="n">Guerrero</span><span class="p">}</span> <span class="ow">and</span> <span class="n">C</span><span class="o">.</span> <span class="p">{</span><span class="n">Juiz</span><span class="p">}},</span>
+<span class="n">journal</span><span class="o">=</span><span class="p">{</span><span class="n">IEEE</span> <span class="n">Access</span><span class="p">},</span>
+<span class="n">title</span><span class="o">=</span><span class="p">{</span><span class="n">YAFS</span><span class="p">:</span> <span class="n">A</span> <span class="n">Simulator</span> <span class="k">for</span> <span class="n">IoT</span> <span class="n">Scenarios</span> <span class="ow">in</span> <span class="n">Fog</span> <span class="n">Computing</span><span class="p">},</span>
+<span class="n">year</span><span class="o">=</span><span class="p">{</span><span class="mi">2019</span><span class="p">},</span>
+<span class="n">volume</span><span class="o">=</span><span class="p">{</span><span class="mi">7</span><span class="p">},</span>
+<span class="n">number</span><span class="o">=</span><span class="p">{},</span>
+<span class="n">pages</span><span class="o">=</span><span class="p">{</span><span class="mi">91745</span><span class="o">-</span><span class="mi">91758</span><span class="p">},</span>
+<span class="n">keywords</span><span class="o">=</span><span class="p">{</span><span class="n">Relays</span><span class="p">;</span><span class="n">Large</span> <span class="n">scale</span> <span class="n">integration</span><span class="p">;</span><span class="n">Wireless</span> <span class="n">communication</span><span class="p">;</span><span class="n">OFDM</span><span class="p">;</span><span class="n">Interference</span> <span class="n">cancellation</span><span class="p">;</span><span class="n">Channel</span> <span class="n">estimation</span><span class="p">;</span><span class="n">Real</span><span class="o">-</span><span class="n">time</span> <span class="n">systems</span><span class="p">;</span><span class="n">Complex</span> <span class="n">networks</span><span class="p">;</span><span class="n">fog</span> <span class="n">computing</span><span class="p">;</span><span class="n">Internet</span> <span class="n">of</span> <span class="n">Things</span><span class="p">;</span><span class="n">simulator</span><span class="p">},</span>
+<span class="n">doi</span><span class="o">=</span><span class="p">{</span><span class="mf">10.1109</span><span class="o">/</span><span class="n">ACCESS</span><span class="o">.</span><span class="mf">2019.2927895</span><span class="p">},</span>
+<span class="n">ISSN</span><span class="o">=</span><span class="p">{</span><span class="mi">2169</span><span class="o">-</span><span class="mi">3536</span><span class="p">},</span>
+<span class="n">month</span><span class="o">=</span><span class="p">{},</span>
 </pre></div>
 </div>
 <p>Please let it knows us if you use this project in your research. We will cite them. Thank you</p>
+<p>You can find other related works developed with YAFS in the readme of YAFS git hub repository.</p>
 </div>
 </div>
 <div class="section" id="acknowledge">
diff --git a/docs/build/html/introduction/basic.html b/docs/build/html/introduction/basic.html
index d34e6f26..319ad208 100644
--- a/docs/build/html/introduction/basic.html
+++ b/docs/build/html/introduction/basic.html
@@ -56,7 +56,7 @@ <h2>Network Topology<a class="headerlink" href="#network-topology" title="Permal
 <ul class="simple">
 <li><strong>BW</strong> Channel Bandwidth: in Bytes</li>
 <li><strong>PR</strong> Channel Propagation speed</li>
-<li>The <strong>Latency</strong> is dynamically computed using: Message.size.bits / (BW + PR)</li>
+<li>The <strong>Latency</strong> is dynamically computed using: (Message.size.bits / BW) + PR)</li>
 </ul>
 <p>A network can be created using a dictionary structure (or json file) or through some implemented algorithms from specific libraries compatibles with Networkx (see <a class="reference internal" href="../architecture/index.html#architecture"><span class="std std-ref">architecture details</span></a>).</p>
 <p>In the definition of your devices, nodes,  you can include your custom tags.</p>
diff --git a/docs/build/html/objects.inv b/docs/build/html/objects.inv
index 704a6878063e1265e3724a0baac110817b7e46a8..d68894b738e0c5588594ee15040e4f5f13b70f4a 100644
GIT binary patch
delta 1376
zcmV-m1)ut-3&#tPcz=%DHV}aCdI|#R)!w8)FS+fmwS|%F+ORhXauR5Xl8I8JKvKp!
zr#?iVuuoD_vVJH_qSmH+vxmcPhUCofM@JY7kR3m#EXoN29|6p8z)_4iq9M9Fs^<A#
zrsPAZF#8S6yg~@GjNlMT%&4t@OV!Gn-<#Z!Kq0`VNmv_i{(t&&?FY}R#ka4%W<x1C
z-sKWG<!_fSUv5ZWecL?V#(Nk=fk6C#Llm5rQ!gx%dlucohG01lZ)Kxk2PqN)CP=t9
zk|0^pZv)SAUM<6o+!vVsbvp|}PmoLab2Hl)6@`#-WUEwKr@urMEnA#g%r}6uo^wbD
z3xkEfoshkDPJff3SEHIlyaE-WjId*%=HIs56DTR8STgQ_q=VcAW>T#h10gE0R3k%b
zhC^}XWFvaGlAsGfx%!1;*q)_hG?frC*yZ9FNSt09Ng2mf1`*ojNuUx9Clsd2$*UaX
zD8WJ^9-xClm190$1<dI+-Gzi))p*WARn@KovFytE)_({WuH>}N-YJKNaTG@|+`}C~
zQ9x7*UzjkFTJ)mJgi~r;w|@^XG!`B7$fj^k?ng#QMQDntlHu_G<ZpE}u9-?ZN0!iA
z#;8s*NNzBW0lM>1<P^t@r*1~jD*R(ncv9;Rz^d`NVU0LrplU`&V2E@*wRuu2_WRN_
zKayOR)_-*yJmOY|+XM8Y1i7QVu$r}spPLiuRZw^C)uduersz%W%b~=F=4L%oL*Ii}
zd9O33-1VK)C+vrVIF{vP(nCU{IS`Xg``Unxtx$(K4!dZP-e=*0b$XwHDNFS}qNr|@
zA)}Hratk~UUDDNFq4q#XE)5QW2nwf!Y^~TIv42hT6Xxm+z1=e|k&tUB_ZHte<R0XT
zq79@GOP$cR?IF7%l@A>!=f;-w5@rx{mIg7zB<JX211e6edv>8Tu)ampwxWzpTLbCq
zJ%<OxVS)m})M=d~p^iYpJ}e7V&s7xHFLLVKLh!FiHK&iP?h%Zz<Y=3(O0R#)>ekm5
zZhvIrOxiGJ{&o5CC3yHT;U@7u<a*;0`LbI0!E*iTlBr)rDT}P(G8q`E>zPCWFRDvm
zth+;e)lg<~!eO>|W+KKk3YH7u45(8HMG0~abnBwiFsOj;T@-<eeP>j{VB`$OQOXX;
z?L-Rv>r$Am+14GZP&zBOaK~~9gp58DxPL<g%#>X%x>LD<-YPry536slUaO(#5wWmO
zztV2I(6L~6*RrG<W=)^_^%89SCx7F=Jo;WwC&P;Y<|su^%rK<>@Co!UZ~RMx1=IZ|
z0lHFe;5Ey_tslHV)8pU2{{dT^>QgJ@0MP_f<XK)SEN0FgHNctJ8-9MUz}t@$pnom#
z#%_=nsCm-_rpy~X=iA8Ug#dJf-q_L7f;Nw!z?6AIM=%?-KBj@@zc*4{EIgwK0Yl^s
z)g246sZF5y??E2!u~dW4dAESHS~``g)nWkd&S;f8LrSOeF$g>_LH%Bt2z`MqzGSpI
zR<crk!NObzX&H;LO5vaPPg@VY!GAQ<?^ec4R8n&m{FBr(o7*;fI`(vvxhf(0CE_IM
zC3KZa*y~AJQN8$+={nXo`6w@9`)&sX4x4Q){(ZV`f@m|kx<@4~omuLi-q|FyG*;jJ
z&G)7M!z)aUST`nGuZ(I2e}HF9)gfJY=boAdd&dDD3dKjJG9r^5NJ5wpkXauGIh8_*
z`m<7JG0<=Q9a_&E^bXE8G)z?;A?F2iP^nsoM&hY+NYBb;$63`-_9-81PirWUPBXJd
iDJzw?W&2v)lfB;PJx`t9`2A2xXI1C3fc_6yEvZ)aW1)`#

delta 1329
zcmV-11<v}%3#SW^cz<r&I1qsEdI|#FtDSa%z4VsE%ED+98+O{FCxMnInOKSxNXm$N
z+K1RD+$UL5vMf=5RBU>0$;|MZ;cz%2=_8B<$c~>=7Ucwij{s&k;3!5M(GcAom3qFH
zDfv(u%zgtiuMom4BRGT-Gin>(FtxJg_a-+aPzdm864u6>zkmK*`@!>S@$IXx*-%Q3
zcezAP`P=2ommAVo-!_l8i5^B#AP_&`5Cx~@)C-H`o<+CtAz04CTlpy1L5hTc2@>v|
zBuG~D+rYD&SIcmt@CBxS-Ohv1333U4uCsknQwSMHwoavO`dd_?+2YjVz6Nwg&LJTz
z3>N-&!tS+m>VF-2HLBi-SD+%45q1nz{%y-Wfs!(cCF2fAy2xE%CiSW@5TX)GH8Z3#
z9EvNGjp*S@LdG$bL4<aB5~ym%35BT&QCu@cjuI>+;sH7+R8Y?NDqv2p87?H`s*!RQ
zs@8EGh-FviTO(YAl2eXgxQ9D}qJXI4zOa-cwNk~934iCerfq+BG%OY^^hmqxlKYVn
zQe~B5s$@9)Klxi-LTje>iX%_xEn`&g3`lM;j{&;#S>zPQjHhm9&}fNcRd_P%FThIq
zT(d@kF;HhlMqr3^6SPHgHtdh3RzH$l_rrA)JQ7xm+XM8Y1i7QVurq5FKi6lqtDx?}
zJClmjDt|?9GJv7Phx*Pr(nH^aSNmS?n4mZfIj2wfhz;UcmXk?W?AmgmCTsoLfR3$D
zi#ZOvXp!FM;evH~pMxn&^**Ag?pYzDk~4A(JP%#c)we=@10lJzI0PanoKmu9!~Tk`
z)lZlU8Ep5AOC;nP%DpAF7P$wxqG$tY#8M};ZGUshZb;=5z$v(~CB1|h#GIu;3^B<$
zy4ZoL6YDp-FdA6jLba_ZV`-})eWT~_fH+K0K$tpWb0pLeNZ6-kf$CgE@%gPvom&Y0
zHL2(Hk=5a!5tbZn`Ks*tQ+C$AHgF?}Gik$^`Pb#km*C;Ygqy_skn4?0<jZQ|2g~)V
zOMj+*E2J#4mdj*dsIF%c1-$4kfwArm@s*<7$q9$q-kFOS(<oRjgfpPtN+?Q@bD-N0
zot8lbbRVJ!RP8&X5(Xn@Fpg4oKyDK$@UKf@x@TLzP=!&a-NGHqB@i<DOyCX?FjIcD
z=uYho^j7(~e^`Bc^%{y|M8v{A`^vf*LSf5;5naQRQq1Zx_v<Ct_)q@Ee|hx1o<T+w
z1I$s1PRuam{F5Nie|h6?@D@z_wH~yk-oR^?g?oPR0`-W0|NaMTajH+Pi~~dyOp#}K
zsj#@|JZgZB*c*O+u)v#-6rd@SaRd{8w1nQ+(b9r8kD$Pmc|%7q8}xik1NHyjNO!UD
zj3xvOkvG(LEXcYyf%<<B@^Fu(ntaaN4WyxIb*hHO0NizGRX9UNr}i-j?6#o(s7!>u
zz!pD0GzM0((tN?fTo-9si?Q0mKkuKm9(sdmrr)iMOjJ@c3;s#!nd+v`o`F4o!(^^n
zh<=GUNqPxwqZ0Odl2%kN{$z%Z^-Vs?i`u^1L4m{ivljn8-8MnAp51vwB`t$l>OZ|s
z5*ik(@BZfd(*NNVu135YiPkHl)Zh>BjHx=L3$Gig>9BVm;Gr;lWNJrbvIR*969V$%
zAg3}YQGZtEEC%|mzeVfGLGR>5Y*WKj^%2r-n1e>uLevsZokMz7E<4UDMLDK?usyAz
nKzf^*BT89mye;)>bx-zstGBy#dh7Q?C7o4+I|cn89cWexaCDSc

diff --git a/docs/build/html/searchindex.js b/docs/build/html/searchindex.js
index 71e132cb..4bb228af 100644
--- a/docs/build/html/searchindex.js
+++ b/docs/build/html/searchindex.js
@@ -1 +1 @@
-Search.setIndex({docnames:["about/index","api_reference/index","api_reference/yafs","api_reference/yafs.application","api_reference/yafs.core","api_reference/yafs.distribution","api_reference/yafs.metrics","api_reference/yafs.placement","api_reference/yafs.population","api_reference/yafs.selection","api_reference/yafs.stats","api_reference/yafs.topology","api_reference/yafs.utils","architecture/architecture","architecture/index","contents","examples/index","examples/tutorial_example","index","introduction/basic","introduction/glossary","introduction/index","introduction/installation"],envversion:52,filenames:["about/index.rst","api_reference/index.rst","api_reference/yafs.rst","api_reference/yafs.application.rst","api_reference/yafs.core.rst","api_reference/yafs.distribution.rst","api_reference/yafs.metrics.rst","api_reference/yafs.placement.rst","api_reference/yafs.population.rst","api_reference/yafs.selection.rst","api_reference/yafs.stats.rst","api_reference/yafs.topology.rst","api_reference/yafs.utils.rst","architecture/architecture.rst","architecture/index.rst","contents.rst","examples/index.rst","examples/tutorial_example.rst","index.rst","introduction/basic.rst","introduction/glossary.rst","introduction/index.rst","introduction/installation.rst"],objects:{"":{yafs:[2,0,0,"-"]},"yafs.application":{Application:[3,1,1,""],Message:[3,1,1,""]},"yafs.application.Application":{TYPE_MODULE:[3,2,1,""],TYPE_SINK:[3,2,1,""],TYPE_SOURCE:[3,2,1,""],add_service_module:[3,3,1,""],add_service_source:[3,3,1,""],add_source_messages:[3,3,1,""],get_message:[3,3,1,""],get_pure_modules:[3,3,1,""],get_sink_modules:[3,3,1,""],set_modules:[3,3,1,""]},"yafs.core":{Sim:[4,1,1,""]},"yafs.core.Sim":{alloc_DES:[4,2,1,""],alloc_module:[4,2,1,""],alloc_source:[4,2,1,""],deploy_app:[4,3,1,""],deploy_monitor:[4,3,1,""],deploy_sink:[4,3,1,""],deploy_source:[4,3,1,""],entity_metrics:[4,2,1,""],env:[4,2,1,""],print_debug_assignaments:[4,3,1,""],register_event_entity:[4,3,1,""],run:[4,3,1,""],start_process:[4,3,1,""],stop:[4,2,1,""],stop_process:[4,3,1,""],unreachabled_links:[4,2,1,""]},"yafs.distribution":{Distribution:[5,1,1,""],deterministicDistribution:[5,1,1,""],deterministicDistributionStartPoint:[5,1,1,""],exponentialDistribution:[5,1,1,""],exponentialDistributionStartPoint:[5,1,1,""],uniformDistribution:[5,1,1,""]},"yafs.metrics":{Metrics:[6,1,1,""]},"yafs.placement":{ClusterPlacement:[7,1,1,""],EdgePlacement:[7,1,1,""],NoPlacementOfModules:[7,1,1,""],Placement:[7,1,1,""]},"yafs.placement.Placement":{get_next_activation:[7,3,1,""],initial_allocation:[7,3,1,""],run:[7,3,1,""]},"yafs.population":{Population:[8,1,1,""],Statical:[8,1,1,""]},"yafs.population.Population":{get_next_activation:[8,3,1,""],initial_allocation:[8,3,1,""],run:[8,3,1,""],set_sink_control:[8,3,1,""],set_src_control:[8,3,1,""]},"yafs.selection":{First_ShortestPath:[9,1,1,""],OneRandomPath:[9,1,1,""],Selection:[9,1,1,""]},"yafs.selection.Selection":{get_path:[9,3,1,""],get_path_from_failure:[9,3,1,""]},"yafs.stats":{Stats:[10,1,1,""]},"yafs.stats.Stats":{average_loop_response:[10,3,1,""],get_df_service_utilization:[10,3,1,""]},"yafs.topology":{Topology:[11,1,1,""]},"yafs.topology.Topology":{LINK_BW:[11,2,1,""],LINK_PR:[11,2,1,""],NODE_IPT:[11,2,1,""],add_node:[11,3,1,""],create_random_topology:[11,3,1,""],create_topology_from_graph:[11,3,1,""],find_IDs:[11,3,1,""],get_edge:[11,3,1,""],get_edges:[11,3,1,""],get_node:[11,3,1,""],get_nodes:[11,3,1,""],get_nodes_att:[11,3,1,""],load:[11,3,1,""],remove_node:[11,3,1,""],size:[11,3,1,""]},yafs:{application:[3,0,0,"-"],core:[4,0,0,"-"],distribution:[5,0,0,"-"],metrics:[6,0,0,"-"],placement:[7,0,0,"-"],population:[8,0,0,"-"],selection:[9,0,0,"-"],stats:[10,0,0,"-"],topology:[11,0,0,"-"],utils:[12,0,0,"-"]}},objnames:{"0":["py","module","Python module"],"1":["py","class","Python class"],"2":["py","attribute","Python attribute"],"3":["py","method","Python method"]},objtypes:{"0":"py:module","1":"py:class","2":"py:attribute","3":"py:method"},terms:{"abstract":[5,18,20],"boolean":4,"byte":[3,19],"case":[17,19],"class":[1,3,4,5,6,7,8,9,10,11,18,19],"default":[3,4],"float":3,"function":[1,3,4,7,8,9,11,12,19],"import":19,"int":[3,4,9,11],"new":[9,18],"public":[18,19],"return":[3,4,7,8,9,10,11,19],"static":[8,19],"true":4,"var":4,And:8,DES:[4,19],For:19,IPS:[11,19],One:19,QoS:[],That:19,The:[1,2,3,4,17,18,19],There:[4,18],Using:[4,17],abil:19,about:[4,15,18],abov:18,absolut:18,accept:19,access:[18,19],accord:[7,8,17,19],acknowledg:15,acsicuib:18,action:[18,20],activ:[7,8],activation_dist:[7,8],actuat:[3,4,19,20],actuator_dev:19,acycl:19,adapt:18,add:[3,4,11],add_nod:11,add_service_modul:[3,19],add_service_sourc:3,add_source_messag:[3,19],addit:[11,18],admit:11,advanc:19,affect:17,aggreg:19,aka:4,algorithm:[3,4,7,8,9,15,18,21],all:[2,4,9,11,17,18,19],alloc:[7,8,17,18,19,20],alloc_d:[4,9,19],alloc_modul:[4,9,19],alloc_sourc:4,allow:3,along:18,also:[9,19,22],although:19,alwai:18,among:[9,19],analys:[17,22],analysi:18,analyt:18,ani:[4,18,20],anoth:18,api:[15,18,19],aplic:19,app1:19,app:[4,19],app_nam:[3,4,7,8,9,19],appedg:19,append:19,applic:[1,4,7,8,9,15,18,20,21],applicaiton:[],architectur:[15,18,19],arg:[3,4,7,8,9,11],arrai:[4,9,18,19],arrang:19,arriv:19,aspect:[],assign:[4,7,8,11,18],associ:[4,7,8,19],attent:[],attract:19,attribut:[11,19],author:[18,22],avail:[2,19],averag:19,average_loop_respons:10,balear:0,bandwidth:[11,19],base:[8,18],basic:[15,17,18,21],been:17,behaviour:4,believ:18,beloglazov:19,below:20,bestd:19,bestpath:19,between:[3,4,18,19,20],bill:18,bit:19,block:19,both:[0,8,9,19],broadcast:[3,19],broken:9,buffer:19,buyya:19,calcul:9,calheiro:19,call:9,can:[3,4,9,17,18,19,20,22],capabl:[],capac:[],carlo:0,certain:19,chang:[4,7,8,19],channel:19,characterist:[3,18,19],cheapest:7,chequeo:10,cite:15,classic:18,clean:4,client:4,clone:18,close:17,cloud:[4,17,18,19],cloud_dev:19,cloudplac:19,cloudsim:19,cluster:[7,19],clusterplac:7,code:[4,19],com:18,come:3,common:12,commun:22,comp_m:19,compar:[17,18],compat:19,complex:[11,18,19],compon:[1,2],comput:[0,3,18,19,20],concept:[15,18,20,21],configur:18,connect:[18,20],consid:18,consider:18,consist:19,consum:[4,19],contain:[4,18],content:15,contributor:[],control:[3,4,7,8,17,18,19,20],coordin:[4,19],core:[1,3,7,8,9,15],cost:19,cot:18,cover:18,creat:[3,4,19],create_apl:19,create_appl:19,create_random_topolog:11,create_topology_from_graph:11,creation:[11,19],criteria:7,csv:19,ctime:[9,19],current:[4,9],curv:18,custom:[1,17,18,19],dag:[3,19],dastjerdi:19,data:[3,11,18,19],databas:4,ddf:19,deal:11,debug:4,decid:18,deepen:20,deeper:19,def:19,default_results_path:[4,6],defaultpath:10,defin:[3,4,18,19],definit:[14,19],del:10,delai:11,demo:17,denot:19,depend:[15,18,19,21],deploi:[4,18,19,20],deploy:[4,18,19],deploy_app:[4,19],deploy_modul:19,deploy_monitor:4,deploy_sink:4,deploy_sourc:4,des:19,des_dst:19,descript:[1,18],design:[0,18],destin:[9,11,19],destini:[9,19],detail:[1,17,18,19],deterministicdistribut:[5,19],deterministicdistributionstartpoint:5,develop:[],devic:[18,19,20],dict:[3,4,7,8,9,11],dictionari:[4,11,19],differ:[4,7,19],direct:19,directli:[],directori:17,discret:[4,18,22],distinct:3,distribut:[1,3,4,7,8,15,17,18,19],doe:19,done:19,download:18,driver:8,dst:[3,9,19],dst_int:3,dst_node:19,dure:[7,8],dynam:[17,18,19],dynamicalloc:17,dynamicfailuresonnod:17,dynamicworkload:17,each:[3,4,8,11,17,19],ecosystem:[7,8,18,19],edg:[4,11,18,19],edgeplac:7,eeg_gam:19,effici:22,egg_gam:4,element:[4,18,19],elemento:19,emerg:[],empti:[3,9],enabl:[18,20],engin:[1,15],enorm:22,entiti:[3,4,9,19,20],entity_metr:4,env:4,environ:[4,18,19],equival:[19,20],etc:[18,19],euclidean:17,evalu:19,event:[4,18,19,22],event_typ:4,events_log:4,everi:19,evolut:18,exampl:[11,15,18,19],execut:[3,7,8,19],existencia:10,experi:[17,19],experiment1:17,experiment2:17,explain:[17,18,19],exponentialdistribut:5,exponentialdistributionstartpoint:5,expos:19,extend:[1,8,18],facilit:11,faculti:0,failur:18,fall:[],fals:[3,4,19],far:19,featur:[11,18],feautur:11,few:21,field:20,file:[4,11,19],financi:18,find:19,find_id:[11,19],finish:19,first:[9,17,19],first_shortestpath:9,firstli:19,fix:19,focus:[],fog:[18,19],fogcentr:17,follow:[2,3,9,18,19],format:[17,18,19],fractional_select:19,from:[3,9,11,17,18,19],gatewai:[],gather:18,gener:[3,5,8,11,18,19,20],get:19,get_df_service_util:10,get_edg:11,get_messag:[3,19],get_next_activ:[7,8],get_nod:11,get_nodes_att:11,get_path:[9,19],get_path_from_failur:9,get_pure_modul:3,get_sink_modul:[3,19],ghosh:19,git:18,github:18,given:[7,8],glossari:[15,21],good:19,graph:[11,19],graphml:17,group:19,guerrero:0,guid:18,gupta:19,hai:10,has:[3,4,18,19,22],have:[7,8,9,11,17,19,22],help:1,hidden:18,highli:18,highlight:18,histori:18,host:19,how:[8,17,18,19],http:18,id_clust:19,id_nod:[4,11,19],id_topolog:19,idd:19,idea:19,identifi:[3,4,9,11,19],ifogsim:[17,19],illustr:19,implement:[0,7,8,17,18,19,22],impli:9,includ:[18,19],incom:19,index:15,inform:4,infrastructur:18,initi:[7,8],initial_alloc:[7,8,19],input:[3,4],inst:3,instal:[15,21],instanc:3,instant:3,instead:3,instrucct:3,instruct:[3,11,19],interact:4,interfac:[7,8,9],intermedi:3,intern:[3,4,19],internatlli:4,internet:19,introduc:5,intuit:[],invok:[4,7,8,19],iot:19,ipt:[3,11,19],isaac:0,island:0,its:[3,4,11,19],json:[4,11,19],just:[21,22],kei:[4,11,18,19],kind:5,know:18,kwarg:[3,4,5,7,8,11],lambd:5,last:19,latenc:[17,19],launch:19,learn:[18,21],length:19,lera:0,let:18,level:18,librari:[18,19,22],licens:18,lightweight:18,like:3,link1:19,link2:19,link:[3,4,9,11,18,19,20],link_bw:11,link_pr:11,link_regist:4,links_log:4,list:[2,3,11,19,20],load:[7,11,19],local:[8,19],locat:7,logger:[4,7,8,9,11],look:19,loop:10,low:18,m_a:19,m_b:19,main1:[17,19],main2:17,main3:17,main:[2,4,8,17,18,19,20],mainli:22,manag:[3,18,19,22],mandatori:19,manipul:[],manual:18,max:5,mayb:19,mean:19,memori:19,messag:[3,4,8,9,18,19,20],message_in:3,message_out:3,method:[7,8,19],metric:[1,4,15],millisecond:19,min:5,mineco:18,minimum:17,minimun:19,minimunpath:19,minut:[15,19],mip:3,mit:18,mod:[7,8],model:[11,15,18,21],modul:[2,3,4,5,7,8,9,10,17,18,19,20],module_dest:3,module_nam:3,monitor:4,more:19,most:[17,19],move:19,movement:17,msg:[3,4],multi:19,multipl:19,must:[3,19],mytag:19,name:[3,4,5,7,8,19],name_regist:4,necessari:[4,20],network:[9,11,15,17,18,20,21],networkx:[11,19,22],next:[7,8,17],next_event_dist:4,next_time_period:19,node:[4,7,8,9,11,17,18,19,20],node_cost:[],node_ipt:11,node_ram:[],node_src:19,node_up:4,nodo:19,non:3,none:[3,4,6,7,8,9,11],noplacementofmodul:7,nosql:[],nsame:3,number:[3,11,18,19],nxgraphgener:11,object:[4,7],objet:19,obligatori:[7,9],obtain:19,occup:9,offer:18,onc:[7,19],oncloud:19,one:[4,9,11,19],onerandompath:9,onli:[4,7,8,11,18,19,20],option:9,orchestr:[9,18,19],ord:18,order:18,other:[7,18,19,20],output:3,over:[],overrid:[7,8,9],overview:15,packag:[19,20,22],page:15,panda:22,param:[3,4,7,8,11,19],param_distribut:3,paramet:[3,4,7,8,9,11],part:[19,20],path:[3,9,17,19],pend:18,per:[11,19],perform:[2,19],pip:22,placement:[1,4,15,18,20,21],plan:1,pleas:18,point:[9,17,18,19],polici:[18,19],pop:19,popul:[1,3,4,15,17,21],possibl:[9,18,19],practic:19,previou:19,print:[4,19],print_debug_assigna:4,probabl:3,process:[3,4,18,19],progress:[14,16],project:[18,22],propag:[11,19],provid:[1,9,18],provis:19,pure:[3,4,8,19,20,22],purge_regist:4,purpos:4,put:4,pypi:[18,22],python:[18,19,22],quit:18,ram:19,random:[9,17,19],rang:19,ranjan:19,raw:18,reach:[3,9,17],real:19,reason:19,receiv:[3,19,20],recib:3,record:[4,19],redi:4,reduc:18,refer:[15,18,19],regard:18,regardless:7,regist:4,register_event_ent:4,registr:19,rel:3,relat:20,relationship:4,releas:18,reli:22,remov:[11,17],remove_nod:11,rep:19,replica:7,repres:[4,18,19],represent:[19,20],request:[18,19],requir:[7,8,9,18,19],research:18,resort:20,resourc:[18,19],respect:19,respons:[4,10,19],rest:[4,19],result:[10,15,21,22],robin:17,robust:18,rose:19,round:17,rout:[9,17,18],router:[],rule:19,run:[4,7,8,15,21,22],same:[3,4,11,18,19],scale:[17,19],scaleservic:19,scenario:19,schedul:17,scienc:0,search:[11,15],second:[17,19],secondli:19,section:[17,19,21],see:[4,17,19],seed:5,seen:9,select:[1,4,15,17,18,19],selector:[4,15,21],selectorpath:19,self:19,send:[3,9,19],sensor:[3,4,8,19,20],sensor_dev:19,sent:19,sequenc:19,serv:19,servic:[4,7,10,18,19],servicea:19,set:[3,18,19],set_modul:[3,19],set_sink_control:[8,19],set_src_control:[8,19],setup:17,sever:[8,17,18,19],shorter:9,shortest:19,shortest_path:19,should:[1,9],show:17,show_progress_monitor:[4,19],sim:[4,7,8,9,19],similar:[18,19],simpi:[18,22],simpl:[18,19],simplecas:19,simul:[1,2,3,5,7,8,11,15,17,18,21,22],simulation_tim:19,sinc:3,singl:19,sink:[3,4,7,8,19,20],sink_m:19,size:[3,11,19],softwar:[18,19,22],some:[4,9,12,19,22],sophist:17,sourc:[3,4,5,6,7,8,9,10,11,19,20],spain:18,special:20,specif:[10,19],speed:19,src:[3,9,19],start:[4,5,7,8],start_process:4,stat:[1,15,18,19],statist:19,step:17,stop:4,stop_process:4,storag:19,store:[8,18,19],str:[3,4,7,8,11],stranger:18,string:[4,7],structur:[4,19],subsect:19,sudo:[],support:[18,22],system:[],tabl:2,tag:19,tak:19,take:19,taken:19,target:[3,19],task:19,techniqu:19,tempor:[7,8],temporari:[4,18],term:[15,21],test_initial_deploi:4,than:19,thank:[18,22],thei:19,them:[3,18,19,20],theori:18,thi:[2,3,4,5,7,8,9,11,15,17,19,20,21],thing:[18,19],those:3,three:17,threshold:19,through:[18,19],thu:18,time:[3,4,5,7,8,10,11,17,19],time_emit:19,time_in:19,time_loop:10,time_out:19,time_recept:19,time_shift:19,timestamp:[3,18],tin2017:18,tinydb:[],titl:19,tnode:19,todo:[4,13,17],toolkit:19,topic:18,topo:19,topolog:[1,3,4,7,8,9,15,17,18,21,22],topology_json:19,topology_src:[9,19],tprocess:19,traffic:[9,18,19],transfer:3,transmiss:[3,19],transmit:19,travel:3,trequest:19,tupl:[],tuplemap:19,tutori:[15,16,18,19],tutorial1:19,two:[7,8,19,20],type:[4,7,8,19,20,22],type_modul:[3,19],type_sink:[3,19],type_sourc:[3,19],typic:[],typifi:3,unavail:9,under:18,understand:19,unifi:[4,11],uniformdistribut:5,uniqu:[3,19],unit:[3,19],univers:0,unreachabled_link:4,until:4,usag:18,use:[3,17,18,19,22],used:[3,4,17,19,22],useful:18,user:[4,10,17,18,19],using:[18,19],usual:19,util:[1,4,10,15,19],vahid:19,valu:[3,4,8,11,19],vari:[],variabl:[4,18,19],variou:18,vertic:19,vrgamefog:17,wai:[],wait:19,want:[19,22],watt:19,well:22,whatev:[5,18,19,22],when:[9,19],where:[4,7,18,19],whether:[],which:[3,19],who:[2,3,4,19,20],whole:18,wholel:[],wish:19,within:[3,4,9,11],work:[0,15,20,22],workload:18,yaf:[0,1,17,18,19],yet:18,you:[1,17,18,19,21,22],your:[18,19]},titles:["ABOUT","API REFERENCE","<code class=\"docutils literal\"><span class=\"pre\">yafs</span></code>","<code class=\"docutils literal\"><span class=\"pre\">yafs.application</span></code>","<code class=\"docutils literal\"><span class=\"pre\">yafs.core</span></code> \u2014 Simulator engine","<code class=\"docutils literal\"><span class=\"pre\">yafs.distribution</span></code>","<code class=\"docutils literal\"><span class=\"pre\">yafs.metrics</span></code>","<code class=\"docutils literal\"><span class=\"pre\">yafs.placement</span></code>","<code class=\"docutils literal\"><span class=\"pre\">yafs.population</span></code>","<code class=\"docutils literal\"><span class=\"pre\">yafs.selection</span></code>","<code class=\"docutils literal\"><span class=\"pre\">yafs.stats</span></code>","<code class=\"docutils literal\"><span class=\"pre\">yafs.topology</span></code>","<code class=\"docutils literal\"><span class=\"pre\">yafs.utils</span></code>","Architecture","Architecture","Documentation for YAFS","Examples","Tutorial Example","OVERVIEW","Basic Concepts","Glossary of terms","YAFS in 5 Minutes","Installation"],titleterms:{about:0,acknowledg:18,algorithm:19,api:1,applic:[2,3,19],architectur:[13,14],basic:19,cite:18,concept:19,core:[2,4],depend:22,distribut:5,document:[15,18],engin:4,exampl:[16,17],glossari:20,indic:15,instal:[18,22],metric:[2,6],minut:21,model:19,network:19,overview:18,placement:[2,7,19],popul:[2,8,19],refer:1,result:19,run:19,select:[2,9],selector:19,simul:[4,19],stat:10,tabl:15,term:20,thi:18,topolog:[2,11,19],tutori:17,util:12,work:18,yaf:[2,3,4,5,6,7,8,9,10,11,12,15,21,22]}})
\ No newline at end of file
+Search.setIndex({docnames:["about/index","api_reference/index","api_reference/yafs","api_reference/yafs.application","api_reference/yafs.core","api_reference/yafs.distribution","api_reference/yafs.metrics","api_reference/yafs.placement","api_reference/yafs.population","api_reference/yafs.selection","api_reference/yafs.stats","api_reference/yafs.topology","api_reference/yafs.utils","architecture/architecture","architecture/index","contents","examples/index","examples/tutorial_example","index","introduction/basic","introduction/glossary","introduction/index","introduction/installation"],envversion:52,filenames:["about/index.rst","api_reference/index.rst","api_reference/yafs.rst","api_reference/yafs.application.rst","api_reference/yafs.core.rst","api_reference/yafs.distribution.rst","api_reference/yafs.metrics.rst","api_reference/yafs.placement.rst","api_reference/yafs.population.rst","api_reference/yafs.selection.rst","api_reference/yafs.stats.rst","api_reference/yafs.topology.rst","api_reference/yafs.utils.rst","architecture/architecture.rst","architecture/index.rst","contents.rst","examples/index.rst","examples/tutorial_example.rst","index.rst","introduction/basic.rst","introduction/glossary.rst","introduction/index.rst","introduction/installation.rst"],objects:{"":{yafs:[2,0,0,"-"]},"yafs.application":{Application:[3,1,1,""],Message:[3,1,1,""]},"yafs.application.Application":{TYPE_MODULE:[3,2,1,""],TYPE_SINK:[3,2,1,""],TYPE_SOURCE:[3,2,1,""],add_service_module:[3,3,1,""],add_service_source:[3,3,1,""],add_source_messages:[3,3,1,""],get_message:[3,3,1,""],get_pure_modules:[3,3,1,""],get_sink_modules:[3,3,1,""],set_modules:[3,3,1,""]},"yafs.core":{Sim:[4,1,1,""]},"yafs.core.Sim":{alloc_DES:[4,2,1,""],alloc_module:[4,2,1,""],alloc_source:[4,2,1,""],deploy_app:[4,3,1,""],deploy_monitor:[4,3,1,""],deploy_sink:[4,3,1,""],deploy_source:[4,3,1,""],entity_metrics:[4,2,1,""],env:[4,2,1,""],get_alloc_entities:[4,3,1,""],last_busy_time:[4,2,1,""],print_debug_assignaments:[4,3,1,""],register_event_entity:[4,3,1,""],run:[4,3,1,""],start_process:[4,3,1,""],stop:[4,2,1,""],stop_process:[4,3,1,""],undeploy_module:[4,3,1,""],unreachabled_links:[4,2,1,""]},"yafs.distribution":{Distribution:[5,1,1,""],deterministicDistribution:[5,1,1,""],deterministicDistributionStartPoint:[5,1,1,""],exponentialDistribution:[5,1,1,""],exponentialDistributionStartPoint:[5,1,1,""],uniformDistribution:[5,1,1,""]},"yafs.metrics":{Metrics:[6,1,1,""]},"yafs.placement":{ClusterPlacement:[7,1,1,""],EdgePlacement:[7,1,1,""],NoPlacementOfModules:[7,1,1,""],Placement:[7,1,1,""]},"yafs.placement.Placement":{get_next_activation:[7,3,1,""],initial_allocation:[7,3,1,""],run:[7,3,1,""]},"yafs.population":{Population:[8,1,1,""],Statical:[8,1,1,""]},"yafs.population.Population":{get_next_activation:[8,3,1,""],initial_allocation:[8,3,1,""],run:[8,3,1,""],set_sink_control:[8,3,1,""],set_src_control:[8,3,1,""]},"yafs.selection":{First_ShortestPath:[9,1,1,""],OneRandomPath:[9,1,1,""],Selection:[9,1,1,""]},"yafs.selection.Selection":{get_path:[9,3,1,""],get_path_from_failure:[9,3,1,""]},"yafs.stats":{Stats:[10,1,1,""]},"yafs.stats.Stats":{average_loop_response:[10,3,1,""],get_df_service_utilization:[10,3,1,""]},"yafs.topology":{Topology:[11,1,1,""]},"yafs.topology.Topology":{LINK_BW:[11,2,1,""],LINK_PR:[11,2,1,""],NODE_IPT:[11,2,1,""],add_node:[11,3,1,""],create_random_topology:[11,3,1,""],create_topology_from_graph:[11,3,1,""],find_IDs:[11,3,1,""],get_edge:[11,3,1,""],get_edges:[11,3,1,""],get_node:[11,3,1,""],get_nodes:[11,3,1,""],get_nodes_att:[11,3,1,""],load:[11,3,1,""],remove_node:[11,3,1,""],size:[11,3,1,""]},yafs:{application:[3,0,0,"-"],core:[4,0,0,"-"],distribution:[5,0,0,"-"],metrics:[6,0,0,"-"],placement:[7,0,0,"-"],population:[8,0,0,"-"],selection:[9,0,0,"-"],stats:[10,0,0,"-"],topology:[11,0,0,"-"],utils:[12,0,0,"-"]}},objnames:{"0":["py","module","Python module"],"1":["py","class","Python class"],"2":["py","attribute","Python attribute"],"3":["py","method","Python method"]},objtypes:{"0":"py:module","1":"py:class","2":"py:attribute","3":"py:method"},terms:{"abstract":[5,18,20],"boolean":4,"byte":[3,19],"case":[17,19],"class":[1,3,4,5,6,7,8,9,10,11,18,19],"default":[3,4],"float":3,"function":[1,3,4,7,8,9,11,12,19],"import":19,"int":[3,4,11],"new":[9,18],"public":[18,19],"return":[3,4,7,8,9,10,11,19],"static":[8,19],"true":4,"var":4,And:8,DES:[4,19],For:19,IPS:[11,19],One:19,QoS:[],That:19,The:[1,2,3,4,17,18,19],There:[4,18],Using:[4,17],abil:19,about:[4,15,18],abov:18,absolut:18,accept:19,access:[18,19],accord:[7,8,17,19],acknowledg:15,acsicuib:18,action:[18,20],activ:[7,8],activation_dist:[7,8],actuat:[3,4,19,20],actuator_dev:19,acycl:19,adapt:[4,18],add:[3,4,11],add_nod:11,add_service_modul:[3,19],add_service_sourc:3,add_source_messag:[3,19],addit:[11,18],admit:11,advanc:19,affect:17,aggreg:19,aka:4,algorithm:[3,4,7,8,9,15,18,21],all:[2,4,9,11,17,18,19],alloc:[7,8,17,18,19,20],alloc_d:[4,9,19],alloc_modul:[4,9,19],alloc_sourc:4,allow:3,along:18,also:[9,19,22],although:19,alwai:18,among:[9,19],analys:[17,22],analysi:18,analyt:18,ani:[4,18,20],anoth:18,api:[15,18,19],aplic:19,app1:19,app:[4,19],app_nam:[3,4,7,8,9,19],appedg:19,append:19,applic:[1,4,7,8,15,18,20,21],applicaiton:[],architectur:[15,18,19],arg:[3,4,7,8,9,11],arrai:[4,9,18,19],arrang:19,arriv:19,articl:18,aspect:[],assign:[4,7,8,11,18],associ:[4,7,8,19],attent:[],attract:19,attribut:[11,19],author:[18,22],avail:[2,19],averag:19,average_loop_respons:10,balear:0,bandwidth:[11,19],base:[8,18],basic:[15,17,18,21],been:17,behaviour:4,believ:18,beloglazov:19,below:20,bestd:19,bestpath:19,between:[3,4,18,19,20],bill:18,bit:19,block:19,both:[0,8,9,19],broadcast:[3,19],broken:9,buffer:19,buyya:19,calcul:9,calheiro:19,call:9,can:[3,4,9,17,18,19,20,22],cancel:18,capabl:[],capac:[],carlo:[0,18],certain:19,chang:[4,7,8,19],channel:[18,19],characterist:[3,18,19],cheapest:7,chequeo:10,cite:15,classic:18,clean:4,client:4,clone:18,close:17,cloud:[4,17,18,19],cloud_dev:19,cloudplac:19,cloudsim:19,cluster:[7,19],clusterplac:7,code:[4,19],com:18,come:3,common:12,commun:[18,22],comp_m:19,compar:[17,18],compat:19,complex:[11,18,19],compon:[1,2],comput:[0,3,18,19,20],concept:[15,18,20,21],configur:18,connect:[18,20],consid:18,consider:18,consist:19,consum:[4,19],contain:[4,18],content:15,contributor:[],control:[3,4,7,8,17,18,19,20],coordin:[4,19],core:[1,3,7,8,15],cost:19,cot:18,cover:18,creat:[3,4,19],create_apl:19,create_appl:19,create_random_topolog:11,create_topology_from_graph:11,creation:[11,19],criteria:7,csv:19,ctime:[9,19],current:4,curv:18,custom:[1,17,18,19],dag:[3,19],dastjerdi:19,data:[3,11,18,19],databas:4,ddf:19,deal:11,debug:4,decid:18,deepen:20,deeper:19,def:19,default_results_path:[4,6],defaultpath:10,defin:[3,4,18,19],definit:[14,19],del:10,delai:11,demo:17,denot:19,depend:[15,18,19,21],deploi:[4,18,19,20],deploy:[4,18,19],deploy_app:[4,19],deploy_modul:19,deploy_monitor:4,deploy_sink:4,deploy_sourc:4,des:19,des_dst:19,descript:[1,18],design:[0,18],destin:[9,11,19],destini:[9,19],detail:[1,17,18,19],deterministicdistribut:[5,19],deterministicdistributionstartpoint:5,develop:18,devic:[18,19,20],dict:[3,4,7,8,11],dictionari:[4,11,19],differ:[4,7,19],direct:19,directli:[],directori:17,discret:[4,18,22],distinct:3,distribut:[1,3,4,7,8,15,17,18,19],doe:19,doi:18,done:19,download:18,driver:8,dst:[3,19],dst_int:3,dst_node:19,dure:[7,8],dynam:[17,18,19],dynamicalloc:17,dynamicfailuresonnod:17,dynamicworkload:17,each:[3,4,8,11,17,19],ecosystem:[7,8,18,19],edg:[4,11,18,19],edgeplac:7,eeg_gam:19,effici:22,egg_gam:4,element:[4,18,19],elemento:19,emerg:[],empti:[3,9],enabl:[18,20],engin:[1,15],enorm:22,entiti:[3,4,9,19,20],entity_metr:4,env:4,environ:[4,18,19],equival:[19,20],estim:18,etc:[18,19],euclidean:17,evalu:19,event:[4,18,19,22],event_typ:4,events_log:4,everi:19,evolut:18,exampl:[11,15,18,19],execut:[3,7,8,19],existencia:10,experi:[17,19],experiment1:17,experiment2:17,explain:[17,18,19],exponentialdistribut:5,exponentialdistributionstartpoint:5,expos:19,extend:[1,8,18],facilit:11,faculti:0,failur:18,fall:[],fals:[3,4,19],far:19,featur:[11,18],feautur:11,few:21,field:20,file:[4,11,19],financi:18,find:[18,19],find_id:[11,19],finish:19,first:[9,17,19],first_shortestpath:9,firstli:19,fix:19,focus:[],fog:[18,19],fogcentr:17,follow:[2,3,9,18,19],format:[17,18,19],fractional_select:19,from:[3,4,9,11,17,18,19],from_d:9,gatewai:[],gather:18,gener:[3,5,8,11,18,19,20],get:19,get_alloc_ent:4,get_df_service_util:10,get_edg:11,get_messag:[3,19],get_next_activ:[7,8],get_nod:11,get_nodes_att:11,get_path:[9,19],get_path_from_failur:9,get_pure_modul:3,get_sink_modul:[3,19],ghosh:19,git:18,github:18,given:[7,8],glossari:[15,21],good:19,graph:[11,19],graphml:17,group:19,guerrero:[0,18],guid:18,gupta:19,hai:10,has:[3,4,18,19,22],have:[7,8,9,11,17,19,22],help:1,hidden:18,highli:18,highlight:18,histori:18,host:19,how:[8,17,18,19],http:18,hub:18,id_clust:19,id_nod:[4,11,19],id_topo:4,id_topolog:19,idd:19,idea:19,identifi:[3,4,9,11,19],idtopo:4,ieee:18,ieeexplor:18,ifogsim:[17,19],illustr:19,implement:[0,7,8,17,18,19,22],impli:9,includ:[18,19],incom:19,index:15,inform:4,infrastructur:18,initi:[7,8],initial_alloc:[7,8,19],input:[3,4],inst:3,instal:[15,21],instanc:3,instant:3,instead:3,instrucct:3,instruct:[3,11,19],integr:18,interact:4,interfac:[7,8,9],interfer:18,intermedi:3,intern:[3,4,19],internatlli:4,internet:[18,19],introduc:5,intuit:[],invok:[4,7,8,19],iot:[18,19],ipt:[3,11,19],isaac:[0,18],island:0,issn:18,its:[3,4,11,19],journal:18,json:[4,11,19],juiz:18,jul:18,just:[21,22],kei:[4,11,18,19],keyword:18,kind:5,know:18,kwarg:[3,4,5,7,8,11],lambd:5,larg:18,last:19,last_busy_tim:4,latenc:[17,19],launch:19,learn:[18,21],length:19,lera:[0,18],let:18,level:18,librari:[18,19,22],licens:18,lightweight:18,like:3,link1:19,link2:19,link:[3,4,9,11,18,19,20],link_bw:11,link_pr:11,link_regist:4,links_log:4,list:[2,3,4,11,19,20],load:[7,11,19],local:[8,19],locat:7,logger:[4,7,8,9,11],look:19,loop:10,low:18,m_a:19,m_b:19,main1:[17,19],main2:17,main3:17,main:[2,4,8,17,18,19,20],mainli:22,manag:[3,18,19,22],mandatori:19,manipul:[],manual:18,max:5,mayb:19,mean:19,memori:19,messag:[3,4,8,9,18,19,20],message_in:3,message_out:3,method:[7,8,19],metric:[1,4,15],millisecond:19,min:5,mineco:18,minimum:17,minimun:19,minimunpath:19,minut:[15,19],mip:3,mit:18,mobil:4,mobile_behaviour:4,mod:[7,8],model:[11,15,18,21],modul:[2,3,4,5,7,8,9,10,17,18,19,20],module_dest:3,module_nam:3,monitor:4,month:18,more:19,most:[17,19],move:19,movement:17,msg:[3,4],multi:19,multipl:19,must:[3,19],mytag:19,name:[3,4,5,7,8,19],name_regist:4,necessari:[4,20],network:[11,15,17,18,20,21],networkx:[11,19,22],next:[7,8,17],next_event_dist:4,next_time_period:19,node:[4,7,8,9,11,17,18,19,20],node_cost:[],node_ipt:11,node_ram:[],node_src:19,node_up:4,nodo:19,non:3,none:[3,4,6,7,8,9,11],noplacementofmodul:7,nosql:[],nsame:3,number:[3,11,18,19],nxgraphgener:11,object:[4,7],objet:19,obligatori:[7,9],obtain:19,occup:[],ofdm:18,offer:18,onc:[7,19],oncloud:19,one:[4,9,11,19],onerandompath:9,onli:[4,7,8,11,18,19,20],option:9,orchestr:[9,18,19],ord:18,order:18,org:18,other:[7,18,19,20],output:3,over:[],overrid:[7,8,9],overview:15,packag:[19,20,22],page:[15,18],panda:22,param:[3,4,7,8,9,11,19],param_distribut:3,paramet:[3,4,7,8,9,11],part:[19,20],path:[3,9,17,19],pend:[],per:[11,19],perform:[2,19],pip:22,placement:[1,4,15,18,20,21],plan:1,pleas:18,point:[9,17,18,19],polici:[18,19],pop:19,popul:[1,3,4,15,17,21],possibl:[9,18,19],practic:19,previou:19,print:[4,19],print_debug_assigna:4,probabl:3,process:[3,4,18,19],progress:[14,16],project:[18,22],propag:[11,19],provid:[1,9,18],provis:19,pure:[3,4,8,19,20,22],purge_regist:4,purpos:4,put:4,pypi:22,python:[18,19,22],quit:18,ram:19,random:[9,17,19],rang:19,ranjan:19,raw:18,reach:[3,9,17],readm:18,real:[18,19],reason:19,receiv:[3,19,20],recib:3,record:[4,19],redi:4,reduc:18,refer:[15,18,19],regard:18,regardless:7,regist:4,register_event_ent:4,registr:19,rel:3,relai:18,relat:[18,20],relationship:4,releas:18,reli:22,remov:[4,11,17],remove_nod:11,rep:19,replica:7,repositori:18,repres:[4,18,19],represent:[19,20],request:[18,19],requir:[7,8,9,18,19],research:18,resort:20,resourc:[18,19],respect:19,respons:[4,10,19],rest:[4,19],result:[10,15,21,22],robin:17,robust:18,rose:19,round:17,rout:[9,17,18],router:[],rule:19,run:[4,7,8,15,21,22],same:[3,4,11,18,19],scale:[17,18,19],scaleservic:19,scenario:[18,19],schedul:17,scienc:0,search:[11,15],second:[17,19],secondli:19,section:[17,19,21],see:[4,17,19],seed:5,seen:9,select:[1,4,15,17,18,19],selector:[4,15,21],selectorpath:19,self:19,send:[3,9,19],sensor:[3,4,8,19,20],sensor_dev:19,sent:19,sequenc:19,serv:19,servic:[4,7,10,18,19],service_nam:4,servicea:19,set:[3,18,19],set_modul:[3,19],set_sink_control:[8,19],set_src_control:[8,19],setup:17,sever:[8,17,18,19],shorter:9,shortest:19,shortest_path:19,should:[1,9],show:17,show_progress_monitor:[4,19],sim:[4,7,8,9,19],similar:[18,19],simpi:[18,22],simpl:[18,19],simplecas:19,simul:[1,2,3,5,7,8,11,15,17,18,21,22],simulation_tim:19,sinc:3,singl:19,sink:[3,4,7,8,19,20],sink_m:19,size:[3,11,19],softwar:[18,19,22],some:[4,9,12,19,22],sophist:17,sourc:[3,4,5,6,7,8,9,10,11,19,20],spain:18,special:20,specif:[10,19],speed:19,src:[3,19],start:[4,5,7,8],start_process:4,stat:[1,15,18,19],statist:19,step:17,stop:4,stop_process:4,storag:19,store:[8,18,19],str:[3,4,7,8,11],stranger:18,string:[4,7],structur:[4,19],subsect:19,sudo:[],support:[18,22],system:18,tabl:2,tag:19,tak:19,take:19,taken:19,target:[3,19],task:19,techniqu:19,tempor:[7,8],temporari:[4,18],term:[15,21],test_initial_deploi:4,than:19,thank:[18,22],thei:19,them:[3,18,19,20],theori:18,thi:[2,3,4,5,7,8,9,11,15,17,19,20,21],thing:[18,19],those:3,three:17,threshold:19,through:[18,19],thu:18,time:[3,4,5,7,8,10,11,17,18,19],time_emit:19,time_in:19,time_loop:10,time_out:19,time_recept:19,time_shift:19,timestamp:[3,18],tin2017:18,tinydb:[],titl:[18,19],tnode:19,todo:[4,13,17],toolkit:19,topic:18,topo:19,topolog:[1,3,4,7,8,9,15,17,18,21,22],topology_json:19,topology_src:[9,19],tprocess:19,traffic:[9,18,19],transfer:3,transmiss:[3,19],transmit:19,travel:3,trequest:19,tupl:[],tuplemap:19,tutori:[15,16,18,19],tutorial1:19,two:[7,8,19,20],type:[4,7,8,19,20,22],type_modul:[3,19],type_sink:[3,19],type_sourc:[3,19],typic:[],typifi:3,unavail:9,undeploy_modul:4,under:18,understand:19,unifi:[4,11],uniformdistribut:5,uniqu:[3,19],unit:[3,19],univers:0,unreachabled_link:4,until:4,usag:18,use:[3,17,18,19,22],used:[3,4,17,19,22],useful:18,user:[4,10,17,18,19],using:[18,19],usual:19,util:[1,4,10,15,19],vahid:19,valu:[3,4,8,11,19],vari:[],variabl:[4,18,19],variou:18,vertic:19,vol:18,volum:18,vrgamefog:17,wai:[],wait:19,want:[19,22],watt:19,well:22,whatev:[5,18,19,22],when:[9,19],where:[4,7,18,19],whether:[],which:[3,19],who:[2,3,4,19,20],whole:18,wholel:[],wireless:18,wish:19,within:[3,4,9,11],work:[0,15,20,22],workload:18,yaf:[0,1,17,18,19],year:18,yet:18,you:[1,17,18,19,21,22],your:[18,19]},titles:["ABOUT","API REFERENCE","<code class=\"docutils literal\"><span class=\"pre\">yafs</span></code>","<code class=\"docutils literal\"><span class=\"pre\">yafs.application</span></code>","<code class=\"docutils literal\"><span class=\"pre\">yafs.core</span></code> \u2014 Simulator engine","<code class=\"docutils literal\"><span class=\"pre\">yafs.distribution</span></code>","<code class=\"docutils literal\"><span class=\"pre\">yafs.metrics</span></code>","<code class=\"docutils literal\"><span class=\"pre\">yafs.placement</span></code>","<code class=\"docutils literal\"><span class=\"pre\">yafs.population</span></code>","<code class=\"docutils literal\"><span class=\"pre\">yafs.selection</span></code>","<code class=\"docutils literal\"><span class=\"pre\">yafs.stats</span></code>","<code class=\"docutils literal\"><span class=\"pre\">yafs.topology</span></code>","<code class=\"docutils literal\"><span class=\"pre\">yafs.utils</span></code>","Architecture","Architecture","Documentation for YAFS","Examples","Tutorial Example","OVERVIEW","Basic Concepts","Glossary of terms","YAFS in 5 Minutes","Installation"],titleterms:{about:0,acknowledg:18,algorithm:19,api:1,applic:[2,3,19],architectur:[13,14],basic:19,cite:18,concept:19,core:[2,4],depend:22,distribut:[2,5],document:[15,18],engin:4,exampl:[16,17],glossari:20,indic:15,instal:[18,22],metric:[2,6],minut:21,model:19,network:19,overview:18,placement:[2,7,19],popul:[2,8,19],refer:1,result:19,run:19,select:[2,9],selector:19,simul:[4,19],stat:10,tabl:15,term:20,thi:18,topolog:[2,11,19],tutori:17,util:12,work:18,yaf:[2,3,4,5,6,7,8,9,10,11,12,15,21,22]}})
\ No newline at end of file
diff --git a/docs/index.rst b/docs/index.rst
index f7dd2280..d0bcf82f 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -5,7 +5,6 @@
 
         Yet Another Fog Simulator for Python
 
-        `PyPI <https://pypi.python.org/pypi/yafs>`_
 
 .. only:: html
 
@@ -69,14 +68,28 @@ Please, consider including this reference in your works or publications:
 
 .. code-block:: python
 
-    PENDING
+    Isaac Lera, Carlos Guerrero, Carlos Juiz. YAFS: A simulator for IoT scenarios in fog computing. IEEE Access. Vol. 7(1), pages 91745-91758,
+    10.1109/ACCESS.2019.2927895, Jul 10 2019.
 
-.. code-block:: python
+    https://ieeexplore.ieee.org/document/8758823
+
+    @ARTICLE{8758823,
+    author={I. {Lera} and C. {Guerrero} and C. {Juiz}},
+    journal={IEEE Access},
+    title={YAFS: A Simulator for IoT Scenarios in Fog Computing},
+    year={2019},
+    volume={7},
+    number={},
+    pages={91745-91758},
+    keywords={Relays;Large scale integration;Wireless communication;OFDM;Interference cancellation;Channel estimation;Real-time systems;Complex networks;fog computing;Internet of Things;simulator},
+    doi={10.1109/ACCESS.2019.2927895},
+    ISSN={2169-3536},
+    month={},
 
-    PENDING
 
 Please let it knows us if you use this project in your research. We will cite them. Thank you
 
+You can find other related works developed with YAFS in the readme of YAFS git hub repository.
 
 ===========
 Acknowledge