# NAME

write_matrix_with_header - Writes a matrix to a file row-wise with 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 write_matrix_with_header
(
const Matrix *mp,
const char *file_name
);

# DESCRIPTION

This routine outputs a Matrix to a file specified by the input file name row
by row with a header. Since matrix files with headers are usually components
of more complex data structures, we write the data at full precision.
"file_name" is a pointer to a character array containing the name of the file
to write the matrix contents to. If "file_name" is NULL or equal to '\0',
output is directed to STDOUT. Otherwise, the file is created or the existing
copy is overwritten.
"mp" is a pointer to the matrix whose contents are to be written. If the
matrix is NULL, then this routine writes a matrix with 0 rows and 0 columns
which will become a NULL matrix with the anologous read routine.
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).
# RETURNS

NO_ERROR on success, or ERROR on a file write or close error.
# DISCLAIMER

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

Kobus Barnard
# DOCUMENTER

Kobus Barnard
# SEE ALSO

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