dss_factor_real, dss_factor_complex

Compute factorization of the matrix with previously specified location.

Syntax

C:

dss_factor_real(handle, opt, rValues)

dss_factor_complex(handle, opt, cValues)

FORTRAN 77:

call dss_factor_real(handle, opt, rValues)

call dss_factor_complex(handle, opt, cValues)

Fortran 90:

unified Fortran 90 interface:

call dss_factor(handle, opt, Values)

or FORTRAN 77 like interface:

call dss_factor_real(handle, opt, rValues)

call dss_factor_complex(handle, opt, cValues)

Include Files

The FORTRAN 77 interface is specified in the mkl_dss.f77 include file, the Fortran 90 interface is specified in the mkl_dss.f90 include file, and the C interface is specified in the mkl_dss.h include file.

Description

These routines compute factorization of the matrix whose non-zero locations were previously specified by a call to dss_define_structure and whose non-zero values are given in the array rValues, cValues or Vulues . These arrays are assumed to be of length nNonZeros as defined in a previous call to dss_define_structure.

The opt argument should contain one of the following options:

depending on whether the user's matrix is positive definite, indefinite, or Hermitian.

Note iconNote

This routine supports the Progress Routine feature. See Progress Function for details.

Input Parameters

Name

Type

Description

handle

FORTRAN 77: INTEGER*8

Fortran 90: TYPE (MKL_DSS_HANDLE), INTENT(INOUT)

C: _MKL_DSS_HANDLE_t*

Pointer to the data structure storing intermediate DSS results (MKL_DSS_HANDLE).

opt

FORTRAN 77: INTEGER

Fortran 90: INTEGER, INTENT(IN)

C: _INTEGER_t const*

Parameter to pass the DSS options. The default value is MKL_DSS_POSITIVE_DEFINITE.

rValues

FORTRAN 77: REAL*4 or

REAL*8

Fortran 90: REAL(KIND=4), INTENT(IN) or

REAL(KIND=8), INTENT(IN)

C: VOID const*

Array of elements of the matrix A. Real data, single or double precision*).

cValues

FORTRAN 77: COMPLEX*8 or

COMPLEX*16

Fortran 90: COMPLEX(KIND=4), INTENT(IN) or

COMPLEX(KIND=8), INTENT(IN)

C: VOID const*

Array of elements of the matrix A. Complex data, single or double precision*).

Values

Fortran 90: REAL(KIND=4), INTENT(OUT), or

REAL(KIND=8), INTENT(OUT), or

COMPLEX(KIND=4), INTENT(OUT), or

COMPLEX(KIND=8), INTENT(OUT)

Array of elements of the matrix A. Real or complex data, single or double precision*).

*) - data type (single or double precision) must be in correspondence with precision specified by the parameter opt in the routine dss_create.

Return Values

MKL_DSS_SUCCESS

MKL_DSS_STATE_ERR

MKL_DSS_INVALID_OPTION

MKL_DSS_OPTION_CONFLICT

MKL_DSS_OUT_OF_MEMORY

MKL_DSS_ZERO_PIVOT

See Also


Submit feedback on this help topic

Copyright © 1994 - 2010, Intel Corporation. All rights reserved.