MATRIX (kmatrix) functions


LIBRARY ROUTINE

lmexchg - exchange rows and/or columns of a matrix

LIBRARY CALL

int lmexchg( kobject in_obj, int r1, int r2, int c1, int c2, kobject out_obj)

INPUT

OUTPUT

RETURN VALUE

TRUE (1) on success, FALSE (0) otherwise

DESCRIPTION

lmexchg can exchange one pair of rows and one pair of columns of a matrix. If only a column exchange is desired, then the indices of the rows to be exchanged be set to the same value (i.e. exchange a row with itself). Likewise if only a row exchange is desired, set the column indices to the same number.

Row exchanges are done before column exchanges.

The exchange operation will take place across all planes of (DxTxE) data. The actual data is copied as (for a row exchange) a WxDxTxE hyperplane. It is implicitly assumed that this hyperplane will easily fit in memory. Columns are copied as HxDxTxE hyperplanes under the same assumption.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

Restrictions on data or input as applicable

MODIFICATION

none

FILES

$MATRIX/objects/library/kmatrix/src/lmexchg.c

SEE ALSO

kmatrix(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.