NAME

remove_matrix_row - Removes a matrix row

SYNOPSIS

#include "m/m_mat_basic.h"

Example compile flags (system dependent):
  -DLINUX_X86_64 -DLINUX_X86_64_OPTERON  -DGNU_COMPILER 
   -I/home/kobus/include
   -L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
  -lKJB                               -lfftw3  -lgsl -lgslcblas -ljpeg  -lSVM -lstdc++                    -lpthread -lSLATEC -lg2c    -lacml -lacml_mv -lblas -lg2c      -lncursesw 


int remove_matrix_row
(
	Vector **vpp,
	Matrix *mp,
	int row_num
);

DESCRIPTION

This routine removes row "row_num" from the matrix "mp" and optionally puts it into the vector pointed to by vpp (if vpp is not NULL). If *vpp is NULL, then the vector is created. If it is the wrong length, then it is resized. Otherwise, the storage is reused.

RETURNS

If the routine fails (due to storage allocation), then ERROR is returned with and error message being set. Otherwise NO_ERROR is returned.

NOTE

Matrix row counting begins with 0.

NOTE

Currently, trying to remove the only row of matrix is treated as a bug. This may change with future versions.

DISCLAIMER

This software is not adequatedly tested. It is recomended that results are checked independantly where appropriate.

AUTHOR

Kobus Barnard

DOCUMENTER

Kobus Barnard

SEE ALSO

random_split_matrix_by_rows , 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 , put_matrix_row , copy_matrix_row , get_random_matrix_col , get_matrix_col , remove_matrix_col , put_matrix_col , copy_matrix_col , insert_zero_row_in_matrix , insert_zero_col_in_matrix , vector_is_matrix_row , stack_matrix_rows , unstack_matrix_rows , randomize_matrix_rows , pad_matrix_by_extending , get_matrix_trace , is_matrix_diagonal , nonnan_matrix