vsn2trsf                 package:vsn                 R Documentation

_A_p_p_l_y _t_h_e _v_s_n _t_r_a_n_s_f_o_r_m_a_t_i_o_n _t_o _d_a_t_a

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

     Apply the vsn transformation to data.

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

     ## S4 method for signature 'vsn':
     predict(object, newdata, strata=object@strata, log2scale=TRUE, useDataInFit=FALSE)

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

  object: An object of class 'vsn' that contains transformation
          parameters and strata information, typically this is the
          result of a previous call to 'vsn2'.

 newdata: Object of class 'ExpressionSet', 'NChannelSet', 'AffyBatch'
          (from the 'affy' package), 'RGList' (from the 'limma'
          package), 'matrix' or 'numeric', with the data to which the
          fit is to be applied to.

  strata: Optional, a 'factor' or 'integer' that aligns with the rows
          of 'newdata'; see the 'strata' argument of 'vsn2'.

log2scale: If 'TRUE', the data are returned on the glog scale to base
          2, and an overall offset c is added (see _Value_ section of
          the 'vsn2' manual page). If 'FALSE', the data are returned on
          the glog scale to base e, and no offset is added.

useDataInFit: If 'TRUE', then no transformation is attempted and the
          data stored in 'object' is transferred appropriately into
          resulting object, which otherwise preserves the class and
          metadata of 'newdata'. This option exists to increase
          performance in constructs like


                 fit = vsn2(x, ...)
                 nx = predict(fit, newdata=x)

          and is used, for example, in the 'justvsn' function. 

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

     An object typically of the same class as 'newdata'. There are two
     exceptions: if 'newdata' is an 'RGList', the return value is an
     'NChannelSet', and if 'newdata' is numeric, the return value is a
     'matrix' with 1 column.

_A_u_t_h_o_r(_s):

     Wolfgang Huber <URL: http://www.ebi.ac.uk/huber>

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

     data("kidney")

     ## nb: for random subsampling, the 'subsample' argument of vsn
     ##   provides an easier way to do this
     fit = vsn2(kidney[sample(nrow(kidney), 500), ])
     tn = predict(fit, newdata=exprs(kidney))

