NAME

read_matrix_by_rows - Reads data row-wise from a file into a matrix

SYNOPSIS

#include "m/m_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_matrix_by_rows
(
	Matrix **result_mpp,
	const char *file_name,
	int num_cols
);

DESCRIPTION

This routine reads data contained in a file specified by a file name into a matrix whose number of columns is known. The matrix will be created or resized if necessary. Currently there must be exactly one number per line in the file. The 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_cols" indicates the number of columns the created matrix will contain. The number of rows in the new matrix depends on the number of data elements in the file.

RETURNS

Either NO_ERROR, or ERROR, with an appropriate error message being set.

read_matrix_by_cols, fp_read_matrix_by_rows, 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

read_matrix_from_config_file , read_matrix , fp_read_matrix , fp_read_raw_matrix , fp_read_matrix_with_header , fp_read_formatted_matrix , fp_read_matrix_by_rows , read_matrix_by_cols , fp_read_matrix_by_cols , fp_ow_read_formatted_matrix , fp_ow_read_matrix_by_rows , fp_ow_read_matrix_by_cols , write_matrix , write_matrix_2 , fp_write_matrix , fp_write_matrix_2 , write_matrix_with_header , fp_write_matrix_with_header , write_matrix_full_precision , fp_write_matrix_full_precision , write_matrix_rows , fp_write_matrix_rows , write_matrix_cols , fp_write_matrix_cols , write_matrix_vector , fp_write_matrix_vector , write_matrix_vector_full_precision , fp_write_matrix_vector_full_precision , fp_write_matrix_with_title , fp_write_matrix_full_precision_with_title , write_raw_matrix , fp_write_raw_matrix , read_matrix_vector , fp_read_matrix_vector , fp_read_raw_matrix_vector , fp_read_matrix_vector_with_headers , write_raw_matrix_vector , fp_write_raw_matrix_vector , fp_write_raw_matrix_vector_header