EditPooledCovariance

Modifies pooled/group covariance matrix array pointers.

Syntax

Fortran:

status = vslssseditpooledcovariance(task, grp_indices, pld_mean, pld_cov, grp_cov_indices, grp_means, grp_cov)

status = vsldsseditpooledcovariance(task, grp_indices, pld_mean, pld_cov, grp_cov_indices, grp_means, grp_cov)

status = vslsSSEditPooledCovariance(task, grp_indices, pld_mean, pld_cov, grp_cov_indices, grp_means, grp_cov);

status = vsldSSEditPooledCovariance(task, grp_indices, pld_mean, pld_cov, grp_cov_indices, grp_means, grp_cov);

Include Files

The Fortran 90 interfaces are specified in the mkl_vsl.f90 include file, and the C interfaces are specified in the mkl_vsl_functions.h include file.

Input Parameters

Name	Type	Description
task	Fortran: TYPE(VSL_SS_TASK) C: VSLSSTaskPtr	Descriptor of the task
grp_indices	Fortran: INTEGER DIMENSION() C: MKL_INT	Pointer to an array of size `n`. The `i`-th element of the array contains the number of the group the observation belongs to.
pld_mean	Fortran: REAL(KIND=4) DIMENSION() for vslssseditpooledcovariance REAL(KIND=8) DIMENSION() for vsldsseditpooledcovariance C: float* for vslsSSEditPooledCovariance double* for vsldSSEditPooledCovariance	Pointer to the array of pooled means
pld_cov	Fortran: REAL(KIND=4) DIMENSION() for vslssseditpooledcovariance REAL(KIND=8) DIMENSION() for vsldsseditpooledcovariance C: float* for vslsSSEditPooledCovariance double* for vsldSSEditPooledCovariance	Pointer to the array that holds a pooled covariance matrix
grp_cov_indices	Fortran: INTEGER DIMENSION() C: MKL_INT	Pointer to the array that contains indices of group covariance matrices to return
grp_means	Fortran: REAL(KIND=4) DIMENSION() for vslssseditpooledcovariance REAL(KIND=8) DIMENSION() for vsldsseditpooledcovariance C: float* for vslsSSEditPooledCovariance double* for vsldSSEditPooledCovariance	Pointer to the array of group means
grp_cov	Fortran: REAL(KIND=4) DIMENSION() for vslssseditpooledcovariance REAL(KIND=8) DIMENSION() for vsldsseditpooledcovariance C: float* for vslsSSEditPooledCovariance double* for vsldSSEditPooledCovariance	Pointer to the array that holds group covariance matrices

Output Parameters

Name	Type	Description
status	Fortran: INTEGER C: int	Current status of the task

Name

Type

Description

status

Fortran: INTEGER

C: int

Current status of the task

Description

The EditPooledCovariance routine replaces pointers to the array of group indices, the array of pooled means, the array for a pooled covariance matrix, and pointers to the array of indices of group matrices, the array of group means, and the array for group covariance matrices with values passed in the editors. If an input parameter is NULL, the corresponding parameter in the VSL Summary Statistics task descriptor remains unchanged. Use the EditTask routine to replace the storage format for pooled and group covariance matrices.