NAG Library Routine Document

c09acf  (dim3_init)

1

Purpose

2

Specification

3

Description

4

References

5

Arguments

1:     $\mathbf{wavnam}$ – Character(*)Input

On entry: the name of the mother wavelet. See the C09 Chapter Introduction for details.

$\mathbf{wavnam}=\text{'HAAR'}$

Haar wavelet.

$\mathbf{wavnam}=\text{'DB}\mathit{n}\text{'}$, where $\mathit{n}=2,3,\dots ,10$

Daubechies wavelet with $\mathit{n}$ vanishing moments ($2\mathit{n}$ coefficients). For example, $\mathbf{wavnam}=\text{'DB4'}$ is the name for the Daubechies wavelet with $4$ vanishing moments ($8$ coefficients).

$\mathbf{wavnam}=\text{'BIOR}\mathit{x}$.$\mathit{y}\text{'}$, where $\mathit{x}$.$\mathit{y}$ can be one of 1.1, 1.3, 1.5, 2.2, 2.4, 2.6, 2.8, 3.1, 3.3, 3.5 or 3.7

Biorthogonal wavelet of order $\mathit{x}$.$\mathit{y}$. For example $\mathbf{wavnam}=\text{'BIOR3.1'}$ is the name for the biorthogonal wavelet of order $3.1$.

Constraint: $\mathbf{wavnam}=\text{'HAAR'}$, $\text{'DB2'}$, $\text{'DB3'}$, $\text{'DB4'}$, $\text{'DB5'}$, $\text{'DB6'}$, $\text{'DB7'}$, $\text{'DB8'}$, $\text{'DB9'}$, $\text{'DB10'}$, $\text{'BIOR1.1'}$, $\text{'BIOR1.3'}$, $\text{'BIOR1.5'}$, $\text{'BIOR2.2'}$, $\text{'BIOR2.4'}$, $\text{'BIOR2.6'}$, $\text{'BIOR2.8'}$, $\text{'BIOR3.1'}$, $\text{'BIOR3.3'}$, $\text{'BIOR3.5'}$ or $\text{'BIOR3.7'}$.

2:     $\mathbf{wtrans}$ – Character(1)Input

On entry: the type of discrete wavelet transform that is to be applied.

$\mathbf{wtrans}=\text{'S'}$

Single-level decomposition or reconstruction by discrete wavelet transform.

$\mathbf{wtrans}=\text{'M'}$

Multiresolution, by a multi-level DWT or its inverse.

Constraint: $\mathbf{wtrans}=\text{'S'}$ or $\text{'M'}$.

3:     $\mathbf{mode}$ – Character(1)Input

On entry: the end extension method.

$\mathbf{mode}=\text{'P'}$

Periodic end extension.

$\mathbf{mode}=\text{'H'}$

Half-point symmetric end extension.

$\mathbf{mode}=\text{'W'}$

Whole-point symmetric end extension.

$\mathbf{mode}=\text{'Z'}$

Zero end extension.

Constraint: $\mathbf{mode}=\text{'P'}$, $\text{'H'}$, $\text{'W'}$ or $\text{'Z'}$.

4:     $\mathbf{m}$ – IntegerInput

On entry: the number of elements, $m$, in the first dimension (number of rows of each two-dimensional frame) of the input data, $A$.

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

5:     $\mathbf{n}$ – IntegerInput

On entry: the number of elements, $n$, in the second dimension (number of columns of each two-dimensional frame) of the input data, $A$.

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

6:     $\mathbf{fr}$ – IntegerInput

On entry: the number of elements, $\mathit{fr}$, in the third dimension (number of frames) of the input data, $A$.

Constraint: $\mathbf{fr}\ge 2$.

7:     $\mathbf{nwlmax}$ – IntegerOutput

On exit: the maximum number of levels of resolution, $l_{\max }$, that can be computed if a multi-level discrete wavelet transform is applied ($\mathbf{wtrans}=\text{'M'}$). It is such that $2^{l_{\max }}\le \min \left(m,n,\mathit{fr}\right)<2^{l_{\max }+1}$, for $l_{\max }$ an integer.

If $\mathbf{wtrans}=\text{'S'}$, nwlmax is not set.

8:     $\mathbf{nf}$ – IntegerOutput

On exit: the filter length, $n_f$, for the supplied mother wavelet. This is used to determine the number of coefficients to be generated by the chosen transform.

9:     $\mathbf{nwct}$ – IntegerOutput

On exit: the total number of wavelet coefficients, $n_{\mathrm{ct}}$, that will be generated. When $\mathbf{wtrans}=\text{'S'}$ the number of rows required (i.e., the first dimension of each two-dimensional frame) in each of the output coefficient arrays can be calculated as $n_{\mathrm{cm}}=n_{\mathrm{ct}}/\left(8\times n_{\mathrm{cn}}\times n_{\mathrm{cfr}}\right)$. When $\mathbf{wtrans}=\text{'M'}$ the length of the array used to store all of the coefficient matrices must be at least $n_{\mathrm{ct}}$.

10:   $\mathbf{nwcn}$ – IntegerOutput

On exit: for a single-level transform ($\mathbf{wtrans}=\text{'S'}$), the number of coefficients that would be generated in the second dimension, $n_{\mathrm{cn}}$, for each coefficient type. For a multi-level transform ($\mathbf{wtrans}=\text{'M'}$) this is set to $1$.

11:   $\mathbf{nwcfr}$ – IntegerOutput

On exit: for a single-level transform ($\mathbf{wtrans}=\text{'S'}$), the number of coefficients that would be generated in the third dimension, $n_{\mathrm{cfr}}$, for each coefficient type. For a multi-level transform ($\mathbf{wtrans}=\text{'M'}$) this is set to $1$.

12:   $\mathbf{icomm}\left(260\right)$ – Integer arrayCommunication Array

On exit: contains details of the wavelet transform and the problem dimension which is to be communicated to the two-dimensional discrete transform routines in this chapter.

13:   $\mathbf{ifail}$ – IntegerInput/Output

On entry: ifail must be set to $0$, $-1\text{ or }1$. If you are unfamiliar with this argument you should refer to Section 3.4 in How to Use the NAG Library and its Documentation for details.

For environments where it might be inappropriate to halt program execution when an error is detected, the value $-1\text{ or }1$ is recommended. If the output of error messages is undesirable, then the value $1$ is recommended. Otherwise, if you are not familiar with this argument, the recommended value is $0$. When the value $-\mathbf{1}\text{ or }\mathbf{1}$ is used it is essential to test the value of ifail on exit.

On exit: $\mathbf{ifail}=\mathbf{0}$ unless the routine detects an error or a warning has been flagged (see Section 6).

6

Error Indicators and Warnings

$\mathbf{ifail}=1$

On entry, $\mathbf{wavnam}=〈\mathit{\text{value}}〉$ was an illegal value.

$\mathbf{ifail}=2$

On entry, $\mathbf{wtrans}=〈\mathit{\text{value}}〉$ was an illegal value.

$\mathbf{ifail}=3$

On entry, $\mathbf{mode}=〈\mathit{\text{value}}〉$ was an illegal value.

$\mathbf{ifail}=4$

On entry, $\mathbf{fr}=〈\mathit{\text{value}}〉$.
Constraint: $\mathbf{fr}\ge 2$.

On entry, $\mathbf{m}=〈\mathit{\text{value}}〉$.
Constraint: $\mathbf{m}\ge 2$.

On entry, $\mathbf{n}=〈\mathit{\text{value}}〉$.
Constraint: $\mathbf{n}\ge 2$.

$\mathbf{ifail}=-99$

An unexpected error has been triggered by this routine. Please contact NAG.

See Section 3.9 in How to Use the NAG Library and its Documentation for further information.

$\mathbf{ifail}=-399$

Your licence key may have expired or may not have been installed correctly.

See Section 3.8 in How to Use the NAG Library and its Documentation for further information.

$\mathbf{ifail}=-999$

Dynamic memory allocation failed.

See Section 3.7 in How to Use the NAG Library and its Documentation for further information.

7

Accuracy

8

Parallelism and Performance

9

Further Comments

10

Example

10.1

Program Text

Program Text (c09acfe.f90)

10.2

Program Data

Program Data (c09acfe.d)

10.3

Program Results

Program Results (c09acfe.r)