/*!

\page essay01  Gromit Log File Location Conventions

\section Introduction

\li October 2005

<hr>

\section gromit_log_files Gromit Log File Conventions

It is important for everybody to understand the structure of the log
directories generated by the Gromit run script.


\li First, I expect the runs on the rover to be made all from Thierry's or my
directory on gromit-wireless.  The Logs are always under:

     ~/projects/CDS/GromitIdea/Models/CDS/Logs

where ~ is either /home/mus or /home/ffi

\li From there on it won't be difficult to get to the actual logs. The directory
structure is the following:

 <date>/<test-name>/<configuration>/<run directory>

\li  Under that path there are the actual log files. The ones for the agent are
always prefixed by GromitExecSimple.log followed by the timestamp of the run.

\li  <date> is the date of the run, in local Ames (PDT) time.

\li  <test-name> is the name of the test itself. If the run in on the rover with
the MA Gromit agent this name is arbitrary. We should use the convention to
call it ORT-test from now on. Otherwise it is the prefix of both the
*.slave.script and *.master.script*  files that can be found under
~/projects/CDS/GromitIdea/Models/CDS/Scenarios.

\li  <configuration> tells which part of the interfaces is simulated and what is
not. There are four possibilities,  "sim-all" means that everything (MobileAgent 
and Gromit rover) is simulated by an IDEA simulator, "sim-MA" means that the 
rover is real but MA is simulated, "sim-gromit" means that MA is real and the 
rover is simulated. "real" means that everything is real, that is, interfaced
with Gromit itself.

\li  Finally, the run directory is a directory of the structure run-<time stamp>
where the time stamp is the exact time at which the "run" command was issued.

\li  The Gromit team will make every attempt to coordinate better (see my previous messages)
but I am relying on everybody else's doggedness and persistence to dig out the
data even if the accounts of the problems are sketchy in the emails.

<hr>

*/

