uls_control_type structure

    struct uls_control_type{T,INT}
      f_indexing::Bool
      error::INT
      warning::INT
      out::INT
      print_level::INT
      print_level_solver::INT
      initial_fill_in_factor::INT
      min_real_factor_size::INT
      min_integer_factor_size::INT
      max_factor_size::Int64
      blas_block_size_factorize::INT
      blas_block_size_solve::INT
      pivot_control::INT
      pivot_search_limit::INT
      minimum_size_for_btf::INT
      max_iterative_refinements::INT
      stop_if_singular::Bool
      array_increase_factor::T
      switch_to_full_code_density::T
      array_decrease_factor::T
      relative_pivot_tolerance::T
      absolute_pivot_tolerance::T
      zero_tolerance::T
      acceptable_residual_relative::T
      acceptable_residual_absolute::T
      prefix::NTuple{31,Cchar}

detailed documentation

control derived type as a Julia structure

components

Bool f_indexing

use C or Fortran sparse matrix indexing

INT error

unit for error messages

INT warning

unit for warning messages

INT out

unit for monitor output

INT print_level

controls level of diagnostic output

INT print_level_solver

controls level of diagnostic output from external solver

INT initial_fill_in_factor

prediction of factor by which the fill-in will exceed the initial number of nonzeros in \(A\)

INT min_real_factor_size

initial size for real array for the factors and other data

INT min_integer_factor_size

initial size for integer array for the factors and other data

Int64 max_factor_size

maximum size for real array for the factors and other data

INT blas_block_size_factorize

level 3 blocking in factorize

INT blas_block_size_solve

level 2 and 3 blocking in solve

INT pivot_control

pivot control:

• 1 Threshold Partial Pivoting is desired

• 2 Threshold Rook Pivoting is desired

• 3 Threshold Complete Pivoting is desired

• 4 Threshold Symmetric Pivoting is desired

• 5 Threshold Diagonal Pivoting is desired

INT pivot_search_limit

number of rows/columns pivot selection restricted to (0 = no restriction)

INT minimum_size_for_btf

the minimum permitted size of blocks within the block-triangular form

INT max_iterative_refinements

maximum number of iterative refinements allowed

Bool stop_if_singular

stop if the matrix is found to be structurally singular

T array_increase_factor

factor by which arrays sizes are to be increased if they are too small

T switch_to_full_code_density

switch to full code when the density exceeds this factor

T array_decrease_factor

if previously allocated internal workspace arrays are greater than array_decrease_factor times the currently required sizes, they are reset to current requirements

T relative_pivot_tolerance

pivot threshold

T absolute_pivot_tolerance

any pivot small than this is considered zero

T zero_tolerance

any entry smaller than this in modulus is reset to zero

T acceptable_residual_relative

refinement will cease as soon as the residual \(\|Ax-b\|\) falls below max( acceptable_residual_relative \* \(\|b\|\), acceptable_residual_absolute )

T acceptable_residual_absolute

see acceptable_residual_relative

NTuple{31,Cchar} prefix

all output lines will be prefixed by prefix(2:LEN(TRIM(.prefix))-1) where prefix contains the required string enclosed in quotes, e.g. “string” or ‘string’