NAME

create_matrix_matrix - Creates a Matrix of matrices

SYNOPSIS

#include "m/m_mat_matrix.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 


Matrix_matrix *create_matrix_matrix
(
	int num_rows,
	int num_cols,
	int elt_rows,
	int elt_cols
);

DESCRIPTION

This routine creates a matrix of the specified dimensions and returns a pointer P to it. The number of rows is P->num_rows, the number of columns is P->num_cols, and the elements (of type "Matrix*") may be referenced by (P->elements)[ row ][ col ]. The routine free_matrix_matrix should be used to dispose of the storage once it is no longer needed.

RETURNS

A pointer to the Matrix_matrix on success and NULL on failure (with an error message being set.) This routine will only fail if storage allocation fails.

WARNING

The user of this library must take care with assumptions about the structure of the array embedded in the matrix type. See the documentation for "Matrix" for more details and CRITICAL information on the internal structure of the returned matrix.

DISCLAIMER

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

AUTHOR

Kobus Barnard

DOCUMENTER