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
- in_obj - input matrix object
- r1 - index of first row to be exchanged
- r2 - index of second row to be exchanged
- c1 - index of first column to be exchanged
- c2 - index of second column to be exchanged
OUTPUT
- out_obj - output matrix object
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.