doc update

Author: hpuhr

doc/screenshots/eval_filter_utns.png

@@ -81,6 +81,98 @@ \subsubsection{Result Values}
 \end{table}
 \end{center}
 
+
+\subsection{Dubious Tracks}
+\label{sec:eval_req_dubious_tracks} 
+
+\subsubsection{Configuration}
+
+\begin{figure}[H]
+    \includegraphics[width=14cm,frame]{../screenshots/eval_req_dubious_tracks.png}
+   \caption{Evaluation Dubious Tracks}
+\end{figure}
+
+The 'Dubious Tracks' requirement can be used to check for dubious tracks generated by a \textbf{Tracker} data-source (using the attributed track number). This requirement checks based on test data only, so the reference data is of no importance. \\
+
+For each track number (existing in an UTN) a number of checks are performed, and a probability of dubious target report is caluclated. Which checks are used can be defined as follows, but are focused on short tracks or physically dubious movement. \\
+
+\begin{itemize}  
+\item Probability [1]: Probability of dubious track
+\item Probability Check Type: $\geq$
+\item Use only from L.U. Sensor: Checkbox if only data from a single last-updating sensor id should be considered
+\item L.U. Sensor [1]: Last-updating sensor id (number, as in the 'Manage Data-Sources' task)
+\item Minimum Comparison Time [s]: Skip movement checks if time between updates is smaller than the defined time
+\item Maximum Comparison Time [s]: Skip movement checks if time between updates is larger than the defined time
+\item Mark Primary-Only: Checkbox if all primary-only tracks should be counted as dubious
+\item Use Minimum Updates: Checkbox if tracks with less than the defined number of updates should be counted as dubious
+\item Minimum Updates [1]: Minimum number of updates
+\item Use Minimum Duration: Checkbox if tracks with a duration less than the defined time should be counted as dubious
+\item Minimum Duration [s]: Minimum duration
+\item Use Maximum Groundspeed: Checkbox if maximum groundspeed should be used
+\item Maximum Groundspeed [kts]: Maximum groundspeed to be considered
+\item Use Maximum Acceleration: Checkbox if maximum acceleration should be used
+\item Maximum Acceleration [$m/s^{2}$]: Maximum acceleration to be considered
+\item Use Maximum Turnrate: Checkbox if maximum turnrate should be used
+\item Turnrate Groundspeed [deg/s]: Maximum groundspeed to be considered
+\item Use Maximum ROCD: Checkbox if turnrate rate of climb/descent should be used
+\item Maximum ROCD [ft/s]: Maximum  rate of climb/descent to be considered
+\item Dubious Probability [1]: Probability of dubious target report to classify a track as dubious
+\end{itemize}
+\ \\
+
+\subsubsection{Calculation}
+
+As a summary, the reference is used to calculate the number of expected update intervals inside the sector layer (\#EUI). Then, for the test data, if the reference exists at the time, time differences between target reports are checked and the number of misses/gaps are calculated as number of missed update intervals (\#MUI). \\
+
+Gaps are, if a minimum or maximum gap length is used, only counted if the detected gap fulfills the thresholds. \\
+
+The ratio of \#MUI and \#EUI gives the probability of missed update interval, the counter-probability gives the Probability of Detection (PD). The PD must greator or equal than the defined 'Probability' for the requirement to pass.
+
+\subsubsection{Result Values}
+
+\paragraph{Sector}
+
+\begin{center}
+ \begin{table}[H]
+  \begin{tabularx}{\textwidth}{ | l | X |  l | }
+    \hline
+    \textbf{Name} & \textbf{Description} & \textbf{Example} \\ \hline
+    Sector Layer & Name of the sector layer & fir\_cut\_sim \\ \hline
+    Reqirement Group & Name of the requirement group & Mandatory  \\ \hline
+    Reqirement & Name of the requirement & Detection  \\ \hline
+    Num Results & Total number of results & 728  \\ \hline
+    Num Usable Results & Number of usable results & 417  \\ \hline
+    Num Unusable Results & Number of unusable results & 311  \\ \hline
+    \#Updates/\#EUIs [1] & Total number update intervals & 7960  \\ \hline
+    \#MUIs [1] & Number of missed update intervals & 2221  \\ \hline
+    PD [\%] & Probability of Detection & 72.10  \\ \hline
+    Condition &  & >= 90.00  \\ \hline
+    Condition Fulfilled &  & Failed  \\ \hline
+\end{tabularx}
+\end{table}
+\end{center}
+
+Also, a table is given for all single targets, sorted by PD.
+
+\paragraph{Single Target}
+
+\begin{center}
+ \begin{table}[H]
+  \begin{tabularx}{\textwidth}{ | l | X |  l | }
+    \hline
+    \textbf{Name} & \textbf{Description} & \textbf{Example} \\ \hline
+    Use & To be used in results & true \\ \hline
+    \#EUIs [1] & Expected Update Intervals & 6 \\ \hline
+    \#MUIs [1] & Missed Update Intervals & 5 \\ \hline
+    PD [\%] & Probability of Detection & 16.67 \\ \hline
+    Reference Period 0 & Time inside sector & [15:47:22.680,15:47:45.828] \\ \hline
+    Reference Period 1 & Time inside sector & [15:47:53.844,15:47:57.844] \\ \hline
+    Condition &  & >= 90.00 \\ \hline
+    Condition Fulfilled &  & Failed \\ \hline
+\end{tabularx}
+\end{table}
+\end{center}
+
 \subsection{Extra Data}
 \label{sec:eval_req_extra_data} 
 

doc/screenshots/eval_req_dubious_tracks.png

@@ -176,6 +176,8 @@ \subsection{Targets Tab}
   \caption{Evaluation Targets tab with loaded data}
 \end{figure}
 
+
+
 \subsection{Filter Tab}
 
 \begin{figure}[H]
@@ -389,6 +391,7 @@ \subsection{Filtering Targets}
 \item Remove Primary-Only Targets: Removes primary-only targets (w/o secondary attributes)
 \item Remove Mode A/C Code onlys: Removes targets without Mode S attributes
 \item Remove by Mode A Code: Removes targets having a Mode A code given in the list
+\item Remove by Mode C Code: Removes targets having a Mode C code smaller than the given value
 \item Remove by Target Address: Removes targets having a Mode S target address given in the list
 \item Remove by Non-Detection of DBObject: Removes targets not being detected by a given DBOObject (e.g. sensor type)
 \end{itemize}

doc/screenshots/osgview_render_order.png

@@ -3,7 +3,7 @@ \subsection{Style Tab}
 
 \begin{figure}[H]
    \center
-    \includegraphics[width=9cm,frame]{../screenshots/osgview_style_tab.png}
+    \includegraphics[width=8cm,frame]{../screenshots/osgview_style_tab.png}
   \caption{OSG View Style tab}
 \end{figure}
 
@@ -265,18 +265,25 @@ \subsubsection{Style Examples}
 
 \subsubsection{Render Order}
 
-In the render order widget, the drawing order of all DBObjects is specified. The one at the top is drawn last (over all others), so it is useful to move the most important DBObject (for the current inspection) to the top.
+In the render order widget, the drawing order of the drawn geometry is specified. The one at the top is drawn last (over all others), so it is useful to move the most important DBObject (for the current inspection) to the top.
 
 \begin{figure}[H]
-    \includegraphics[width=10cm,frame]{../screenshots/osgview_render_order.png}
+    \includegraphics[width=8cm,frame]{../screenshots/osgview_render_order.png}
   \caption{OSG View render order}
 \end{figure}
 
-To change the drawing order click on the DBObject to move and use the buttons on the right side. Please note that no redraw is required and that the drawing order is persisted in the configuration.
-% 
+Using the 'Order By' checkbox, the drawing order can be defined based on:
+\begin{itemize}
+ \item DBObject: Data-source type (e.g. Tracker, Radar, ...)
+ \item ds\_id: Data-source (e.g. Tracker1, Tracker2, Radar3, ...)
+\end{itemize}
+\ \\
+
+To change the drawing order click on the item to move and use the buttons on the right side. Please note that no redraw is required and that the drawing order is persisted in the configuration. \\
+
  \begin{itemize}
- \item \includegraphics[width=0.5cm]{../../data/icons/top.png} Move to Top: Move DBO to top position
- \item \includegraphics[width=0.5cm]{../../data/icons/up.png} Move Up: Move DBO one position up
- \item \includegraphics[width=0.5cm]{../../data/icons/down.png} Move Down: Move DBO one position down
- \item \includegraphics[width=0.5cm]{../../data/icons/bottom.png} Move to Bottom: Move DBO to the bottom position
+ \item \includegraphics[width=0.5cm]{../../data/icons/top.png} Move to Top: Move item to top position
+ \item \includegraphics[width=0.5cm]{../../data/icons/up.png} Move Up: Move item one position up
+ \item \includegraphics[width=0.5cm]{../../data/icons/down.png} Move Down: Move item one position down
+ \item \includegraphics[width=0.5cm]{../../data/icons/bottom.png} Move to Bottom: Move item to the bottom position
 \end{itemize}

doc/screenshots/osgview_style_tab.png

@@ -225,7 +225,7 @@
 \begin{center}
 \normalsize\textsf{by Helmut Puhr}\par
 \medskip
-\normalsize\textsf{Version 0.6.2 \textit{Tenacious Tapir}}\par\textsf{Alpha Release}\par
+\normalsize\textsf{Version 0.6.3 \textit{Ubiquitous Unicorn}}\par\textsf{Alpha Release}\par
 \end{center}
 \vspace*{\fill}
 \begin{center}