Summary Statistics Task Editors

Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

Download PDF

ID 766686

Date 3/22/2024

Version

Public

A newer version of this document is available. Customers should click here to go to the newest version.

Visible to Intel only — GUID: GUID-9D27013C-5463-4596-BB93-7E9993ADE2D6

View Details

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	Changes a pointer in the task descriptor.
vslSSEditMoments	Changes pointers to arrays associated with raw and central moments.
vslSSEditSums	Modifies the pointers to arrays that hold sum estimates.
vslSSEditCovCor	Changes pointers to arrays associated with covariance and/or correlation matrices.
vslSSEditCP	Modifies the pointers to cross-product matrix parameters.
vslSSEditPartialCovCor	Changes pointers to arrays associated with partial covariance and/or correlation matrices.
vslSSEditQuantiles	Changes pointers to arrays associated with quantile/order statistics calculations.
vslSSEditStreamQuantiles	Changes pointers to arrays for quantile related calculations for streaming data.
vslSSEditPooledCovariance	Changes pointers to arrays associated with algorithms related to a pooled covariance matrix.
vslSSEditRobustCovariance	Changes pointers to arrays for robust estimation of a covariance matrix and mean.
vslSSEditOutliersDetection	Changes pointers to arrays for detection of outliers.
vslSSEditMissingValues	Changes pointers to arrays associated with the method of supporting missing values in a dataset.
vslSSEditCorParameterization	Changes pointers to arrays associated with the algorithm for parameterization of a correlation matrix.

NOTE:

You can use the NULL task pointer in calls to editor routines. In this case, the routine is terminated and no system crash occurs.

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

Summary Statistics Task Editors