wstCVl              package:wavethresh              R Documentation

_P_e_r_f_o_r_m_s _t_w_o-_f_o_l_d _c_r_o_s_s-_v_a_l_i_d_a_t_i_o_n _e_s_t_i_m_a_t_i_o_n _u_s_i_n_g _p_a_c_k_e_t-_o_r_d_e_r_e_d _n_o_n-_d_e_c_i_m_a_t_e_d _w_a_v_e_l_e_t _t_r_a_n_s_f_o_r_m_s _a_n_d _a (_v_e_c_t_o_r) _l_e_v_e_l-_d_e_p_e_n_d_e_n_t _t_h_r_e_s_h_o_l_d.

_D_e_s_c_r_i_p_t_i_o_n:

     Performs Nason's 1996 two-fold cross-validation estimation using
     packet-ordered non-decimated wavelet transforms and a (vector)
     level-dependent threshold.

_U_s_a_g_e:

     wstCVl(ndata, ll = 3, type = "soft", filter.number = 10, family = "DaubLeAsymm",
             tol = 0.01, verbose = 0, plot.it = FALSE, norm = l2norm, InverseType = "average",
             uvdev = madmad)

_A_r_g_u_m_e_n_t_s:

   ndata: the noisy data. This is a vector containing the signal plus
          noise. The length of this vector should be a power of two.

      ll: the primary resolution for this estimation. Note that the
          primary resolution is _problem-specific_: you have to find
          out which is the best value.

    type: whether to use hard or soft thresholding. See the explanation
          for this argument in the 'threshold.wst' function.

filter.number: This selects the smoothness of wavelet that you want to
          use in the decomposition. By default this is 10, the
          Daubechies least-asymmetric orthonormal compactly supported
          wavelet with 10 vanishing moments.

  family: specifies the family of wavelets that you want to use. The
          options are "DaubExPhase" and "DaubLeAsymm".

     tol: the cross-validation tolerance which decides when an estimate
          is sufficiently close to the truth (or estimated to be so).

 verbose: If 'TRUE' then informative messages are printed during the
          progression of the function, otherwise they are not.

 plot.it: 

    norm: which measure of distance to judge the dissimilarity between
          the estimates. The functions 'l2norm' and 'linfnorm' are
          suitable examples.

InverseType: The possible options are "average" or "minent". The former
          uses basis averaging to form estimates of the unknown
          function. The "minent" function selects a basis using the
          Coifman and Wickerhauser, 1992 algorithm to select a basis to
          invert.

   uvdev: Universal thresholding is used to generate an upper bound for
          the ideal threshold. This argument provides the function that
          computes an estimate of the variance of the noise for use
          with the universal threshold calculation (see
          'threshold.wst').

_D_e_t_a_i_l_s:

     This function implements a modified version of the
     cross-validation method detailed by Nason, 1996 for computing an
     estimate of the error between an estimate and the ``truth''. The
     difference here is that it uses the packet ordered non-decimated
     wavelet transform rather than the standard Mallat wd discrete
     wavelet transform. As such it is an example of the
     translation-invariant denoising of Coifman and Donoho, 1995 but
     uses cross-validation to choose the threshold rather than
     SUREshrink. 

     Further, this function computes level-dependent thresholds. That
     is, it can compute a different threshold for each resolution
     level. 

     Note that the procedure outlined above can use 'AvBasis' basis
     averaging or basis selection and inversion using the Coifman and
     Wickerhauser, 1992 best-basis algorithm

_V_a_l_u_e:

     A list returning the results of the cross-validation algorithm.
     The list includes the following components: 

   ndata: a copy of the input noisy data

    xvwr: a reconstruction of the best estimate computed using this
          algorithm. It is the inverse (computed depending on what the
          InverseType argument was) of the 'xvwrWSTt' component.

xvwrWSTt: a thresholded version of the packet-ordered non-decimated
          wavelet transform of the noisy data using the best threshold
          discovered by this cross-validation algorithm.

     uvt: the universal threshold used as the upper bound for the
          algorithm that tries to discover the optimal cross-validation
          threshold. The lower bound is always zero.

xvthresh: the best threshold as discovered by cross-validation. Note
          that this is vector, a level-dependent threshold with one
          threshold value for each resolution level. The first entry
          corresponds to level 'll', the last entry corresponds to
          level 'nlevels(ndata)-1' and the entries in between linearly
          to the levels in between. The 'wstCV' function should be used
          to compute a global threshold.

  optres: The results from performing the optimisation using the
          'nlminb' function from Splus. This object contains many
          interesting components with information about how the
          optimisation went. See the 'nlminb' help page for
          information.

_R_E_L_E_A_S_E:

     Version 3.6 Copyright Guy Nason 1995

_S_e_e _A_l_s_o:

     'GetRSSWST', 'linfnorm', 'linfnorm', 'threshold.wst', 'wst',
     'wst.object', 'wstCV'

_E_x_a_m_p_l_e_s:

     #
     # Example PENDING
     #

