<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">\documentclass[onecolumn,letterpaper,11pt]{article}

%===================================================================
\input{common_latex/common_latex_packages}
\input{common_latex/common_latex_definitions}
\input{common_latex/common_latex_help_format}
%===================================================================

\begin{document}

\begin{labcover}
\labtitle{The Alog Toolbox Command Line Utilities}
\vspace{0.1in}
\labdate{June 2018}
\vspace{0.1in}
\labauth{Michael Benjamin, mikerb@mit.edu}
\labauth{Department of Mechanical Engineering}
\labauth{MIT, Cambridge MA 02139}
\labsrc{project-pavlab/apps/app\_alog\_cmdline} 
\labtoc{small}
\end{labcover}

\wikidoc{file=IvPTools.ALogCmdLine}
\wikidoc{bugz=alogcmd}
\wikidoc{auth=mikerb@mit.edu}

%=================================================================
\section{Overview}
%=================================================================
\label{util_alogtools}

The Alog Toolbox, in addition to the \app{alogview} GUI based utility,
also contains a set of command line post-mission analysis utility
applications:

\begin{packed_itemize}
\item \app{alogclip}
\item \app{aloggrep}
\item \app{alogrm}
\item \app{alogscan}
\item \app{aloghelm}
\item \app{alogiter}
\item \app{alogsplit}
\item \app{alogpare}
\item \app{alogcd}
\item \app{alogcat}
\item \app{alogavg}
\item \app{alogmhash}
\item \app{alognpos}
\end{packed_itemize}

\vspace{0.1in}
\noindent
Each application manipulates or renderings \var{.alog} files generated
by the \app{pLogger} application. Four of the applications,
\app{alogclip}, \app{aloggrep}, \app{alogpare}, and \app{alogrm} are
command-line tools for filtering a given \var{.alog} file to a reduced
size. Reduction of a log file size may facilitate the time to load a
file in a post-processing application, may facilitate its transmission
over slow transmission links when analyzing data between remote users,
or may simply ease in the storing and back-up procedures. The
\app{alogscan} tool provides statistics on a given \var{.alog} file
that may indicate how to best reduce file size by eliminating variable
entries not used in post-processing. It also generates other
information that may be handy in debugging a mission. The
\app{alogsplit} tool will split a single alog file into a folder
containing a dedicated alog file for each logged variable. This
operation is also done automatically upon the launch of app{alogview}
when launched on an alog file for the first time.  The \app{alogview}
tool is a GUI-based tool that accepts one or more \var{.alog} files
and renders a vehicle positions over time on an operation area,
provides time-correlated plots of any logged numerical MOOS variables,
and renders helm autonomy mode data with plots of generated objective
functions.

%=================================================================
\section{An Example .alog File}

The \var{.alog} file used in the examples below was generated from the
Alpha example mission. This file, \var{alpha.alog}, is found in the
missions distributed with the MOOS-IvP tree.  The \var{alpha.alog}
file was created by simply running the mission as described, and can
be found in:

\vspace{0.1in}
\footnotesize
\begin{verbatim}
  moos-ivp/trunk/ivp/missions/alpha/alpha.alog
\end{verbatim}
\normalsize

%=================================================================
\input{common_alog/inc_alog_scan}
%=================================================================
\input{common_alog/inc_alog_clip}
%=================================================================
\input{common_alog/inc_alog_grep}
%=================================================================
\input{common_alog/inc_alog_rm}
%=================================================================
\input{common_alog/inc_alog_helm}
%=================================================================
\input{common_alog/inc_alog_iter}
%=================================================================
\input{common_alog/inc_alog_split}
%=================================================================
\input{common_alog/inc_alog_pare}
%=================================================================
\input{common_alog/inc_alog_cd}
%=================================================================
\input{common_alog/inc_alog_cat}
%=================================================================
\input{common_alog/inc_alog_avg}
%=================================================================
\input{common_alog/inc_alog_mhash}
%=================================================================
\input{common_alog/inc_alog_eval}

\end{document}

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