** Next:** Effect and Restrictions
** Up:** The Java Adlib API
** Previous:** Effect and Restrictions
** Contents**

A `maxvalDim()` method is a reduction operation for finding the
largest elements of a distributed array along one of its dimensions,
yielding a reduced array with the rank one less than the source.
It has two prototypes
and
where the variable runs over all primitive types other than boolean,
and the notation ` #`

means a multiarray of arbitrary rank,
with elements of type .
The result of this operation is written in `res`.
The reduction occurs in dimension `dimension`.
The second form takes an extra boolean array aligned with the source array
and ignores all elements of `source` for which the corresponding element of
`mask` is false.
The `maxvalDim` method is implemented by a schedule object with HPspmd
class `MaxvalDim`.
Each primitive types other than boolean has its own schedule class.
This class has two constructors with arguments identical to the method above,
and has one public method with no arguments called `execute()`,
which executes the schedule.
The effective public interface of the `MaxvalDim` class is
The source array is `source` and the result array is `res`.
They will both have elements of type .
The reduction occurs in dimension `dimension`.
The mask array is `mask`.

**Subsections**

** Next:** Effect and Restrictions
** Up:** The Java Adlib API
** Previous:** Effect and Restrictions
** Contents**
Bryan Carpenter
2004-06-09