Suzaku Pattern Parallel Programming Framework

June 2, 2018
B. Wilkinson
abw@uncc.edu

Suzaku is a pattern parallel programming framework developed at UNC-Charlotte that enables programmers to create pattern-based MPI programs without actually writing MPI message passing code implicit in the patterns. The purpose of this framework is to simplify message passing programming and create better structured and scalable programs based upon established parallel design patterns. Our work focuses on teaching parallel programming using a pattern progaramming approach. Suzaku can be used to teach parallel programming before (or after) learning MPI. The structure of Suzaku programs is intentionally modeled on the thread-based OpenMP often taught in parallel programming courses, but using message-passing processes rather than threads. A Virtualbox virtual machine is provided with all the software and sample programs pre-installed so that you can try the Suzaku framework out very easily and use in a classroom setting:

ParallelProg-32.ova (Note 2.4 GB+) Documentation on using our virtual machines: Parallel Programming Software

This work is supported by the National Science Foundation. For more information see: Pattern Programming Project. We welcome anyone who would like to develop the concepts further or use the materials in their classes. For educational use only. Please acknowledge any materials used and contact Barry Wilkinson (abw@uncc.edu) if you need additional information. Thank you.

Suzaku Pattern Programming Framework Specification

• 1 - Suzaku structure and low level patterns
• 2 - Workpool Version 1
• 3 - Workpool Version 2 (using put and get)
• 4 - Workpool Version 3 (dynamic workpool)
• 5 - Pipeline Pattern
• 6 - Generalized Patterns

Suzaku Source Files

• suzaku.h
• suzaku.c

Sample Programs

1. Using low-level message passing patterns

• SZ_pt-to-pt.c
• SZ_collective.c
• SZ_matrixmult.c
• SZ_Nbody.c *

2. Workpool version 1

• MontePi_workpool.c
• matrixmult_workpool.c
• Nbody_workpool.c*

3. Workpool version 2

• test_workpool2.c
• matrixmult_workpool2.c
• blkmatrixmult_workpool2.c *

4. Workpool version 3

• test1_workpool3.c
• shortpath_workpool3.c

5. Pipeline patterns

• pipeline_sort.c

6. Generalized patterns

• pattern_test.c (all-to-all test)
• gen_pipeline_sort.c
• gen_heat.c
• gen_connect_test.c

Sequential programs

• shortestpath.c
• Nbody.c *
• NbodyG.c *

makefile

X11Macros.h

* Programs not posted because they are set as student programming assignments. Avaliable to instructors.

Spring 2016 Powerpoint slides
• Introduction to Patterns
• Suzaku framework
• Suzaku workpool version 2

Spring 2016 Suzaku assignment
• Assignment 5 (Undergraduate)
• Assignment 5 (Graduate)
• Demo

Fall 2014 Class Video (Drs. C Ferner and B Wilkinson)
• Lecture 10 - Introduction to patterns and Suzaku. Note: There are significant improvements in the Suzaku specification and implementation after 2014, see the Spring 2016 powerpoint slides and Assignment 5. The Suzaku specification gives the most up-to-date details.