wörk(review)

ThesTeX/TODO

@@ -1,20 +0,0 @@
-einleitung:
-	* biodiv2go: zu speziell => nach 2 verschieben "orientierung an… , aber flexibel"
-2:
-	* #teacher: 1 game
-	* #research: \inf games
-3
-	* #adimistrative doppeldeutig
-4:
-	* (modularität herausarbeiten, stream/pipelining)
-5:
-	* webui
-		+ screenshot
-		+ ergebnis
-			+ activitymapper 
-7:
-	* keypoints
-		* modular
-		* api / unabhängig
-		* activitymapper:
-			* track + bilder parallel

ThesTeX/content/0-introduction.tex

@@ -1,6 +1,9 @@
-
-\section{Location based Games: Put the 'fun' in education}
 In this thesis, a framework for the analysis of spatial game data is developed.
+This game data is collected during the game sessions and stored in log files.
+The following chapters describe the basics of the development process.
+
+\section{Location based Games: Put the `fun' in education}
+
 Spatial games, also known as location based games, are at the intersection of GIS and gaming technology \cite{Ahlqvist2018}.
 With game actions tied to real-world spatial places, this genre breaks the magic circle of games: they are embedded into the environment and the boundary between game and non-game are vanishing \cite{montola2009games}.
 As they feature locomotion as an essential game part, a focus on certain aspects of the environment can be achieved by game related tasks.
@@ -15,22 +18,5 @@ With a fine tuned setup of educational content, game elements and integration of
 \autoref{img:gg2} shows the map overview of such a game: FindeVielfalt Simulation\furl{https://biodivlb.jimdo.com/english-1/project-finde-vielfalt/finde-vielfalt-simulation/}\!.
 Located in an orchard, the blue dots are caches tied to game actions.
 To proceed in the games narrative story, the caches are to be completed.
-The players have to complete a task with context of the caches' location.
+The players have to complete a task within the context of the caches' location.
 \image{.5\textwidth}{../../PresTeX/images/gg2}{Geogame map view}{img:gg2}
-
-\section{Research with location based games}\label{sec:gg-res}
-Usually, when the effectiveness of location based educational games is to be measured, the following pattern is applied:
-
-After a mission statement has been defined and approved, a fitting statistical framework has to be developed.
-Based on such a framework, questionnaires have to be derived.
-As some metrics cannot be retrieved directly from the questionnaires answers, the statistical framework needs to considers these and consider measurable information to derive the original metric from.
-The finished and for alignment with the mission statement approved questionnaires are then applied at field test with users from the target groups.
-Each field test consists of an upstream questionnaire, a pass of the location based game and a final round of questionnaires.
-After an data entry step for paper-based questionnaires, the raw results are fed into the statistical framework implemented in a statistical processing software to retrieve the final results.
-
-\cite{Schaal2017} describes this development in the context of the BioDiv2Go project.
-\autoref{img:biodiv-schaal} shows the resulting statistical framework for the valuing of biodiversity as target variable of the location based geogame developed in the BioDiv2Go project.
-
-
-\image{\textwidth}{../../PresTeX/images/biodiv-schaal}{Statistical framework for BioDiv2Go\cite{Schaal2017}}{img:biodiv-schaal}
-

ThesTeX/content/2.1-text.tex

@@ -1,7 +1,25 @@
-\autoref{sec:logproctheo} shows the current state of tools and processes for managing large volumes of log and time series data.
+In \autoref{sec:gg-res} example the involvement of location based games in the research field is reviewed. 
+Covering the basic data aggregation, \autoref{sec:logproctheo} shows the current state of tools and processes for managing large volumes of log and time series data.
 An overview of the field of pedestrian track analysis is located in \autoref{sec:pedest}.
 Finally, in \autoref{sec:gametheo} the connection of spatial analysis and digital game optimizations is showcased.
 
+\section{Research with location based games}\label{sec:gg-res}
+\cite{Schaal2017} describes the evaluation of a location based game.
+To measure the effectiveness of the game, the following pattern is applied:
+
+After a mission statement has been defined and approved, a fitting statistical framework has to be developed.
+Based on such a framework, questionnaires have to be derived.
+As some metrics cannot be retrieved directly from the questionnaires answers, the statistical framework needs to considers these and consider measurable information to derive the original metric from.
+The finished and for alignment with the mission statement approved questionnaires are then applied at field test with users from the target groups.
+Each field test consists of an upstream questionnaire, a pass of the location based game and a final round of questionnaires.
+After an data entry step for paper-based questionnaires, the raw results are fed into the statistical framework implemented in a statistical processing software to retrieve the final results.
+
+\autoref{img:biodiv-schaal} shows the resulting statistical framework for the valuing of biodiversity as target variable of the location based geogame developed in the BioDiv2Go project.
+
+
+\image{\textwidth}{../../PresTeX/images/biodiv-schaal}{Statistical framework for BioDiv2Go\cite{Schaal2017}}{img:biodiv-schaal}
+
+
 \section{Log processing}\label{sec:logproctheo}
 System administrators and developers face a daily surge of log files from applications, systems, and servers.
 For knowledge extraction, a wide range of tools is in constant development for such environments.

ThesTeX/content/3-solution.tex

@@ -58,13 +58,13 @@ While the development of a custom stack requires a lot of infrastructural work t
 With the requirements from \autoref{sec:require} and the learnings from log processing evaluations in mind, a modular processing pipeline depicted in \autoref{img:flowchart} allows for a configurable solution.
 It comprises the stages of input, analysis and rendering.
 With interfaces defined between the stages, this approach allows the exchange of single modules without affecting the remaining pipeline.
-\image{\textwidth}{flowchart.pdf}{Modular processing pipeline}{img:flowchart}
+\image{.75\textwidth}{flowchart.pdf}{Modular processing pipeline}{img:flowchart}
 
 \subsection{Overview}
 An architectural approach surrounding the processing pipeline is visualized in \autoref{img:solution}.
 It outlines three main components of the project: Two user facing services (Web \& CLI / API), and an analysis framework.
 The interfaces (Web and CLI/API) for both target groups (see \autoref{sec:require}) are completely dependent on the analysis framework at the core.
-\image{\textwidth}{solution.pdf}{Architecture approach}{img:solution}
+\image{.75\textwidth}{solution.pdf}{Architecture approach}{img:solution}
 
 The following sections describe each of those components.
 \subsection{Analysis Framework}

ThesTeX/content/4-implementation.tex

@@ -125,7 +125,7 @@ Therefore, an additional log providing server was created to allow access to the
 
 Clients can have arbitrary amounts of options, as all fields in the JSON settings file are passed through (see \autoref{img:oebkml}, section "source").
 
-\subsection{Web Interface}\label{sec:web}
+\subsection{Web Interface for prepared results}\label{sec:web}
 The selector package holds a Flask\furl{http://flask.pocoo.org/} app for an web interface for non-expert users.
 It utilizes the provided clients (see \autoref{sec:source}) for authentication, and gives users the following options:
 \begin{itemize}
@@ -155,6 +155,13 @@ The link \emph{create new analysis} leads to the configuration menu for new anal
 It lists the game logs available for the logged in user, and offers a selection of the predefined analysis configurations.
 With a given name, it is easy to identify the results for each analysis run in the result overview page.
 
+\subsection{Result interface}
+Accompanying the Web interface above is the result interface.
+Here, results of the analysis runs issued in the Web interface are displayed to the users.
+\autoref{img:trackfi} shows a result by example: The combination of spatial positions of players and the screen activity.
+
+\image{\textwidth}{../../PresTeX/images/track-fi}{ActivityMapper: Combined screen activity and spatial progress}{img:trackfi}
+
 \subsection{Task definition}\label{sec:tasks} in the \texttt{package} provides tasks available for execution.
 This package is the interface for celery\furl{http://www.celeryproject.org/} workers and issuers.
 The key point is the task \texttt{analyze} to start new analysis runs.
@@ -250,4 +257,4 @@ The advantage of docker-compose is the definition of all images, volumes and net
 When a scenario with high load occurs, this definition allows for simple scaling.
 To create more celery worker nodes, issuing the command \textit{docker-compose scale worker=8} suffices to create 8 worker containers running in parallel.
 
-\image{\textwidth}{architecture.pdf}{Service composition overview}{img:arch}
+\image{.75\textwidth}{architecture.pdf}{Service composition overview}{img:arch}

ThesTeX/content/6-discussion.tex

@@ -1,9 +1,18 @@
 \section{Review}
 As shown in \autoref{sec:eval}, the proposed framework (see \autoref{sec:solution}) and its implementation (see \autoref{sec:implementation}) deliver what \autoref{sec:scope} asked for regarding the portability aspect.
-With the web interface depicted in \autoref{app:webif}, it is possible for non-expert users to generate pre-defined reports, while researchers can dive into the API of the framework either as preprocessing step or integrated into a larger project.
+
+\subsection{Modular framework}
 Given the lean framework core, the development of new analyzers and rendering target is encouraged.
 This is backed by the focus on a standalone application instead of extensions to log processing systems struggling with spatial data in the required resolution.
 
+As experienced in \autoref{sec:eval}, a change in the import stage of the processing pipeline is completely unnoticed in the other parts.
+The same is true for the addition or modification of analyzering or rendering functionality.
+
+\subsection{Web UI}
+With the web interface depicted in \autoref{app:webif}, it is possible for non-expert users to generate pre-defined reports, while researchers can dive into the API of the framework either as preprocessing step or integrated into a larger project.
+
+The web ui also gives direct access to the results for the non-expert users.
+
 \subsection{Results}
 Th selection of rendered results in \autoref{img:oebkml}, \ref{img:oebge}, \ref{img:retries}, \ref{img:trackfi}, \ref{img:time} showcases the already possible descriptive analysis capabilities.
 \autoref{img:trackfi} features a map view accessible through a browser, which aligns the active screen content of the mobile device with the spatial track.

ThesTeX/content/appendix.tex

@@ -5,7 +5,6 @@
 \image{\textwidth}{../../PresTeX/images/oeb-ge}{Result visualized}{img:oebge}
 \image{\textwidth}{../../PresTeX/images/simu-retries}{Experimentational rounds}{img:retries}
 
-\image{\textwidth}{../../PresTeX/images/track-fi}{ActivityMapper: Combined screen activity and spatial progress}{img:trackfi}
 \image{\textwidth}{../../PresTeX/images/speed}{Aggregated speed distribution of four game fields}{img:speed}
 \image{\textwidth}{../../PresTeX/images/time-rel}{Time distribution of game sessions overview of four game fields}{img:time}
 

ThesTeX/content/outline.tex

@@ -16,5 +16,5 @@
 \chapter{Portability evaluation of the analysis framework}\label{sec:eval}
 \input{content/5-evaluation}
 
-\chapter{Discussion and outlook}
+\chapter{A modular framework: Discussion and outlook}
 \input{content/6-discussion}

ThesTeX/thesis.tex

@@ -104,9 +104,9 @@
 % Stichwortverzeichnis soll im Inhaltsverzeichnis auftauchen
 % Sprungmarke mit Phantomsection korrigiert
 \phantomsection%
-\addcontentsline{toc}{chapter}{Index}%
+%\addcontentsline{toc}{chapter}{Index}%
 % Stichwortverzeichnis endgueltig anzeigen
-\printindex%
+%\printindex%
 
 
 \appendix