NAME

add_int_matrices - Performs element-wise addition of two integer matrices.

SYNOPSIS

#include "l/l_int_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 


int add_int_matrices
(
	Int_matrix **target_mpp,
	const Int_matrix *first_mp,
	const Int_matrix *second_mp
);

DESCRIPTION

This routine performs element-wise addition of two matrices. The second matrix must fit into the first an integral number of times. For example, if the first matrix has dimenions 6x3, then the second can have dimensions 6x3 (the common case), 6x1, 3x3, 2x3, 1x6, etc, but NOT 2x2, 5x1, etc. The second matrix is added to each block in the first matrix. The first argument is a pointer to 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.

RETURNS

NO_ERROR on success, and ERROR on failure, with an error message being set.

DISCLAIMER

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

AUTHOR

Ernesto Brau

DOCUMENTER

Ernesto Brau

SEE ALSO

same_int_matrix_dimensions , get_zero_int_matrix , get_initialized_int_matrix , get_target_int_matrix , ra_get_target_int_matrix , get_diagonal_int_matrix , free_int_matrix , ow_zero_int_matrix , ow_set_int_matrix , ra_get_target_int_matrix_vector , get_target_int_matrix_vector , free_int_matrix_vector , get_target_int_vector_matrix , free_int_vector_matrix , concat_int_matrices_vertically , copy_int_matrix , ow_copy_int_matrix , copy_int_matrix_block , ow_copy_int_matrix_block , copy_int_matrix_row , copy_int_matrix_col , get_int_matrix_row , get_int_matrix_col , put_int_matrix_row , put_int_matrix_col , get_int_transpose , get_int_identity_matrix , swap_int_matrix_rows , min_int_matrix_element , max_int_matrix_element , max_abs_int_matrix_difference , check_same_int_matrix_dimensions , sum_int_matrix_elements , sum_int_matrix_rows , ow_sum_int_matrix_rows , ow_add_col_int_vector_to_int_matrix , ow_add_row_int_vector_to_int_matrix , ow_add_int_scalar_to_int_matrix , subtract_int_matrices , ow_subtract_int_matrices , multiply_int_matrices , ow_get_abs_of_int_matrix , get_abs_of_int_matrix , multiply_int_matrix_by_int_scalar , ow_multiply_int_matrix_by_int_scalar , multiply_int_matrix_and_int_vector , multiply_int_vector_and_int_matrix , ow_add_int_matrices , get_target_int_matrix_vector_vector , free_int_matrix_vector_vector