CLAW Compiler for Performance Portability
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
cmake
compiler
cx2t
documentation
driver
modules
omni-compiler @ 95e1bf9
resources
scripts
test
.gitignore
.gitmodules
.travis.yml
CHANGELOG.md
CMakeLists.txt
CONTRIBUTING.md
INSTALL.md
INSTALL_Ant.md
ISSUE_TEMPLATE.md
LICENSE
PULL_REQUEST_TEMPLATE.md
README.dev.md
README.md
properties.cmake
sonar-project.properties

README.md

CLAW Logo

Version Build Status Slack Doc

CLAW-Language-spec

Who is in charge here?

The CLAW!

The CLAW is our master.

The CLAW chooses who will go and who will stay.

-- Buzz Lightyear & Two Green Aliens in the UFO Catcher.

What is the CLAW Compiler?

The CLAW Compiler is a source-to-source translator working on the XcodeML intermediate representation. It implements the necessary transformation to the CLAW Directive Language Specifications. Intent of this language is to achieve performance portability on weather and climate code, especially for column- or point-wise computation.

CLAW Directive Language Specifications

The directives that control the transformation flow are defined in the CLAW Directive Language Specification.

Compiler workflow

The diagram below shows the workflow of the CLAW Compiler. CLAW Compiler workflow

Key components:
  • FPP: standard preprocessor.
  • OMNI F_Front: FORTRAN front-end. Convert FORTRAN source code into an intermediate representation (XcodeML/F).
  • CLAWX2T: CLAW XcodeML to XcodeML translator.
  • OMNI F_Back: FORTRAN back-end. Generates FORTRAN code from XcodeML/F intermediate representation.
  • OMNI C_Back: C back-end. Generates C code from XcodeML/C intermediate representation.

CLAWX2T Java Library Stack Overview

CLAWX2T Library stack

The CLAW XcodeML to XcodeML translator library stack is divided in three distinct library:

  • CLAW-WANI: CLAW translator implementation with all high-level transformation as well as mechanism to plug external translator and transformation.
  • CLAW-SHENRON: Define the super classes for any translator or transformation implementation.
  • CLAW-TATSU: Define the interface between XcodeML IR and the translation library. Implements all primitive transformations that serve as higher-level transformation building block.

How to install

See INSTALL.md file.

Documentation

To generate the java documentation and the compiler documentation, run the following command. The compiler documentation require pdflatex.

The compiler documentation is generated in the /documentation directory, the developer's guide is generated in the /documentation/developer directory and the javadoc is generated in the /documentation/javadoc/ directory.

make doc

Supported version

The CLAW XcodeML to XcodeML translator is written in Java. Java version 7 and above are supported.

OMNI Compiler

The CLAW Compiler is built on the top of the OMNI Compiler. For more information: OMNI Compiler website

About

This work was initially funded by the ETH zürich and the PASC initiative under the ENIAC project.


Logo by adrienbachmann.ch