KmlScadssFactorize

对矩阵做数值分解,需先使用KmlScadssAnalyze进行分析。

接口定义

C Interface:

int KmlScadssFactorize(KmlScadssSolver *solver, KmlScasolverMatrix *matrix, const KmlDssFactorizeOption *basicOptions, const KmlScadssFactorizeOption *scaOptions);

参数

参数名

类型

描述

输入/输出

solver

KmlScadssSolver *

由KmlScadssInit创建的求解器句柄。

输入

matrix

KmlSolverMatrix *

矩阵句柄,由KmlSolverMatrixCreate函数创建,不可为空指针。

输入

basicOptions

KmlDssFactorizeOption *

分解阶段基础配置选项,不可为空指针,具体内容如4.3.3.10.2.3-表1所示。

输入

scaOptions

KmlScadssFactorizeOption *

分解阶段分布式配置选项,具体内容如表1所示(暂无配置项)。

输入

表1 KmlScadssFactorizeOption结构体字段描述

字段名

类型

描述

fieldMask

uint64_t

配置生效的字段掩码。非0的位代表配置对应字段指定的值,0的位代表使用默认值,暂无可配置的掩码位。

返回值

返回值

类型

描述

KMLSS_NO_ERROR

int

正常执行。

KMLSS_INTERNAL_ERROR

int

内部错误。

KMLSS_NULL_ARGUMENT

int

solver,matrix,basicOptions,scaOptions存在空参数。

依赖

#include "kml_scadss.h"