Statistiques
| Révision :

root / man / man3 / HPL_pdtest.3 @ 1

Historique | Voir | Annoter | Télécharger (2,19 ko)

1 
.TH HPL_pdtest 3 "September 10, 2008" "HPL 2.0" "HPL Library Functions"
2 
.SH NAME
3 
HPL_pdtest \- Perform one test.
4 
.SH SYNOPSIS
5 
\fB\&#include "hpl.h"\fR
6
7 
\fB\&void\fR
8 
\fB\&HPL_pdtest(\fR
9 
\fB\&HPL_T_test *\fR
10 
\fI\&TEST\fR,
11 
\fB\&HPL_T_grid *\fR
12 
\fI\&GRID\fR,
13 
\fB\&HPL_T_palg *\fR
14 
\fI\&ALGO\fR,
15 
\fB\&const int\fR
16 
\fI\&N\fR,
17 
\fB\&const int\fR
18 
\fI\&NB\fR
19 
\fB\&);\fR
20 
.SH DESCRIPTION
21 
\fB\&HPL_pdtest\fR
22 
performs  one  test  given a set of parameters such as the
23 
process grid, the  problem size, the distribution blocking factor ...
24 
This function generates  the data, calls  and times the linear system
25 
solver,  checks  the  accuracy  of the  obtained vector solution  and
26 
writes this information to the file pointed to by TEST->outfp.
27 
.SH ARGUMENTS
28 
.TP 8
29 
TEST    (global input)          HPL_T_test *
30 
On entry,  TEST  points  to a testing data structure:  outfp
31 
specifies the output file where the results will be printed.
32 
It is only defined and used by the process  0  of the  grid.
33 
thrsh  specifies  the  threshhold value  for the test ratio.
34 
Concretely, a test is declared "PASSED"  if and only if  the
35 
following inequality is satisfied:
36 
||Ax-b||_oo / ( epsil *
37 
                ( || x ||_oo * || A ||_oo + || b ||_oo ) *
38 
                 N )  < thrsh.
39 
epsil  is the  relative machine precision of the distributed
40 
computer. Finally the test counters, kfail, kpass, kskip and
41 
ktest are updated as follows:  if the test passes,  kpass is
42 
incremented by one;  if the test fails, kfail is incremented
43 
by one; if the test is skipped, kskip is incremented by one.
44 
ktest is left unchanged.
45 
.TP 8
46 
GRID    (local input)           HPL_T_grid *
47 
On entry,  GRID  points  to the data structure containing the
48 
process grid information.
49 
.TP 8
50 
ALGO    (global input)          HPL_T_palg *
51 
On entry,  ALGO  points to  the data structure containing the
52 
algorithmic parameters to be used for this test.
53 
.TP 8
54 
N       (global input)          const int
55 
On entry,  N specifies the order of the coefficient matrix A.
56 
N must be at least zero.
57 
.TP 8
58 
NB      (global input)          const int
59 
On entry,  NB specifies the blocking factor used to partition
60 
and distribute the matrix A. NB must be larger than one.
61 
.SH SEE ALSO
62 
.BR HPL_pddriver \ (3),
63 
.BR HPL_pdinfo \ (3).