SPEC MPI2007 Documentation

To check for possible updates to the SPEC MPI2007 documentation, see www.spec.org/mpi2007/Docs. This index was updated 20 Oct 2009.

Suggested reading order:

If you are just getting started with SPEC MPI2007, here is a suggested reading order:

  1. Start with faq.html to get an overview of the suite and the process.

  2. Use system-requirements.html to help you choose which computer to use as your first test system.

  3. Once you've chosen the test system, install the suite, using install-guide-unix.html or install-guide-windows.html.

  4. Read at least the first part of runspec.html, because runspec is the primary tool in the suite. It is used to build the benchmarks, run them, and report on their results. You should read at least section 1 through section 3.1 of that document.

  5. After that, you can pick and choose which documents to read based on where your needs may take you. The list in the next section can help you decide. Note that the run rules will need to be studied carefully if you plan to quote results in public.

List of documents

The following documents are included on the SPEC MPI2007 DVD.

changes-in-v2.0.html

A summary of the changes that have been made in the second major release of MPI2007, Version 2.0.

config.html

SPEC MPI2007 provides benchmarks in source code form, which are compiled under control of SPEC's toolset. A config file controls how they are compiled, and also controls various settings for your tests. If you are new to the suite, you will probably start with an existing config file, such as one downloaded from www.spec.org/mpi2007. Eventually, you will either want to understand the details of what is inside that config file, or you will want to write your own. This document tells you how.

credits.html

Information about the contributors to SPEC MPI2007.

errata.html

Known problems and errata information.

faq.html

Frequently asked technical questions

flag-description.html

When the benchmarks are compiled, compilation flags (such as -O5 or -unroll) are detected and automatically reported by the tools. A flag description file helps the tools recognize such flags and describe them in reports. The tester is responsible for providing a flag description file to go with his or her config file. This document tells you how to write a flag description file.

Note that if you are just getting started with MPI2007, you may find that your starter config file already points to a valid flags description, via the config file flagsurl field.

install-guide-unix.html

How to install SPEC MPI2007 on Unix, Linx, and Mac OS X systems. Includes an example installation and an example of running the first benchmark.

install-guide-windows.html

How to install SPEC MPI2007 on Microsoft Windows systems. Includes an example installation and an example of running the first benchmark.

legal.html

Copyright notice and other legal information.

makevars.html

Advanced users of the suite who want to understand exactly how the benchmarks are built can use this file to help decipher the process.

runrules.html

The SPEC MPI2007 Run and reporting rules. These must be followed for generating publicly disclosed results. If you plan to quote results in public, you will need to study these rules carefully.

runspec.html

Information on the "runspec" command, which is the primary user interface for running SPEC MPI2007 benchmarks and reporting results.

runspec-avoidance.html

Some users prefer to avoid using the SPEC-supplied toolset, because they have specialized tasks that require more direct access to the benchmarks. Such tasks might include instrumenting the code, doing performance traces, or debugging an experimental compiler. This document describes how you can use SPEC's tools for the minimal purpose of just generating work directories, for use as a private sandbox.

sample-sysinfo-program.pl

A SPEC result includes a system description. If your system allows it, you may be able to automate part of the process of gathering a system description. This perl script provides an example of how that might be done. Note: some web browsers may refuse to open a file of type ".pl". If clicking on the link doesn't work, try saving the file and opening it with your favorite text editor.

system-requirements.html

A list of the hardware and software needed in order to run the SPEC MPI2007 suite.

techsupport.html

Information on SPEC technical support.

tools-build.html

How to build (or re-build) the tools such as runspec

utility.html

How to use various utilities, such as specinvoke, specdiff, and specmake.

Benchmark Documentation

Benchmark Suite Language Application domain
104.milc medium C Physics: Quantum Chromodynamics (QCD)
107.leslie3d medium Fortran Computational Fluid Dynamics (CFD)
113.GemsFDTD medium Fortran Computational Electromagnetics (CEM)
115.fds4 medium C/Fortran Computational Fluid Dynamics (CFD)
121.pop2 medium,large C/Fortran Ocean Modeling
122.tachyon medium,large C Graphics: Parallel Ray Tracing
125.RAxML large C DNA Matching
126.lammps medium,large C++ Molecular Dynamics Simulation
127.wrf2 medium C/Fortran Weather Prediction
128.GAPgeofem medium,large C/Fortran Heat Transfer using Finite Element Methods (FEM)
129.tera_tf medium,large Fortran 3D Eulerian Hydrodynamics
130.socorro medium C/Fortran Molecular Dynamics using Density-Functional Theory (DFT)
132.zeusmp2 medium,large C/Fortran Physics: Computational Fluid Dynamics (CFD)
137.lu medium,large Fortran Computational Fluid Dynamics (CFD)
142.dmilc large C Physics: Quantum Chromodynamics (QCD)
143.dleslie large Fortran Computational Fluid Dynamics (CFD)
145.lGemsFDTD large Fortran Computational Electromagnetics (CEM)
147.l2wrf2 large C/Fortran Weather Prediction

Some individual benchmark in the suite have additional documents, found in the benchmark "Docs" subdirectory on your installed benchmark tree, or on the MPI2007 distribution media. For example, additional information about 137.lu may be found in:

$SPEC/benchspec/MPI2007/137.lu/Docs/137.lu.html (Unix)
or
%SPEC%\benchspec\MPI2007\137.lu\Docs\137.lu.html (Windows)

Redistributable Sources

On the SPEC distribution media (DVD), you will find:

redistributable_sources/README      Information about freely-available sources
                                    that have been incorporated in SPEC MPI2007

Copyright © 2007-2010 Standard Performance Evaluation Corporation
All Rights Reserved