TGUW: Tail-Greedy Unbalanced Wavelet (TGUW) transformation of a...

View source: R/TGUW.R

TGUWR Documentation

Tail-Greedy Unbalanced Wavelet (TGUW) transformation of a vector

Description

Performs the bottom-up unbalanced wavelet decomposition. This function is used inside trendsegment. Details of the TGUW transformation can be found in H. Maeng and P. Fryzlewicz (2023), Detecting linear trend changes in data sequences.

Usage

TGUW(x, p = 0.04)

Arguments

x

An input vector to be decomposed.

p

Proportion of all possible remaining merges which specifies the number of merges allowed in a single pass over the data. The default is 0.04.

Value

A list with the followings:

x

The original input vector x.

n

The length of x.

twotogether

A vector indicating locations of the detail coefficients returned by Type 3 merges (merging two sets of paired smooth coefficients). This is used in thresholding to apply the "two together" rule which makes both detail coefficients (paired by a Type 3 merge) survived if at least one of their size is over threshold.

merging.hist

An array of dimension 4 by 3 by n-2 which has the full record of the n-2 merges in the TGUW transformation. Each matrix contains the information of each merge. The first row shows the indices of merged smooth coefficients in increasing order and the second row gives the value of detail filter coefficients which is the weight vector for computing the corresponding detail coefficient. The third row shows the (detail coefficient, first smooth coefficient, second smooth coefficient) obtained by an orthonormal transform. The fourth row gives the balancedness of merging. If it is Type 1 merging (three initial smooth coefficients) then the fourth row is always (1/3, 1/3, 1/3). In Type 2 and Type 3 mergings, the values depend on the ratio of the length of the left and right wings to the entire merged region and only first two components of the fourth row are filled with the corresponding ratios (sum to 1) but the third one is left as NA.

ts.coeffs

The transformed x by the TGUW transformation.

Author(s)

Hyeyoung Maeng hyeyoung.maeng@durham.ac.uk, Piotr Fryzlewicz p.fryzlewicz@lse.ac.uk

See Also

trendsegment, thresholding, invTGUW

Examples

x <- c(1:10, rep(5,9))
n <- length(x)
x <- x + rnorm(n)
tguwfit <- TGUW(x)
tguwfit

trendsegmentR documentation built on Aug. 24, 2023, 5:07 p.m.