---
name: "tricensus-mpi-status"
section: "1"
platform: "linux"
package: "regina-normal-mpi"
version: "5.1-6+b1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/tricensus-mpi-status"
---

# tricensus-mpi-status(1)

Summarise the log file of an MPI census of triangulations

## 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.