NAME

PTIM_stop - stops MPI process time counters and prints all timings to STDOUT [default]
             or into a specified file.

SYNOPSIS

call PTIM_stop([label], [file])

PARAMETERS

<IN> label : Optional input string. If present, its value should be equal to
             the input argument specified at the PTIM_start call.

<IN> file  : Optional input string. If present, timings will be printed into the
             specified file. Otherwise, they will be printed in STDOUT.

NOTES

PTIM_stop subroutine is collective over all processes of MPI_COMM_WORLD communicator.
Process of rank 0 is in charge of collecting all time measurements and prints results
on standard output.

EXAMPLE

The example of the MPI program below, invokes PTIM_start/stop subroutines to time-instrument the "do_parallel_work" routine call:

     USE PTIM
     INTEGER :: ierr

     CALL MPI_INIT(ierr)
     ...
     call PTIM_start(LABEL="Parallel work")
       CALL do_parallel_work(...)
     call PTIM_stop(LABEL="Parallel work")
     ...
     CALL MPI_FINALIZE(ierr)

OUTPUT EXAMPLE

The table below is printed by PTIM_stop subroutine which resumes the timings collected from the instrumentation of a parallel MPI only section:

     Copyright (C) 2004, Jalel CHERGUI, IDRIS-CNRS FRANCE.
     PTIM (release 3.1) summary report of *** Parallel work ***

     Process Rank | Process CPU Time (s) | Process Elapsed Time (s) | CPU/Elapsed
     =============|======================|==========================|============
        0         |         21.400       |          21.399          |       1.000
        1         |          8.480       |          21.360          |        .397
        2         |          7.860       |          21.395          |        .367
        3         |          8.320       |          21.375          |        .389
     =============|======================|==========================|============
     Total        |         46.060       |          85.529          |       2.154
     Minimum      |          7.860       |          21.360          |        .367
     Maximum      |         21.400       |          21.399          |       1.000
     Average      |         11.515       |          21.382          |        .538
     =============|======================|==========================|============

     PTIM started on 05/11/2004 at 12:43:47 MET +01:00 from GMT
     PTIM stopped on 05/11/2004 at 12:44:08 MET +01:00 from GMT

SEE ALSO

PTIM_start

Back to the routines' list...


Last modified: Tue Dec 7 11:38:59 CET 2004