Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
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. |