NAME

fp_read_vector_vector - Reads a vector vector from data in a formated file

SYNOPSIS

#include "m/m_vec_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_vector_vector
(
	Vector_vector **result_vvpp,
	FILE *fp
);

DESCRIPTION

This routine reads a vector vector 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 ource 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. In theory, and in parallel with other routines such as read_matrix, several read strategies are tried until one succeeds. However, only one strategy is currently implemented. Specifically we assume that the file is a formatted ascii file, and the vector vector dimensions are deduced from the number of rows and columns. Each row is assumed to be a vector. The vector vector *result_vvpp is created or resized as necessary.

RETURNS

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

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_vector_from_config_file , read_vector , fp_read_vector , fp_read_raw_vector , fp_read_vector_with_header , fp_read_ascii_vector , fp_ow_read_vector , write_row_vector , fp_write_row_vector , write_indexed_vector , fp_write_indexed_vector , write_col_vector , fp_write_col_vector , write_col_vector_with_header , fp_write_col_vector_with_header , write_raw_vector , fp_write_raw_vector , write_row_vector_full_precision , fp_write_row_vector_full_precision , write_col_vector_full_precision , fp_write_col_vector_full_precision , read_vector_vector_from_config_file , read_vector_vector , fp_read_raw_vector_vector , fp_read_formatted_vector_vector , fp_write_vector_vector_with_title , write_vector_vector , fp_write_vector_vector , write_raw_vector_vector , fp_write_raw_vector_vector , fp_write_raw_vector_vector_header , write_vector_vector_full_precision , fp_write_vector_vector_full_precision