PMTM

PMTM Documentation

The Performance Modelling Timing Module (PMTM) is a timing library that was created to support cross platform timing. Currently, most of the tested platforms are POSIX compliant x86 architectures, however it is planned to port the library to other architectures such as IBM BlueGene.

As well as providing a standardised timing library across multiple platforms the PMTM library also outputs into an easy to parse Comma Separated (.pmtm) file, which can be opened using a standard spreadsheet application such as Microsoft Excel or OpenOffice/LibreOffice Calc) or can be imported into an ichnaea database via the Performance Modelling Analysis Tool (PMAT) into the database used to store and analyse the performance modelling results.

PMTM can also output parameter information, allowing for the values of parameters to be logged for a single rank or for all ranks, as well as other options, such as only logging the parameter if it changes during a run.

Usage

• [Initialising and Finalising]
  • [PMTM_init]
  • [PMTM_create_instance]
  • [PMTM_initialized]
  • [PMTM_finalize]
  • [PMTM_destroy_instance]
• [Timer Setup]
  • [PMTM_create_timer_group]
  • [PMTM_create_timer]
  • [PMTM_set_sample_mode]
• [Timer Control]
  • [PMTM_timer_start]
  • [PMTM_timer_stop]
  • [PMTM_timer_pause]
  • [PMTM_timer_continue]
• [Outputting Timers]
  • [PMTM_timer_output]
  • [PMTM_get_cpu_time]
  • [PMTM_get_last_cpu_time]
  • [PMTM_get_total_cpu_time]
  • [PMTM_get_wc_time]
  • [PMTM_get_last_wc_time]
  • [PMTM_get_total_wc_time]
• [Outputting Parameters]
  • [PMTM_parameter_output]
• [Outputting the Environment]
  • [PMTM_set_option]
  • [Outputting Specific Environment Variables]
• [Miscellaneous Routines]
  • [PMTM_get_error_message]
  • [PMTM_log_flags]
  • [PMTM_set_file_name]
• [PMTM Constants]
• PMTM [error codes]
• [Examples]
  • [Fortran]
  • [C or C++]
  • [Fortran Timers Module]
  • [OpenMP Fortran]
  • [OpenMP C or C++]
  • [OpenMP Fortran Timers]