<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">%=================================================================
\section{The alogiter Tool}
%================================================================
\label{sec_alogiter}
\index{alogiter!Overview}

The \app{alogiter} tool will analyze the \var{ITER\_GAP} and
\var{ITER\_LEN} information produced by any appcasting MOOS app. These
variables indicate the ability of an application to keep up with the
requested apptick frequency.  For example \mvar{PHELMIVP\_ITER\_GAP}
will be close to 1.0 when configured with an apptick of 4, and the
observed apptick is also 4. The gap value will be around 2 if the
observed apptick is around 2. The \mvar{PHELMIVP\_ITER\_LEN} is the 
elapsed time between the start and end of the helm iterate loop. 

%================================================================
\subsection{Command Line Usage for the alogiter Tool}
\index{alogiter!Command Line Usage}
\index{Command Line Usage!alogiter}

\begin{consoleverb}
 $ alogiter --help or -h
\end{consoleverb}

\vspace{0.1in}
\begin{listing}{Command line usage for the \app{alogiter} tool}
\label{alogiter_usage}
\scriptsize
\begin{verbatim}
  1  $ alogrm -h
  2    
  3  Usage: 
  4    alogiter in.alog [OPTIONS]                               
  5                                                             
  6  Synopsis:                                                  
  7    Analyze the ITER_GAP and ITER_LEN information provided by
  8    all applications recorded in the given alog file.        
  9                                                             
 10  Standard Arguments:                                        
 11    file.alog - The input logfile.                           
 12                                                             
 13  Options:                                                   
 14    -h,--help     Displays this help message                 
 15    -v,--version  Displays the current release version       
 16                                                             
 17  Further Notes:                                             
 18    See also: alogscan, alogrm, alogclip, alogview, aloggrep 
\end{verbatim}
\end{listing}
\normalsize



%=================================================================
\subsection{Example Output from the alogiter Tool}
\index{alogiter!Example Output}

The output shown in Listing \ref{alogiter_output} was generated from
the \var{alpha.alog} file generated by the Alpha example mission, at 
time warp 20.

\vspace{0.1in}
\begin{listing}{Example \app{alogiter} output applied to the \var{alpha.alog} file}
\label{alogiter_output}
\scriptsize
\begin{verbatim}
  1  $ alogiter alpha.alog 
  2  
  3  Processing on file : MOOSLog_22_4_2015_____13_25_19.alog
  4                  GAP     GAP       PCT     PCT     PCT    
  5  AppName         MAX     AVG       &gt;1.25   &gt;1.50   &gt;2.0   
  6  -------------  -----   -----      -----   -----   -----  
  7  PHELMIVP        1.26    1.11      0.005   0.000   0.000
  8  PMARINEVIEWER   1.10    1.07      0.000   0.000   0.000
  9  PNODEREPORTER   1.25    1.15      0.008   0.000   0.000
 10  UPROCESSWATCH   1.26    1.12      0.014   0.000   0.000
 11  USIMMARINE      1.27    1.12      0.009   0.000   0.000
 12  
 13                  LEN    LEN      PCT     PCT     PCT     PCT  
 14  AppName         MAX    AVG      &gt;0.25   &gt;0.50   &gt;0.75   &gt;1.0 
 15  -------------  -----  -----     -----   -----   -----   -----
 16  PHELMIVP        0.08   0.04     0.000   0.000   0.000   0.000
 17  PMARINEVIEWER   0.00   0.00     0.000   0.000   0.000   0.000
 18  PNODEREPORTER   0.01   0.00     0.000   0.000   0.000   0.000
 19  UPROCESSWATCH   0.01   0.00     0.000   0.000   0.000   0.000
 20  USIMMARINE      0.02   0.00     0.000   0.000   0.000   0.000
 22  
 23  Mission Summmary 
 24  ---------------------------
 25   Collective APP_GAP: 1.11
 26   Collective APP_LEN: 0.01
\end{verbatim}
\end{listing}
\normalsize
</pre></body></html>