umfpack_report_symbolic.h 3.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112
  1. /* ========================================================================== */
  2. /* === umfpack_report_symbolic ============================================== */
  3. /* ========================================================================== */
  4. /* -------------------------------------------------------------------------- */
  5. /* UMFPACK Copyright (c) Timothy A. Davis, CISE, */
  6. /* Univ. of Florida. All Rights Reserved. See ../Doc/License for License. */
  7. /* web: http://www.cise.ufl.edu/research/sparse/umfpack */
  8. /* -------------------------------------------------------------------------- */
  9. int umfpack_di_report_symbolic
  10. (
  11. void *Symbolic,
  12. const double Control [UMFPACK_CONTROL]
  13. ) ;
  14. UF_long umfpack_dl_report_symbolic
  15. (
  16. void *Symbolic,
  17. const double Control [UMFPACK_CONTROL]
  18. ) ;
  19. int umfpack_zi_report_symbolic
  20. (
  21. void *Symbolic,
  22. const double Control [UMFPACK_CONTROL]
  23. ) ;
  24. UF_long umfpack_zl_report_symbolic
  25. (
  26. void *Symbolic,
  27. const double Control [UMFPACK_CONTROL]
  28. ) ;
  29. /*
  30. double int Syntax:
  31. #include "umfpack.h"
  32. void *Symbolic ;
  33. double Control [UMFPACK_CONTROL] ;
  34. int status ;
  35. status = umfpack_di_report_symbolic (Symbolic, Control) ;
  36. double UF_long Syntax:
  37. #include "umfpack.h"
  38. void *Symbolic ;
  39. double Control [UMFPACK_CONTROL] ;
  40. UF_long status ;
  41. status = umfpack_dl_report_symbolic (Symbolic, Control) ;
  42. complex int Syntax:
  43. #include "umfpack.h"
  44. void *Symbolic ;
  45. double Control [UMFPACK_CONTROL] ;
  46. int status ;
  47. status = umfpack_zi_report_symbolic (Symbolic, Control) ;
  48. complex UF_long Syntax:
  49. #include "umfpack.h"
  50. void *Symbolic ;
  51. double Control [UMFPACK_CONTROL] ;
  52. UF_long status ;
  53. status = umfpack_zl_report_symbolic (Symbolic, Control) ;
  54. Purpose:
  55. Verifies and prints a Symbolic object. This routine checks the object more
  56. carefully than the computational routines. Normally, this check is not
  57. required, since umfpack_*_*symbolic either returns (void *) NULL, or a valid
  58. Symbolic object. However, if you suspect that your own code has corrupted
  59. the Symbolic object (by overruning memory bounds, for example), then this
  60. routine might be able to detect a corrupted Symbolic object. Since this is
  61. a complex object, not all such user-generated errors are guaranteed to be
  62. caught by this routine.
  63. Returns:
  64. UMFPACK_OK if Control [UMFPACK_PRL] is <= 2 (no inputs are checked).
  65. Otherwise:
  66. UMFPACK_OK if the Symbolic object is valid.
  67. UMFPACK_ERROR_invalid_Symbolic_object if the Symbolic object is invalid.
  68. UMFPACK_ERROR_out_of_memory if out of memory.
  69. Arguments:
  70. void *Symbolic ; Input argument, not modified.
  71. The Symbolic object, which holds the symbolic factorization computed by
  72. umfpack_*_*symbolic.
  73. double Control [UMFPACK_CONTROL] ; Input argument, not modified.
  74. If a (double *) NULL pointer is passed, then the default control
  75. settings are used. Otherwise, the settings are determined from the
  76. Control array. See umfpack_*_defaults on how to fill the Control
  77. array with the default settings. If Control contains NaN's, the
  78. defaults are used. The following Control parameters are used:
  79. Control [UMFPACK_PRL]: printing level.
  80. 2 or less: no output. returns silently without checking anything.
  81. 3: fully check input, and print a short summary of its status
  82. 4: as 3, but print first few entries of the input
  83. 5: as 3, but print all of the input
  84. Default: 1
  85. */