NAME

read_int_matrix_by_cols - Reads data column-wise from a file into a new integer matrix

SYNOPSIS

#include "l/l_int_mat_io.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 read_int_matrix_by_cols
(
	Int_matrix **result_mpp,
	const char *file_name,
	int num_rows
);

DESCRIPTION

This routine reads data contained in a file specified by a file name into an integer matrix whose number of rows is known. The matrix will be created. Currently there must be exactly one number per line in the file. The integer matrix *result_mpp is created or resized as necessary. "file_name" points to a character array specifying the name of the file to read the data from. If the "file_name" argument is NULL or the first character is null, input is expected from STDIN instead of a file. "num_rows" indicates the number of rows the created matrix will contain. The number of columns in the new matrix depends on the number of data elements in the file.

RETURNS

NO_ERROR on success and ERROR on failure, with an appropriate error message being set.

RELATED

read_int_matrix_by_rows, fp_read_int_matrix_by_cols, kjb_print_error.

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER

Lindsay Martin and Kobus Barnard

SEE ALSO

read_int_matrix_from_config_file , read_int_matrix , fp_read_int_matrix , fp_read_raw_int_matrix , fp_read_int_matrix_from_matlab_file , fp_read_int_matrix_with_header , fp_read_formatted_int_matrix , read_int_matrix_by_rows , fp_read_int_matrix_by_rows , fp_read_int_matrix_by_cols , fp_ow_read_formatted_int_matrix , fp_ow_read_int_matrix_by_rows , fp_ow_read_int_matrix_by_cols , fp_read_matrix_size_header , fp_write_int_matrix_with_title , write_int_matrix , fp_write_int_matrix , write_raw_int_matrix , fp_write_raw_int_matrix , write_int_matrix_rows , fp_write_int_matrix_rows , write_int_matrix_cols , fp_write_int_matrix_cols , write_int_matrix_with_header , fp_write_int_matrix_with_header , fp_write_matrix_size_header , write_int_matrix_to_matlab_file , fp_write_int_matrix_to_matlab_file