Skip to content

Latest commit

 

History

History
80 lines (59 loc) · 2.45 KB

README.md

File metadata and controls

80 lines (59 loc) · 2.45 KB
Raw

Coarray ICAR

National Center for Atmospheric Research

This document provides information about the Coarray ICAR program.

CONTENTS

Installation and testing

The first execution creates three *.dat files and takes about 30 minutes using 4 cores inside a Lubuntu Linux virtual machine. Subsequent executions will read the *.dat files and execute run much faster than the first run.

Installation and execution via fpm:

$ fpm test --compiler caf --runner "cafrun -n 4" --target test-ideal

which will run the test-ideal executable program in 4 images.

Build options

Append --profile debug --flag -DNO_ASSERTIONS=ON to the above fpm command to turn off runtime checking of assertions. Including assertions enhances the runtime error checking at a significant cost (factor of 2 in runtime).

System requirements

The following operating systems are supported:

  • Windows 10 Ubuntu Subsystem for Linux beta
  • Linux
  • macOS

The following compilers are supported:

  • Intel Fortran Compiler Version 16.0.0 or later
  • GNU Fortran Compiler Version 6.3.0 (a regression prevents the use of later versions)
  • Cray Fortran Compiler (untested)

The following build software is supported:

  • The Fortran Package Manager (fpm)

Generating documentation

Install the FORD Fortran documentation generator and type

  ford doc-generator.md

which will create doc/ subdirectory containing HTML files. Open doc/index.html for the Coarray ICAR documentation. On Linux, you might exeute the following at the command prompt:

  firefox doc/index.html &