NAME

multiply_int_matrix_by_int_scalar - Multiplies each element of a matrix by a scalar

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 multiply_int_matrix_by_int_scalar
(
	Int_matrix **target_mpp,
	const Int_matrix *source_mp,
	int scalar
);

DESCRIPTION

This routine multiplies each element of a matrix by a scalar. If we are respecting missing values (disabled by default), then, if either operands are DBL_MISSING, then the result is DBL_MISSING as well. 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. Currenly this routine can only fail (gracefully!) due to memory allocation failure.

RELATED

ow_multiply_int_matrix_by_int_scalar(3)

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 , subtract_int_matrices , ow_subtract_int_matrices , multiply_int_matrices , ow_get_abs_of_int_matrix , get_abs_of_int_matrix , 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