pyatf 0.0.2

Auto-Tuning Framework (ATF) is a generic, general-purpose auto-tuning approach for programs whose tuning parameters may be constrained

pyATF: The Auto-Tuning Framework (ATF) in Python

Auto-Tuning Framework (ATF) is a generic, general-purpose auto-tuning approach that automatically finds well-performing values of performance-critical parameters (a.k.a. tuning parameters), such as sizes of tiles and numbers of threads. ATF works for programs written in arbitrary programming languages and belonging to arbitrary application domains, and it allows tuning for arbitrary objectives (e.g., high runtime performance and/or low energy consumption).

A major feature of ATF is that it supports auto-tuning programs whose tuning parameters have interdependencies among them, e.g., the value of one tuning parameter has to be smaller than the value of another tuning parameter. For this, ATF introduces novel process to generating, storing, and exploring the search spaces of interdependent tuning parameters (discussed in detail here).

ATF comes with easy-to-use user interfaces to make auto-tuning appealing also to common application developers. The Interfaces are based on either:

1. Domain-Specific Language (DSL), for auto-tuning at compile time (a.k.a. offline tuning) (discussed here);
2. General Purpose Language (GPL), for auto-tuning at runtime (a.k.a. online tuning), e.g., of C++ programs (referred to as cppATF, and discussed here) or Python programs (referred to as pyATF).

The full GitHub repository for pyATF, i.e., ATF with its GPL-based Python interface can be found here.

Documentation

The full documentation is available here.

Installation

pyATF requires Python 3.9+ and can be installed using pip:

pip install pyatf

pyATF's pre-implemented OpenCL and CUDA cost functions require additional packages to be installed:

• OpenCL cost function:

  pip install numpy pyopencl
  

  For the OpenCL cost function, a matching OpenCL runtime is also required, e.g., for Intel CPUs:

  pip install intel-opencl-rt
  

• CUDA cost function:

  pip install numpy cuda-python