Skip to content
Snippets Groups Projects
cube.md 2.04 KiB
Newer Older
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

Lukáš Krupčík's avatar
Lukáš Krupčík committed
After loading the apropriate 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