tricensus-mpi-status(1) [debian man page]

TRICENSUS-MPI-STATUS(1) 					The Regina Handbook					   TRICENSUS-MPI-STATUS(1)

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:

       o whether processing for each face pairing has finished;

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

       o 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

       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.

								    28 May 2012 					   TRICENSUS-MPI-STATUS(1)

REGFILEDUMP(1)							The Regina Handbook						    REGFILEDUMP(1)

NAME

       regfiledump - Dump the contents of a Regina data file

SYNOPSIS

       regfiledump [ -f | -l | -n ] [ -c ] file [ packet-label ... ]

DESCRIPTION

       This utility dumps the contents of the given Regina data file to standard output in a human-readable format.

       If  a  list of packet labels is given on the command-line, only those packets will be output.  Otherwise all packets in the given file will
       be output.

OPTIONS

       -f (default)
	      Output full packet details.  The output for each packet will cover several lines, beginning with basic details (such as  the  packet
	      label and type) followed by the packet's long description.

       -l     Output a list of packet labels and types only, one packet per line.

       -n     Don't output any packets at all; this option forces a packet count (see option -c).

       -c     Finish the output with a total count of all packets in the file.

INTERNATIONALISATION

       If any packets contain international characters, Regina will attempt to convert these to your local character encoding as it writes them to
       the output.

       You can tell Regina what character encoding to use by setting standard locale-related environment variables,  such  as  LANG,  LC_CTYPE	or
       LC_ALL.

       For  example,  if  LANG is set to en_AU then output will be written in the Western European character set ISO-8859-1, and if LANG is set to
       en_AU.UTF-8 then output will be written in the universal character set UTF-8.

       Typically these environment variables will already be set for you when you install your GNU/Linux system, and  Regina  will  just  use  the
       right character set out of the box.  See your GNU/Linux system reference for further information on supporting different locales.

MACOS X USERS

       If  you	downloaded  a drag-and-drop app bundle, this utility is shipped inside it.  If you dragged Regina to the main Applications folder,
       you can run it as /Applications/Regina.app/Contents/MacOS/regfiledump.

WINDOWS USERS

       The command-line utilities  are	installed  beneath  the  Program  Files  directory;  on  some  machines  this  directory  is  called  Pro-
       gram Files (x86).  You can start this utility by running c:Program FilesReginaRegina 4.93in
egfiledump.exe.

SEE ALSO

       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.

								    28 May 2012 						    REGFILEDUMP(1)