NAME

fp_read_formatted_matrix - Reads a matrix from data in a formatted FILE

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 fp_read_formatted_matrix
(
	Matrix **result_mpp,
	FILE *fp
);

DESCRIPTION

This routine reads a matrix from a file containing data formatted into fixed rows and columns. The matrix dimensions are controlled by the formatting of the data in the file. For example, if the input file contains 5 rows of data, each with 3 columns, then the output matrix will be 5 X 3. If there are multiple matrices in the file separated with soft EOFs, then the reading continues to the next soft (or hard) EOF. The matrix *result_mpp is created or resized as necessary. "fp" points to type FILE as returned by "kjb_fopen".

RETURNS

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

RELATED

read_matrix, 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

SEE ALSO

read_matrix_from_config_file , read_matrix , fp_read_matrix , fp_read_raw_matrix , fp_read_matrix_with_header , read_matrix_by_rows , 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