Using the Default Result Directory
After each analysis run, the Intel® VTune™ Amplifier saves collected data in a result directory. By default, the result directory is created under the current working directory and given a name based on a standard naming convention. Actions that take results as input, such as the report or finalize actions, look for results in the default location if a result directory is not specified.
The standard naming convention for a result directory is <r@@@{at}>.
@@@ is an auto-incremented number, beginning with 000. The next-highest number is assigned for each subsequent run of this type of analysis.
{at} represents a two- or three-letter abbreviation for the analysis type used in the collection. For example, hs for Hotspots, cc for Concurrency, lw for Locks and Waits, ah for Advanced Hotspots.
You can use the default result directories on the command line if you are performing a series of simple, straightforward collect actions, and do not intend to use the results as input for any other command line tasks.
Specifying the Result Directory
It is generally safest to specify a PATH/name for the result directory when working on the command line. When using an action that takes a result as input, it is safer to specify the result directory, even if the result was created using the default directory.
Be sure to specify the result directory when using an action that takes a result as input, especially the finalize or import action.
You want to store the result in a different directory than the current working directory.
The result is assigned a name other than the default. In this case, you would specify the result name when performing the collect or collect-with action, and also when generating a report or performing any other actions that take this result as input.
Using the result-dir action-option
Use the result-dir action-option to specify the PATH/name of a result directory. This may be an absolute path, or a path relative to the current working directory.
To specify the directory path but use the default naming conventions for the directory, just specify the path.
To specify the name of the result directory, but have the result written to the current working directory, just specify a name for the result directory.
Note
If you want to use a base directory other than the current working directory, use the user-data-dir action-option to specify the base directory.
Example
This command runs the Hotspots analysis of myApplication.exe in the current working directory, which is named test. The result is saved in a default-named directory under the C:\test\baseline directory. If this were the first Hotspots analysis run, the result directory would be named r000hs.
$ amplxe-cl -collect hotspots -result-dir C:\test\baselineC:\test\myApplication.exeTo generate a report from this result, you must specify the result directory.
$ amplxe-cl -report hotspots -result-dir C:\test\baselineC:\test\myApplication.exeThis command runs the Hotspots analysis of myApplication.exe in the current working directory, which is named test. The result is saved in the C:\test\baseline\ directory, using the standard naming convention. If this were the first Hotspots analysis run, the result directory would be named r000hs.
See Also
Supplemental documentation specific to a particular Intel Studio may be available at <install-dir>\<studio>\documentation\ .