NAME

get_target_matrix_vector - Gets a target matrix vector

SYNOPSIS

#include "m/m_mat_vector.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 get_target_matrix_vector
(
	Matrix_vector **mvpp,
	int length
);

DESCRIPTION

This routine implements the creation/over-writing semantics used in the KJB library in the case of matrix vectors. If *target_mvpp is NULL, then this routine creates the matrix vector. If it is not null, and it is the right size, then this routine does nothing. If it is the wrong size, then it is resized. The routine free_matrix_vector should be used to dispose of the storage once it is no longer needed.

RETURNS

On error, this routine returns NULL, with an error message being set. On success it returns a pointer to the array.

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

free_matrix_vector , count_non_null_matrix_vector_matrices , matrix_vectors_are_comparable , is_matrix_vector_consistent , average_matrices , std_dev_matrices , get_target_matrix_vector_vector , free_matrix_vector_vector , interleave_matrix_rows , interleave_matrix_cols , concat_matrices_vertically , concat_matrices_horizontally , 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