Debian Codegraph @

hpl/www/HPL_xjumpm.html

raw
1 <HTML>
2 <HEAD>
3 <TITLE>HPL_xjumpm HPL 2.0 Library Functions September 10, 2008</TITLE>
4 </HEAD>
5
6 <BODY BGCOLOR="WHITE" TEXT = "#000000" LINK = "#0000ff" VLINK = "#000099"
7 ALINK = "#ffff00">
8
9 <H1>Name</H1>
10 <B>HPL_xjumpm</B> Compute constants to jump in the random sequence.
11
12 <H1>Synopsis</H1>
13 <CODE>#include "hpl.h"</CODE><BR><BR>
14 <CODE>void</CODE>
15 <CODE>HPL_xjumpm(</CODE>
16 <CODE>const int</CODE>
17 <CODE>JUMPM</CODE>,
18 <CODE>int *</CODE>
19 <CODE>MULT</CODE>,
20 <CODE>int *</CODE>
21 <CODE>IADD</CODE>,
22 <CODE>int *</CODE>
23 <CODE>IRANN</CODE>,
24 <CODE>int *</CODE>
25 <CODE>IRANM</CODE>,
26 <CODE>int *</CODE>
27 <CODE>IAM</CODE>,
28 <CODE>int *</CODE>
29 <CODE>ICM</CODE>
30 <CODE>);</CODE>
31
32 <H1>Description</H1>
33 <B>HPL_xjumpm</B>
34 computes the constants A and C to jump JUMPM numbers in
35 the random sequence: X(n+JUMPM) = A*X(n)+C. The constants encoded in
36 MULT and IADD specify how to jump from one entry in the sequence to
37 the next.
38
39 <H1>Arguments</H1>
40 <PRE>
41 JUMPM (local input) const int
42 On entry, JUMPM specifies the number of entries in the
43 sequence to jump over. When JUMPM is less or equal than zero,
44 A and C are not computed, IRANM is set to IRANN corresponding
45 to a jump of size zero.
46 </PRE>
47 <PRE>
48 MULT (local input) int *
49 On entry, MULT is an array of dimension 2, that contains the
50 16-lower and 15-higher bits of the constant a to jump from
51 X(n) to X(n+1) = a*X(n) + c in the random sequence.
52 </PRE>
53 <PRE>
54 IADD (local input) int *
55 On entry, IADD is an array of dimension 2, that contains the
56 16-lower and 15-higher bits of the constant c to jump from
57 X(n) to X(n+1) = a*X(n) + c in the random sequence.
58 </PRE>
59 <PRE>
60 IRANN (local input) int *
61 On entry, IRANN is an array of dimension 2. that contains the
62 16-lower and 15-higher bits of the encoding of X(n).
63 </PRE>
64 <PRE>
65 IRANM (local output) int *
66 On entry, IRANM is an array of dimension 2. On exit, this
67 array contains respectively the 16-lower and 15-higher bits
68 of the encoding of X(n+JUMPM).
69 </PRE>
70 <PRE>
71 IAM (local output) int *
72 On entry, IAM is an array of dimension 2. On exit, when JUMPM
73 is greater than zero, this array contains the encoded
74 constant A to jump from X(n) to X(n+JUMPM) in the random
75 sequence. IAM(0:1) contains respectively the 16-lower and
76 15-higher bits of this constant A. When JUMPM is less or
77 equal than zero, this array is not referenced.
78 </PRE>
79 <PRE>
80 ICM (local output) int *
81 On entry, ICM is an array of dimension 2. On exit, when JUMPM
82 is greater than zero, this array contains the encoded
83 constant C to jump from X(n) to X(n+JUMPM) in the random
84 sequence. ICM(0:1) contains respectively the 16-lower and
85 15-higher bits of this constant C. When JUMPM is less or
86 equal than zero, this array is not referenced.
87 </PRE>
88
89 <H1>See Also</H1>
90 <A HREF="HPL_ladd.html">HPL_ladd</A>,
91 <A HREF="HPL_lmul.html">HPL_lmul</A>,
92 <A HREF="HPL_setran.html">HPL_setran</A>,
93 <A HREF="HPL_jumpit.html">HPL_jumpit</A>,
94 <A HREF="HPL_rand.html">HPL_rand</A>.
95
96 </BODY>
97 </HTML>