kgen's Introduction

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 ([email protected]).

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

Download from KGen Github repository.

>> git clone https://github.com/NCAR/KGen.git
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

Recommend Projects