Skip to content
Snippets Groups Projects
cube.md 2.04 KiB
Newer Older
  • Learn to ignore specific revisions
  • Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    CUBE
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    ====
    
    Introduction
    ------------
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    CUBE is a graphical performance report explorer for displaying data from Score-P and Scalasca (and other compatible tools). The name comes from the fact that it displays performance data in a three-dimensions :
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    -   **performance metric**, where a number of metrics are available, such as communication time or cache misses,
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    -   **call path**, which contains the call tree of your program
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    -   s**ystem resource**, which contains system's nodes, processes and threads, depending on the parallel programming model.
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    Each dimension is organized in a tree, for example the time performance metric is divided into Execution time and Overhead time, call path dimension is organized by files and routines in your source code etc.
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    ![](../../../img/Snmekobrazovky20141204v12.56.36.png)
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    *Figure 1. Screenshot of CUBE displaying data from Scalasca.*
    
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    Each node in the tree is colored by severity (the color scheme is displayed at the bottom of the window, ranging from the least severe blue to the most severe being red). For example in Figure 1, we can see that most of the point-to-point MPI communication happens in routine exch_qbc, colored red.
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    Installed versions
    ------------------
    
    Currently, there are two versions of CUBE 4.2.3 available as [modules](../../environment-and-modules/):
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    -    cube/4.2.3-gcc, compiled with GCC
    -    cube/4.2.3-icc, compiled with Intel compiler
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    Usage
    -----
    
    CUBE is a graphical application. Refer to Graphical User Interface documentation for a list of methods to launch graphical applications on Anselm.
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    !!! Note "Note"
    	Analyzing large data sets can consume large amount of CPU and RAM. Do not perform large analysis on login nodes.
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    David Hrbáč's avatar
    David Hrbáč committed
    After loading the appropriate module, simply launch cube command, or alternatively you can use  scalasca -examine command to launch the GUI. Note that for Scalasca datasets, if you do not analyze the data with scalasca -examine before to opening them with CUBE, not all performance data will be available.
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    References
    
    1.  <http://www.scalasca.org/software/cube-4.x/download.html>
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed