update report content

1 files changed, 46 insertions, 21 deletions

diff --git a/report.qmd b/report.qmd
index 5c2b1f5..e782876 100644
--- a/report.qmd
+++ b/report.qmd
@@ -36,6 +36,15 @@ OUR THREE REQUIRED COMPONENTS,and a conclusion*
 
 ## Copyright and licensing
 
+*FIXME: this section cannot be a subsection of Abstract:
+Abstract must be a standalone section
+(which comes before table of contents,
+which will happen automatically
+when we drop "Menna" from the title)*
+
+*TODO: suggested alternative location for above section:
+last subsection of section "Project Planning and theoretical framework"*
+
 To encourage collaboration and stimulate a circular gift economy
 as introduced by @Mikkelsen2000,
 this project is copyleft licensed:
@@ -60,7 +69,6 @@ We have defined a research question to work around:
 **How do we simulate and visualise an existing biomonitoring technology
 for its core purpose**
 
-
 Our simulation is inspired by SYMBIO --
 a biomonitoring system --
 developed by the company PROTE
@@ -91,7 +99,6 @@ An alarm will then be triggered
 and further laboratory tests are done
 [@Nazaruk2016].
 
-
 To meet this question,
 we will be using touch and light sensors
 to represent our virtual models on Arduino --
@@ -120,7 +127,6 @@ Concurrently, we learned about the roles
 artefacts can play in the research process,
 and used that framework to help define the aim of our project.
 
-
 The following framework, as introduced in @Wensveen2014,
 explains how prototypes can serve different purposes
 depending on the type of knowledge a project aims to produce.
@@ -135,26 +141,36 @@ in both a physical and abstract sense
 
 Next we each did early prototyping and pseudocoding
 for about three weeks.
-During this phase, we worked on the sensor setups and on the logic behind the voting mechanism
+During this phase, we worked on the sensor setups
+and on the logic behind the voting mechanism
 and the possible communication-methods between them.
 
-Our project group has received a brief introduction to API's during a lecture session,
-and through additinoal notes on the topic, that are available on the lecture slides for week 5.
-From these notes, we learned that API works as a standardized *messenger*, that allows different software applications to communicate through defined rules and protocols. API enables seamless integration between the systems.
-
-
-We decided to use a combination of bluetooth and API, to
-connect the sensor-data to the voting program.The bluetooth handles the connection between the sensors and our computer/phone, whilst the API is being used to send/retrieve data and trigger an output.
-A further explanation of this process,
+Our project group has received a brief introduction to APIs
+during a lecture session,
+and through additional notes on the topic,
+that are available on the lecture slides for week 5.
+From these notes, we learned
+that API works as a standardized "messenger",
+that allows different software applications to communicate
+through defined rules and protocols.
+API enables seamless integration between the systems.
+
+We decided to use a combination of bluetooth and API,
+to connect the sensor-data to the voting program.
+Bluetooth handles the connection
+between the sensors and our computer/phone,
+whilst the API is being used to send/retrieve data
+and trigger an output.
+A further explanation of this process
 will be displayed in @sec-user-guide.
 
 ## Detecting stressful mussel behavior
 
-We wish to expound some of the ways that freshwater mussels behave
-and how the detection works,
+We wish to expound some of the ways
+that freshwater mussels behave and how the detection works,
 in real-life implementation.
-The thresholds and logic for our sensors and voting-mechanism,
-is mostly based upon the following.
+The thresholds and logic for our sensors and voting-mechanism
+are mostly based upon the following.
 
 The use of a mussel as biodetector requires distinction
 between slow-paced valve gaping change (normal),
@@ -231,14 +247,19 @@ 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.
+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's the program that is interesting in this section*
 
 *TODO: here we need to introduce the source we know this from,
 and to give a little insight
-in why there's different roles to choose from*
+into why there's different roles to choose from*
 
 *TODO*
 
@@ -304,15 +325,19 @@ Although, we have reflected upon how AI could be useful
 in an expansion of our prototype
 or hypothetically in an existing system.
 For an instance, in the future --
-when scientists have analysed and interpreted enough data to feed to a MLM --
+when scientists have analysed and interpreted enough data
+to feed to a MLM --
 ai could be used for detecting subtle behavioral changes,
 that humans would otherwise miss,
 or spot patterns that further indicates pollution
 or predicts contamination or enviromental stress.
 
+*FIXME: the abbreviations AI and MLM must be introduced before used,
+and then used consistently (e.g. all caps or no caps)*
+
 It could also be put into perspective of surrounding cases,
 and through datacentric AI,
-it could be visualised like a weatherforecast on a dashboard.
+it could be visualized like a weatherforecast on a dashboard.
 It could be based on patterns
 like "When x conditions rise, contamination tends to follow."
 
@@ -321,7 +346,7 @@ like "When x conditions rise, contamination tends to follow."
 This hypothesis would come at the cost of a lot of x,
 which would be a research question in itself.
 
-*TODO: in above paragraph, "x" should say something
+*FIXME: in above paragraph, "x" should say something
 about consuming a lot of space and resources*
 
 # Conclusion - menna