Developer Reference for Intel® oneAPI Math Kernel Library for C

ID 766684
Date 3/22/2024
Public

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

Document Table of Contents

vslSSEditCP

Modifies the pointers to cross-product matrix parameters.

Syntax

status = vslsSSEditCP(task, mean, sum, cp, cp_storage);

status = vsldSSEditCP(task, mean, sum, cp, cp_storage);

Include Files

  • mkl.h

Input Parameters

Name

Type

Description

task

VSLSSTaskPtr

Descriptor of the task

mean

float* for vslsSSEditCP

double* for vsldSSEditCP

Pointer to array of means

sum

float* for vslsSSEditCP

double* for vsldSSEditCP

Pointer to array of sums

cp

float* for vslsSSEditCP

double* for vsldSSEditCP

Pointer to a cross-product matrix

cp_storage

const MKL_INT*

Pointer to the storage format of the cross-product matrix

Output Parameters

Name

Type

Description

status

int

Current status of the task

Description

The vslSSEditCP routine replaces pointers to the array of means, array of sums, cross-product matrix, and its storage format with values passed as corresponding parameters of the routine. See Table: "Storage formats of a variance-covariance/correlation/cross-product matrix" for possible values of the cp_storage parameter. If you pass a value of NULL for a specific input parameter, the value of that parameter in the task descriptor is unchanged.

Storage formats of variance-covariance/correlation/cross-product matrices

Parameter

Description

VSL_SS_MATRIX_STORAGE_FULL

The array cp contains all elements of the matrix stored sequentially, row-by-row:

  • cp[0] contains c1, 1
  • cp[1] contains c1, 2
  • cp[p - 1] contains c1,p
  • cp[p] contains c2,1
  • cp[p*p - 1] contains cp,p

The size of array cp is p*p.

VSL_SS_MATRIX_STORAGE_L_PACKED

The array cp contains the lower triangular part of the symmetric matrix stored sequentially, row-by-row:

  • cp[0] contains c1, 1
  • cp[1] contains c2, 1
  • cp[2] contains c2, 2
  • and so on.

The size of the array is p*(p+ 1)/2.

VSL_SS_MATRIX_STORAGE_U_PACKED

The array cp contains the upper triangular part of the symmetric matrix stored sequentially, row-by-row:

  • cp[0] contains c1, 1
  • cp[1] contains c1, 2
  • cp[3] contains c1, 3
  • and so on.

The size of the array is p*(p+ 1)/2.