NAME

fp_write_matrix_with_header - Writes data row-wise to a FILE prefaced by a matrix header

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_write_matrix_with_header
(
	const Matrix *mp,
	FILE *fp
);

DESCRIPTION

This routine writes data in a matrix to a file. Data is prefaced by a matrix size header indicating the number of rows and columns in the matrix being output. Since matrix files with headers are usually components of more complex data structures, we write the data at full precision. "fp" points to a FILE as returned by "kjb_fopen". "mp" is a pointer to the matrix whose contents are to be written. If the matrix is NULL, then this routine is a NOP. The matrix size header has the form:

   #! rows=<num-matrix-rows> cols=<num-matrix-cols>

where <num-matrix-rows>,<num-matrix-cols> are positive integers. (The "#" is actually the comment char (user settable) and the "!" is actually the header char, also user settable). Data is then written in row order to the file. The current file position is NOT reset to the starting after the function returns, so this function can be used to write multiple matrices from the same file.

RETURNS

NO_ERROR on success, ERROR on failure, with "kjb_error" set to a descriptive message.

fp_read_matrix_with_header fp_write_matrix_size_header count_data_lines_until_next_header, kjb_print_error.

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER