Statistiques
| Révision :

root / www / HPL_pdmatgen.html

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

1 1 equemene
<HTML>
2 1 equemene
<HEAD>
3 1 equemene
<TITLE>HPL_pdmatgen HPL 2.0 Library Functions September 10, 2008</TITLE>
4 1 equemene
</HEAD>
5 1 equemene
6 1 equemene
<BODY BGCOLOR="WHITE" TEXT = "#000000" LINK = "#0000ff" VLINK = "#000099"
7 1 equemene
      ALINK = "#ffff00">
8 1 equemene
9 1 equemene
<H1>Name</H1>
10 1 equemene
<B>HPL_pdmatgen</B> Parallel random matrix generator.
11 1 equemene
12 1 equemene
<H1>Synopsis</H1>
13 1 equemene
<CODE>#include "hpl.h"</CODE><BR><BR>
14 1 equemene
<CODE>void</CODE>
15 1 equemene
<CODE>HPL_pdmatgen(</CODE>
16 1 equemene
<CODE>const HPL_T_grid *</CODE>
17 1 equemene
<CODE>GRID</CODE>,
18 1 equemene
<CODE>const int</CODE>
19 1 equemene
<CODE>M</CODE>,
20 1 equemene
<CODE>const int</CODE>
21 1 equemene
<CODE>N</CODE>,
22 1 equemene
<CODE>const int</CODE>
23 1 equemene
<CODE>NB</CODE>,
24 1 equemene
<CODE>double *</CODE>
25 1 equemene
<CODE>A</CODE>,
26 1 equemene
<CODE>const int</CODE>
27 1 equemene
<CODE>LDA</CODE>,
28 1 equemene
<CODE>const int</CODE>
29 1 equemene
<CODE>ISEED</CODE>
30 1 equemene
<CODE>);</CODE>
31 1 equemene
32 1 equemene
<H1>Description</H1>
33 1 equemene
<B>HPL_pdmatgen</B>
34 1 equemene
generates (or regenerates) a parallel random matrix A.
35 1 equemene
36 1 equemene
The  pseudo-random  generator uses the linear congruential algorithm:
37 1 equemene
X(n+1) = (a * X(n) + c) mod m  as  described  in the  Art of Computer
38 1 equemene
Programming, Knuth 1973, Vol. 2.
39 1 equemene
40 1 equemene
<H1>Arguments</H1>
41 1 equemene
<PRE>
42 1 equemene
GRID    (local input)                 const HPL_T_grid *
43 1 equemene
        On entry,  GRID  points  to the data structure containing the
44 1 equemene
        process grid information.
45 1 equemene
</PRE>
46 1 equemene
<PRE>
47 1 equemene
M       (global input)                const int
48 1 equemene
        On entry,  M  specifies  the number  of rows of the matrix A.
49 1 equemene
        M must be at least zero.
50 1 equemene
</PRE>
51 1 equemene
<PRE>
52 1 equemene
N       (global input)                const int
53 1 equemene
        On entry,  N specifies the number of columns of the matrix A.
54 1 equemene
        N must be at least zero.
55 1 equemene
</PRE>
56 1 equemene
<PRE>
57 1 equemene
NB      (global input)                const int
58 1 equemene
        On entry,  NB specifies the blocking factor used to partition
59 1 equemene
        and distribute the matrix A. NB must be larger than one.
60 1 equemene
</PRE>
61 1 equemene
<PRE>
62 1 equemene
A       (local output)                double *
63 1 equemene
        On entry,  A  points  to an array of dimension (LDA,LocQ(N)).
64 1 equemene
        On exit, this array contains the coefficients of the randomly
65 1 equemene
        generated matrix.
66 1 equemene
</PRE>
67 1 equemene
<PRE>
68 1 equemene
LDA     (local input)                 const int
69 1 equemene
        On entry, LDA specifies the leading dimension of the array A.
70 1 equemene
        LDA must be at least max(1,LocP(M)).
71 1 equemene
</PRE>
72 1 equemene
<PRE>
73 1 equemene
ISEED   (global input)                const int
74 1 equemene
        On entry, ISEED  specifies  the  seed  number to generate the
75 1 equemene
        matrix A. ISEED must be at least zero.
76 1 equemene
</PRE>
77 1 equemene
78 1 equemene
<H1>See Also</H1>
79 1 equemene
<A HREF="HPL_ladd.html">HPL_ladd</A>,
80 1 equemene
<A HREF="HPL_lmul.html">HPL_lmul</A>,
81 1 equemene
<A HREF="HPL_setran.html">HPL_setran</A>,
82 1 equemene
<A HREF="HPL_xjumpm.html">HPL_xjumpm</A>,
83 1 equemene
<A HREF="HPL_jumpit.html">HPL_jumpit</A>,
84 1 equemene
<A HREF="HPL_drand.html">HPL_drand</A>.
85 1 equemene
86 1 equemene
</BODY>
87 1 equemene
</HTML>