Changes between Version 3 and Version 4 of doc/app/recommended_compiler_options

Timestamp:

Aug 23, 2018 3:23:12 PM (6 years ago)

Author:

raasch

Comment:

--

doc/app/recommended_compiler_options

@@ -8 +8 @@
 Compilers currently used by the PALM group are Intel, Cray, PGI and GNU-Fortran. We recommend to use these compilers with the following options (library and include-file options are omitted here):
 
-'''Intel (version 14 and higher) for optimized code:'''\\{{{-fpe0 -O3 -xHost -fp-model source -ftz -no-prec-div -no-prec-sqrt -ip}}}
+'''Intel (version 14 and higher) for optimized code:'''\\\\{{{ifort  -fpp -fpe0 -O3 -xHost -fp-model source -ftz -no-prec-div -no-prec-sqrt -ip}}}
 
 ||='''Option''' =||='''meaning''' =||
 |-----------
+||-fpp             ||Runs the Fortran preprocessor on source files before compilation.  ||
 ||-fpe0            ||Specifies the floating-point exception handling level. Floating-point invalid, divide-by-zero, and overflow exceptions are enabled. If any such exceptions occur, execution is aborted. This option causes denormalized floating-point results to be set to zero.  ||
 ||-O3              ||Performs O2 optimizations and enables more aggressive loop transformations such as Fusion, Block-Unroll-and-Jam, and collapsing IF statements.  ||
@@ -21 +22 @@
 ||-ip              ||Enables additional interprocedural optimizations for single-file compilation. ||
 |----------
+
+\\\\
+'''Intel (version 14 and higher) for debugging:'''\\\\{{{ifort  -fpp -fpe0 -O0 -check -check nooutput_conversion -traceback -g}}}
+
+
+||='''Option''' =||='''meaning''' =||
+|-----------
+||-O0              ||Disables all optimizations.  ||
+||-check           ||All available runtime checks (e.g. array bounds) are switched on.  ||
+||-check nooutput_conversion ||No checking for the fit of data items within a designated format descriptor field. '''If this option isn't set, compilation aborts with errors.'''  ||
+||-traceback       ||Tells the compiler to generate extra information in the object file to provide source file traceback information when a severe error occurs at run time.  ||
+||-g               ||Tells the compiler to generate full debugging information in the object file.  ||
+
+
+
+\\\\
+'''Cray (version 8.5.6):'''\\\\{{{ftn  -eZ -em -O3 -hnoomp -hnoacc -hfp3 -hdynamic -dynamic}}}
+
+
+||='''Option''' =||='''meaning''' =||
+|-----------
+||-eZ                 ||Perform source preprocessing and compilation on Fortran source files.  ||
+||-em                 ||When this option is enabled, the compiler creates .mod files to hold module information for future compiles.  ||
+||-O3                 ||Switch on most aggressive optimization level.  ||
+||-hnoomp             ||Disable compiler recognition of OpenMP directives.  ||
+||-hnoacc             ||Disables the compiler recognition of OpenACC accelerator directives.  ||
+||-hfp3               ||Controls the level of floating point optimizations. (highest level would be -hfp4)  ||
+||-hdynamic -dynamik  ||Directs the compiler driver to link dynamic libraries at runtime.  ||
+
+
+
+\\\\
+'''Cray (version 8.5.6) for debugging:'''\\\\{{{ftn  -eZ -K trap=fp -eD -ei -em -O0 -hnoomp -hnoacc -hdynamic -dynamic}}}
+
+
+||='''Option''' =||='''meaning''' =||
+|-----------
+||-K trap=fp          ||Enable traps on divz, inv, or ovf exceptions.  ||
+||-eD                 ||Enables all debugging options.  ||
+||-ei                 ||Initializes all undefined local stack, static, and heap variables of type REAL or COMPLEX to an invalid value (signaling NaN).  ||
+||-O0                 ||Disables all optimizations including floating point optimizations and OpenACC acceleration.  ||
+
+'''Important on Cray-systems:'''  Getting tracebacks requires setting of {{{export ATP_ENABLED=1}}} before execution of PALM. Use an input command in the configuration file for that:
+{{{
+IC:export ATP_ENABLED=1
+}}}