NAME

remove_matrix_col - Removes a matrix column

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_col
(
	Vector **vpp,
	Matrix *mp,
	int col_num
);

DESCRIPTION

This routine removes column "col_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 column counting begins with 0.

NOTE

Currently, trying to remove the only column 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 , remove_matrix_row , put_matrix_row , copy_matrix_row , get_random_matrix_col , get_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