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
|
<!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>Option Arguments</TITLE>
<META NAME="description" CONTENT="Option 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="tex2html3375" HREF="node96.html"><IMG WIDTH=37 HEIGHT=24 ALIGN=BOTTOM ALT="next" SRC="http://www.netlib.org/utk/icons/next_motif.gif"></A> <A NAME="tex2html3373" HREF="node92.html"><IMG WIDTH=26 HEIGHT=24 ALIGN=BOTTOM ALT="up" SRC="http://www.netlib.org/utk/icons/up_motif.gif"></A> <A NAME="tex2html3367" HREF="node94.html"><IMG WIDTH=63 HEIGHT=24 ALIGN=BOTTOM ALT="previous" SRC="http://www.netlib.org/utk/icons/previous_motif.gif"></A> <A NAME="tex2html3377" 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="tex2html3378" 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="tex2html3376" HREF="node96.html">Problem Dimensions</A>
<B>Up:</B> <A NAME="tex2html3374" HREF="node92.html">Design and Documentation of </A>
<B> Previous:</B> <A NAME="tex2html3368" HREF="node94.html">Order of Arguments</A>
<BR> <P>
<H2><A NAME="SECTION04463000000000000000">Option Arguments</A></H2>
<A NAME="subsecoptionargs"> </A>
<P>
Arguments<A NAME="3413"> </A> specifying
options are usually of type CHARACTER<IMG WIDTH=7 HEIGHT=8 ALIGN=BOTTOM ALT="tex2html_wrap_inline15263" SRC="img329.gif">1.
The arguments that specify options are character
arguments with the names <TT>SIDE</TT>, <TT>TRANS</TT>,
<TT>UPLO</TT>, and <TT>DIAG</TT>. On entry to a ScaLAPACK
routine, these arguments are <B>global input</B>
and must have the same value on each process in
the process grid.
<P>
<TT>SIDE</TT><A NAME="3420"> </A> is used by the
routines as follows:
<BR><IMG WIDTH=565 HEIGHT=103 ALIGN=BOTTOM ALT="tabular3422" SRC="img357.gif"><BR>
<P>
<TT>TRANS</TT><A NAME="3429"> </A> is used by
the routines as follows:
<BR><IMG WIDTH=570 HEIGHT=82 ALIGN=BOTTOM ALT="tabular3431" SRC="img358.gif"><BR>
In the real case the values <TT>`T'</TT> and <TT>`C'</TT>
have the same meaning, and in the complex case the
value <TT>`T'</TT> is not allowed.
<P>
<TT>UPLO</TT><A NAME="3442"> </A> is used by
the Hermitian, symmetric, and triangular
distributed matrix routines to specify
whether the upper or lower triangle is
being referenced as follows:
<BR><IMG WIDTH=192 HEIGHT=60 ALIGN=BOTTOM ALT="tabular3444" SRC="img359.gif"><BR>
<P>
<TT>DIAG</TT><A NAME="3451"> </A> is used by
the triangular distributed matrix routines
to specify whether the distributed matrix
is unit triangular, as follows:
<BR><IMG WIDTH=224 HEIGHT=60 ALIGN=BOTTOM ALT="tabular3453" SRC="img360.gif"><BR>
When <TT>DIAG</TT> is supplied as <TT>`U'</TT>,
the diagonal elements are not referenced.
For example:
<P>
<UL>
<DT>UPLO
<DD> (global input) CHARACTER<IMG WIDTH=7 HEIGHT=8 ALIGN=BOTTOM ALT="tex2html_wrap_inline15263" SRC="img329.gif">1 <BR>
= 'U': Upper triangle of the matrix A(IA:IA+M-1,JA:JA+N-1);
<BR> = 'L': Lower triangle of the matrix A(IA:IA+M-1,JA:JA+N-1).
</UL>
<P>
The corresponding lower-case characters
may be supplied (with the same meaning),
but any other value is illegal (see
section <A HREF="node101.html#subsecinfo">4.6.6</A>).
<P>
A longer character string can be passed
as the actual argument, making the calling
program more readable, but only the first
character is significant; this is a standard
feature of Fortran 77. For example:
<P>
<PRE> CALL PSPOTRS('upper', . . . )</PRE>
<P>
<BR> <HR>
<P><ADDRESS>
<I>Susan Blackford <BR>
Tue May 13 09:21:01 EDT 1997</I>
</ADDRESS>
</BODY>
</HTML>
|
