NAME

subtract_vectors - Performs element-wise subtraction of two vectors.

SYNOPSIS

#include "m/m_vec_arith.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_vectors
(
	Vector **target_vpp,
	const Vector *first_vp,
	const Vector *second_vp
);

DESCRIPTION

This routine performs element-wise subtraction of two vectors. The second vector must fit into the first an integral number of times.The second vector is added to each block in the first vector. 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 the adress of the target vector. If the target vector itself is null, then a vector of the appropriate size is created. If the target vector 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