---
title: KmlScadssFactorize
description: "对矩阵做数值分解，需先使用KmlScadssAnalyze进行分析。"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpckit/devg/kunpengaccel_kml_1015.html
sourcePath: /source/zh/kunpenghpcs/hpckit/devg/kunpengaccel_kml_1015.html
indexId: 54fd87d96414344171955fb5f73df51dd17824eab3a590e52520da4378153c5961
---
# 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"