Package org.apfloat.spi

Interface MatrixStrategy

All Known Implementing Classes:

DoubleMatrixStrategy, FloatMatrixStrategy, IntAparapiMatrixStrategy, IntMatrixStrategy, LongAparapiMatrixStrategy, LongMatrixStrategy

public interface MatrixStrategy

Matrix operations.

Since:

1.7.0

Version:

1.7.0

Author:

Mikko Tommila

Method Summary

Modifier and Type	Method	Description
void	permuteToDoubleWidth(ArrayAccess arrayAccess, int n1, int n2)	Permute the rows of the n1 x n2 matrix so that it is shaped like a n1/2 x 2*n2 matrix.
void	permuteToHalfWidth(ArrayAccess arrayAccess, int n1, int n2)	Permute the rows of the n1 x n2 matrix so that it is shaped like a 2*n1 x n2/2 matrix.
void	transpose(ArrayAccess arrayAccess, int n1, int n2)	Transpose a n1 x n2 matrix.
void	transposeSquare(ArrayAccess arrayAccess, int n1, int n2)	Transpose a square n1 x n1 block of n1 x n2 matrix.

Method Details

transpose

void transpose(ArrayAccess arrayAccess,
 int n1,
 int n2)
        throws ApfloatRuntimeException

Transpose a n₁ x n₂ matrix.

Both n₁ and n₂ must be powers of two. Additionally, one of these must be true:

n₁ = n₂
n₁ = 2*n₂
n₂ = 2*n₁

Parameters:

arrayAccess - Accessor to the matrix data. This data will be transposed.

n1 - Number of rows in the matrix.

n2 - Number of columns in the matrix.

Throws:

ApfloatRuntimeException

transposeSquare

void transposeSquare(ArrayAccess arrayAccess,
 int n1,
 int n2)
              throws ApfloatRuntimeException

Transpose a square n₁ x n₁ block of n₁ x n₂ matrix.

Both n₁ and n₂ must be powers of two, and n₁ <= n₂.

Parameters:

arrayAccess - Accessor to the matrix data. This data will be transposed.

n1 - Number of rows and columns in the block to be transposed.

n2 - Number of columns in the matrix.

Throws:

ApfloatRuntimeException

permuteToDoubleWidth

void permuteToDoubleWidth(ArrayAccess arrayAccess,
 int n1,
 int n2)
                   throws ApfloatRuntimeException

Permute the rows of the n₁ x n₂ matrix so that it is shaped like a n₁/2 x 2*n₂ matrix. Logically, the matrix is split in half, and the lower half is moved to the right side of the upper half.

Both n₁ and n₂ must be powers of two, and n₁ >= 2.

E.g. if the matrix layout is originally as follows:

Matrix before

0	1	2	3
4	5	6	7
8	9	10	11
12	13	14	15

Then after this method it is as follows:

Matrix after

0	1	2	3	8	9	10	11
4	5	6	7	12	13	14	15

Parameters:

arrayAccess - Accessor to the matrix data. This data will be permuted.

n1 - Number of rows in the matrix.

n2 - Number of columns in the matrix.

Throws:

ApfloatRuntimeException

Since:

1.7.0

permuteToHalfWidth

void permuteToHalfWidth(ArrayAccess arrayAccess,
 int n1,
 int n2)
                 throws ApfloatRuntimeException

Permute the rows of the n₁ x n₂ matrix so that it is shaped like a 2*n₁ x n₂/2 matrix. Logically, the matrix is split in half, and the right half is moved below the left half.

Both n₁ and n₂ must be powers of two. E.g. if the matrix layout is originally as follows:

Matrix before

0	1	2	3	4	5	6	7
8	9	10	11	12	13	14	15

Then after this method it is as follows:

Matrix after

0	1	2	3
8	9	10	11
4	5	6	7
12	13	14	15

Parameters:

arrayAccess - Accessor to the matrix data. This data will be permuted.

n1 - Number of rows in the matrix.

n2 - Number of columns in the matrix.

Throws:

ApfloatRuntimeException