This document provides information about the Coarray ICAR program.

• Installation and testing
• System requirements
• Generating documentation

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.

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

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

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).

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)

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 &