1HPL_pdinfo(3)                HPL Library Functions               HPL_pdinfo(3)
2
3
4

NAME

6       HPL_pdinfo - Read input parameter file.
7

SYNOPSIS

9       #include "hpl.h"
10
11       void HPL_pdinfo( HPL_T_test * TEST, int * NS, int * N, int * NBS, int *
12       NB, HPL_T_ORDER * PMAPPIN, int * NPQS, int * P, int * Q,  int  *  NPFS,
13       HPL_T_FACT  *  PF,  int * NBMS, int * NBM, int * NDVS, int * NDV, int *
14       NRFS, HPL_T_FACT * RF, int * NTPS, HPL_T_TOP * TP, int *  NDHS,  int  *
15       DH, HPL_T_SWAP * FSWAP, int * TSWAP, int * L1NOTRAN, int * UNOTRAN, int
16       * EQUIL, int * ALIGN );
17

DESCRIPTION

19       HPL_pdinfo reads  the  startup  information for the various  tests  and
20       transmits it to all processes.
21

ARGUMENTS

23       TEST    (global output)         HPL_T_test *
24               On  entry,  TEST  points to a testing data structure.  On exit,
25               the fields of this data structure are initialized  as  follows:
26               TEST->outfp   specifies  the output file where the results will
27               be printed.  It is only defined and used by  the process  0  of
28               the  grid.   TEST->thrsh specifies the threshhold value for the
29               test ratio.  TEST->epsil is the relative machine  precision  of
30               the  distributed  computer.  Finally  the test counters, kfail,
31               kpass, kskip, ktest are initialized to zero.
32
33       NS      (global output)         int *
34               On exit,  NS  specifies the number of different  problem  sizes
35               to be tested. NS is less than or equal to HPL_MAX_PARAM.
36
37       N       (global output)         int *
38               On  entry,  N is an array of dimension HPL_MAX_PARAM.  On exit,
39               the first NS entries of this array contain the   problem  sizes
40               to run the code with.
41
42       NBS     (global output)         int *
43               On  exit,   NBS  specifies the number of different distribution
44               blocking factors to be tested. NBS must be less than  or  equal
45               to HPL_MAX_PARAM.
46
47       NB      (global output)         int *
48               On  exit,   PMAPPIN  specifies the process mapping onto the no-
49               des of the  MPI machine configuration.  PMAPPIN   defaults   to
50               row-major ordering.
51
52       PMAPPIN (global output)         HPL_T_ORDER *
53               On  entry,  NB is an array of dimension HPL_MAX_PARAM. On exit,
54               the first NBS entries of this array contain the values  of  the
55               various distribution blocking factors, to run the code with.
56
57       NPQS    (global output)         int *
58               On  exit,  NPQS  specifies the  number of different values that
59               can be used for P and Q, i.e., the number of process  grids  to
60               run   the   code with.  NPQS must be  less  than  or  equal  to
61               HPL_MAX_PARAM.
62
63       P       (global output)         int *
64               On entry, P  is an array of dimension HPL_MAX_PARAM.  On  exit,
65               the  first  NPQS entries of this array contain the values of P,
66               the number of process rows of the  NPQS grids to run  the  code
67               with.
68
69       Q       (global output)         int *
70               On  entry,  Q  is an array of dimension HPL_MAX_PARAM. On exit,
71               the first NPQS entries of this array contain the values  of  Q,
72               the  number  of process columns of the  NPQS  grids to  run the
73               code with.
74
75       NPFS    (global output)         int *
76               On exit, NPFS  specifies the  number of different  values  that
77               can  be  used for PF : the panel factorization algorithm to run
78               the code with. NPFS is less than or equal to HPL_MAX_PARAM.
79
80       PF      (global output)         HPL_T_FACT *
81               On entry, PF is an array of dimension HPL_MAX_PARAM.  On  exit,
82               the  first   NPFS  entries  of this array  contain  the various
83               panel factorization algorithms to run the code with.
84
85       NBMS    (global output)         int *
86               On exit,  NBMS  specifies  the  number  of   various  recursive
87               stopping  criteria   to be tested.  NBMS  must be  less than or
88               equal to HPL_MAX_PARAM.
89
90       NBM     (global output)         int *
91               On entry,  NBM  is an array of  dimension   HPL_MAX_PARAM.   On
92               exit,  the  first NBMS entries of this array contain the values
93               of the various recursive stopping criteria to be tested.
94
95       NDVS    (global output)         int *
96               On exit,  NDVS  specifies  the number  of various  numbers   of
97               panels  in  recursion to be tested.  NDVS is less than or equal
98               to HPL_MAX_PARAM.
99
100       NDV     (global output)         int *
101               On entry,  NDV  is an array of  dimension   HPL_MAX_PARAM.   On
102               exit,  the  first NDVS entries of this array contain the values
103               of the various numbers of panels in recursion to be tested.
104
105       NRFS    (global output)         int *
106               On exit, NRFS  specifies the  number of different  values  that
107               can  be  used for RF : the recursive factorization algorithm to
108               be tested. NRFS is less than or equal to HPL_MAX_PARAM.
109
110       RF      (global output)         HPL_T_FACT *
111               On entry, RF is an array of dimension HPL_MAX_PARAM.  On  exit,
112               the  first   NRFS  entries  of  this array contain  the various
113               recursive factorization algorithms to run the code with.
114
115       NTPS    (global output)         int *
116               On exit, NTPS  specifies the  number of different  values  that
117               can  be  used for the  broadcast topologies  to be tested. NTPS
118               is less than or equal to HPL_MAX_PARAM.
119
120       TP      (global output)         HPL_T_TOP *
121               On entry, TP is an array of dimension HPL_MAX_PARAM.  On  exit,
122               the   first  NTPS  entries of this  array  contain  the various
123               broadcast (along rows) topologies to run the code with.
124
125       NDHS    (global output)         int *
126               On exit, NDHS  specifies the  number of different  values  that
127               can  be  used for the  lookahead depths to be  tested.  NDHS is
128               less than or equal to HPL_MAX_PARAM.
129
130       DH      (global output)         int *
131               On entry,  DH  is  an array of  dimension   HPL_MAX_PARAM.   On
132               exit,  the  first NDHS entries of this array contain the values
133               of lookahead depths to run the code with.  Such a value  is  at
134               least 0 (no-lookahead) or greater than zero.
135
136       FSWAP   (global output)         HPL_T_SWAP *
137               On  exit,  FSWAP specifies the swapping algorithm to be used in
138               all tests.
139
140       TSWAP   (global output)         int *
141               On exit,  TSWAP  specifies the swapping threshold as  a  number
142               of columns when the mixed swapping algorithm was chosen.
143
144       L1NOTRA (global output)         int *
145               On  exit,  L1NOTRAN specifies whether the upper triangle of the
146               panels of columns  should  be stored  in   no-transposed   form
147               (L1NOTRAN=1) or in transposed form (L1NOTRAN=0).
148
149       UNOTRAN (global output)         int *
150               On  exit,  UNOTRAN  specifies whether the panels of rows should
151               be stored in  no-transposed form  (UNOTRAN=1)   or   transposed
152               form (UNOTRAN=0) during their broadcast.
153
154       EQUIL   (global output)         int *
155               On  exit,   EQUIL  specifies  whether  equilibration during the
156               swap-broadcast  of  the  panel of rows  should   be   performed
157               (EQUIL=1) or not (EQUIL=0).
158
159       ALIGN   (global output)         int *
160               On  exit,   ALIGN  specifies the alignment  of  the dynamically
161               allocated buffers in double precision words. ALIGN  is  greater
162               than zero.
163

SEE ALSO

165       HPL_pddriver (3), HPL_pdtest (3).
166
167
168
169HPL 2.1                        October 26, 2012                  HPL_pdinfo(3)
Impressum