NAME
concat_matrices_vertically - Concatenates matrices vertically
SYNOPSIS
#include "m/m_mat_vector.h"
Example compile flags (system dependent):
-DLINUX_386 -DLINUX_386_P4
-I/home/kobus/include
-L/home/kobus/load/linux_386_p4 -L/usr/local/lib -L/usr/lib
-lKJB -llapack -lblas -lg2c -lXext -lX11
int concat_matrices_vertically
(
Matrix **mpp,
int num_matrices,
Matrix *matrix_list[]
);
DESCRIPTION
This routine takes an array of matrices and forms one matrix consisting of
those matrices stacked on top of each other.
The first argument is the adress of the target matrix. If the target matrix
itself is null, then a matrix of the appropriate size is created. If the
target matrix is the wrong size, it is resized. Finally, if it is the right
size, then the storage is recycled, as is.
The matrix array may contain any number of NULL matrices. If there are only
NULL matrices, or if num_matrices is zero, then the target matrix is freed
and set to NULL.
RETURNS
NO_ERROR on success and ERROR on failure This routine will only fail if
storage allocation fails.
NOTE
More often then not, one wants to concatentate the matrices in a matrix
vector. The routine get_matrix_from_matrix_vector() is much more
convenient for that.
SEEALSO
get_matrix_from_matrix_vector
DISCLAIMER
This software is not adequatedly tested. It is recomended that
results are checked independantly where appropriate.
AUTHOR
Kobus Barnard
DOCUMENTOR
Kobus Barnard
SEE ALSO
get_target_matrix_vector
,
free_matrix_vector
,
count_non_null_matrix_vector_matrices
,
matrix_vectors_are_comparable
,
get_target_matrix_vector_vector
,
free_matrix_vector_vector
,
interleave_matrix_rows
,
interleave_matrix_cols
,
get_matrix_from_matrix_vector
,
get_matrix_from_matrix_vector_with_col_selection
,
get_matrix_vector_from_matrix
,
get_matrix_vector_from_matrix_2
,
allocate_2D_mp_array
,
free_2D_mp_array
,
free_2D_mp_array_and_matrices