Review Design-Kapitel (Zwischenstand 2)

Ausarbeitung/chapter2.tex

@@ -11,50 +11,53 @@ Nutzeroberfläche zur Verfügung stehen, um Daten aus der CSD auszulesen (siehe
 Die Benutzeroberfläche ermöglicht das Suchen nach vielen Kriterien, wie zum Beispiel dem Namen der Mission, des Erstellers und der Erstellzeit.
 
 Die Auswahl einer Region soll auch möglich sein, um die Daten auf diesen Bereich der Karte zu beschränken. Der Geoviewer bietet hierfür eine einfache Möglichkeit.  Der Nutzer kann durch eine einfach Einzeichnung auf der Karte den Suchbereich selektieren und die Suche einschränken. Auf dem SBA ist dieses nicht % oder ``noch nicht''? Wird daraus eine Anforderung an dein Projekt?
-so einfach möglich. Hierfür wurde eine Verbindung zum Geoviewer implementiert. % durch dich oder vorher schon?
-Ist der SBA mit dem Backend des Geoviewers verbunden und Geoviewer gestartet, so aktiviert sich der Regionsauswahl des Bildauswerters. Die Auswahl der Region erfolgt für den SBA auf dem Geoviewer und das Ergebniss wird zurück an den SBA gesendet.
+so einfach möglich. Hierfür wurde eine Verbindung zum Geoviewer implementiert. % durch dich oder vorher schon? 
+Ist der SBA mit dem Backend des Geoviewers verbunden und Geoviewer gestartet, so aktiviert sich der Regionsauswahl des Bildauswerters. Die Auswahl der Region erfolgt für den SBA auf dem Geoviewer und das Ergebniss wird zurück an den SBA gesendet. % Ich habe nicht verstanden, was anders ist als bei der schon vorhandenen o.g. Auswahl der Region auf dem Geoviwer.
 
-Dei Nutzeroberfläche kann durch ein Preset vorkonfiguriert werden. Die Konfiguration wird aus einem Konfogurations Datei gelesne und ermöglicht eine einfacher Bedienung. Zum Beipiel kann man so mögliche CSD - Server angeben und der Nuter muss keine URL eingeben, sondern kann die Server aus einer Combobox auswählen.
+Die Nutzeroberfläche kann durch ein Preset vorkonfiguriert werden. Die Konfiguration wird aus einem Konfigurationsdatei gelesen und ermöglicht eine einfachere Bedienung. Zum Beispiel kann man so mögliche CSD-Server vorgeben. Der Nutzer muss dann keine URL eingeben, sondern kann die Server aus einer Combobox auswählen.
 
-Die Nuterzoberfläche wurde in eine CSDCommons Bibliothek integreirt, damit sie wiederverwendet werden kann.
+Der Sourcecode der Nutzeroberfläche wurde in eine separate Bibliothek ausgelagert, damit sie wiederverwendet werden kann.  Die Bibliothek wurde CSD-Commons genannt. % Darfst du im Design-Kapitel so formulieren? Musst du die Auslagerung nicht als Anforderung schreiben? Hier sthet schon, was du implementiert hast.
 
 \begin{figure}
 \centering
 \includegraphics[width=\textwidth,height=\textheight,keepaspectratio]{RequestUI.png}
-\caption{Die Eingabe eines CSD Requests im SBA. Der Request ist begrenzt auf Bilder da der SBA nur Bilder unterstützt}
+\caption{Die Eingabe eines CSD-Requests im SBA. Der Request ist auf Bilder eingeschränkt, da der SBA nur Bilder unterstützt}
 \label{figure:requestUI}
 \end{figure}
 
 \subsection{Task ausführen}
-Nachdem der Nutzer eine Task Request erstellt hat muss dieser Ausgeführt werden. Die Eingaben des Nutzers müssen in einen CSD Abfrage umgewandelt werden und eine Verbindung aufgebaut werden. 
+Nachdem der Nutzer einen Task Request erstellt hat, muss dieser ausgeführt werden. Die Eingaben des Nutzers müssen in einen CSD-Abfrage umgewandelt werden und eine Verbindung aufgebaut werden. 
 
-Der Geoviewer sendet den Task Request zur Verarbeitung an den CSDAdapter. Der Adapter baut mit Hilfe der Isaac.lib (TODO ref)eine Verbindung zum CSD-Server auf und generiert die zugehörige Querry. Der SBA verarbeitet den Task direkt. Die Schritte sind serh ähnlich und sind deshalb ebenfalls in die CSDCommon Bibliothek integriert worden (Siehe Abbildungen  \ref{figure:strukturViewer} und \ref{figure:strukturSBA} die grün markierten Komponennten sind  gleich). Zur Verbinbdung an die CSD wird die Isaac.lib verwendet.
+Der Geoviewer sendet den Task Request zur Verarbeitung an den CSD-Adapter. Der Adapter baut mit Hilfe der Isaac.lib (TODO ref) eine Verbindung zum CSD-Server auf und generiert die zugehörige Query. Der SBA verarbeitet den Task direkt. Die Schritte sind sehr ähnlich % womit ähnlich? Hier ist nicht klar, wo Reuse möglich ist.
+und sind deshalb ebenfalls in die CSD-Common Bibliothek integriert worden (Siehe Abbildungen  \ref{figure:strukturViewer} und \ref{figure:strukturSBA}. Die grün markierten Komponenten sind gleich). Zur Verbindung mit der CSD wird die Isaac.lib verwendet.
 
 
 \subsection{Ergebnis auswerten}
-Der Isaac.lib kann bei einer Abfrage ein ResultHandler übergeben werden. Findet DIe Bibliothek ein Ergebniss wird diese dem Result Handler übergeben. Für den SBA und den CSD Adapter müssen zunächst alle generellen Informationen aus dem MetaDaten XML Dokument ausgelesen werden. Anschließend folgt die genauere Verarbeitung der einzelnen Ergebnisse.
+Der Isaac.lib kann bei einer Abfrage ein Result Handler übergeben werden. Findet die Bibliothek ein Ergebnis wird diese dem Result Handler übergeben. %Was meinst du mit der Formulierung ``Ereignis finden''?
+Für den SBA und den CSD Adapter müssen zunächst alle generellen Informationen aus dem MetaDaten-XML-Dokument ausgelesen werden. Anschließend folgt die genauere Verarbeitung der einzelnen Ergebnisse. % Was sind das für Ergebnisse?
 
-Beim SBA wird anschließend ein CSDData Objekt mit allen nötigen Informationen erstellt und diese Objekt dem CSDDataStore hinzugefügt. Das Ergebnis der Anfrage wir anschließend in einer Tabelle dargestellt und der Nutzer kann sich ein Bild zum laden aussuchen (Bild \ref{figure:resultUI}).
+Beim SBA wird anschließend ein CSD-Data-Objekt mit allen nötigen Informationen erstellt und dieses Objekt dem CSD-DataStore hinzugefügt. Das Ergebnis der Anfrage wird anschließend in einer Tabelle dargestellt und der Nutzer kann ein Bild zum Laden auswählen (Bild \ref{figure:resultUI}).
 
-Der CSDAdapter teilt die Ergebnisse erst nach dem Typ as, so dass zum Beispiel Bilder und Videos anders verarbeitet werden. Im den meisten Fällen wird zuerst das eigentliche Objekt heruntergeladen und für den Lagetisch aufbereitet. Bei Bildern wird überprüft ob das Bild direkt als Kartenmaterial eingebunden werden kann. Aus dem Metadeaten XML File wird ein Metadaten ANzeig erstellt. Außerdem wird ein Data Objekt erstellt und das Backend gesendet, sodass das Ergebniss auf der Karte visualisiert wird. Im Geoviewer werden diese Objekt dann dargestellt und können verwendet werden um die Metadaten im Metadaten Display anzuzeigen.
+Der CSD-Adapter teilt die Ergebnisse erst nach Typ aus, sodass zum Beispiel Bilder und Videos anders verarbeitet werden. % Was meinst du mit ``austeilen''?
+Im den meisten Fällen wird zuerst das eigentliche Objekt heruntergeladen und für den Lagetisch aufbereitet. Bei Bildern wird überprüft, ob das Bild direkt als Kartenmaterial eingebunden werden kann. Aus dem Metadaten-XML-File wird eine Metadaten-Anzeige erstellt. Außerdem wird ein Data Objekt erstellt und an das Backend gesendet, sodass das Ergebnis auf der Karte visualisiert werden kann. Im Geoviewer werden diese Objekt dann dargestellt und können verwendet werden, um die Metadaten im Metadaten Display anzuzeigen.
 
 \begin{figure}
 \centering
 \includegraphics[width=\textwidth,height=\textheight,keepaspectratio]{ResultUI.png}
-\caption{Die Anzeige aller Ergebnisse im SBA. Die Tabelle ist sortierbar und es lassen sich beliebige Spalten ein und ausblenden. Falls ein Vorschau Bild verfügbar ist wird dies An der Seite zusammen mit dem Kommentar des Bildes angezeigt.}
+\caption{Die Anzeige aller Ergebnisse im SBA. Die Tabelle ist sortierbar und es lassen sich beliebige Spalten ein- und ausblenden. Falls ein Vorschaubild verfügbar ist, wird dieses an der Seite zusammen mit dem Kommentar des Bildes angezeigt.}
 \label{figure:resultUI}
 \end{figure}
 
- \begin{landscape} 
+\begin{landscape} 
 \begin{figure*}
 \includegraphics[scale=0.9]{../UML/Struktur Viewer.png}
-\caption{Struktur der Anbindung an die CSD für den Geoviewer. In grün eingezeichnet sind die Komponenten die aus der CSDCommon Bibliothek. }
+\caption{Struktur der Anbindung an die CSD für den Geoviewer. In Grün eingezeichnet sind die Komponenten aus der CSD-Common Bibliothek. }
 \label{figure:strukturViewer}
 \end{figure*}
 
 \begin{figure*}
 \includegraphics[scale=1]{../UML/Struktur SBA.png}
-\caption{Struktur der Anbindung an die CSD im Stereo Bildauswerter.  In grün eingezeichnet sind die Komponenten die aus der CSDCommon Bibliothek. In gelb sind die Swing Actions eingezeichnet die der Nutzer aufrufen kann.}
+\caption{Struktur der Anbindung an die CSD im Stereo-Bildauswerter. In Grün eingezeichnet sind die Komponenten aus der CSD-Common Bibliothek. In Gelb sind die Swing-Actions eingezeichnet, die der Nutzer aufrufen kann.}
 \label{figure:strukturSBA}
 \end{figure*}
 \end{landscape} 
@@ -62,7 +65,7 @@ Der CSDAdapter teilt die Ergebnisse erst nach dem Typ as, so dass zum Beispiel B
 
 \section{Ausgewertete Daten des SBA speichern}
 \subsection{Export in \rec}
-Eine Funktion der Erkennungsassistenz \rec ist das hinzufügen von bisher unbekannten Fahrzeugen. Sind zum Beispiel Piraten mit ihrem modifizierten Bot unterwegs, so kann man Bilder hinzufügen, sodass dies in Zukunft auch vorgeschlagen wird. In dem SBA wurde eine Funktion eingebaut, die das Exportieren eines Bildes für den \rec vereinfacht. Durch einen Knopf wird das Bild gerendert und in einen definierten Ordner abgespeichert. In diesem Ordner findet der \rec das Bild und bietet eine Import an.
+Eine Funktion der Erkennungsassistenz \rec ist das Hinzufügen von bisher unbekannten Fahrzeugen. Sind zum Beispiel Piraten mit ihrem modifizierten Bot unterwegs, so kann man Bilder hinzufügen, sodass dies in Zukunft auch vorgeschlagen wird. In dem SBA wurde eine Funktion eingebaut, die das Exportieren eines Bildes für den \rec vereinfacht. Durch einen Knopf wird das Bild gerendert und in einen definierten Ordner abgespeichert. In diesem Ordner findet der \rec das Bild und bietet eine Import an.
 
 \subsection{Export in CSD}
 Nach einer erfolgreichen Auswertung  soll das annotierte Bild auch wieder in die CSD hinzugefügt werden. Hierfür wurde in den SBA ein schreibender Zugriff auf den Server implementiert. Zunächst kann der Nutzer die nötigen  und bei bedarf auch einige optionale Meta Informationen eingeben. Hierfür wurde ein Oberfläche angelegt (Siehe Abbildung \ref{figure:metaUI}). Falls das Bild aus der CSD geladen wurde, so wird die UI  mit den Werten des geladenen Bildes gefüllt. Die Obefläche überprüft  ob alle nötigen Richtlinien eingehalten wurden. Dies kann zum Beispiel bedeuten, dass gewisse Felder notwendig sind und das einige Felder eien maximale Länge haben. Zur einfacheren Benutzung wurden Knöpfe zur einfacheren Datums Auswahl und zum generieren von zufälligen IDs hinzugefügt.