xenial (1) tricensus-mpi-status.1.gz

Provided by: regina-normal-mpi_4.96-2.1build2_amd64 bug

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


SYNOPSIS
       tricensus-mpi-status log-file


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@debian.org>.  Many people  have  been  involved  in  the
       development of Regina; see the users' handbook for a full list of credits.

                                                 23 August 2014                          TRICENSUS-MPI-STATUS(1)