1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
<!--Converted with LaTeX2HTML 96.1-h (September 30, 1996) by Nikos Drakos (nikos@cbl.leeds.ac.uk), CBLU, University of Leeds -->
<HTML>
<HEAD>
<TITLE>Arguments</TITLE>
<META NAME="description" CONTENT="Arguments">
<META NAME="keywords" CONTENT="slug">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<LINK REL=STYLESHEET HREF="slug.css">
</HEAD>
<BODY LANG="EN" >
<A NAME="tex2html4343" HREF="node172.html"><IMG WIDTH=37 HEIGHT=24 ALIGN=BOTTOM ALT="next" SRC="http://www.netlib.org/utk/icons/next_motif.gif"></A> <A NAME="tex2html4341" HREF="node169.html"><IMG WIDTH=26 HEIGHT=24 ALIGN=BOTTOM ALT="up" SRC="http://www.netlib.org/utk/icons/up_motif.gif"></A> <A NAME="tex2html4337" HREF="node170.html"><IMG WIDTH=63 HEIGHT=24 ALIGN=BOTTOM ALT="previous" SRC="http://www.netlib.org/utk/icons/previous_motif.gif"></A> <A NAME="tex2html4345" HREF="node1.html"><IMG WIDTH=65 HEIGHT=24 ALIGN=BOTTOM ALT="contents" SRC="http://www.netlib.org/utk/icons/contents_motif.gif"></A> <A NAME="tex2html4346" HREF="node190.html"><IMG WIDTH=43 HEIGHT=24 ALIGN=BOTTOM ALT="index" SRC="http://www.netlib.org/utk/icons/index_motif.gif"></A> <BR>
<B> Next:</B> <A NAME="tex2html4344" HREF="node172.html">C Interface</A>
<B>Up:</B> <A NAME="tex2html4342" HREF="node169.html">PxTRMR2D</A>
<B> Previous:</B> <A NAME="tex2html4338" HREF="node170.html">Purpose</A>
<BR> <P>
<H3><A NAME="SECTION04853200000000000000">Arguments</A></H3>
<P>
<DL COMPACT><DT>UPLO
<DD> (global input) CHARACTER<IMG WIDTH=7 HEIGHT=8 ALIGN=BOTTOM ALT="tex2html_wrap_inline15263" SRC="img329.gif">1 <BR>
On entry, UPLO specifies whether we should copy the upper
part or the lower part of the indicated (sub)matrix:
<DL COMPACT><DT>= 'U':
<DD> Copy the upper triangular part.
<DT>= 'L':
<DD> Copy the lower triangular part.
<P>
</DL>
<P>
<DT>DIAG
<DD> (global input) CHARACTER<IMG WIDTH=7 HEIGHT=8 ALIGN=BOTTOM ALT="tex2html_wrap_inline15263" SRC="img329.gif">1 <BR>
On entry, DIAG specifies whether we should copy the diagonal.
<DL COMPACT><DT>= 'U':
<DD> Do NOT copy the diagonal of the (sub)matrix.
<DT>= 'N':
<DD> Do copy the diagonal of the (sub)matrix.
<P>
</DL>
<P>
<DT>M
<DD> (global input) INTEGER <BR>
On entry, M specifies the number of rows of the
(sub)matrix to be copied. M <IMG WIDTH=11 HEIGHT=24 ALIGN=MIDDLE ALT="tex2html_wrap_inline14966" SRC="img308.gif"> 0.
<P>
<DT>N
<DD> (global input) INTEGER<BR>
On entry, N specifies the number of columns of the (sub)matrix
to be copied. N <IMG WIDTH=11 HEIGHT=24 ALIGN=MIDDLE ALT="tex2html_wrap_inline14966" SRC="img308.gif"> 0.
<P>
<DT>A
<DD> (local input) REAL/COMPLEX/INTEGER array, dimension
(LLD_A,LOCc(JA+N-1)) <BR>
On entry, the source matrix.
<P>
<DT>IA
<DD> (global input) INTEGER <BR>
On entry,the global row index of the beginning of the (sub)matrix
of A to copy.<BR>
1 <IMG WIDTH=11 HEIGHT=24 ALIGN=MIDDLE ALT="tex2html_wrap_inline14970" SRC="img309.gif"> IA <IMG WIDTH=11 HEIGHT=24 ALIGN=MIDDLE ALT="tex2html_wrap_inline14970" SRC="img309.gif"> M_A - M + 1.
<P>
<DT>JA
<DD> (global input) INTEGER <BR>
On entry,the global column index of the beginning of the (sub)matrix
of A to copy.<BR>
1 <IMG WIDTH=11 HEIGHT=24 ALIGN=MIDDLE ALT="tex2html_wrap_inline14970" SRC="img309.gif"> JA <IMG WIDTH=11 HEIGHT=24 ALIGN=MIDDLE ALT="tex2html_wrap_inline14970" SRC="img309.gif"> N_A - N + 1.
<P>
<DT>DESCA
<DD> (global and local input) INTEGER array, dimension (DLEN_)<BR>
The array descriptor for the distributed matrix A.<BR>
Only DESCA(DTYPE_)=1 is supported, and thus DLEN_ = 9.<BR>
If the current process is not part of the context of A,
then DESCA(CTXT_) must be equal to -1.
<P>
<DT>B
<DD> (local output) REAL/COMPLEX/INTEGER array, dimension
(LLD_B,LOCc(JB+N-1)) <BR>
On exit, the defined (sub)matrix is overwritten by the indicated
(sub)matrix from A.
<P>
<DT>IB
<DD> (global input) INTEGER <BR>
On entry, the global row index of the beginning of the (sub)matrix
of B that will be overwritten.<BR>
1 <IMG WIDTH=11 HEIGHT=24 ALIGN=MIDDLE ALT="tex2html_wrap_inline14970" SRC="img309.gif"> IB <IMG WIDTH=11 HEIGHT=24 ALIGN=MIDDLE ALT="tex2html_wrap_inline14970" SRC="img309.gif"> M_B - M + 1.
<P>
<DT>JB
<DD> (global input) INTEGER <BR>
On entry, the global column index of the beginning of the submatrix
of B that will be overwritten.<BR>
1 <IMG WIDTH=11 HEIGHT=24 ALIGN=MIDDLE ALT="tex2html_wrap_inline14970" SRC="img309.gif"> JB <IMG WIDTH=11 HEIGHT=24 ALIGN=MIDDLE ALT="tex2html_wrap_inline14970" SRC="img309.gif"> N_B - N + 1.
<P>
<DT>DESCB
<DD> (global and local input) INTEGER array, dimension (DLEN_)<BR>
The array descriptor for the distributed matrix B.<BR>
Only DESCB(DTYPE_)=1 is supported, and thus DLEN_ = 9.<BR>
If the calling process is not part of the context of B,
then DESCB(CTXT_) must be equal to -1.
<P>
<DT>ICTXT
<DD> (global input) INTEGER <BR>
The context encompassing at least the union of all processes
in context A and context B. All processes in the context ICTXT
must call this routine, even if they do not own a piece of either
matrix.
<P>
</DL><HR><A NAME="tex2html4343" HREF="node172.html"><IMG WIDTH=37 HEIGHT=24 ALIGN=BOTTOM ALT="next" SRC="http://www.netlib.org/utk/icons/next_motif.gif"></A> <A NAME="tex2html4341" HREF="node169.html"><IMG WIDTH=26 HEIGHT=24 ALIGN=BOTTOM ALT="up" SRC="http://www.netlib.org/utk/icons/up_motif.gif"></A> <A NAME="tex2html4337" HREF="node170.html"><IMG WIDTH=63 HEIGHT=24 ALIGN=BOTTOM ALT="previous" SRC="http://www.netlib.org/utk/icons/previous_motif.gif"></A> <A NAME="tex2html4345" HREF="node1.html"><IMG WIDTH=65 HEIGHT=24 ALIGN=BOTTOM ALT="contents" SRC="http://www.netlib.org/utk/icons/contents_motif.gif"></A> <A NAME="tex2html4346" HREF="node190.html"><IMG WIDTH=43 HEIGHT=24 ALIGN=BOTTOM ALT="index" SRC="http://www.netlib.org/utk/icons/index_motif.gif"></A> <BR>
<B> Next:</B> <A NAME="tex2html4344" HREF="node172.html">C Interface</A>
<B>Up:</B> <A NAME="tex2html4342" HREF="node169.html">PxTRMR2D</A>
<B> Previous:</B> <A NAME="tex2html4338" HREF="node170.html">Purpose</A>
<P><ADDRESS>
<I>Susan Blackford <BR>
Tue May 13 09:21:01 EDT 1997</I>
</ADDRESS>
</BODY>
</HTML>
|
