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

The \app{alogrm} tool will prune a given \var{.alog} file by removing
lines of the original file that contain log entries for a
user-specified list of MOOS variables or MOOS processes (sources). It
may be fairly viewed as the complement of the \app{aloggrep} tool.

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

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

\begin{fileverb}
  Usage: 
   alogrm in.alog [VAR] [SRC] [out.alog] [OPTIONS]         
                                             
 Synopsis:                                                 
    Remove the entries matching the given MOOS variables or sources
    from the given .alog file and generate a new .alog file.    
                                                           
 Standard Arguments:                                       
   in.alog  - The input logfile.                           
   out.alog - The newly generated output logfile. If no    
              file provided, output goes to stdout.        
   VAR      - The name of a MOOS variable
   SRC      - The name of a MOOS process (source)
                                                           
 Options:                                                  
   -h,--help     Displays this help message                
   -v,--version  Displays the current release version      
   -f,--force    Force overwrite of existing file          
   -q,--quiet    Verbose report suppressed at conclusion   
   --nostr       Remove lines with string data values      
   --nonum       Remove lines with double data values      
   --clean       Remove lines that have a timestamp that is
                 non-numerical or lines w/ no 4th column   
                                                           
 Further Notes:                                            
   (1) The second alog is the output file. Otherwise the   
       order of arguments is irrelevent.                   
   (2) VAR* matches any MOOS variable starting with VAR 
   (3) See also: alogscan, aloggrep, alogclip, alogview    
\end{fileverb}

\vspace{0.1in}
\noindent
Note that, in specifying items to be filtered out, there is no
distinction made on the command line that a given item refers to a
entry's variable name or an entry's source, i.e., MOOS process name.

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

The output shown below was generated from the \var{alpha.alog} file
generated by the Alpha example mission.

\begin{consoleverb}
 $ alogrm alpha.alog NAV_* new.alog
\end{consoleverb}

\begin{fileverb}
 Processing on file : alpha.alog
   Total lines retained: 47396 (46.70%)
   Total lines excluded: 54099 (53.30%)
   Total chars retained: 6453494 (66.21%)
   Total chars excluded: 3293774 (33.79%)
   Variables retained: (48) BHV_IPF, CREATE_CPU, CYCLE_INDEX, DB_CLIENTS, 
 DB_TIME, DB_UPTIME, DEPLOY, DESIRED_HEADING, DESIRED_RUDDER, DESIRED_SPEED, 
 DESIRED_THRUST, HELM_IPF_COUNT, HELM_MAP_CLEAR, HSLINE, USIMMARINE_STATUS, 
 IVPHELM_DOMAIN, IVPHELM_ENGAGED, IVPHELM_MODESET, IVPHELM_POSTINGS, 
 IVPHELM_STATEVARS, IVPHELM_SUMMARY, LOGGER_DIRECTORY, LOOP_CPU, MOOS_DEBUG, 
 MOOS_MANUAL_OVERIDE, NODE_REPORT_LOCAL, PC_hsline, PC_waypt_return, 
 PC_waypt_survey, PHELMIVP_STATUS, PLOGGER_CMD, PLOGGER_STATUS, 
 PMARINEPID_STATUS, PMARINEVIEWER_STATUS, PNODEREPORTER_STATUS, 
 PWT_BHV_HSLINE, PWT_BHV_WAYPT_RETURN, PWT_BHV_WAYPT_SURVEY, RETURN, 
 STATE_BHV_HSLINE, STATE_BHV_WAYPT_RETURN, STATE_BHV_WAYPT_SURVEY, 
 SURVEY_INDEX, SURVEY_STATUS, VIEW_POINT, VIEW_SEGLIST, WPT_INDEX, WPT_STAT
\end{fileverb}

</pre></body></html>