Generate Pre-configured Command Lines
You can use
Intel® Advisor
to generate command lines for perspective or analysis configuration and copy the lines to a clipboard to run from a terminal/command prompt. If you use pre-configured command lines, you do not need to provide analysis configuration, project directory, target application, and application options manually for each analysis you run.
To generate the command lines, you can do one of the following:
- Generate the command lines fromIntel Advisorgraphical user interface (GUI).
- For theOffload Modelingperspective only: Generate the command lines fromIntel Advisorcommand line interface (CLI).
Generate Command Lines from GUI
Prerequisite
:
Set up a project.
- Select a perspective from aPerspective Selectoror a drop-down menu in theAnalysis Workflowpane.TheAnalysis Workflowpane opens for a selected perspective.
- In theAnalysis Workflowpane, do one of the following:
- To use a pre-defined set of analyses and properties, select an accuracy level.
- Select analyses and options manually from theAnalysis Workflowtab. To set additional options, go to and set the properties for desired analyses in the respective left-side sections.See Dialog Box: Project Properties - Analysis Target for option details.
- From theAnalysis Workflowpane, generate the command lines:
- For all selected analysis: Click theGet Command Linebutton.
- For a specific analysis: Expand the analysis controls and click theCommand Linebutton.
TheCopy Command Line to Clipboarddialog box opens, which provides commands to launch the perspective or the analysis with selected configuration. Options with default values are hidden by default. - Click theCopybutton to copy the generated command lines to the clipboard.
- Paste the copied command lines to a terminal/command prompt one by one and run them.
Generate Command Lines from GUI for an MPI Application
Prerequisite
:
Set up a project.
- Go toand select the analysis you want to generate the command line for from the left-side pane. For example, go toSurvey Hotspots Analysisto generate command line for the Survey analysis.
- Set properties to configure the analysis, if required.See Dialog Box: Project Properties - Analysis Target for option details
- Select theUse MPI Launchercheckbox.
- Specify MPI run parameters:
- If you select theIntel MPIas the MPI launcher: specify the number of ranks to profile, selectSelectiveand specify ranks to profile, if required.
- If you selectOtheras the MPI launcher: specify an MPI launcher executable and the number of ranks to profile. Make sure theAllis selected underProfile ranks.
- ClickOKto save the parameters.
If you need to generate commands for more than one analysis or for the whole perspective, specify the MPI run parameters foreachanalysis you want to run. Otherwise,Intel Advisoruses default parameters for all analyses you do not configure properly. - Open theAnalysis Workflowpane and select a perspective to run.
- Select an accuracy level to preconfigure the perspective or configure it manually using the checkboxes. Make sure to select only analyses that you have specified the MPI run parameters for.Do notchange the accuracy level if you specified additional parameters in theProject Properties. Preconfigured accuracy levels reset your configuration.
- Generate the command lines:
- For all selected analysis: Click theGet Command Linebutton.
- For a specific analysis: Expand the analysis controls and click theCommand Linebutton.
TheCopy Command Line to Clipboarddialog box opens, which provides commands to launch the perspective or the analysis with selected configuration. Options with default values are hidden by default. - In theCopy Command Line to Clipboarddialog box, select theGenerate command line for MPIcheckbox to apply the MPI syntax you configured.
- Click theCopybutton to copy the generated command lines to the clipboard.
- Paste the copied command lines to a terminal/command prompt one by one and run them.
Generate Command Lines for
Offload Modeling from CLI
Offload Modeling
from CLI You can generate pre-configured command lines to analyze your application with
Offload Modeling
. Use this feature if you want to:
- Analyze an MPI application
- Customize presetOffload Modelingcommands
Note
: In the commands below, make sure to replace the
myApplication
with your application executable path and name
before
executing a command. If your application requires additional command line options, add them
after
the executable name.- Generate pre-configured command lines using the option of the--collect=projectionanalysis orcollect,pyscript. Specify accuracy level and paths to your project directory and application executable. For example, to generate commands for the default medium accuracy with--collect=projection:advisor --collect=offload --dry-run --project-dir=./advi_results -- ./myApplicationIf you want to scale parameters, for example, to change the number of GPU tiles per MPI process, generate the commands using thecollect.pyscript as follows:advisor-python $APM/collect.py ./advi_results --set-parameter <parameter-to-modify> --dry-run -- ./myApplicationFamilies of Intel® Xegraphics products starting with Intel® Arc™ Alchemist (formerly DG2) and newer generations feature GPU architecture terminology that shifts from legacy terms. For more information on the terminology changes and to understand their mapping with legacy content, see GPU Architecture Terminology for Intel® XeGraphics.After you run the command, a list of analysis commands to run the Offload Modeling with the specified accuracy level is printed to the terminal/command prompt.
- If you analyze an MPI application: Copy the generated commands to your preferred text editor and modify each command to use an MPI launcher: addmpirunormpiexecand a number of MPI processed to launch to each command. For details about the syntax, see Analyze MPI Applications.
- Run the generated commands one by one from a command prompt or a terminal. You can add more options or modify the commands to better fit your goal. See Command Line Option Reference for available options.
- If you generated commands with the script: Run Performance Modeling step with the scaled parameter:advisor --collect=projection --project-dir=./advi_results --set-parameter <parameter-to-modify>
For details about MPI application analysis with Offload Modeling, see
Model MPI Application Performance on GPU.