pyotter 0.1.1

Otter post-processing tool

pyotter - The post-processing package for Otter

This is the post-processing package for use with Otter - please see the main Otter repo for details.

Getting Started

Prerequisites

The following dependencies should be installed before installing pyotter:

• OTF2 v2.3
• python-igraph v0.9.1

Installing pyotter

To install pyotter from github:

git clone https://github.com/adamtuft/pyotter.git && cd pyotter
git checkout main
pip install .

To install from PyPi:

pip install pyotter

Using pyotter

A trace recorded by Otter can be converted into a graph in graph.dot with:

python3 -m otter my-otter-trace/my-otter-trace.otf2 -o graph.dot

The graph, saved to graph.dot, can then be visualised using the dot command line tool included with Graphviz or a graph visualisation tool such as yEd-Desktop or yEd-Live.

Future Work

The future direction of development may include, in no particular order:

• Visualise actual work done per task.
• Automatic detection of the critical path.
• Support for MPI+OpenMP applications.
• Support for GPU-offloaded tasks.
• Stronger graph visualisation capabilities.

Contributing

Contributions are welcome! If you would like to contribute, please fork the repository and use the contributions branch. There is no specific style guide, although I would be grateful if you could code in a style consistent with that of the main project.

Issues, Questions and Feature Requests

Please post any of the above in the main Otter repo so as to keep everything in one place.

Licensing

pyotter is released under the BSD 3-clause license. See LICENSE for details.

Copyright (c) 2021, Adam Tuft All rights reserved.

Acknowledgements

pyotter was conceived and developed as the subject of a final project and dissertation for the the Scientific Computing and Data Analysis MSc (MISCADA) at Durham University, UK. The author is grateful for the guidance and support of his supervisor Prof. Tobias Weinzierl and for the invaluable assistance provided by Dr. Holger Schulz.