KmlScadssInit

创建求解器操作句柄。

接口定义

C Interface:

int KmlScadssInit(KmlScadssSolver **pSolver, const KmlDssInitOption *basicOptions, const KmlScadssInitOption *scaOptions);

参数

参数名

类型

描述

输入/输出

pSolver

KmlScadssSolver **

求解器句柄,传入之前步骤的变量。

输入/输出

basicOptions

KmlDssInitOption *

求解器基础配置选项,不可为空指针,具体内容如4.3.3.10.2.1-表1所示。

输入

scaOptions

KmlScadssInitOption *

求解器分布式配置选项,具体内容如表1所示。

输入

表1 KmlScadssInitOption结构体字段描述

字段名

类型

描述

fieldMask

uint64_t

配置生效的字段掩码。非0的位代表配置对应字段指定的值,0的位代表使用默认值,可配置的掩码位见具体字段的说明。

comm

MPI_Comm

MPI通信子。

掩码位:KMLSCADSS_OPTIONS_COMM

autotune

int8_t

指示是否允许求解器实例自动调整输入的进程与线程配比以获得更好的性能,但该参数不会调整Fillin Reduction的进程线程数。有如下值。

  • 0表示关闭自动调整,默认选项。
  • 1表示开启自动调整。

掩码位:KMLSCADSS_OPTIONS_AUTOTUNE

返回值

返回值

类型

描述

KMLSS_NO_ERROR

int

正常执行。

KMLSS_INTERNAL_ERROR

int

内部错误。

KMLSS_NULL_ARGUMENT

int

pSolver,basicOptions,scaOptions存在空参数。

依赖

#include "kml_scadss.h"