Changes

The Intel C++ Compiler is not the only tool that comes provides with IPS XE 2019. It also includes next applicationstools to do thread debugging:  [[File:XEVTuneLogo.jpg]]

[[File:Inspector VS.PNG| 700px]]

[[File:Inspector_app.PNG| 200px]] 

[[File:Inspector_01_init_windowInspector_03_Threading_analysis_startpage.PNG| 700px]]

Intel VTune amplifier is a analysis software that allows you the ability to measure performance of your serial or multithreaded program. VTune allows you to analyze the performance of your algorithms and multithreading. It can help with debugging threads by calculating overhead, finding bottlenecks or inefficiencies.

VTune can be ran as a stand alone program or Integrated with Visual Studio.  ==='''Starting VTune'''===When you hover over Intel VTune Amplifier 2019 in the tool’s menu. You will see more options appear.  Select the '''configure Analysis''' option. [[File:options.PNG | 400px]]  To see the different analysis's available to be ran with Vtune. Click on the three little dots circled in the below picture.  [[File:SetupOptions.PNG | 600px]]  This menu will appear, it contains different tests that you can run against your program. [[File:startup options.PNG | 400px]]  ==='''Demo'''===  The following is some code from the Matrix Multiplication exercise we did in lab3. It contains 2 versions of the “matMul” function.  Change the value of the version macro inside "MatMul.cpp" to run the different versions. *Version 1 – the matrix multiplication logic has been put inside a parallel for statement *Version 2 – the matrix multiplication logic is still inside the parallel for statement, but it is being dynamically scheduled and certain variables are selected to be private or shared.  '''[https://github.com/coreyjjames/CoreyJJames/tree/Lab3_VTune_Example Example Code]'''  To run the example code, copy the code into Visual Studio and Build it. - Run the program with VTune threading analysis. - The point of interest in the program is under the platform tab.  - You will notice in version 1 some of the threads finish before other's. The work is not being spread evenly. - In version 2, that issue is resolved all the threads end at the same time. When I ran Version 2 I saw around a 0.6s increase in performance. Important notes:*Run in Release X64, using OpenMP and Intel compiler.*Turn off optimization so you can see source code Hotspot's*Rebuild after any changes. ==='''Interpreting results'''===  Determining the results from VTune will be explaining how a different process for your program then mine.  To be successful make sure to read through the results and look for anomalies.  '''Example of anomalies:'''*Poor utilization of all the available threads.*Uneven distribution of the work across the threads.*High spin or overhead time.*thread's waiting for no reason.*Hotspots in the code '''VTune navigation bar (Depending on the Analysis):'''*Analysis configuration**Main configuration page for VTune*Collection log**Logs from the analysis*Summary**Display's relevant information about the analysis*Bottom-up**Allows you to se the call stack of a function starting from the first call.*Caller/Callee**Allows you to see details on each function and see callers and callees for each function *Top-down tree**Shows the call stack of the program as a tree starting from the top.*Platform**Displays the time and the utilization of each thread.  Note:*When reviewing results pay attention to use any red flags that are displayed beside results in VTune part . If you hover over them, it will give you more information.*Almost everything that is in the color red means their is a potential problem.*OpenMP integration, VTune does have native support for OpenMP some results are generated by VTune specifically for OpenMP. ---- =Intel® Advisor=Intel® Parallel Studio Advisor gives software architects and developers the data and analysis tools they need to build well-threaded and vectorized code that exploits modern hardware capabilities. ==='''Create a project'''===First of all you need to have Intel parallel XE 2019 installed on your machine it will allows you to have access to tools such as Intel Advisor, Vtune Amplifier and Inspector on top of the alongside your Visual Studio 2017window. Intel® Parallel  Lets start by creating a project on Visual Studio XE , I am using a sample code from Intel Advisor folder which they provide different samples for you to test the functionality of it. They can be found here: httpsunder <Your-Installed-Directory>\IntelSWTools\Advisor 2019\samples\en. I am using the "nqueens_Advisor" one. After choosing your project build the solution and look the following Icon from the image below [[File:Advisor.png|900px]] ==='''Configure the project'''===Before starting to play around with Intel Advisor, I encourage to set the optimazation of your project to O2 since it will speed up the analysis process on Intel Advisor which can be found under Debug > Properties > C/C++ > Optimization > Optimization > Maximize Speed (/softwareO2) Now, you can see from the left side of Intel Advisor window Vectorization Workflow and Threading Workflow.intelI will be guiding you on how to debug Thread using this tool so click on Threading Workflow [[File:Select.com/enpng|250px]]  ==='''How it works'''===For debugging Thread purpose we will have to run 2 analysis report in Intel Advisor -us/parallelThreading Workflow pane: Survey Target and Check Dependencies. * Survey Target gives you a report on how the threads are behaving and its run time on different calls so that you can try to improve it.* Check Dependencies gives you a report on the errors and problems that thread are causing so that you can know where they are and fixing it. '''First step is to Collect the Survey Target report by clicking "Collect"'''  [[File:Survey.png|250px]]  After Collecting the data for the report the following window will appear and there are 3 important things we should pay attention on  [[File:Collectsurvey.png|900px]]  '''1 -studio''' Here display the list of the most important functions and loops which took a large part of the total program run time and tells a bit of information about them at the same time giving you some suggestions on how to improve it '''2 -xe''' In this menu bar there are several options but the most important two are Source and Top Down.* Source shows the actual code of the selected function call or loop selected from the #1 window* Top Down shows all the run time of each calls and loop in your program which allows you to go more in detail with each of them  [[File:Top_Down.png|700px]]Once installed  '''3 -''' It is a dropdown list which shows you all the threads runned in this program which it is important in this case since we are focusing on debugging threads  '''Second step is running Check Dependecies'''For running Check Dependecies we should select one of the function call or loop from the first step from the following window  [[File:Drop.png|800px]]  Pay attention to the black water drop which indicates me that I have selected a loop or function for Annotation. This means that part of the code will be inside of an Annotation range specially for the analysis. This is a new feature since before it did not exist and we would have to go into the source code and add the Annotation range for the part of the code which we would like to analyze.  After selecting the loop or function for Annotation we will proceed to start the Check Dependecies  [[File:Dependency.png|200px]]  Starting Check Dependencies will take a bit longer than running the program so be able patient with it. After it is done the following window should appear.  [[File:No_lock.png|900px]]  '''1 -''' It displays the selected loop or function for Annotation and tells us the number of errors it contains. '''2 -''' Here is a very important window since it tells us in detail all the errors that needs to find VTune be fixed. '''3 -''' In this case I selected the P6 error and it tells me in which function it is in and the specific variable affected.  ==='''Fixing the problem'''===We have Identified that there are several problems from the Check Dependencies report lets try to fix one of them. From the "Dependecies Report - Problem and Messages" Window. right-click any data row and choose Edit Source to open the source file. It will bring you directly to the code of the selected problem. In my case I selected the previously selected error P6 and the error is because multiple tasks may try and increment nrOfSolutions at the same time. So by adding Lock into it can avoid the multiple access to the variable making it one by one with the tools tab inside Visual Studiofollowing way.  [[File:Lock.png|300px]]  After adding the lock, we build the solution again and re run the 2 analysis following the previous steps.This time we can notice that our Check Dependencies Report has changed  [[File:Tools_TabRefined.PNGpng|800px]]  The previous error has disappeared. Notice that previously there were 2 errors in RAW and now there is just one. We can also verify from the "Dependecies Report - Problem and Messages" Window that the previous problem is not there anymore which means it has been fixed.