5164
|
1 /* ========================================================================== */ |
|
2 /* === umfpack_report_numeric =============================================== */ |
|
3 /* ========================================================================== */ |
|
4 |
|
5 /* -------------------------------------------------------------------------- */ |
|
6 /* UMFPACK Version 4.4, Copyright (c) 2005 by Timothy A. Davis. CISE Dept, */ |
|
7 /* Univ. of Florida. All Rights Reserved. See ../Doc/License for License. */ |
|
8 /* web: http://www.cise.ufl.edu/research/sparse/umfpack */ |
|
9 /* -------------------------------------------------------------------------- */ |
|
10 |
|
11 int umfpack_di_report_numeric |
|
12 ( |
|
13 void *Numeric, |
|
14 const double Control [UMFPACK_CONTROL] |
|
15 ) ; |
|
16 |
|
17 long umfpack_dl_report_numeric |
|
18 ( |
|
19 void *Numeric, |
|
20 const double Control [UMFPACK_CONTROL] |
|
21 ) ; |
|
22 |
|
23 int umfpack_zi_report_numeric |
|
24 ( |
|
25 void *Numeric, |
|
26 const double Control [UMFPACK_CONTROL] |
|
27 ) ; |
|
28 |
|
29 long umfpack_zl_report_numeric |
|
30 ( |
|
31 void *Numeric, |
|
32 const double Control [UMFPACK_CONTROL] |
|
33 ) ; |
|
34 |
|
35 /* |
|
36 double int Syntax: |
|
37 |
|
38 #include "umfpack.h" |
|
39 void *Numeric ; |
|
40 double Control [UMFPACK_CONTROL] ; |
|
41 int status ; |
|
42 status = umfpack_di_report_numeric (Numeric, Control) ; |
|
43 |
|
44 double long Syntax: |
|
45 |
|
46 #include "umfpack.h" |
|
47 void *Numeric ; |
|
48 double Control [UMFPACK_CONTROL] ; |
|
49 long status ; |
|
50 status = umfpack_dl_report_numeric (Numeric, Control) ; |
|
51 |
|
52 complex int Syntax: |
|
53 |
|
54 #include "umfpack.h" |
|
55 void *Numeric ; |
|
56 double Control [UMFPACK_CONTROL] ; |
|
57 int status ; |
|
58 status = umfpack_zi_report_numeric (Numeric, Control) ; |
|
59 |
|
60 complex long Syntax: |
|
61 |
|
62 #include "umfpack.h" |
|
63 void *Numeric ; |
|
64 double Control [UMFPACK_CONTROL] ; |
|
65 long status ; |
|
66 status = umfpack_zl_report_numeric (Numeric, Control) ; |
|
67 |
|
68 Purpose: |
|
69 |
|
70 Verifies and prints a Numeric object (the LU factorization, both its pattern |
|
71 numerical values, and permutation vectors P and Q). This routine checks the |
|
72 object more carefully than the computational routines. Normally, this check |
|
73 is not required, since umfpack_*_numeric either returns (void *) NULL, or a |
|
74 valid Numeric object. However, if you suspect that your own code has |
|
75 corrupted the Numeric object (by overruning memory bounds, for example), |
|
76 then this routine might be able to detect a corrupted Numeric object. Since |
|
77 this is a complex object, not all such user-generated errors are guaranteed |
|
78 to be caught by this routine. |
|
79 |
|
80 Returns: |
|
81 |
|
82 UMFPACK_OK if Control [UMFPACK_PRL] <= 2 (the input is not checked). |
|
83 |
|
84 Otherwise: |
|
85 |
|
86 UMFPACK_OK if the Numeric object is valid. |
|
87 UMFPACK_ERROR_invalid_Numeric_object if the Numeric object is invalid. |
|
88 UMFPACK_ERROR_out_of_memory if out of memory. |
|
89 |
|
90 Arguments: |
|
91 |
|
92 void *Numeric ; Input argument, not modified. |
|
93 |
|
94 The Numeric object, which holds the numeric factorization computed by |
|
95 umfpack_*_numeric. |
|
96 |
|
97 double Control [UMFPACK_CONTROL] ; Input argument, not modified. |
|
98 |
|
99 If a (double *) NULL pointer is passed, then the default control |
|
100 settings are used. Otherwise, the settings are determined from the |
|
101 Control array. See umfpack_*_defaults on how to fill the Control |
|
102 array with the default settings. If Control contains NaN's, the |
|
103 defaults are used. The following Control parameters are used: |
|
104 |
|
105 Control [UMFPACK_PRL]: printing level. |
|
106 |
|
107 2 or less: no output. returns silently without checking anything. |
|
108 3: fully check input, and print a short summary of its status |
|
109 4: as 3, but print first few entries of the input |
|
110 5: as 3, but print all of the input |
|
111 Default: 1 |
|
112 */ |