NAME

       tricensus-mpi-status - Summarise the log file of an MPI census of triangulations

SYNOPSIS

       tricensus-mpi-status log-file

CAUTION

       The  MPI  utilities  in Regina are deprecated, and will be removed from Regina in a future
       release.  If you wish to parallelise the generation of a census, we recommend splitting up
       the  input  pairing  files  into  chunks, and using typical queue systems (such as PBS) to
       parallelise.

DESCRIPTION

       This utility reads a log file produced by a tricensus-mpi job, and writes a human-readable
       summary  to  standard  output.   It can be used for either jobs that have finished or jobs
       that are still running, and it can happily read logs that have been compressed using  gzip
       or bzip2.

       The  logs  produced  by  tricensus-mpi are very detailed, including timestamps, details of
       which slaves have taken which tasks, and how many triangulations each task  has  produced.
       This  utility  distills  this detailed log into an easy-to-read summary, with one line for
       each face pairing.

       Output will only appear for face pairings that have been examined so far  (which  includes
       face pairings still being processed).  This output will include:

       • whether processing for each face pairing has finished;

       • the number of triangulations found so far for each face pairing;

       • the number of subsearches generated and/or finished for each face pairing (only relevant
         when running in subsearch mode).

       The final line of output will list the  total  number  of  triangulations  found  so  far,
       whether the census has finished, and if not, when the last log entry was written.

       For further explanation of the terminology used above, see the tricensus-mpi reference.

EXAMPLES

       See  the  tricensus-mpi  reference  for  a sample session in which tricensus-mpi-status is
       used.

MACOS X AND WINDOWS USERS

       This utility is not shipped with the drag-and-drop app bundle for  MacOS  X  or  with  the
       Windows installer.

SEE ALSO

       censuslookup, tricensus-mpi, regina-gui.

AUTHOR

       This  utility was written by Benjamin Burton <bab@maths.uq.edu.au>.  Many people have been
       involved in the development of Regina; see the users' handbook for a full list of credits.

                                         14 December 2016                 TRICENSUS-MPI-STATUS(1)