计算精度分析

命令功能

定位x86和鲲鹏平台上Fortran语言的精度差异。

命令格式

编译插桩：

1

devkit advisor precision [-h | --help] {-instrument | --instrument} {-c COMMAND COMMANDS | --commands COMMANDS} {-p PROJECT | --project PROJECT} {-e ENTRY | --entry ENTRY} [-d DEPTH | --depth DEPTH] [-b BLACK_LIST | --black-list BLACK_LIST] [-L | --loops] [-l {0,1,2,3} | --log-level {0,1,2,3}] [--set-timeout TIMEOUT]

日志差异分析：

1

devkit advisor precision [-h | --help] {-analysis | --analysis} {-i INPUT_LOG | --input INPUT_LOG} [-l {0,1,2,3} | --log-level {0,1,2,3}] [--set-timeout TIMEOUT]

参数说明

使用示例

此处以扫描“/home/test/demo1”路径下源码文件为例，编译命令为cmake ..、make，请根据实际情况进行修改。

demo1文件目录结构：

1
2
3
4
5
6

demo1
├── build
├── CMakeLists.txt
├── funcparam_utils.f90
├── shape_utils.f90
└── test.f90

1. 分别在鲲鹏环境和x86环境的项目目录下运行编译插桩操作。

   1 2 3

   cd /home/test/demo1/build cmake .. devkit advisor precision -instrument -c make -p /home/test/demo1 -e test.f90:main -d 1

   回显信息如下：

   1 2 3 4 5 6 7

   Perform the instrumentation and compilation mode. Finish run precision check tool. For detail logs on the tool, see /Absolute-Path-to-DevKit-CLI/advisor/logs/preccheck.log and /home/test1/demo1/build/precision_20241106111820_6193.txt Please check whether error information exists in above two files to ensure that the project can run properly. Before running the project to get the log file, please add: 1) the libcorrect.mod file path: export LD_LIBRARY_PATH=/Absolute-Path-to-DevKit-CLI/advisor/devkitplugins/affinity/tools/compileopt/libcruiser/gfortran_lib(or flang_lib):$LD_LIBRARY_PATH 2) the log file path: export CRUISER_LOG=/absPATH/

   

   • 在执行编译插桩模式前，必须保证项目是未编译过的，否则在增量编译的情况下，编译命令获取不完整，会导致程序执行失败。
   • “/Path_to_Devkit_CLI/”：DevKit命令行工具路径。
   • -p指定项目源码路径（“/home/test1/demo1/”），-e参数指定项目源码路径下的插桩入口文件和对应的函数（test.f90:main）。
   • 执行编译插桩后，会在插桩入口文件所在路径下生成同名的.bak文件（test.f90.bak），会在“build”目录下生成可执行文件。
   • 编译插桩模式下txt文件中若有Error相关信息，请参见计算精度分析编译插桩模式下txt文件中显示Error的解决方法进行处理。

2. 在鲲鹏和x86环境下重新运行编译后的可执行文件。
   1. 根据编译器类型添加对应的libcruiser库路径。
      gfortran：

      export LD_LIBRARY_PATH=/Path_to_Devkit_CLI/advisor/devkitplugins/affinity/tools/compileopt/libcruiser/gfortran_lib:$LD_LIBRARY_PATH

      flang：

      export LD_LIBRARY_PATH=/Path_to_Devkit_CLI/advisor/devkitplugins/affinity/tools/compileopt/libcruiser/flang_lib:$LD_LIBRARY_PATH

   2. 添加生成日志文件路径。

      export CRUISER_LOG=/LOGPATH/

      

      “/LOGPATH/”：生成的日志文件存放路径。

   3. 运行可执行文件。

      ./myprogram

      运行可执行文件后若有以下输出信息，表示日志文件所在路径磁盘空间已不满足1G，请清理磁盘空间。

      1	[ERROR] Insufficient disk space in /home/test1/, please clean up the disk.

      

      myprogram：生成的可执行文件。

      生成日志时请注意磁盘空间大小。

   4. 查看生成的cruiser.log日志文件，日志内容如下：

      1 2 3 4 5 6

      shape_utils.f90|absize|=|28|ins|998058|429d81ed2795e3c586906c6c335aa136 shape_utils.f90|absize|=|28|ins|998058|429d81ed2795e3c586906c6c335aa136 test.f90|main|absize|26|array1d|998058|22160b46bba283274412c4033f1f33fe shape_utils.f90|absize|=|28|ins|998058|429d81ed2795e3c586906c6c335aa136 test.f90|main|xysize|35|x2|998058|5d5ebe7707f02dec747fd0d111d0f83c test.f90|main|submain|41|array1d|998058|22160b46bba283274412c4033f1f33fe

      

      日志文件中的内容解释：

      1. 第一部分：文件名。
      2. 第二部分：第三部分内容表达式语句所在的当前最小作用域名称，可能是函数、子例程或主程序。
      3. 第三部分：当插桩变量位于函数调用语句（作为函数参数）时，此处为被调用函数名；当插桩变量位于赋值语句时，此处为“=”号。
      4. 第四部分：行号。
      5. 第五部分：插桩变量名。
      6. 第六部分：线程ID。
      7. 第七部分：HASH值。

3. 在鲲鹏或x86平台上进行日志差异分析操作。
   将鲲鹏平台上生成的cruiser.log日志文件改名为cruiser_kp.log，x86平台上生成的cruiser.log日志文件改名为cruiser_x86.log，将其放到其中一个平台上。

   1	devkit advisor precision -analysis -i "/home/test1/cruiser_kp.log;/home/test1/cruiser_x86.log"

   回显信息如下：

   1 2 3 4

   Perform the logs analysis mode. Finish run precision check tool. For detail logs on the tool, see /Absolute-Path-to-DevKit-CLI/advisor/logs/preccheck.log The analysis result is in /home/test1/demo1/build/precision_20241106113405_5b7a.txt

4. 请查看3生成的txt文件，定位源码，查找精度问题。