NAG Library Function Document

nag_idwt_3d (c09fbc)

1  Purpose

2  Specification

3  Description

4  References

5  Arguments

1:     m – IntegerInput

On entry: the number of rows of each two-dimensional frame.

Constraint: this must be the same as the value m passed to the initialization function nag_wfilt_3d (c09acc).

2:     n – IntegerInput

On entry: the number of columns of each two-dimensional frame.

Constraint: this must be the same as the value n passed to the initialization function nag_wfilt_3d (c09acc).

3:     fr – IntegerInput

On entry: the number two-dimensional frames.

Constraint: this must be the same as the value fr passed to the initialization function nag_wfilt_3d (c09acc).

4:     lenc – IntegerInput

On entry: the dimension of the array c.

Constraint: $\mathbf{lenc}\ge n_{\mathrm{ct}}$, where $n_{\mathrm{ct}}$ is the total number of wavelet coefficients, as returned by nag_wfilt_3d (c09acc).

5:     c[lenc] – const doubleInput

On entry: the coefficients of the discrete wavelet transform. This will normally be the result of some transformation on the coefficients computed by function nag_dwt_3d (c09fac).

Note that the coefficients in c may be extracted according to type into three-dimensional arrays using nag_wav_3d_coeff_ext (c09fyc), and inserted using nag_wav_3d_coeff_ins (c09fzc).

6:     b[$\mathit{dim}$] – doubleOutput

Note: the dimension, dim, of the array b must be at least $\mathbf{ldb}\times \mathbf{sdb}\times \mathbf{fr}$.

On exit: the $m$ by $n$ by $\mathit{fr}$ reconstructed array, $B$, with $B_{ijk}$ stored in $\mathbf{b}\left[\left(k-1\right)\times \mathbf{ldb}\times \mathbf{sdb}+\left(j-1\right)\times \mathbf{ldb}+i-1\right]$. The reconstruction is based on the input wavelet coefficients and the transform options supplied to the initialization function nag_wfilt_3d (c09acc).

7:     ldb – IntegerInput

On entry: the stride separating row elements of each of the sets of frame coefficients in the three-dimensional data stored in b.

Constraint: $\mathbf{ldb}\ge \mathbf{m}$.

8:     sdb – IntegerInput

On entry: the stride separating corresponding coefficients of consecutive frames in the three-dimensional data stored in b.

Constraint: $\mathbf{sdb}\ge \mathbf{n}$.

9:     icomm[$260$] – const IntegerCommunication Array

On entry: contains details of the discrete wavelet transform and the problem dimension as setup in the call to the initialization function nag_wfilt_3d (c09acc).

10:   fail – NagError *Input/Output

The NAG error argument (see Section 3.6 in the Essential Introduction).

6  Error Indicators and Warnings

NE_ALLOC_FAIL

Dynamic memory allocation failed.

NE_BAD_PARAM

On entry, argument $⟨\mathit{\text{value}}⟩$ had an illegal value.

NE_INITIALIZATION

Either the communication array icomm has been corrupted or there has not been a prior call to the initialization function nag_wfilt_3d (c09acc).

The initialization function was called with $\mathbf{wtrans}=\mathrm{Nag\_MultiLevel}$.

NE_INT

On entry, $\mathbf{fr}=⟨\mathit{\text{value}}⟩$.
Constraint: $\mathbf{fr}=⟨\mathit{\text{value}}⟩$, the value of fr on initialization (see nag_wfilt_3d (c09acc)).

On entry, $\mathbf{m}=⟨\mathit{\text{value}}⟩$.
Constraint: $\mathbf{m}=⟨\mathit{\text{value}}⟩$, the value of m on initialization (see nag_wfilt_3d (c09acc)).

On entry, $\mathbf{n}=⟨\mathit{\text{value}}⟩$.
Constraint: $\mathbf{n}=⟨\mathit{\text{value}}⟩$, the value of n on initialization (see nag_wfilt_3d (c09acc)).

NE_INT_2

On entry, $\mathbf{ldb}=⟨\mathit{\text{value}}⟩$ and $\mathbf{m}=⟨\mathit{\text{value}}⟩$.
Constraint: $\mathbf{ldb}\ge \mathbf{m}$.

On entry, $\mathbf{lenc}=⟨\mathit{\text{value}}⟩$ and $n_{\mathrm{ct}}=⟨\mathit{\text{value}}⟩$.
Constraint: $\mathbf{lenc}\ge n_{\mathrm{ct}}$, where $n_{\mathrm{ct}}$ is the number of DWT coefficients returned by nag_wfilt_3d (c09acc) in argument nwct.

On entry, $\mathbf{sdb}=⟨\mathit{\text{value}}⟩$ and $\mathbf{n}=⟨\mathit{\text{value}}⟩$.
Constraint: $\mathbf{sdb}\ge \mathbf{n}$.

NE_INTERNAL_ERROR

An internal error has occurred in this function. Check the function call and any array sizes. If the call is correct then please contact NAG for assistance.

7  Accuracy

8  Parallelism and Performance

9  Further Comments

10  Example