Statistiques
| Révision :

root / man / man3 / HPL_xjumpm.3

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

1 
.TH HPL_xjumpm 3 "September 10, 2008" "HPL 2.0" "HPL Library Functions"
2 
.SH NAME
3 
HPL_xjumpm \- Compute constants to jump in the random sequence.
4 
.SH SYNOPSIS
5 
\fB\&#include "hpl.h"\fR
6
7 
\fB\&void\fR
8 
\fB\&HPL_xjumpm(\fR
9 
\fB\&const int\fR
10 
\fI\&JUMPM\fR,
11 
\fB\&int *\fR
12 
\fI\&MULT\fR,
13 
\fB\&int *\fR
14 
\fI\&IADD\fR,
15 
\fB\&int *\fR
16 
\fI\&IRANN\fR,
17 
\fB\&int *\fR
18 
\fI\&IRANM\fR,
19 
\fB\&int *\fR
20 
\fI\&IAM\fR,
21 
\fB\&int *\fR
22 
\fI\&ICM\fR
23 
\fB\&);\fR
24 
.SH DESCRIPTION
25 
\fB\&HPL_xjumpm\fR
26 
computes  the constants  A and C  to jump JUMPM numbers in
27 
the random sequence: X(n+JUMPM) = A*X(n)+C.  The constants encoded in
28 
MULT and IADD  specify  how to jump from one entry in the sequence to
29 
the next.
30 
.SH ARGUMENTS
31 
.TP 8
32 
JUMPM   (local input)           const int
33 
On entry,  JUMPM  specifies  the  number  of entries  in  the
34 
sequence to jump over. When JUMPM is less or equal than zero,
35 
A and C are not computed, IRANM is set to IRANN corresponding
36 
to a jump of size zero.
37 
.TP 8
38 
MULT    (local input)           int *
39 
On entry, MULT is an array of dimension 2,  that contains the
40 
16-lower  and 15-higher bits of the constant  a  to jump from
41 
X(n) to X(n+1) = a*X(n) + c in the random sequence.
42 
.TP 8
43 
IADD    (local input)           int *
44 
On entry, IADD is an array of dimension 2,  that contains the
45 
16-lower  and 15-higher bits of the constant  c  to jump from
46 
X(n) to X(n+1) = a*X(n) + c in the random sequence.
47 
.TP 8
48 
IRANN   (local input)           int *
49 
On entry, IRANN is an array of dimension 2. that contains the
50 
16-lower and 15-higher bits of the encoding of X(n).
51 
.TP 8
52 
IRANM   (local output)          int *
53 
On entry,  IRANM  is an array of dimension 2.   On exit, this
54 
array  contains respectively  the 16-lower and 15-higher bits
55 
of the encoding of X(n+JUMPM).
56 
.TP 8
57 
IAM     (local output)          int *
58 
On entry, IAM is an array of dimension 2. On exit, when JUMPM
59 
is  greater  than  zero,  this  array  contains  the  encoded
60 
constant  A  to jump from  X(n) to  X(n+JUMPM)  in the random
61 
sequence. IAM(0:1)  contains  respectively  the  16-lower and
62 
15-higher  bits  of this constant  A. When  JUMPM  is less or
63 
equal than zero, this array is not referenced.
64 
.TP 8
65 
ICM     (local output)          int *
66 
On entry, ICM is an array of dimension 2. On exit, when JUMPM
67 
is  greater  than  zero,  this  array  contains  the  encoded
68 
constant  C  to jump from  X(n)  to  X(n+JUMPM) in the random
69 
sequence. ICM(0:1)  contains  respectively  the  16-lower and
70 
15-higher  bits  of this constant  C. When  JUMPM  is less or
71 
equal than zero, this array is not referenced.
72 
.SH SEE ALSO
73 
.BR HPL_ladd \ (3),
74 
.BR HPL_lmul \ (3),
75 
.BR HPL_setran \ (3),
76 
.BR HPL_jumpit \ (3),
77 
.BR HPL_rand \ (3).