Merge pull request #721 from jgphpc/intel_advisor

[test] Add Intel Advisor Roofline test

cscs-checks/tools/profiling_and_debugging/intel_advisor_roofline.py

@@ -0,0 +1,161 @@
+import os
+
+import reframe as rfm
+import reframe.utility.sanity as sn
+
+
+@rfm.required_version('>=2.14')
+@rfm.parameterized_test(*[[repeat, toolsversion, datalayout]
+                          for repeat in ['50000']
+                          for toolsversion in ['551025']
+                          for datalayout in ['G3_AOS_SCALAR', 'G3_SOA_SCALAR',
+                                             'G3_AOS_VECTOR', 'G3_SOA_VECTOR',
+                                             'G3_SOA_VECTOR_FMAS']])
+class IntelRooflineTest(rfm.RegressionTest):
+    '''This test checks the values reported by Intel Advisor's roofline model:
+    https://software.intel.com/en-us/intel-advisor-xe
+
+    The roofline model is based on GFLOPS and Arithmetic Intensity (AI):
+      "Self GFLOPS" = "Self GFLOP" / "Self Elapsed Time"
+      "Self GB/s" = "Self Memory GB" / "Self Elapsed Time"
+      "Self AI" = "Self GFLOPS" / "Self GB/s"
+
+    While a roofline analysis flag exists ('advixe-cl -collect roofline'), it
+    may not be used to collect data on MPI applications; in that case, the
+    survey and flops analysis must be collected separately: first run a survey
+    analysis ('advixe-cl -collect survey') and then run a tripcounts+flops
+    analysis ('advixe-cl -collect tripcounts -flop') using the same project
+    directory for both steps.
+    '''
+    def __init__(self, repeat, toolsversion, datalayout):
+        super().__init__()
+        self.descr = 'Roofline Analysis test with Intel Advisor'
+        self.valid_systems = ['daint:mc', 'dom:mc']
+        # Reporting MFLOPS is not available on Intel Haswell cpus, see
+        # https://www.intel.fr/content/dam/www/public/us/en/documents/manuals/
+        # 64-ia-32-architectures-software-developer-vol-1-manual.pdf
+        self.valid_prog_environs = ['PrgEnv-intel']
+        self.prgenv_flags = {
+            'PrgEnv-intel': ['-O2', '-g', '-std=c++11'],
+        }
+        self.sourcesdir = os.path.join(self.current_system.resourcesdir,
+                                       'roofline', 'intel_advisor')
+        self.build_system = 'Make'
+        self.prebuild_cmd = [
+            'sed -e "s-XXXX-%s-" -e "s-YYYY-%s-" %s &> %s' %
+            (repeat, datalayout, 'roofline_template.cpp', '_roofline.cpp')
+        ]
+        self.num_tasks = 1
+        self.num_tasks_per_node = 1
+        self.num_cpus_per_task = 1
+        self.variables = {
+            'OMP_NUM_THREADS': str(self.num_cpus_per_task),
+            'CRAYPE_LINK_TYPE': 'dynamic',
+        }
+        self.pre_run = [
+            # Testing with advisor/2018 Update 2 (build 551025):
+            #   advisor/2019 is broken on dom ("Exceeded job memory limit"),
+            #   and advisor/2019 is not installed on daint,
+            'source $INTEL_PATH/../advisor_2018/advixe-vars.sh',
+            'advixe-cl -help collect | head -20',
+        ]
+        self.executable = 'advixe-cl'
+        self.target_executable = './roof.exe'
+        self.roofdir = './roof.dir'
+        self.executable_opts = [
+            '--collect survey --project-dir=%s --search-dir src:rp=. '
+            '--data-limit=0 --no-auto-finalize --trace-mpi -- %s ' %
+            (self.roofdir, self.target_executable)
+        ]
+        self.version_rpt = 'Intel_Advisor_version.rpt'
+        self.roofline_ref = 'Intel_Advisor_roofline_reference.rpt'
+        self.roofline_rpt = 'Intel_Advisor_roofline_results.rpt'
+        # Reference roofline boundaries for Intel Broadwell CPU (E5-2695 v4):
+        L1bw = 293*1024**3
+        L2bw = 79*1024**3
+        L3bw = 33*1024**3
+        DPfmabw = 49*1024**3
+        DPaddbw = 12*1024**3
+        ScalarAddbw = 3*1024**3
+        self.sanity_patterns = sn.all([
+            # check the job status:
+            sn.assert_found('loop complete.', self.stdout),
+            # check the tool's version:
+            sn.assert_eq(sn.extractsingle(
+                r'I*.\(build\s(?P<toolsversion>\d+)\s*.',
+                self.version_rpt, 'toolsversion'), toolsversion),
+            # --- roofline boundaries:
+            # check --report=roofs (L1 bandwidth):
+            sn.assert_reference(sn.extractsingle(
+                r'^L1\sBandwidth\s\(single-threaded\)\s+(?P<L1bw>\d+)\s+'
+                r'memory$', self.roofline_ref, 'L1bw', int),
+                L1bw, -0.08, 0.08),
+            # check --report=roofs (L2 bandwidth):
+            sn.assert_reference(sn.extractsingle(
+                r'^L2\sBandwidth\s\(single-threaded\)\s+(?P<L2bw>\d+)\s+'
+                r'memory$', self.roofline_ref, 'L2bw', int),
+                L2bw, -0.08, 0.08),
+            # check --report=roofs (L3 bandwidth):
+            sn.assert_reference(sn.extractsingle(
+                r'^L3\sBandwidth\s\(single-threaded\)\s+(?P<L3bw>\d+)\s+'
+                r'memory$', self.roofline_ref, 'L3bw', int),
+                L3bw, -0.08, 0.08),
+            # check --report=roofs (DP FMA):
+            sn.assert_reference(sn.extractsingle(
+                r'^DP Vector FMA Peak\s\(single-threaded\)\s+'
+                r'(?P<DPfmabw>\d+)\s+compute$', self.roofline_ref,
+                'DPfmabw', int), DPfmabw, -0.08, 0.08),
+            # check --report=roofs (DP Add):
+            sn.assert_reference(sn.extractsingle(
+                r'^DP Vector Add Peak\s\(single-threaded\)\s+'
+                r'(?P<DPaddbw>\d+)\s+compute$', self.roofline_ref,
+                'DPaddbw', int), DPaddbw, -0.08, 0.08),
+            # check --report=roofs (Scalar Add):
+            sn.assert_reference(sn.extractsingle(
+                r'^Scalar Add Peak\s\(single-threaded\)\s+'
+                r'(?P<ScalarAddbw>\d+)\s+compute$', self.roofline_ref,
+                'ScalarAddbw', int), ScalarAddbw, -0.08, 0.08),
+            # --- check Arithmetic_intensity:
+            sn.assert_reference(sn.extractsingle(
+                r'^returned\sAI\sgap\s=\s(?P<Intensity>.*)', self.roofline_rpt,
+                'Intensity', float), 0.0, -0.01, 0.01),
+            # --- check GFLOPS:
+            sn.assert_reference(sn.extractsingle(
+                r'^returned\sGFLOPS\sgap\s=\s(?P<Flops>.*)', self.roofline_rpt,
+                'Flops', float), 0.0, -0.01, 0.01),
+        ])
+        self.maintainers = ['JG']
+        self.tags = {'production'}
+
+    def setup(self, partition, environ, **job_opts):
+        super().setup(partition, environ, **job_opts)
+        environ_name = self.current_environ.name
+        prgenv_flags = self.prgenv_flags[environ_name]
+        self.build_system.cxxflags = prgenv_flags
+        launcher_cmd = ' '.join(self.job.launcher.command(self.job))
+        self.post_run = [
+            # collecting the performance data for the roofline model is a 2
+            # steps process:
+            '%s %s --collect tripcounts --flop --project-dir=%s '
+            '--search-dir src:rp=. --data-limit=0 --no-auto-finalize '
+            '--trace-mpi -- %s' %
+            (launcher_cmd, self.executable, self.roofdir,
+             self.target_executable),
+            # check tool's version:
+            'advixe-cl -V &> %s' % self.version_rpt,
+            # "advixe-cl --report" looks for e000/ in the output directory;
+            # if not found, it will fail with:
+            # IOError: Survey result cannot be loaded
+            'cd %s;ln -s nid* e000;cd -' % self.roofdir,
+            # report reference values/boundaries (roofline_ref):
+            'advixe-cl --report=roofs --project-dir=%s &> %s' %
+            (self.roofdir, self.roofline_ref),
+            'python2 API/cscs.py %s &> %s' % (self.roofdir, self.roofline_rpt),
+            # 'advixe-cl --format=csv' seems to be not working (empty report),
+            # keeping as reference for a future check:
+            #   'advixe-cl --show-all-columns -csv-delimiter=";"'
+            #   ' --report=tripcounts --format=csv --project-dir=%s &> %s'
+            # This can be used instead (see advisor/config/report/roofs.tmpl):
+            #   'advixe-cl --report custom --report-template ./TEMPL/cscs.tmpl'
+            #   ' --project-dir=%s &> %s'
+        ]