KmlIssCgGet?I?

获得迭代求解相关参数。

接口定义

C Interface：

int KmlIssCgGetSII(KmlSolverTask **handle, enum KML_SOLVER_PARAM param, int *data, int nd);

int KmlIssCgGetDII(KmlSolverTask **handle, enum KML_SOLVER_PARAM param, int *data, int nd);

int KmlIssCgGetSIS(KmlSolverTask **handle, enum KML_SOLVER_PARAM param, float *data, int nd);

int KmlIssCgGetDID(KmlSolverTask **handle, enum KML_SOLVER_PARAM param, double *data, int nd);

参数

参数名

类型

描述

输入/输出

handle

KmlSolverTask **

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

输入/输出

param

enum KML_SOLVER_PARAM
  • ITERATION_COUNT表示迭代次数。
  • TOLERANCE表示最终的迭代残差。

输入

data
  • 在KmlIssCgGetSII中为int *。
  • 在KmlIssCgGetDII中为int *。
  • 在KmlIssCgGetSIS中为float *。
  • 在KmlIssCgGetDID中为double *。
  • 在KmlIssCgGetSII中为迭代步数。
  • 在KmlIssCgGetDII中为迭代步数。
  • 在KmlIssCgGetSIS中为残差。
  • 在KmlIssCgGetDID中为残差。

输入

nd

int

data数组元素个数。

输入

返回值

返回值

类型

描述

NO_ERROR

int

正常执行。

DATA_SIZE_ERROR

int

数据个数错误。

KML_SOLVER_INVALID_ARGUMENT

int

无效的参数。

依赖

#include "kml_iss.h"

示例

C Interface：

    KmlSolverTask *handle
    int n = 8;   
    double a[17] = { 1.0,1.0,2.0,9.0,2.0,1.0,-3.0,3.0,2.0,9.0,-5.0,6.0,1.0,4.0,1.0,7.0,2.0 };
    int ja[17] = { 0,3,4,1,2,3,5,2,7,3,6,4,5,5,7,6,7 };
    int ia[9] = {0, 3, 7, 9, 11, 13, 15, 16, 17};
    int nb = 1;
    double x[8];
    int ldx = n;
    double b[8] = {4.0, 9.0, 7.0, 6.0, 9.0, 3.0, 2.0, 5.0};
    int ldb = n;
    int data[] = {0};
    int nd = 1;
    double data1[] = {0};
    KML_SOLVER_PARAM param = ITERATION_COUNT;
    int ierr;
    ierr = KmlIssCgInitDI(&handle, n, a, ja, ia);
    ierr = KmlIssCgAnalyzeDI(&handle);
    ierr = KmlIssCgFactorizeDI(&handle);
    ierr = KmlIssCgSolveDI(&handle, nb, x, ldx, b, ldb);
    ierr = KmlIssCgGetDII(&handle, param, data, nd);
    param = TOLERANCE;
    ierr = KmlIssCgGetDID(&handle, param, data1, nd);
父主题： CG