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
|
<!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>Common Errors in Calling ScaLAPACK Routines</TITLE>
<META NAME="description" CONTENT="Common Errors in Calling ScaLAPACK Routines">
<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="tex2html4079" HREF="node150.html"><IMG WIDTH=37 HEIGHT=24 ALIGN=BOTTOM ALT="next" SRC="http://www.netlib.org/utk/icons/next_motif.gif"></A> <A NAME="tex2html4077" HREF="node145.html"><IMG WIDTH=26 HEIGHT=24 ALIGN=BOTTOM ALT="up" SRC="http://www.netlib.org/utk/icons/up_motif.gif"></A> <A NAME="tex2html4071" HREF="node148.html"><IMG WIDTH=63 HEIGHT=24 ALIGN=BOTTOM ALT="previous" SRC="http://www.netlib.org/utk/icons/previous_motif.gif"></A> <A NAME="tex2html4081" 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="tex2html4082" 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="tex2html4080" HREF="node150.html">Failures Detected by ScaLAPACK </A>
<B>Up:</B> <A NAME="tex2html4078" HREF="node145.html">Troubleshooting</A>
<B> Previous:</B> <A NAME="tex2html4072" HREF="node148.html">Application Debugging Hints</A>
<BR> <P>
<H1><A NAME="SECTION04740000000000000000">Common Errors in Calling ScaLAPACK Routines</A></H1>
<A NAME="seccommonerrors"> </A>
<P>
The user must read the leading comments of a
ScaLAPACK routine before invoking the routine.
The wording of the leading comments is explained
in Chapter <A HREF="node68.html#chap2dbsd">4</A>. Basic terminology is explained in
the <B>Glossary</B> and <B>List of Notation</B>.
<P>
For the benefit of less experienced programmers, we provide a list of
common programming errors in calling a ScaLAPACK routine.
These errors may cause the ScaLAPACK routine to report a failure,
as described in section <A HREF="node150.html#secfailures">7.4</A><A NAME="6283"> </A>;
they may cause an error to be reported by the system;
or they may lead to wrong results -- see also
section <A HREF="node153.html#secwrongresults">7.5</A>.
<P>
<UL>
<LI> Wrong number of arguments
<LI> Arguments in the wrong order
<LI> Argument of the wrong type (especially real and complex
arguments of the wrong precision)
<LI> Wrong dimensions for an array argument
<LI> Insufficient space in a workspace argument
<LI> Failure to assign a value to an input argument
<LI> Routine designed for homogeneous computers was executed on
a heterogeneous system (see section <A HREF="node134.html#sec_Hetero">6.2</A>)
</UL>
<P>
Some modern compilation systems, as well as
software tools such as the Fortran 77 syntax checker <TT>ftnchek</TT> (freely
available on <EM>netlib</EM>) and the portability checker in
Toolpack [<A HREF="node189.html#Toolpack">105</A>], can check that arguments agree in number and type;
and many compilation systems offer run-time detection
of errors such as an array element out-of-bounds or use of an
unassigned variable.
<P>
<BR> <HR>
<P><ADDRESS>
<I>Susan Blackford <BR>
Tue May 13 09:21:01 EDT 1997</I>
</ADDRESS>
</BODY>
</HTML>
|
