Developer Reference for Intel® oneAPI Math Kernel Library for C
Summary Statistics Task Editors
Task editors are intended to set up or change the task parameters listed in Table “Parameters of Summary Statistics Task to Be Initialized or Modified” . As an example, to compute the sample mean for a one-dimensional dataset, initialize a variable for the mean value, and pass its address into the task as shown in the example below:
#define DIM 1
#define N 1000
int main()
{
VSLSSTaskPtr task;
double x[N];
double mean;
MKL_INT p, n, xstorage;
int status;
/* initialize variables used in the computations of sample mean */
p = DIM;
n = N;
xstorage = VSL_SS_MATRIX_STORAGE_ROWS;
mean = 0.0;
/* create task */
status = vsldSSNewTask( &task, &p, &n, &xstorage, x, 0, 0 );
/* initialize task parameters */
status = vsldSSEditTask( task, VSL_SS_ED_MEAN, &mean );
/* compute mean using SS fast method */
status = vsldSSCompute(task, VSL_SS_MEAN, VSL_SS_METHOD_FAST );
/* deallocate task resources */
status = vslSSDeleteTask( &task );
return 0;
}Use the single ( vslsssedittask ) or double ( vsldssedittask ) version of an editor, to initialize single or double precision version task parameters, respectively. Use an integer version of an editor ( vslissedittask ) to initialize parameters of the integer type.
Table “Summary Statistics Task Editors” lists the task editors for Summary Statistics. Each of them initializes and/or modifies a respective group of related parameters.
Summary Statistics Task Editors
Editor |
Description |
|---|---|
vslSSEditTask (Modifies address of an input/output parameter in the task descriptor.) |
Changes a pointer in the task descriptor. |
vslSSEditMoments (Modifies the pointers to arrays that hold moment estimates.) |
Changes pointers to arrays associated with raw and central moments. |
Modifies the pointers to arrays that hold sum estimates. |
|
vslSSEditCovCor (Modifies the pointers to covariance/correlation/cross-product parameters.) |
Changes pointers to arrays associated with covariance and/or correlation matrices. |
Modifies the pointers to cross-product matrix parameters. |
|
vslSSEditPartialCovCor (Modifies the pointers to partial covariance/correlation parameters.) |
Changes pointers to arrays associated with partial covariance and/or correlation matrices. |
vslSSEditQuantiles (Modifies the pointers to parameters related to quantile computations.) |
Changes pointers to arrays associated with quantile/order statistics calculations. |
vslSSEditStreamQuantiles (Modifies the pointers to parameters related to quantile computations for streaming data.) |
Changes pointers to arrays for quantile related calculations for streaming data. |
vslSSEditPooledCovariance (Modifies pooled/group covariance matrix array pointers.) |
Changes pointers to arrays associated with algorithms related to a pooled covariance matrix. |
vslSSEditRobustCovariance (Modifies pointers to arrays related to a robust covariance matrix.) |
Changes pointers to arrays for robust estimation of a covariance matrix and mean. |
vslSSEditOutliersDetection (Modifies array pointers related to multivariate outliers detection.) |
Changes pointers to arrays for detection of outliers. |
vslSSEditMissingValues (Modifies pointers to arrays associated with the method of supporting missing values in a dataset.) |
Changes pointers to arrays associated with the method of supporting missing values in a dataset. |
vslSSEditCorParameterization (Modifies pointers to arrays related to the algorithm of correlation matrix parameterization.) |
Changes pointers to arrays associated with the algorithm for parameterization of a correlation matrix. |