/KGen

Fortran Kernel Generator

Primary LanguageFortranOtherNOASSERTION

KGEN: Fortran Kernel Generator

A Python tool that extracts partial codes out of a large Fortran application and converts them into a standalone/verifiable/executable kernel

AUTHORS:Youngsung Kim and John Dennis
VERSION:0.8.0
COPYRIGHT:See the document entitled LICENSE.txt

Send questions and comments to KGEN Dev. Team (kgen@ucar.edu).

Documentation

https://ncar.github.io/kgendocs
Discussion-group
https://groups.google.com/forum/#!forum/kgen-discuss

Changes from KGEN ver. 0.7.2

[ User Interface ]

  • "--invocation" option is changed from mandatory to optional
  • "--repr-etime", "--repr-papi", and "--repr-code" options are added for representative extensions
  • "--state-clean", "--state-build", and "--state-run" options are discarded.

[ Major Improvements ]

KGen measures three types of characteristics from original application and generates kernel and input data in a way to reprouce the types of characteristics in generated kernel.

Overview

  • KGEN extracts an arbitrary region of Fortran source code as a stand-alone executable software
  • In addition, it generates input & output data for executing and verifying the generated kernel
  • All KGEN-generated kernels include correctness check and timing measurement

Dependencies

  • Linux OS
  • Python (>=2.7 and < 3.0)
  • C Pre-Processor(cpp)
  • Make build tool(make)
  • System call trace tool(strace)
  • Stream Editor (sed)

Obtaining the Source Code

The latest KGEN can be obtained from the Git repository.

git clone https://github.com/NCAR/KGen.git

Building & Installation

Current KGEN does not require to build or to install.

Instructions & Use

  1. Download from KGen Github repository.

    >> git clone https://github.com/NCAR/KGen.git

  2. Try a kernel generation example in "examples/simple" directory

    >> cd examples/simple; # move to an example directory

    >> vi src/Makefile; # Modify FC if required

    >> make; # extract a kernel

    >> cd kernel; # move to a kernel directory

    >> make; # build and run a kernel