Skip to main content

Loop Kernel Analysis and Performance Modeling Toolkit

Project description

kerncraft

Loop Kernel Analysis and Performance Modeling Toolkit

This tool allows automatic analysis of loop kernels using the Execution Cache Memory (ECM) model, the Roofline model and actual benchmarks. kerncraft provides a framework to investigate the data reuse and cache requirements by static code analysis. In combination with the Intel IACA tool kerncraft can give a good overview of both in-core and memory bottlenecks and use that data to apply performance models.

For a detailed documentation see publications in doc/.

https://travis-ci.org/RRZE-HPC/kerncraft.svg?branch=master https://codecov.io/github/RRZE-HPC/kerncraft/coverage.svg?branch=master Code Health

Installation

On most systems with python pip and setuputils installed, just run: pip install --user kerncraft for the latest release.

If you want to build from source: Clone this repository and run python ./setup.py install.

If you are unfamiliar with python, here is a tutorial on how to install python packages: https://packaging.python.org/installing/ . The use of virtual enviornments is usually a good choice.

Additional requirements are:

Usage

  1. Get an example kernel and machine file from the examples directory

wget https://raw.githubusercontent.com/RRZE-HPC/kerncraft/master/examples/machine-files/phinally.yaml

wget https://raw.githubusercontent.com/RRZE-HPC/kerncraft/master/examples/kernels/2d-5pt.c

  1. Have a look at the machine file and change it to match your targeted machine (above we downloaded a file for a Sandy Bridge EP machine)

  2. Run kerncraft

kerncraft -p ECM -m phinally.yaml 2d-5pt.c -D N 10000 -D M 10000 add -vv for more information on the kernel and ECM model analysis.

Credits

Implementation: Julian Hammer ECM Model (theory): Georg Hager, Holger Stengel, Jan Treibig LC generalization: Julian Hammer

License

AGPLv3

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kerncraft-0.5.0.tar.gz (169.5 kB view hashes)

Uploaded Source

Built Distributions

kerncraft-0.5.0-py3-none-any.whl (180.6 kB view hashes)

Uploaded Python 3

kerncraft-0.5.0-py2-none-any.whl (180.6 kB view hashes)

Uploaded Python 2

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page