← Back to branch summary

~logan/ubuntu/trusty/suitesparse/4.2.1-3ubuntu1

« back to all changes in this revision

Viewing changes to UMFPACK/Doc/UserGuide.stex

  • Committer: Bazaar Package Importer
  • Author(s): Christophe Prud'homme
  • Date: 2007-05-29 09:36:29 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20070529093629-zowquo0b7slkk6nc
Tags: 3.0.0-2
http://bugs.debian.org/426349
http://bugs.debian.org/426354
* suitesparse builds properly twice in a row
* Bug fix: "suitesparse - FTBFS: Broken build depens: libgfortran1-dev",
  thanks to Bastian Blank (Closes: #426349).
* Bug fix: "suitesparse_3.0.0-1: FTBFS: build-depends on
  libgfortran1-dev", thanks to Steve Langasek (Closes: #426354).

Show diffs side-by-side

added added

removed removed

Lines of Context:
UMFPACK/Doc/UserGuide.stex
20
20
\author{Timothy A. Davis \\
21
21
Dept. of Computer and Information Science and Engineering \\
22
22
Univ. of Florida, Gainesville, FL}
23
 
\title{UMFPACK Version 5.0 User Guide}
24
 
\date{May 5, 2006}
 
23
\title{UMFPACK Version 5.1 User Guide}
 
24
\date{May 31, 2007}
25
25
\maketitle
26
26
 
27
27
%-------------------------------------------------------------------------------
38
38
 
39
39
Technical Report TR-04-003 (revised)
40
40
 
41
 
UMFPACK Version 5.0, Copyright\copyright 1995-2006 by Timothy A. Davis.
 
41
UMFPACK Version 5.1, Copyright\copyright 1995-2006 by Timothy A. Davis.
42
42
All Rights Reserved.
43
43
UMFPACK is available under alternate licences; contact T. Davis for details.
44
44
 
297
297
A detailed list of changes is in the {\tt ChangeLog} file.
298
298
 
299
299
%-------------------------------------------------------------------------------
 
300
\subsection{Version 5.1.0}
 
301
%-------------------------------------------------------------------------------
 
302
 
 
303
Port of MATLAB interface to 64-bit MATLAB.
 
304
 
 
305
%-------------------------------------------------------------------------------
 
306
\subsection{Version 5.0.3}
 
307
%-------------------------------------------------------------------------------
 
308
 
 
309
Renamed the MATLAB function to {\tt umfpack2}, so as not to confict with
 
310
itself (the MATLAB built-in version of UMFPACK).
 
311
 
 
312
%-------------------------------------------------------------------------------
300
313
\subsection{Version 5.0}
301
314
%-------------------------------------------------------------------------------
302
315
 
1493
1506
\item {\tt UMFPACK\_ERROR\_internal\_error},  (-911):  
1494
1507
    An internal error has occurred, of unknown cause.  This is either a bug
1495
1508
    in UMFPACK, or the result of a memory overrun from your program.
1496
 
    Try modifying the file {\tt AMD/Source/amd\_internal.h} and adding
 
1509
    Try modifying the file {\tt AMD/Include/amd\_internal.h} and adding
1497
1510
    the statement {\tt \#undef NDEBUG}, to enable the debugging mode.
1498
1511
    Recompile UMFPACK and rerun your program.
1499
1512
    A failed assertion might occur which
2045
2058
The outputs of these demo programs will then be compared with output
2046
2059
files in the distribution.  Expect to see a few differences, such as
2047
2060
residual norms, compile-time control settings, and perhaps memory usage
2048
 
differences.  The AMD and UMFPACK mexFunctions for
2049
 
use in MATLAB will also be compiled.  If you do not have MATLAB 6.0 or
2050
 
later, type {\tt make lib} instead.
2051
 
 
2052
 
If you have the GNU version of {\tt make}, the {\tt Source/GNUmakefile} and
 
2061
differences.
 
2062
 
 
2063
To use {\tt make} to compile the MATLAB mexFunctions for MATLAB
 
2064
and AMD, you can either type {\tt make mex} in the UMFPACK directory.
 
2065
You may first need to edit the {\tt UFconfig/UFconfig.mk} file to
 
2066
modify the definition of the {\tt MEX}, if you have a version of MATLAB
 
2067
older than Version 7.2.  Remove the {\tt -largeArrayDims} definition.
 
2068
If you use the MATLAB command {\tt umfpack\_make} in the MATLAB directory,
 
2069
then this case is handled for you automatically.
 
2070
 
 
2071
If you have the GNU version of {\tt make}, the {\tt Lib/GNUmakefile} and
2053
2072
{\tt MATLAB/GNUmakefile} files are used.  These are much more concise than
2054
2073
what the ``old'' version of {\tt make} can handle.  If you do not have
2055
 
GNU {\tt make}, the {\tt Source/Makefile} and {\tt MATLAB/Makefile} files
 
2074
GNU {\tt make}, the {\tt Lib/Makefile} and {\tt MATLAB/Makefile} files
2056
2075
are used instead.  Each UMFPACK source file is compiled into four
2057
2076
versions ({\tt double} / complex, and {\tt int} / {\tt UF\_long}).  A proper
2058
2077
old-style {\tt Makefile} is cumbersome in this case, so these two
2193
2212
compile the UMFPACK mexFunction).  This works on any computer with MATLAB,
2194
2213
including Windows.
2195
2214
 
2196
 
You will be prompted to select several configuration options, including
2197
 
whether or not to use the BLAS.
2198
 
MATLAB 5.3 (or earlier) does not include the BLAS, so you either have to
2199
 
compile UMFPACK without the BLAS (UMFPACK will be slow), or modify your
2200
 
{\tt <matlab>/bin/mexopts.sh} by adding your BLAS library
2201
 
to the {\tt CLIBS} string,
2202
 
where {\tt <matlab>} is the directory in which MATLAB is installed.
 
2215
% You will be prompted to select several configuration options, including
 
2216
% whether or not to use the BLAS.
 
2217
% MATLAB 5.3 (or earlier) does not include the BLAS, so you either have to
 
2218
% compile UMFPACK without the BLAS (UMFPACK will be slow), or modify your
 
2219
% {\tt <matlab>/bin/mexopts.sh} by adding your BLAS library
 
2220
% to the {\tt CLIBS} string,
 
2221
% where {\tt <matlab>} is the directory in which MATLAB is installed.
2203
2222
 
2204
2223
If you are using Windows and the {\tt lcc} compiler bundled with
2205
2224
MATLAB 6.1, then you may need to copy the