1HPL_pdinfo(3) HPL Library Functions HPL_pdinfo(3)
2
3
4
6 HPL_pdinfo - Read input parameter file.
7
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
19 HPL_pdinfo reads the startup information for the various tests and
20 transmits it to all processes.
21
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
165 HPL_pddriver (3), HPL_pdtest (3).
166
167
168
169HPL 2.2 February 24, 2016 HPL_pdinfo(3)