get_matrix_inverse_dct - Computes the inverse discrete cosine transform (DCT) of a matrix
Example compile flags (system dependent):
-DLINUX_X86_64 -DLINUX_X86_64_OPTERON -DGNU_COMPILER
-lKJB -lfftw3 -lgsl -lgslcblas -ljpeg -lSVM -lstdc++ -lpthread -lSLATEC -lg2c -lacml -lacml_mv -lblas -lg2c -lncursesw
const Matrix *input_mp
This routine computes the inverse discrete cosine transform (DCT) of a
The first argument is the adress of 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.
NO_ERROR on success, and ERROR on failure, with an error message being
This routine simply wraps the appropriate fftw library functions for
convenient use with our our data structures. The fftw library can also be
used directly in conjunction with the kjb_library by including fftw3.h
(the makefile builder should know where to find everthing). This can be
preferable in some cases where one wants to exploit the tuning mechanism
from that library, and cut down on overhead. However, for ocasional use,
the savings won't be very great.
The default behaviour of this routine is to inherits fftw's normalization
strategy which is to return unnormalized transforms. This means that
taking the transform, and then inverting, requires division by
N=num_cols*num_rows. This behaviour can be changed using the
set_fftw_style() function. Currently the style setting of
FFTW_MATLAB_STYLE is not valid with DCT because it has not yet been
implemented (on the TODO list).
This software is not adequatedly tested. It is recomended that
results are checked independantly where appropriate.