NAME
fp_read_matrix - Reads a matrix from data in a formated 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_matrix
(
Matrix **result_mpp,
FILE *fp
);
DESCRIPTION
This routine reads a matrix from a file. If the file_name is NULL or a null
string, then stdin is assumed. If this is the case, and if the source is not
a file (i.e. a pipe), then this routine will fail. If there are multiple
matrices in the file separated with soft EOFs, then the reading continues to
the next soft (or hard) EOF.
Several read strategies are tried until one succeeds. The first strategy is
to assume that the matrix is in raw (binary) format (see fp_read_matrix(3)).
If that fails, the rouint assume that the file has a header file (see
fp_read_matrix_with_header(3)). The final strategy is to assume that the file
is a formatted ascii file, and the matrix dimensions are deduced from the
number of rows and columns (see fp_read_formatted_matrix(3)). The number of
columns in each row must be the same. For example, if the input file
contains 5 rows of data, each with 3 columns, then the output matrix will be
5 X 3.
The matrix *result_mpp is created or resized as necessary.
RETURNS
Either NO_ERROR, or ERROR, with an appropriate error message being set.
RELATED
read_matrix, write_matrix, fp_read_matrix_with_header,
fp_read_formatted_matrix
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_matrix_from_config_file
,
read_matrix
,
fp_read_raw_matrix
,
fp_read_matrix_with_header
,
fp_read_formatted_matrix
,
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