Merge branch 'main' of github.com:eneller/hr-hci

doc/.gitignore

@@ -372,3 +372,4 @@ TSWLatexianTemp*
 bib
 # Sweave-specific
 *.tex
+*-SAVE-ERROR

doc/.latexmkrc

@@ -0,0 +1,29 @@
+@default_files = ('report.Rnw');
+$latex = 'latex  %O  --shell-escape %S';
+$pdflatex = 'pdflatex --shell-escape %S -synctex=1 %O %S';
+$pdf_mode = 1;
+$clean_ext = 'lol nav snm loa bbl* glo ist tex aux bbl blg log out toc Rnw.tex %R-concordance.tex %R.tex';
+$bibtex_use = 2;
+
+# only enable when compiling .Rnw or .Rtex file
+if(grep(/\.(rnw|rtex)$/i, @ARGV)) {
+    $latex = 'internal knitrlatex ' . $latex;
+    $pdflatex = 'internal knitrlatex ' . $pdflatex;
+    my $knitr_compiled = {};
+    sub knitrlatex {
+        for (@_) {
+            next unless -e $_;
+            my $input = $_;
+            next unless $_ =~ s/\.(rnw|rtex)$/.tex/i;
+            my $tex = $_;
+            my $checksum = (fdb_get($input))[-1];
+            if (!$knitr_compiled{$input} || $knitr_compiled{$input} ne $checksum) {
+                my $ret = system("Rscript -e \"knitr::knit('$input')\"");
+                if($ret) { return $ret; }
+                rdb_ensure_file($rule, $tex);
+                $knitr_compiled{$input} = $checksum;
+            }
+        }
+        return system(@_);
+    }
+}

doc/report.Rnw

@@ -3,6 +3,18 @@
 \usepackage{graphicx}   % for including figures
 \usepackage{booktabs}   % for nicer tables
 \usepackage{float}
+\usepackage[utf8x]{inputenc}
+\usepackage[margin=1in]{geometry} % Adjust margins
+\usepackage{caption}
+\usepackage{hyperref}
+\PassOptionsToPackage{hyphens}{url} % allow breaking urls
+\usepackage{float}
+\usepackage{wrapfig}
+\usepackage{subcaption}
+\usepackage{parskip}
+
+\usepackage[style=ieee, backend=biber, maxnames=1, minnames=1]{biblatex}
+\addbibresource{report.bib}
 
 \begin{document}
 
@@ -48,12 +60,32 @@ This design allowed us to investigate both established and novel layouts, compar
 
 
 \section{Experiment}\label{experiment}
+<<echo=FALSE, message=FALSE>>=
+# load libraries here
+library(knitr)
+library(dplyr)
+library(tidyr)
 
+# Read the results CSV
+results <- read.csv("../data/results.csv", sep=",", header=TRUE)
+@
 \subsection{Participants}\label{participants}
+Our experiment was conducted using a small sample of 12 participants.
+All of our participants, predominantly male with an average age of \Sexpr{round(mean(results$age),digits=1)}
+were then presented all of our 3 keyboards.
 
 \subsection{Apparatus}\label{apparatus}
+The main body of our experimental apparatus was our On-Screen Keyboard, implemented using Tauri + Angular.
+Text-entry measures were collected using TextTest \cite{texttest}.
 
 \subsection{Procedure}\label{procedure}
+Each participant was first provided with an overview of the three keyboard models and design rationale 
+They were then presented all three layouts in a counterbalanced order to mitigate common order effects
+such as practice, fatigue and boredom.
+Each keyboard was evaluated using only lowercase letters, space and enter to display the next sentence.
+Due to our chosen time constraint of 30 minutes, each participant was given three practice sentences per keyboard,
+followed by 10 recorded sentences for the experiment.
+After completion of all 3 layouts, the participants were then asked to fill out the NASA Task Load Index \cite{nasatlx}.
 
 \section{Results}\label{results}
 
@@ -71,12 +103,6 @@ Objective typing performance was assessed using words per minute (WPM) and total
 In contrast, accuracy differences between layouts were relatively small. Mean TER values were low across all conditions, with QWERTY showing a slightly higher average error rate (0.036) than DVORAK (0.0298) and CIRCLE (0.0265). Overall, the objective results suggest that layout differences were most pronounced for speed rather than error performance.
 
 <<echo=FALSE, message=FALSE>>=
-library(knitr)
-library(dplyr)
-library(tidyr)
-
-# Read the results CSV
-results <- read.csv("../data/results.csv", sep=",", header=TRUE)
 
 ter_stats <- results %>%
   summarise(
@@ -408,4 +434,5 @@ kable(
 \end{table}
 \section{Discussion}\label{discussion}
 
+\printbibliography
 \end{document}

doc/report.bib

@@ -0,0 +1,20 @@
+@article{texttest,
+  title={Analyzing the input stream for character-level errors in unconstrained text entry evaluations},
+  author={Wobbrock, Jacob O and Myers, Brad A},
+  journal={ACM Transactions on Computer-Human Interaction (TOCHI)},
+  volume={13},
+  number={4},
+  pages={458--489},
+  year={2006},
+  publisher={ACM New York, NY, USA},
+  url={https://depts.washington.edu/acelab/proj/texttest/},
+}
+@incollection{nasatlx,
+  title={Development of NASA-TLX (Task Load Index): Results of empirical and theoretical research},
+  author={Hart, Sandra G and Staveland, Lowell E},
+  booktitle={Advances in psychology},
+  volume={52},
+  pages={139--183},
+  year={1988},
+  publisher={Elsevier}
+}