from terminal on linux, type amplxe-gui to launch the graphical interface for VTune.

from command line

amplxe-cl <-action> [-action-option] [-global-option] [[--] <target> [target-options]]


collect and report and the main actions.


-global-option -- here are some global-options for both collect and report
   -q, -quiet                    Suppress non-essential messages
   -user-data-dir=<string>       Specify the base directory for result paths
                                 provided by --result-dir option. By default, the 
                                 current working directory is used.

<target> is the executable file

target-options are passed to the target 



-------------------------------------------------------------------------------

<-action> = Collect action

   -c, -collect=<string>         Choose an analysis type.
   
Some Available Analysis Types for collect.
   Use '-help collect <analysis type>' for more information about each analysis type.

   hotspots             Identify your most time-consuming source code
      Knobs: enable-user-tasks, sampling-interval

   advanced-hotspots    does not collect stack information
      Knobs: collection-detail, enable-user-tasks, sampling-interval, event-mode

   concurrency          how your application is using available logical CPUs
      Knobs: enable-user-sync, enable-user-tasks, sampling-interval

   lockandwaits         where your application is waiting
      Knobs: enable-user-sync, enable-user-tasks, sampling-interval
   
   more types for Sandy Bridge analysis
    snb-access-contention           Access Contention - Sandy Bridge / Ivy Bridge
    snb-bandwidth                   Bandwidth - Sandy Bridge / Ivy Bridge
    snb-branch-analysis             Branch Analysis - Sandy Bridge / Ivy Bridge
    snb-client                      Client Analysis - Sandy Bridge / Ivy Bridge
    snb-core-port-saturation        Core Port Saturation - Sandy Bridge / Ivy Bridge
    snb-cycles-uops                 Cycles and uOps - Sandy Bridge / Ivy Bridge
    snb-general-exploration         General Exploration - Sandy Bridge / Ivy Bridge
    snb-memory-access               Memory Access - Sandy Bridge / Ivy Bridge
    snb-port-saturation             Port Saturation - Sandy Bridge / Ivy Bridge
   
   more types for Phi analysis
    knc-bandwidth                   Bandwidth - Knights Corner Platform
    knc-general-exploration         General Exploration - Knights Corner Platform
    knc-hotspots                    Hotspots - Knights Corner Platform




some collect action-options:

   -call-stack-mode=all | user-only | user-plus-one
                                 Choose how to show system functions in the stack.

   -d, -duration=<string>        Specify a duration for collection (in seconds).
   -resume-after=<unsigned integer>
                                 Specify time (in milliseconds) to delay data
                                 collection after the application starts.

   -k, -knob=<string>            Set knob value for selected analysis type as
                                 -knob knobName=knobValue.

   -app-working-dir=<string>     Specify a directory where the application will be run.
   
   -r, -result-dir=<string> (r@@@{at}) Specify result directory path.
   
   -search-dir=<string>          <all | bin | src | sym[:<p | r>]>=<directory>.
                                 <directory> is the name of the search directory
                                 for binaries (bin), sources (src), symbols (sym),
                                 or all these file types (all). Use ':r' to
                                 perform a recursive search of all subdirectories.
                                 Use ':p' to indicate highest priority search
                                 directories (directories that should be searched 
                                 prior to others, including environment paths and 
                                 absolute paths). You can use these options
                                 together as ':rp'.

   -fast-frames-threshold=<double> (100)
   -slow-frames-threshold=<double> (40)

   -target-pid=<unsigned integer>
   -target-process=<string>


-------------------------------------------------------------------------------

Report

-R, -report

Available Reports:
 
    callstacks           Display CPU or wait time for callstacks.
    frequency-analysis   Display CPU frequency scaling time.
    gprof-cc             Display CPU or wait time in the gprof-like format.
    hotspots             Display CPU time.
    hw-events            Display hardware events.
    sleep-analysis       Display CPU sleep time and wake-up reasons.
    summary              Display data about overall performance.
    top-down             Display a call tree and provide CPU and wait time for each function.


some report action-options:

-call-stack-mode=all | user-only | user-plus-one

-cumulative-threshold-percent=<string>  Show top percent of data output.

-filter=<string>              Specify items to include or exclude as follows:
                              <column name> [= | !=] <value>

-group-by=<string>            Specify a grouping level for displaying results. 
                              Default value is function. Use -help report
                              <report name> to get a list of available groupings.

-report-output=<string>       Write report output to a file.

-report-width=<integer>       Set output width limit.

-r, -result-dir=<string> (r@@@{at})   Specify result directory path.

-search-dir=<string>          <all | bin | src | sym[:<p | r>]>=<directory>.

-show-as=samples | events | percent (events)

-s, -sort-asc=<string>        Sort data in ascending order by the given column name.
-S, -sort-desc=<string>       Sort data in descending order by the given column name.

-time-filter=<string>         Specify filtered time range using format <begin_time>:<end_time>




-------------------------------------------------------------------------------


amplxe-cl -collect hotspots -quiet -- ./rn
amplxe-cl -report hotspots -show-as percent -call-stack-mode=user-only -cumulative-threshold-percent=99 -sort-asc='CPU Time:Self'

 To view the results in the GUI, double-click the <resultname>.amplxe
 file located in the result directory.




