update report content

1 files changed, 28 insertions, 25 deletions

diff --git a/report.qmd b/report.qmd
index 7f9b5a7..7123ff1 100644
--- a/report.qmd
+++ b/report.qmd
@@ -186,7 +186,7 @@ of about 1 second
 [@FerreiraRodriguez2023 fig. 2].
 
 One concrete approach used in @Robson2009 and @Robson2010
-is to collect data at a sample rate of 0.5 seconds, i.e. 2 hZ,
+is to collect data at a sample rate of 0.5 seconds, i.e. 2 Hz,
 and convert that into gape angle per second (CHIGA)
 to then monitor gape movement instead of gape position.
 
@@ -240,41 +240,44 @@ P5.js: Used to indicate
 
 # Coding approach - Tanishka
 
-In this paragraph we want to highligt t
-
-*FIXME: above paragraph is unfinished*
-
-The goal of the system is to replicate
-the behavioral response of mussels under stress,
-and translate that into a form of output.
+The coding approach for this project is centered
+around simulating behavioral response of mussels
+under stress, using sensors
+and translate these responses into votes that indicate water quality.
 Real-world use of mussels as biosensors relies
 on monitoring their behavior to detect environmental stress.
 In our project, we simulate this behavior using programmable hardware.
 
-The system is composed of two major components,
-the sensor ... the mussels behavior
-and the vote handling system that collects readings
-from all mussel instances, evaluates their state
-and triggers output.
-
-*FIXME: in above paragraph, some text is missing at the ellipsis (...).
-
-*TODO: not sure this text passage belongs here,
-as it is the program that is interesting in this section*
+The system is composed of three major components:
+
+* p5.js Interface --
+  Simulating environmental changes like day and night.
+  Allows the user to control the light conditions using a button.
+* Sensor (Arduino) --
+  Each sensor simulates a mussel.
+  It reads light and touch input,
+  changes internal "stress" levels accordingly,
+  and outputs a "gape angle" via BLE
+  using the Eddystone TLM protocol.
+* Voting System (Arduino) --
+  This unit scans BLE beacons sent by sensor mussels.
+  Each beacon includes a simulated gape angle.
+  The latest measurements per mussel are stored and evaluated,
+  if the data is recent and valid.
+  It determines whether the water is drinkable using a voting rule.
 
 *TODO: here we need to introduce the source we know this from,
 and to give a little insight
 into why there is different roles to choose from*
 
-*TODO*
-
 ```{.plantuml}
 !include components.puml
 ```
 
 *TODO: if the plantUML is here,
 we should have a text section that explains it also,
-and show snippets of our most important/difficult code for each-ish file.*
+and show snippets
+of our most important/difficult code for each-ish file.*
 
 The p5.js code shows a button
 where, when you press it, it changes from day to night.
@@ -347,10 +350,10 @@ The concrete output, however,
 do not reasonably reflect the logic of the Polish systems,
 because the mussel simulation is too simplistic in that
 a) mussel gape rhythm is simulated as simple linear movements
-rather than the steep S-shaped movements of real mussels,
-and consequently that b) voting is based on "is gape closed"
-rather than the -- with more realistic rhythm -- more telling
-"what is the CHIGA pattern",
+whereas real mussel gape rhythm is closer to a sigmoid curve,
+and consequently b) voting is based on "is gape closed"
+rather than the more telling "what is the CHIGA pattern"
+requiring a more realistic rhythm,
 leading to our setup concluding "bad water quality" fairly randomly.
 That said, the code is structured so that it should only require
 minimal changes to change the evaluation logic