Skip to content

tudasc/MPI-Corrbench

Repository files navigation

MPI-CorrBench 2.0.0 License visualize

MPI-CorrBench [CORRBE21] enables a structured comparison of the different available tools for MPI correctness checking w.r.t. various types of errors.

MPI-CorrBench is automatically executed by our CI pipeline. You can find the automatically generated visualizations in our Visualization Dashboard. for the MPI OpenMP testcases, the CI only executes one configuration for a better assesment it may be a good idea to execute it multiple times variing the amount of threads. For more detailes refer [HYBE22]

Usage

Provide the Following environment Variables:

  • MPI_CORRECTNESS_BM_DIR full path to the local directory of this repo
  • MPI_CORRECTNESS_BM_EXPERIMENT_DIR full path to the directory where the tools should be executed

Running the benchmarks

  • Adapt the SLURM configuration in scripts/SLURM_header.in
  • for each tool a script file scripts/<TOOL>/execute_tool.sh exists. You may need to adopt it to use the tool on your system
  • run scripts/run_measurement.sh 1 to generate the jobscript and submit them via sbatch (the argument given is the number of repetition for each test case)
  • after all jobs are finished use scripts/gather_results.sh to gather all the results, which will override previous data in output (such as our results)

Visualize the results

The visualizations presented in [CORRBE21] can be generated by the usage of the provided scripts. The scripts don't take any arguments and read the data in output to generate the visualization.

References

[CORRBE21] Lehr, Jan-Patrick and Jammer, Tim and Bischof, Christian: MPI-CorrBench: Towards an MPI Correctness Benchmark Suite 2021. https://dl.acm.org/doi/abs/10.1145/3431379.3460652
[HYBE22] Jammer, Tim and Hück, Alexander and Lehr, Jan-Patrick and Protze, Joachim and Schwitanski, Simon and Bischof, Christian: Towards a Hybrid MPI Correctness Benchmark Suite 2022. https://dl.acm.org/doi/10.1145/3555819.3555853