NAME
subtract_int_matrices - Performs element-wise subtraction of two int 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 subtract_int_matrices
(
Int_matrix **target_mpp,
const Int_matrix *first_mp,
const Int_matrix *second_mp
);
DESCRIPTION
This routine performs element-wise subtraction 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 subtracted from 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
Kobus Barnard
DOCUMENTER
Kobus Barnard
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
,
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
,
add_int_matrices
,
ow_add_int_matrices
,
get_target_int_matrix_vector_vector
,
free_int_matrix_vector_vector