Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 11/07/2023
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_vsl.f90

Input Parameters

Name

Type

Description

task

Fortran: TYPE(VSL_SS_TASK)

Descriptor of the task

mean

Fortran: REAL(KIND=4) DIMENSION(*) for vslssseditcp

REAL(KIND=8) DIMENSION(*) for vsldsseditcp

Pointer to array of means

sum

Fortran: REAL(KIND=4) DIMENSION(*) for vslssseditcp

REAL(KIND=8) DIMENSION(*) for vsldsseditcp

Pointer to array of sums

cp

Fortran: REAL(KIND=4) DIMENSION(*) for vslssseditcp

REAL(KIND=8) DIMENSION(*) for vsldsseditcp

Pointer to a cross-product matrix

cp_storage

Fortran: INTEGER

Pointer to the storage format of the cross-product matrix

Output Parameters

Name

Type

Description

status

Fortran: INTEGER

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, column-by-column:

  • cp(1) contains c1, 1
  • cp(2) contains c2, 1
  • cp(p) contains cp, 1
  • cp(p + 1) contains c1, 2
  • cp(p*p) 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, column-by-column:

  • cp(1) contains c1, 1
  • cp(2) contains c2, 1
  • cp(3) contains c3, 1
  • 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, column-by-column:

  • cp(1) contains c1, 1
  • cp(2) contains c1, 2
  • cp(3) contains c2, 2
  • and so on.

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