KmlScaissBicgstabSubPcSet?I?

设置迭代求解的block jacobi中子预条件子相关参数。

接口定义

C Interface：

int KmlScaissBicgstabSubPcSetSII(KmlScasolverTask **handle, enum KmlSolverPreconditionerParam param, int subn, const int *data, int nd);

int KmlScaissBicgstabSubPcSetDII(KmlScasolverTask **handle, enum KmlSolverPreconditionerParam param, int subn, const int *data, int nd);

int KmlScaissBicgstabSubPcSetSIS(KmlScasolverTask **handle, enum KmlSolverPreconditionerParam param, int subn, const float *data, int nd);

int KmlScaissBicgstabSubPcSetDID(KmlScasolverTask **handle, enum KmlSolverPreconditionerParam param, int subn, const double *data, int nd);

参数

参数名

类型

描述

输入/输出

handle

KmlScasolverTask **

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

输入/输出

param

enum KmlSolverParam
  • KML_RELAXATION_FACTOR表示SOR预条件子相关参数。
  • KMLSS_DROP_FILL表示ILUT预条件子每行最多保留元素个数。
  • KMLSS_DROP_TOL表示ILUT预条件子保留元素的阈值。

输入

subn

在KmlScaissBicgstabSubPcSetSIS、KmlScaissBicgstabSubPcSetSII、KmlScaissBicgstabSubPcSetDII、KmlScaissBicgstabSubPcSetDID中为int。

子预条件子索引。

输入

data
  • 在KmlScaissBicgstabSubPcSetSII、KmlScaissBicgstabSubPcSetDII中为const int *。
  • 在KmlScaissBicgstabSubPcSetSIS中为const float *。
  • 在KmlScaissBicgstabSubPcSetDID中为const double *。

预条件子相关参数。

输入

nd
  • 在KmlScaissBicgstabSubPcSetSIS、KmlScaissBicgstabSubPcSetSII、KmlScaissBicgstabSubPcSetDII、KmlScaissBicgstabSubPcSetDID中为int。

data数组元素个数。

输入

返回值

返回值

类型

描述

KMLSS_NO_ERROR

int

正常执行。

KMLSS_DATA_SIZE

int

参数nd不等于1。

KMLSS_NULL_ARGUMENT

int

handle，data中存在空参数。

KMLSS_BAD_SELECTOR

int

param为无效参数。

KMLSS_BAD_PRECONDITIONER

int

选择的预条件子暂未实现。
父主题： SCAISS-BICGSTAB