Merge branch 'master' of ssh://git.breab.org:2222/kai/bachlorarbeit

Ausarbeitung/chapter1.tex

 \chapter{Einleitung}
 \label{chaper:introduction}
 
-In diesem Kapitel wird zunächst der Multi-Display-Arbeitsplatz zur Bildauswertung und deren Komponenten vorgestellt.
+In diesem Kapitel werden zunächst der Multi-Display-Arbeitsplatz zur Bildauswertung und dessen Komponenten vorgestellt.
 Im Kapitel \ref{chapter:design} wird das Design der neuen interaktiven Features dargestellt.
-Insbesondere wird in dieser Ausarbeitung das Laden und Speichern von Auswertungsergebnissen aus einem Coalition Shared Data Server behandelt.
+Insbesondere wird das Laden und Speichern von Auswertungsergebnissen aus einem Coalition Shared Data Server behandelt.
 Kapitel \ref{chapter:implemetation} befasst sich mit der Implementation der einzelnen Komponenten.
 Schließlich wird in Kapitel \ref{chapter:testing} die Code-Qualität betrachtet und in Kapitel \ref{chapter:conclusion} ein Ausblick gegeben, welche Features in Zukunft die interaktive Nutzung von Aufklärungsergebnissen am Bildauswerteplatz der Zukunft verbessern können.
 
 \section{Bildauswerteplatz der Zukunft}
-Der Bildauswerteplatz der Zukunft ist ein Arbeitsplatz, der einen Bildauswerter in seiner Arbeit optimal unterstützen soll.
+Der Bildauswerteplatz der Zukunft ist ein Arbeitsplatz, der einen Bildauswerter bei seiner Arbeit optimal unterstützen soll.
 Es sollen alle erforderlichen Werkzeuge für die Bildauswertung zur Verfügung stehen.
 Der Bildauswerteplatz ist mit vier 1080p Bildschirmen ausgestattet (siehe Bild \ref{figure:Auswerteplatz}).
-Der mittlere obere Bildschirm ist ein 3D Bildschirm und kann verwendet werden, um unter anderm  stereoskopische Luftbildaufnahmen anzuzeigen.
+Der mittlere obere Bildschirm ist ein 3D Bildschirm und kann z.B. stereoskopische Luftbildaufnahmen anzuzeigen.
 Der untere flach liegende Bildschirm ist ein Touch-Bildschirm. Er kann z.B. verwendet werden, um Kartenmaterial der Umgebung anzuzeigen.
 
 \begin{figure}
@@ -28,10 +28,12 @@ Der Auswerter kann außerdem Geodaten hinzufügen, wenn diese nicht im Bild enth
 Aus diesen Daten kann zum Beispiel ein Kompass oder ein Maßstab errechnet und eingezeichnet werden.
 Anschließend lässt sich das annotierte Bild mit den Einzeichnungen exportieren.
 Insbesondere das Anzeigen von stereoskopische Bildern gibt dem Bildauswerter einige Vorteile.
-So lässt sich zum Beispiel die Höhe eines Gebäudes wesentlich einfacher erkennen. Hierfür eigntet sich der mittlere 3D Bidlschirm besonders gut.
+So lässt sich zum Beispiel die Höhe eines Gebäudes wesentlich einfacher erkennen.
+Hierfür eigntet sich der mittlere 3D Bidlschirm besonders gut.
 
 \subsection{Geoviewer}
-Der Geoviewer ist ein Werkzeug zur Kartendarstellung.Hier können interaktiv Geodaten visualisiert werden, um eine bessere Analyse der Bilder zu erzielen (siehe \cite{IVIG}).
+Der Geoviewer ist ein Werkzeug zur Kartendarstellung.
+Hier können interaktiv Geodaten visualisiert werden, um eine bessere Analyse der Bilder zu erzielen (siehe \cite{IVIG}).
 Diese Daten stammen aus diversen Zivilen und Militärischen Quellen und können auf der Karte angezeigt werden.
 Ein Anwendugsfall kann das Anzeigen von Pfaden eines Schiffes oder Fahrzeuges sein.
 Außerdem ermöglicht die Software das Einzeichnen von Formen und Symbolen auf der Karte, dis mit dem Backend und damit mit allen andern verbundenen Anzeigesystemen, wie z.B. dem digitalen Lagetisch.
@@ -39,27 +41,29 @@ Die Software unterstützt die Benutzung durch Touch eingeben und deshalb eignet
 
 \subsection{\rec}
 \todo{überarbeiten}
-\rec  ist eine Objektidentifikations- Software, die dem Bildauswerter hilft, Objekte schneller zu erkennen (siehe \cite{rec}).
-Die eines Bildauswerters ist die Erkennung von Objekten anhand von erkennbaren Bildmerkmalen.
-Bisher wurde diese Aufgebe von speziell ausgebildeten Bildauswertern durchgeführt die ihr wissen über die Objekte aus Handbüchern hatten.
-Die Erkennungsassistenz ermöglicht dem Bildauswerter das Objekt durch Merkmale zu beschreiben und zeigt  mögliche Kandidaten an.
+\rec  ist eine Objekt-Identifikations-Software, die dem Bildauswerter unterstützt, Objekte schneller zu erkennen (siehe \cite{rec}). 
+Die Aufgabe eines Bildauswerters ist die Erkennung von Objekten anhand von charakteristischen Bildmerkmalen. 
+Bisher wurde diese Aufgebe von speziell ausgebildeten Bildauswertern durchgeführt, die ihr Wissen über die Objekte aus Handbüchern erlernt hatten. 
+Die Erkennungsassistenz ermöglicht dem Bildauswerter, das Objekt durch Merkmale zu beschreiben und zeigt mögliche Kandidaten an. % Verstehe ich nicht. Wer muss jetzt hier was beschreiben und warum?
 Für jeden Kandidat steht ein detaillierter Steckbrief zur Verfügung.
 
 \subsection{Weitere Funktonen}
-Zu dem oben genannten Programmen wird noch ein Webbrowser zum Anzeigen von Metadaten verwendet.
-Außerrdem muss ein Bidlasuwerter zu jedem ausgewertete Bild einen Bericht anfertigen. Eine Möglcihleit den Bericht zu schreiben ist Word.
+Ergänzend zu dem bereits genannten Programmen wird noch ein Webbrowser zum Anzeigen von Metadaten verwendet. 
+Zu jedem ausgewerteten Bild muss der Bildauswerter einen Bericht anfertigen. 
+Dafür wird häufig Standardsoftware verwendet, wie zum Beispiel Microsoft Word.
 
 Der Bildauswerteplatz der Zukunft verfügt außerdem über zwei Kinect-Kameras, die oberhalb der mittleren Bildschirme angebracht sind.
-Mit ihnen wird die Bedienung eines Arbeitsplatzes mit vier Bildschirmen verbessert.
+Mit ihnen wird die Bedienung eines Arbeitsplatzes mit vier Bildschirmen erlciehtert.
 Bei der herkömmlichen Bedienung mit Maus und Tastatur muss die Maus eine große Distanz zurücklegen, sobald man zwischen den Bildschirmen wechselt.
-Die eine Kinekt-Kamera erfasst die Kopfdrehung des Betrachter und die zweite erkennt, wenn der Nutzer mit dem Finger auf einen Bildschirm zeigt.
-Aus diesen Daten ergeben sich neue Möglichkeiten der Interaktion mit dem System (siehe \cite{Tim}).
+Die eine Kinect-Kamera erfasst die Kopfdrehung des Betrachters und die zweite erkennt, wenn der Nutzer mit dem Finger auf einen Bildschirm zeigt.
+Mit dieser Technologie ergeben sich neue Möglichkeiten der Interaktion mit dem System (siehe \cite{Tim}).
 
 \section{Coalition Shared Data Server}
-Coalition Shared Data \cite{CSD} Server ist der Speicherort von Aufklärungsergebnissen.
+Coalition Shared Data Server \cite{CSD} ist der Speicherort von Aufklärungsergebnissen.
 Der Server implementiert den STANAG 4559 Standard und dient zur Speicherung von standardisierten Daten, wie zum Beispiel Videos, Bilder, Berichte und Pfaden.
 Auf diese Daten kann durch verschiedene schreibende und lesende Clients zugegriffen werden.
 Der Zugriff erfolgt über Corba und die Antwort ist ein Metadaten-XML-File, in dem alle Referenzinformationen enthalten sind.
 In dem XML-Dokument ist der Download-Link oder -Stream auf die eigentlichen Daten angegeben.
-Es ist möglich Assoziationen zwischen den Daten erstellen, um Abhängigkeiten darzustellen.
+Es ist möglich, Assoziationen zwischen den Daten zu erstellen, um Abhängigkeiten darzustellen.
+% Eventuell besser erklären was Assoziationen sind.
 

Ausarbeitung/chapter3.tex

@@ -5,20 +5,24 @@
 \subsection{CSD-Task erstellen}
 
 Um eine wiederverwendbare Oberfläche einzubinden, wird eine Schnittstelle angelegt (siehe Abbildung  \ref{figure:klassenRequest}). 
-Die Schnittstelle wird aufgerufen, sobald der Nutzer einen Task absendet und bei der Auswahl einer Region. Das CSD-Plugin des Geoviewers implementiert diese Schnittstelle. 
+Die Schnittstelle wird aufgerufen, sobald der Nutzer einen Task absendet und bei der Auswahl einer Region. 
+Das CSD-Plugin des Geoviewers implementiert diese Schnittstelle. 
 Region-Anfragen werden direkt bearbeitet und der Task Request wird an den CSD-Adapter gesendet.
 
 Im SBA wird das Interface der CSDRequestAction implementiert.
-Der Aufruf der Region wird falls möglich über einen DirectRequest an das CSDPlugin weitergeleitet. 
+Der Aufruf der Region wird falls möglich über einen DirectRequest an das CSD-Plugin weitergeleitet. 
 Die Antwort darauf erhält der SBA erneut über einen DirectRequest. % Warum ``erneut''?
-Eine DirectMessage ist im System der Middleware nicht vorhanden. Deshalb werden an dieser Stelle ersatzweise Requests verwendet. 
-Wir können nicht nur einen einzigen Request absetzen, da nicht bekannt ist, wie lange der Nutzer zum Einzeichnen benötigt. 
-Nutzt man lediglich einen DirectRequest, so müsste die Antwort der Plugins innerhalb des Timeouts von 5 Sekunden erfolgen.
+Eine DirectMessage ist im System der Middleware nicht vorhanden. 
+Deshalb werden an dieser Stelle ersatzweise Requests verwendet. 
+Ein einziger Request genügt für diese Aufgabe nicht, da nicht bekannt ist, wie lange der Nutzer zum Einzeichnen benötigt. 
+Nutzt man lediglich einen DirectRequest, so müsste die Antwort der Plugins innerhalb des Timeouts von 5 Sekunden erfolgen, was nicht gewährleistet werden kann. 
 
 \begin{figure}
 \centering
 \includegraphics[width=\textwidth,height=\textheight,keepaspectratio]{../UML/Klassen RequestDialogue.png}
-\caption{Das Generieren von Tasks hat eine einheitliche Schnittstelle. Diese wird im SBA und CSDPlugin implementiert und so kann der RequestDialog wiederverwendet werden}
+\caption{Das Generieren von Tasks hat eine einheitliche Schnittstelle. 
+Diese wird im SBA und CSDPlugin implementiert. 
+So kann der RequestDialog wiederverwendet werden.}
 \label{figure:klassenRequest}
 \end{figure}
 
@@ -58,13 +62,14 @@ Dieser lokale Request lässt sich im Konfigurationsfile aktivieren und führt da
 Die Ergebnisse aus einer CSD-Abfrage werden als Liste aus XML-Dokumenten an die Methode newResults(List<Documents>) übergeben. 
 Diese ist ein Teil des Interfaces isaac.lib ResultHandler. 
 Für den SBA und den CSD-Adapter müssen zunächst einige allgemeine Informationen aus dem XML-Dokument ausgelesen werden. 
-Deshalb wurde die abstrakte Klasse ResultHandler in der CSDCommon Bibliothek angelegt (siehe Abbildung \ref{figure:klassenResult}. 
+Deshalb wurde die abstrakte Klasse ResultHandler in der CSDCommon-Bibliothek angelegt (siehe Abbildung \ref{figure:klassenResult}. 
 Für jedes neue Ergebnis werden zunächst alle allgemeinen Felder ausgelesen und anschließend die Methode newResult aufgerufen, um das Ergebnis genau zu verarbeiten. %Was meinst du mit ``genau verarbeiten''?
-Außerdem wird jeder Fehler abgefangen, der bei der Auswertung passieren könnte. % ``jeder Fehler wird abgefangen''. Bist du sicher das du ALLE Fehler abfängst? Wenn nicht würde ich schreiben ``Außerdem werden Fehler abgefangen''
+Außerdem wird jeder Fehler abgefangen, der bei der Auswertung passieren könnte. % ``jeder Fehler wird abgefangen''. Bist du sicher das du ALLE Fehler abfängst? Wenn nicht, würde ich schreiben ``Außerdem werden Fehler abgefangen''
 Bricht die Verarbeitung eines Ergebnisses ab, so wird die Methode storeErrorProduct aufgerufen. 
 In der Standard-Implementierung wird das XML-Dokument in einem Ordner abgelegt. 
 
-Ist ein Ergebnis verarbeitet, wird im zugehörigen Task die Methode resultFinished aufgerufen. So kann der Task, nachdem alle Ergebnis ausgewertet sind, die Methode afterTask aufrufen, um einen eventuelle Nachbearbeitung durchzuführen.
+Ist ein Ergebnis verarbeitet, wird im zugehörigen Task die Methode resultFinished aufgerufen.
+So kann der Task, nachdem alle Ergebnis ausgewertet sind, die Methode afterTask aufrufen, um einen eventuelle Nachbearbeitung durchzuführen.
 
 \begin{figure}
 \centering
@@ -97,27 +102,28 @@ Alle Ergebnisse werden dem CSDDataStore hinzugefügt und der Nutzer kann sich in
 Sobald der Nutzer ein Bild aus der Datenbank öffnen möchte, wird dieses heruntergeladen und aus dem NSIF-Format in den SBA importiert. 
 
 \section{Ausgewertete Daten speichern}
-Das Exportieren von Daten war im SBA im Allgemeinen vorhanden. %Im Allgemeinen - im Speziellen nicht? Ich verstehe nicht warum du die Formulierung ``im Allgemeinen'' verwendest.
+Das Exportieren von Daten war im SBA im Allgemeinen vorhanden. %Im Allgemeinen - im Speziellen nicht? Ich verstehe nicht, warum du die Formulierung ``im Allgemeinen'' verwendest.
 Die ExportAction fragt den Nutzer nach einem Speicherort und rendert das Bild. 
 
 \subsection{Export in \rec}
 Um den Export in den \rec zu gestalten, wurde das Rendern der ExportAction umgebaut, so dass es wiederverwendbar ist. 
 Die ExportAction in \rec überschreibt die Standard-Export-Action. 
-Die Auswahl des Nutzers wurde ersetzt durch einen Ordnerpfad, der aus der Konfigurationsdatei gelesen werden kann.
+Die Auswahl des Nutzers wurde ersetzt durch einen Ordnerpfad, der aus der Konfigurationsdatei gelesen werden kann. % ... weil hier keine Benutzerinteraktion möglich ist? Ist mir nicht ganz klar.
 
 \subsection{Export in CSD}
 Der Export in die CSD erbt auch von der ExportAction. 
 Zunächst muss der Nutzer alle nötigen Informationen zum Speichern in die CSD eingeben. 
 Die Informationen werden auf Richtigkeit und Notwendigkeit überprüft. 
 Wurde das editierte Bild aus der CSD geladen, so wird die Oberfläche mit den Informationen aus dem geladenen XML-File ausgefüllt.  
-Ist das Bild nicht aus der CSD, werden falls möglich Standardwerte gesetzt. 
+Stammt das Bild nicht aus der CSD, werden falls möglich Standardwerte gesetzt. 
 Diese Werte sind in der Konfigurationsdatei editierbar. 
-Nachdem der Nutzer die Informationen editiert hat, wird das temporäre Bild mit dem Nsif Creator zur einem NSIF-Bild konvertiert. 
+Nachdem der Nutzer die Informationen editiert hat, wird das temporäre Bild mit dem Nsif-Creator zu einem NSIF-Bild konvertiert. 
 Die nötigen Metadaten zur Erstellung des Bildes werden aus der Nutzeroberfläche geladen und in ein XML-Dokument geschrieben. 
 Sind im SBA Geoinformationen vorhanden, werden diese ebenfalls angefügt.
 
-Mit den restlichen Informationen wird das XML-Dokument für die CSD erstellt und zusammen mit dem NSIF Bild an die Isaac.lib übergeben.  % Welche Informationen können zu den ``restlichen'' gehören?
-Ist das Bild aus der CSD geladen, wird darauf geachtet, dass alle Informationen aus dem alten XML-Dokument übernommen werden, da die  Eingabe nicht alle Felder umfasst, die in dem XML-Dokument vorhanden sein können. 
+Das XML-Dokument für die CSD wird mit den restlichen Informationen angereichert und zusammen mit dem NSIF-Bild an die Isaac.lib übergeben.  % Welche Informationen können zu den ``restlichen'' gehören?
+Ist das Bild aus der CSD geladen, wird darauf geachtet, dass alle Informationen aus dem alten XML-Dokument übernommen werden. 
+Die Eingabe umfasst nicht alle Felder , die in dem XML-Dokument vorhanden sein können. 
 Bei der Erstellung des neuen Dokuments wird in diesem Fall das alte kopiert, alle Felder, die vom Server generiert werden, gelöscht und alle Änderungen aus der Nutzereingabe eingetragen. 
 Sind  keine Informationen vom vorherigen Bild vorhanden, wird ein neues XML-Dokument generiert.
 Der CSDWritingClient übernimmt das Übertragen des Meta-Dokuments. 
@@ -125,8 +131,8 @@ Das NSIF-Bild stellt die Bibliothek in einem HttpServer zur Verfügung. % Dieser
 Der CSD-Server lädt sich diese Datei herunter.
 
 In der Implementierung sind beim Bereitstellen des Bildes einige Probleme aufgetreten. 
-Zum einen ist darauf zu achten, dass die Infrastruktur erlaubt, dass der Server eine Rückverbindung zum Client aufbaut. Ist diese Funktionalität durch eine Firewall blockiert, kann das Bild nicht übertragen werden. 
-Außerdem überträgt die Isaac.lib nicht die IP-Adresse des Clients als Download-URL, sondern den DNS-Namen. Dies kann ebenfalls dazu führen, dass der Server das Bild nicht herunterladen kann.
+Zum Einen ist darauf zu achten, dass die Infrastruktur erlaubt, dass der Server eine Rückverbindung zum Client aufbaut. Ist diese Funktionalität durch eine Firewall blockiert, kann das Bild nicht übertragen werden. 
+Zum Anderen überträgt die Isaac.lib nicht die IP-Adresse des Clients als Download-URL, sondern den DNS-Namen. Dies kann ebenfalls dazu führen, dass der Server das Bild nicht herunterladen kann.
 
 \TODO{Ref auf Bild}
 \begin{figure}

Ausarbeitung/chapter5.tex

@@ -7,9 +7,10 @@
 Jedes Objekt in der CSD hat eine eindeutige UUID. Diese wird verwendet um die Datensätze eindeutig zu identifizieren. Bekommt ein Bildauswerter den Auftrag ein Bestimmtes Bild auszuwerten bekommt er die ID des Bildes gesagt. Die Eingabeoberfläche unterstütze das Suchen nach der UUID, jedoch wird das Ergebnis anschließend in der Tabelle angezeigt. Da diese Suche nur ein einziges Ergebnis liefern kann ist das erneute Anzeigen und aussuchen das Nutzer überflüssig. Das direkte laden eines Bildes anhand der UUID könnte die Arbeit des Bildauswerters verbessern.
 
 \subsection{SBA-Import durch Geoviewer}
-Bisher werden auf dem Geoviewer die Objekte aus der CSD nur dargestellt, und ermöglichen das Anzeigen der zugehörigen Metadaten auf dem MetaDaten Display. Hier kann eine weiter Verbindung zwischen SBA und Geoviewer hergestellt werden. Durch Auswahl des Objektes im Geoviewer wird das Bild im SBA geladen. 
+Bisher werden auf dem Geoviewer die Objekte aus der CSD nur dargestellt, und ermöglichen das Anzeigen der zugehörigen Metadaten auf dem MetaDaten Display.
+Hier kann eine weiter Verbindung zwischen SBA und Geoviewer hergestellt werden. Durch Auswahl des Objektes im Geoviewer wird das Bild im SBA geladen. 
 
-\subsection{Assoziationenr}
+\subsection{Assoziationen}
 Bidl und ergebniss verknüpfen
 Bericht hinzufügen