LS2W (version 1.3.6)

A2name: Return a D2Amat list object style name.

Description

This function returns a character string according to a particular format for naming D2Amat objects.

Usage

A2name(J, filter.number, family, switch = "direction")

Value

A character string containing the name of a matrix according to a particular naming scheme.

Arguments

J

Discrete autocorrelation wavelets will be computed for scales -1 up to scale J. This number should be a negative integer.

filter.number

The index number of the wavelet used to build the PsiJ/PhiJ object.

family

The wavelet family used to build the PhiJIE object.

switch

Allows the user to define how they wish their inner product matrix to be formed. There are two available options: switch = "direction" - structures the matrix by scale within each decomposition direction. Thus, the ordering goes as follows (-1, V), (-2, V), ... switch = "scale" - structures the matrix by direction within each scale. Thus the ordering is as follows (-1,V), (-1, H), (-1, D), (-2, V),(-2, H), ...

Author

Idris Eckley

Details

Some of the matrices computed by D2Amat take a long time to compute. Hence it is a good idea to store and re-use them. This function generates a name according to a particular naming scheme that permits a search algorithm to easily find the matrices. Each matrix has three defining characteristics: its order, filter.number, family and the method of construction of the matrix (switch="direction" or "level"). Each of these characteristics are concatenated together to form a name.

References

Eckley, I.A., Nason, G.P. and Treloar, R.L. (2010) Locally stationary wavelet fields with application to the modelling and analysis of image texture. Journal of the Royal Statistical Society (Series C), 59, 595 - 616.

Eckley, I.A. and Nason, G.P. (2011). LS2W: Implementing the Locally Stationary 2D Wavelet Process Approach in R, Journal of Statistical Software, 43(3), 1-23. URL http://www.jstatsoft.org/v43/i03/.

See Also

D2Amat

Examples

#
# What's the name of the order 4 Haar matrix when structured by scale within decompositon direction?
#
A2name(J=-4, filter.number=1, family="DaubExPhase", switch="direction")
#[1] "D2Amat.d.4.1.DaubExPhase"
#
# What's the name of the order 15 Daubechies least-asymmetric wavelet
# with 7 vanishing moments, when ordered by direction within each scale?
#
A2name(J=-15, filter.number=7, family="DaubLeAsymm")
#[1] "D2Amat.l.15.7.DaubLeAsymm"