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

p?max1

Finds the index of the element whose real part has maximum absolute value (similar to the Level 1 PBLAS p?amax, but using the absolute value to the real part).

Syntax

call pcmax1(n, amax, indx, x, ix, jx, descx, incx)

call pzmax1(n, amax, indx, x, ix, jx, descx, incx)

Description

The p?max1routine computes the global index of the maximum element in absolute value of a distributed vector sub(X). The global index is returned in indx and the value is returned in amax, where sub(X) denotes X(ix:ix+n-1, jx) if incx = 1, X(ix, jx:jx+n-1) if incx = m_x.

Input Parameters

n

(global) pointer to INTEGER. The number of components of the distributed vector sub(X). n 0.

x

(local)

COMPLEX for pcmax1.

COMPLEX*16 for pzmax1

Pointer into the local memory to an array of size (lld_x, LOCc(jx+n-1)). On entry this array contains the local pieces of the distributed vector sub(X).

ix

(global) INTEGER. The row index in the global matrix X indicating the first row of sub(X).

jx

(global) INTEGER. The column index in the global matrix X indicating the first column of sub(X).

descx

(global and local) INTEGER. Array of size dlen_. The array descriptor for the distributed matrix X.

incx

(global)INTEGER.The global increment for the elements of X. Only two values of incx are supported in this version, namely 1 and m_x. incx must not be zero.

Output Parameters

amax

(global output) pointer to REAL.The absolute value of the largest entry of the distributed vector sub(X) only in the scope of sub(X).

indx

(global output) pointer to INTEGER.The global index of the element of the distributed vector sub(X) whose real part has maximum absolute value.

See Also