naginterfaces.library.wav.dim2_​sngl_​inv

naginterfaces.library.wav.dim2_sngl_inv(m, n, ca, ch, cv, cd, comm)[source]

dim2_sngl_inv computes the inverse two-dimensional discrete wavelet transform (DWT) at a single level. The initialization function dim2_init() must be called first to set up the DWT options.

For full information please refer to the NAG Library document for c09eb

https://www.nag.com/numeric/nl/nagdoc_29.3/flhtml/c09/c09ebf.html

Parameters
mint

Number of rows, , of data matrix .

nint

Number of columns, , of data matrix .

cafloat, array-like, shape

Contains the matrix of approximation coefficients, . This array will normally be the result of some transformation on the coefficients computed by function dim2_sngl_fwd().

chfloat, array-like, shape

Contains the matrix of horizontal coefficients, . This array will normally be the result of some transformation on the coefficients computed by function dim2_sngl_fwd().

cvfloat, array-like, shape

Contains the matrix of vertical coefficients, . This array will normally be the result of some transformation on the coefficients computed by function dim2_sngl_fwd().

cdfloat, array-like, shape

Contains the matrix of diagonal coefficients, . This array will normally be the result of some transformation on the coefficients computed by function dim2_sngl_fwd().

commdict, communication object

Communication structure.

This argument must have been initialized by a prior call to dim2_init().

Returns
bfloat, ndarray, shape

The reconstructed matrix, , based on the input approximation, horizontal, vertical and diagonal coefficients and the transform options supplied to the initialization function dim2_init().

Raises
NagValueError
(errno )

On entry, .

Constraint: , the value of on initialization (see dim2_init()).

(errno )

On entry, .

Constraint: , the value of on initialization (see dim2_init()).

(errno )

Either the initialization function has not been called first or [‘icomm’] has been corrupted.

(errno )

Either the initialization function was called with or [‘icomm’] has been corrupted.

Notes

dim2_sngl_inv performs the inverse operation of function dim2_sngl_fwd(). That is, given sets of approximation, horizontal, vertical and diagonal coefficients computed by function dim2_sngl_fwd() using a DWT as set up by the initialization function dim2_init(), on a real matrix, , dim2_sngl_inv will reconstruct .