Task Editors

Task editors are intended to set up or change the task parameters listed in Table "Parameters of VSL 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 "VSL Summary Statistics Task Editors" lists the task editors for VSL Summary Statistics. Each of them initializes and/or modifies a respective group of related parameters.

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.