Differences

This shows you the differences between two versions of the page.

--- uf:guanotes [2008/09/26 13:23] – elisag
+++ uf:guanotes [2009/11/18 15:12] (current) – elisag
@@ Line 5: / Line 5: @@
 Guanotes application allows flockrs to post notes, called guanotes, to the ambient ( i.e any device available in the surroundings ranging from other flockr device to devices installed on public places such as KK). This is a concept similar to Stickies application in Mac but guanotes can hop from one device to another.
-Flockrs can thus discover other flockrs guanotes, store them and exchange them later with other flockrs such that guanotes can be percolated through the entire Urbiflock.
+Flockrs can thus discover other flockrs guanotes, store them and exchange them later with other flockrs such that guanotes can be 'percolated' through the entire Urbiflock. Percolation of guanotes allows flockrs to receive guanotes offline without relying on infrastructure. In other words, sender and receiver of guanotes do not have to be necessary online to receive a guanote.
-Flockrs can also subscribe to a particular type of guanotes such that they are automatically notified whenever they meet a flockr carrying guanotes of that particular type.
+Flockrs can also subscribe to a particular type of guanotes such that they are automatically notified whenever they meet a flockr carrying guanotes of that particular type. Currently, flockrs can subscribe to receive guanotes sent to a particular flock. This functionality is reminiscent to the subscription to a mailing list.
 Another idea is that flockrs can stop the percolation of guanotes. For example, if a flockr detects that a spam guanote or a guanote with unapropiate content, it could stop its propagation.
+==== What is a guanote?  ====
-==== Design ====
+A guanote consists of a message and a receiver list (a flock or individual flockrs). Guanotes keeps track of the connected flockrs which are running the application. Guanotes applications communicate with each other (by means of the [[:uf:totam|TOTAM]] middleware) to interchange the guanotes they carry. A guanote is propagated to another device only if a flockr belongs to the receiver list. A guanote is thus propagated through the network hopping from device to device in order to ensure that it gets received by all the targeted flockrs.
+In order to avoid flooding the network, [[:uf:totam|TOTAM]] ensures that only flockrs belonging to the receiver list are used as //routers// (so that only potential targeted flockrs carry guanotes).
-To implement Guanotes, we are going to reuse the concepts developed by  [[http://citeseerx.ist.psu.edu/viewdoc/summary?doi=10.1.1.19.9742|TOTA]] in combination with the RETE engine we built for the proximities.
-From TOTA, the interface for a [[Guanote]] may look like:
+A guanote can be sent to a flock or an explicit collection of flockrs. In the later case end users can enumerate the targeted flockrs in the receiver list or take a snapshot of a flock. It is important to note that if the receiver is a flock, the guanote dynamically recomputes the flock definition at every device to which it gets propagated to determine the targeted flockrs. If the receiver is the snapshot of a flock, the guanote directly contains the list of targeted flockrs.
-<code>
+==== Usage Scenario ====
-def decidePropagation() -> boolean
-def doAction ();
-def changeTupleContent() -> tuple
-def decideStore () -> boolean
-</code>
-and the interface for the application itself:
+{{:uf:guanotes_scenario.png?475x300|:uf:guanotes_scenario.png}}
-<code>
+The above figure illustrates the propagation of a guanote in a campus-based scenario. It shows six flockrs connected in Urbiflock and running the Guanotes application. The communication range of their devices is depicted with a dotted line while the colored dot on their devices denotes the gender of the flockr (pink for girls, blue for males, and grey if the gender is not set in the flockr's profile). In particular, the figure shows how a "hallo" guanote is sent by Elisa to the //nearbyMaleFlock// (defined as all nearby male flockrs). This guanote is transitively propagated until all connected flockrs belonging to the nearbyMaleFlock are reached. The guanote is not propagated to flockrs that do not adhere to the definition of nearbyMaleFlock. The guanote is first propagated to Stijn and then to Wolf. Elisa's device is in communication range of two devices (corresponding to a female flockr and Stijn), but since the guanote is only meant for male nearby flockrs, it is only propagated to Stijn. Similarly, Stijn's device is nearby to Elisa, Wolf and a female flockr, but it only propagates the guanote to Wolf. It is important to note that Wolf receives the "hallo" guanote without being in direct communication range of Elisa's device.
-def subscribe (Tuple template, String reaction)
-  -> subscription object where you can unsubscribe
-</code>