NAME
randomize_matrix_rows - Copies a matrix shuffling the rows randomly
SYNOPSIS
#include "m/m_mat_basic.h"
Example compile flags (system dependent):
-DLINUX_386 -DLINUX_386_P4
-I/home/kobus/include
-L/home/kobus/load/linux_386_p4 -L/usr/local/lib -L/usr/lib
-lKJB -llapack -lblas -lg2c -lXext -lX11
int randomize_matrix_rows
(
Matrix **target_mpp,
const Matrix *source_mp
);
DESCRIPTION
This routine copies the matrix into the one pointed to by target_mpp, but the
rows are randomized along the way. If the matrix pointed to by target_mpp is
NULL, then a matrix of the appropriate size is created. If it exists, but is
the wrong size, then it is recycled. Otherwise, the storage is recycled. If
the source matrix is NULL, then the target matrix becomes NULL also, and any
storage associated with it is freed.
RETURNS
If the routine fails (due to storage allocation), then ERROR is returned
with and error message being set. Otherwise NO_ERROR is returned.
DISCLAIMER
This software is not adequatedly tested. It is recomended that
results are checked independantly where appropriate.
AUTHOR
Kobus Barnard
DOCUMENTOR
Kobus Barnard
SEE ALSO
split_matrix_by_rows
,
get_matrix_transpose
,
create_matrix_copy
,
copy_matrix
,
select_matrix_cols
,
copy_matrix_block
,
ow_copy_matrix_block
,
copy_matrix_block_2
,
ow_copy_matrix_block_2
,
ow_copy_matrix
,
ow_copy_matrix_with_col_selection
,
copy_int_matrix_to_matrix
,
copy_matrix_to_int_matrix
,
get_random_matrix_row
,
get_matrix_row
,
ow_get_matrix_row
,
remove_matrix_row
,
put_matrix_row
,
copy_matrix_row
,
get_random_matrix_col
,
get_matrix_col
,
remove_matrix_col
,
put_matrix_col
,
copy_matrix_col
,
vector_is_matrix_row
,
stack_matrix_rows
,
unstack_matrix_rows