Go to main content
Oracle Developer Studio 12.5 Man Pages

Exit Print View

Updated: June 2017
 
 

StatInit (3p)

Name

StatInit - ables in structure that stores performance statistics collected during the computation of the SuperLU solver.

Synopsis

#include <sunperf.h>


void StatInit(SuperLUStat_t *stat);


void StatInit_64(SuperLUStat_t_64 *stat);

Description

Oracle Solaris Studio Performance Library                         StatInit(3P)



NAME
       StatInit  -  A  utility C function that allocates and initializes vari-
       ables in structure that stores performance statistics collected  during
       the computation of the SuperLU solver.


SYNOPSIS
       #include <sunperf.h>


       void StatInit(SuperLUStat_t *stat);


       void StatInit_64(SuperLUStat_t_64 *stat);


PURPOSE
       Most  of  the  computational routines use a structure to record certain
       kinds of performance data, namely the time and number of floating point
       operations in each phase of the computation, and data about the size of
       the matrices L and U.  These statistics are collected during the compu-
       tation and stored in a variable of type SuperLUStat_t:

       typedef struct {
           int    *panel_histo;
           double *utime;
           float  *ops;
           int    TinyPivots;
           int    RefineSteps;
       } SuperLUStat_t;

       typedef struct {
           long   *panel_histo;
           double *utime;
           float  *ops;
           long   TinyPivots;
           long   RefineSteps;
       } SuperLUStat_t_64;

       where


       panel_histo is histogram of panel size distribution

       utime is running time at various phases

       ops is operation count at various phases

       TinyPivots is number of tiny pivots

       RefineSteps is number of iterative refinement steps

StatInit   allocates  storage  and  performs  initialization  for  the  fields
panel_histo, utime and ops.


ARGUMENTS
       SuperLUStat_t *stat (input/output)
                 On entry, stat points to a SuperLUStat_t structure.  On exit,
                 memory  is  allocated  and initialized for panel_histo, utime
                 and ops.


SEE ALSO
       StatFree

       LUFactTime

       LUSolveTime

       LUFactFlops

       LUSolveFlops

       SuperMatrix

       http://crd.lbl.gov/~xiaoye/SuperLU/

       James W. Demmel, Stanley C. Eisenstat, John R. Gilbert,  Xiaoye  S.  Li
       and  Joseph  W. H. Liu, "A supernodal approach to sparse partial pivot-
       ing", SIAM J. Matrix Analysis and Applications, Vol. 20, Num. 3,  1999,
       pp. 720-755.



                                  7 Nov 2015                      StatInit(3P)