Data Type

Integer

Default Value

2

Description

This parameter controls the amount of printed output produced by calls to the matrix factoring routines RSDAF, RNDAF, CHDAF, CSDAF, CNDAF, RSDF, RNDF, CHDF, CSDF, CNDF and RSDEX, RNDEX, CHDEX, CSDEX, CNDEX. The print code summary table lists the values of IPRF and the output produced.

The following is a detailed description of each option. The value of IPRF you specify is obtained by adding together the numeric value of each option you select. Because these numeric values are a power of 2, they have the effect of setting bits in IPRF.

  • 0, No output from matrix factoring is printed.
  • +1, Start and stop timing is printed.
    The following is an example: 
     START OF FMS MATRIX FACTORING
 END   OF FMS MATRIX FACTORING.
 TIME(SEC): CPU   =       0.740,        WALL=       0.930
  • +2, Timing information for each matrix segment is printed.
    The output also includes the inverse condition number (also available as FMS Parameter CONINV). The following is an example: 
     F M S     M A T R I X     F A C T O R I N G
 <----FUNCTION--->   <-EQUATIONS->     <-CPU  TIME(SEC)->     <-WALL TIME(SEC)->
                     FIRST    LAST     DELTA        TOTAL     DELTA        TOTAL
 MATRIX FACTORING        1     224     0.144        0.144     0.325        0.325
 MATRIX FACTORING      225     400     0.134        0.278     0.152        0.477
 MATRIX FACTORING      401     576     0.125        0.403     0.138        0.615
 MATRIX FACTORING      577     752     0.129        0.532     0.142        0.757
 MATRIX FACTORING      753     928     0.142        0.673     0.155        0.912
 MATRIX FACTORING      929    1000     0.071        0.745     0.087        0.999
 Inverse condition number...........= 0.0008333333
  • +4, Right-hand side vectors {RHS} are printed before forward reduction.
  • +8, Right-hand side vectors are printed after they have been reduced by the lower triangle factor, [L]-1{RHS}.
  • +16, The reduced vectors are printed after diagonal scaling, [1/D][L]-1{RHS} (symmetric matrices only).
  • +32, Information is printed about each equation that is pivoted.
    This applies to slab matrices ( MFMAT=3) only.
    CAUTION: This can produce a line of output for each equation.
  • +64, The matrix diagonals [D] are printed before factoring.
  • +128, The diagonal factor reciprocals [1/D] are printed after factoring.
  • +256, The lower triangle matrix [AL] and upper triangle matrix [AU] (nonsymmetric) are printed before factoring.
  • +512, The lower triangle factor [L] and upper triangle factor [U] (nonsymmetric) are printed after factoring.
  • +1024, The actual performance achieved in Megaflops is printed.
    This computation is based on an actual count of the number of floating point operations (adds and multiplies) required for this matrix and vector(s) and the actual time required.
    NOTE: The operation count may take some time. Therefore this option is not recommended as a default for production applications. It is provided for application tuning.
  • 2048, The number of matrix terms and the number of zeros before and after factoring are counted and printed. A report of the matrix density in the following form is produced: 
    Number of matrix terms.............=         95050.
Number of zeros before factoring...=         93051., ( 97) percent
Number of zeros after  factoring...=             0., (  0) percent

CAUTION: For large problems this parameter can produce a lot of output. You can use the FMS Parameters NEQPR1 and NEQPR2 to create a window on the matrix and vector terms printed.