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.

Parameters of VSL Summary Statistics Task to Be Initialized or Modified

Parameter Value

Type

Purpose

VSL_SS_ED_DIMEN

i

Address of a variable that holds the task dimension

VSL_SS_ED_OBSERV_N

i

Address of a variable that holds the number of observations

VSL_SS_ED_OBSERV

d, s

Address of the observation matrix

VSL_SS_ED_OBSERV_STORAGE

i

Address of a variable that holds the storage format for the observation matrix

VSL_SS_ED_INDC

i

Address of the array of indices

VSL_SS_ED_WEIGHTS

d, s

Address of the array of observation weights

VSL_SS_ED_MEAN

d, s

Address of the array of means

VSL_SS_ED_2R_MOM

d, s

Address of an array of raw moments of the second order

VSL_SS_ED_3R_MOM

d, s

Address of an array of raw moments of the third order

VSL_SS_ED_4R_MOM

d, s

Address of an array of raw moments of the fourth order

VSL_SS_ED_2C_MOM

d, s

Address of an array of central moments of the second order

VSL_SS_ED_3C_MOM

d, s

Address of an array of central moments of the third order

VSL_SS_ED_4C_MOM

d, s

Address of an array of central moments of the fourth order

VSL_SS_ED_KURTOSIS

d, s

Address of the array of kurtosis estimates

VSL_SS_ED_SKEWNESS

d, s

Address of the array of skewness estimates

VSL_SS_ED_MIN

d, s

Address of the array of minimum estimates

VSL_SS_ED_MAX

d, s

Address of the array of maximum estimates

VSL_SS_ED_VARIATION

d, s

Address of the array of variation coefficients

VSL_SS_ED_COV

d, s

Address of a covariance matrix

VSL_SS_ED_COV_STORAGE

i

Address of the variable that holds the storage format for a covariance matrix

VSL_SS_ED_COR

d, s

Address of a correlation matrix

VSL_SS_ED_COR_STORAGE

i

Address of the variable that holds the correlation storage format for a correlation matrix

VSL_SS_ED_ACCUM_WEIGHT

d, s

Address of the array of size 2 that holds the accumulated weight (sum of weights) in the first position and the sum of weights squared in the second position

VSL_SS_ED_QUANT_ORDER_N

i

Address of the variable that holds the number of quantile orders

VSL_SS_ED_QUANT_ORDER

d, s

Address of the array of quantile orders

VSL_SS_ED_QUANT_QUANTILES

d, s

Address of the array of quantiles

VSL_SS_ED_ORDER_STATS

d, s

Address of the array of order statistics

VSL_SS_ED_GROUP_INDC

i

Address of the array of group indices used in computation of a pooled covariance matrix

VSL_SS_ED_POOLED_COV_STORAGE

i

Address of a variable that holds the storage format for a pooled covariance matrix

VSL_SS_ED_POOLED_MEAN

i

Address of an array of pooled means

VSL_SS_ED_POOLED_COV

d, s

Address of pooled covariance matrices

VSL_SS_ED_GROUP_COV_INDC

d, s

Address of an array of indices for which covariance/means should be computed

VSL_SS_ED_GROUP_MEANS

i

Address of an array of group means

VSL_SS_ED_GROUP_COV_STORAGE

d, s

Address of a variable that holds the storage format for a group covariance matrix

VSL_SS_ED_GROUP_COV

i

Address of group covariance matrices

VSL_SS_ED_ROBUST_COV_STORAGE

d, s

Address of a variable that holds the storage format for a robust covariance matrix

VSL_SS_ED_ROBUST_COV_PARAMS_N

i

Address of a variable that holds the number of algorithmic parameters of the method for robust covariance estimation

VSL_SS_ED_ROBUST_COV_PARAMS

d, s

Address of an array of parameters of the method for robust estimation of a covariance

VSL_SS_ED_ROBUST_MEAN

i

Address of an array of robust means

VSL_SS_ED_ROBUST_COV

d, s

Address of a robust covariance matrix

VSL_SS_ED_OUTLIERS_PARAMS_N

d, s

Address of a variable that holds the number of parameters of the outlier detection method

VSL_SS_ED_OUTLIERS_PARAMS

i

Address of an array of algorithmic parameters for the outlier detection method

VSL_SS_ED_OUTLIERS_WEIGHT

d, s

Address of an array of weights assigned to observations by the outlier detection method

VSL_SS_ED_ORDER_STATS_STORAGE

d, s

Address of a variable that holds the storage format of an order statistics matrix

VSL_SS_ED_PARTIAL_COV_IDX

i

Address of an array that encodes subcomponents of a random vector

VSL_SS_ED_PARTIAL_COV

d, s

Address of a partial covariance matrix

VSL_SS_ED_PARTIAL_COV_STORAGE

i

Address of a variable that holds the storage format of a partial covariance matrix

VSL_SS_ED_PARTIAL_COR

d, s

Address of a partial correlation matrix

VSL_SS_ED_PARTIAL_COR_STORAGE

i

Address of a variable that holds the storage format for a partial correlation matrix

VSL_SS_ED_MI_PARAMS_N

i

Address of a variable that holds the number of algorithmic parameters for the Multiple Imputation method

VSL_SS_ED_MI_PARAMS

d, s

Address of an array of algorithmic parameters for the Multiple Imputation method

VSL_SS_ED_MI_INIT_ESTIMATES_N

i

Address of a variable that holds the number of initial estimates for the Multiple Imputation method

VSL_SS_ED_MI_INIT_ESTIMATES

d, s

Address of an array of initial estimates for the Multiple Imputation method

VSL_SS_ED_MI_SIMUL_VALS_N

i

Address of a variable that holds the number of simulated values in the Multiple Imputation method

VSL_SS_ED_MI_SIMUL_VALS

d, s

Address of an array of simulated values in the Multiple Imputation method

VSL_SS_ED_MI_ESTIMATES_N

i

Address of a variable that holds the number of estimates obtained as a result of the Multiple Imputation method

VSL_SS_ED_MI_ESTIMATES

d, s

Address of an array of estimates obtained as a result of the Multiple Imputation method

VSL_SS_ED_MI_PRIOR_N

i

Address of a variable that holds the number of prior parameters for the Multiple Imputation method

VSL_SS_ED_MI_PRIOR

d, s

Address of an array of prior parameters for the Multiple Imputation method

VSL_SS_ED_PARAMTR_COR

d, s

Address of a parameterized correlation matrix

VSL_SS_ED_PARAMTR_COR_STORAGE

i

Address of a variable that holds the storage format of a parameterized correlation matrix

VSL_SS_ED_STREAM_QUANT_PARAMS_N

i

Address of a variable that holds the number of parameters of a quantile computation method for streaming data

VSL_SS_ED_STREAM_QUANT_PARAMS

d, s

Address of an array of parameters of a quantile computation method for streaming data

VSL_SS_ED_STREAM_QUANT_ORDER_N

i

Address of a variable that holds the number of quantile orders for streaming data

VSL_SS_ED_STREAM_QUANT_ORDER

d, s

Address of an array of quantile orders for streaming data

VSL_SS_ED_STREAM_QUANT_QUANTILES

d, s

Address of an array of quantiles for streaming data

 

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.

VSL Summary Statistics Task Editors

Editor

Description

EditTask

Changes a pointer in the task descriptor.

EditMoments

Changes pointers to arrays associated with raw and central moments.

EditCovCor

Changes pointers to arrays associated with covariance and/or correlation matrices.

EditPartialCovCor

Changes pointers to arrays associated with partial covariance and/or correlation matrices.

EditQuantiles

Changes pointers to arrays associated with quantile/order statistics calculations.

EditStreamQuantiles

Changes pointers to arrays for quantile related calculations for streaming data.

EditPooledCovariance

Changes pointers to arrays associated with algorithms related to a pooled covariance matrix.

EditRobustCovariance

Changes pointers to arrays for robust estimation of a covariance matrix and mean.

EditOuliersDetection

Changes pointers to arrays for detection of outliers.

EditMissingValues

Changes pointers to arrays associated with the method of supporting missing values in a dataset.

EditCorParameterization

Changes pointers to arrays associated with the algorithm for parameterization of a correlation matrix.

Note iconNote

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


Submit feedback on this help topic

Copyright © 1994 - 2010, Intel Corporation. All rights reserved.