home *** CD-ROM | disk | FTP | other *** search
/ Big Green CD 8 / BGCD_8_Dev.iso / NEXTSTEP / UNIX / Educational / R-0.49-MI / R-0.49-I / help / acepack / avas < prev    next >
Encoding:
Text File  |  1997-09-13  |  2.6 KB  |  99 lines
  1.     
  2.     _a_v_a_s: _A_d_d_i_t_i_v_i_t_y _a_n_d _v_a_r_i_a_n_c_e _s_t_a_b_i_l_i_z_a_t_i_o_n _f_o_r _r_e_g_r_e_s_s_i_o_n
  3.     
  4.          avas(x, y, wt, mon, lin, cat, circ, delrsq,yspan)
  5.     
  6.     _A_r_g_u_m_e_n_t_s:
  7.     
  8.                 x:
  9.          a matrix containing the independent variables.
  10.     
  11.                 y:
  12.          a vector containing the response variable.
  13.     
  14.                wt:
  15.          an optional vector of weights.
  16.     
  17.               mon:
  18.          an optional integer vector specifying which variables
  19.          are to be transformed by monotone transformations.
  20.          Positive values in mon refer to columns of the x matrix
  21.          and zero to the response variable.
  22.     
  23.               lin:
  24.          an optional integer vector specifying which variables
  25.          are to be transformed by linear transformations.  Posi-
  26.          tive values in lin refer to columns of the x matrix and
  27.          zero to the response variable.
  28.     
  29.               cat:
  30.          an optional integer vector specifying which variables
  31.          assume categorical values.  Positive values in cat
  32.          refer to columns of the x matrix and zero to the
  33.          response variable.
  34.     
  35.              circ:
  36.          an integer vector specifying which variables assume
  37.          circular (periodic) values.  Positive values in circ
  38.          refer to columns of the x matrix and zero to the
  39.          response variable.
  40.     
  41.            delrsq:
  42.          termination threshold.  Iteration stops when R-squared
  43.          changes by less than delrsq in 3 consecutive iterations
  44.          (default 0.01).
  45.     
  46.             yspan:
  47.          Optional window size parameter for smoothing the vari-
  48.          ance. Range[0,1]. Default=0 (cross validated choice).
  49.          .5 is a reasonable alternative to try.
  50.     
  51.          Value:
  52.     
  53.          structure with the following components:
  54.     
  55.            x:
  56.     the input x matrix.
  57.     
  58.            y:
  59.     the input y vector.
  60.     
  61.           tx:
  62.     the transformed x values.
  63.     
  64.           ty:
  65.     the transformed y values.
  66.     
  67.          rsq:
  68.     the multiple R-squared value for the transformed values.
  69.     
  70.            l:
  71.     not used in this version of avas
  72.     
  73.            m:
  74.     not used in this version of avas
  75.     
  76.        yspan:
  77.     span used for smoothing the variance
  78.     
  79.        iters:
  80.     iteration number and rsq for that iteration
  81.     
  82.       niters:
  83.     number of iterations used
  84.     
  85.          Rob Tibshirani, "Estimating optimal transformations for
  86.          regression". JASA Vol 83, No 402 Page 394 Version: Mar
  87.          18/1987
  88.     
  89.     _E_x_a_m_p_l_e_s:
  90.     
  91.          TWOPI <- 8*atan(1)
  92.          x <- runif(200,0,TWOPI)
  93.          y <- exp(sin(x)+rnorm(200)/2)
  94.          a <- avas(x,y)
  95.          plot(a,ay)  # view the response transformation
  96.          plot(a,ax)  # view the carrier transformation
  97.          plot(ax,ay) # examine the linearity of the fitted model
  98.     
  99.