Add copyright, and license files.

[loba.git] / NOTES

diff --git a/NOTES b/NOTES
index 079372baac3ce02e80d468461d9dfddf9fcafaec..71e27296cc07fbd0dd958b5b016b92b4f8ea620e 100644 (file)
--- a/NOTES
+++ b/NOTES
@@ -12,11 +12,11 @@ messages, and data for load transfers.
 Process model
 =============
 
 Process model
 =============
 

-Each process is made of 3 threads: a receiver thread, a computing
-thread, and a load-balancer thread.
+Each process is made of 3 threads: a receiving thread, a computing
+thread, and a load-balancing thread.

 
 

-* Receiver thread
-  ---------------
+* Receiving thread
+  ----------------

 
     Loop
     | wait for a message to come, either on data channel, or on ctrl channel
 
     Loop
     | wait for a message to come, either on data channel, or on ctrl channel


@@ -35,6 +35,7 @@ thread, and a load-balancer thread.
     | if we received some real load, get it (data messages)
     | if there is some real load to send, send it
     | if we own some load, simulate some computing on it
     | if we received some real load, get it (data messages)
     | if there is some real load to send, send it
     | if we own some load, simulate some computing on it

+    | sleep a bit if we are looping too fast

     +-
     send CLOSE on data for all neighbors
     wait for CLOSE on data from all neighbors
     +-
     send CLOSE on data for all neighbors
     wait for CLOSE on data from all neighbors


@@ -46,9 +47,10 @@ thread, and a load-balancer thread.
   ---------------------
 
     Loop
   ---------------------
 
     Loop

+    | receive ctrl messages

     | call load-balancing algorithm
     | send ctrl messages
     | call load-balancing algorithm
     | send ctrl messages

-    | receive ctrl messages
+    | sleep (min_lb_iter_duration)

     +-
     send CLOSE on ctrl for all neighbors
     wait for CLOSE on ctrl from all neighbors
     +-
     send CLOSE on ctrl for all neighbors
     wait for CLOSE on ctrl from all neighbors


@@ -56,10 +58,20 @@ thread, and a load-balancer thread.
   The loop terminates when process::still_running() returns false.
   (read the source for full details...)
 
   The loop terminates when process::still_running() returns false.
   (read the source for full details...)
 

-Open questions
-==============
- * definition of load on heterogeneous hosts?
- * how to detect convergence?
-   : No need to detect convergence.  Computation stops when there
-     nothing more to do.
- * how to manage link failures?
+Some notes about *load attributes
+=================================
+process::real_load              Current *real* load.
+                                Used for the computations.
+                                Displayed in log messages.
+
+process::expected_load          Current load estimation.
+                                Used for load-balancing estimation, and for
+                                diffusing to neighbors.
+                                * Without bookkeeping, it equals real_load
+                                  minus pending sends.
+                                * With bookkeeping, it corresponds to the
+                                  "virtual load".
+
+process::received_load          Real load received from neighbors.
+                                Used when receiveing data messages, and then
+                                added to real_load.