---
title: KmlDssSymAnalyze?I
description: "分析数据结构，对稀疏矩阵进行行/列重排和符号分解。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/240RC1/accel/kunpengaccel_kml_16_0476.html
sourcePath: /source/zh/kunpengboostkithistory/240RC1/accel/kunpengaccel_kml_16_0476.html
indexId: bd15045e6e42164e7e18c01f4722c76a5143fbeaa70a04a7e511322de6ef31c376
---
# KmlDssSymAnalyze?I

分析数据结构，对稀疏矩阵进行行/列重排和符号分解。

#### 接口定义

C Interface：

int KmlDssSymAnalyzeSI(KmlSolverTask **pHandle);

int KmlDssSymAnalyzeDI(KmlSolverTask **pHandle);

int KmlDssSymAnalyzeCI(KmlSolverTask **pHandle);

int KmlDssSymAnalyzeZI(KmlSolverTask **pHandle);


#### 参数

| 参数名 | 类型 | 描述 | 输入/输出 |
| --- | --- | --- | --- |
| pHandle | KmlSolverTask \*\* | 求解器句柄，传入之前步骤的变量。 | 输入 |


#### 返回值

| 返回值 | 类型 | 描述 |
| --- | --- | --- |
| KMLSS\_NO\_ERROR | int | 正常执行。 |
| KMLSS\_NULL\_ARGUMENT | int | pHandle为空指针。 |
| KMLSS\_BAD\_HANDLE | int | pHandle格式存在问题。 |
| KMLSS\_NONZERO\_INDEXING | int | 行索引指针不是从0开始，即ia[0]不等于0。 |
| KMLSS\_MISSING\_DIAGONAL\_ELEMENT | int | 稀疏矩阵对角线元素全部为空。 |
| KMLSS\_INTERNAL\_ERROR | int | 稀疏矩阵对角线存在空元素/算法内部执行失败。 |
| KMLSS\_REORDERING\_PROBLEM | int | 排序算法失败。 |


#### 依赖

#include "kml_dss.h"或#include "kml_solver.h"


#### 示例

C Interface：
```
int n = 8;
int ia[9] = {0, 2, 4, 6, 7, 8, 9, 10, 11};
int ja[11] = {0, 7, 1, 6, 2, 5, 3, 4, 5, 6, 7};
double a[11] = {1.0, 2.0, -2.0, 3.0, 3.0, 4.0, -4.0, 5.0, -6.0, 7.0, 8.0};
KmlSolverTask *handle;
int ierr = KmlDssSymInitDI(&handle, n, a, ja, ia);
if (ierr != 0) {
printf("\nERROR in KmlDssSymInitDI: %d", ierr);
}
ierr = KmlDssSymAnalyzeDI(&handle);
if (ierr != 0) {
printf("\nERROR in KmlDssSymAnalyzeDI: %d", ierr);
}
```