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

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