terms.formula             package:stats             R Documentation

_C_o_n_s_t_r_u_c_t _a _t_e_r_m_s _O_b_j_e_c_t _f_r_o_m _a _F_o_r_m_u_l_a

_D_e_s_c_r_i_p_t_i_o_n:

     This function takes a formula and some optional arguments and
     constructs a terms object. The terms object can then be used to
     construct a 'model.matrix'.

_U_s_a_g_e:

     ## S3 method for class 'formula':
     terms(x, specials = NULL, abb = NULL, data = NULL, neg.out = TRUE,
           keep.order = FALSE, simplify = FALSE, ...,
           allowDotAsName = FALSE)

_A_r_g_u_m_e_n_t_s:

       x: a formula.

specials: which functions in the formula should be marked as special in
          the 'terms' object.

     abb: Not implemented in R.

    data: a data frame from which the meaning of the special symbol '.'
          can be inferred. It is unused if there is no '.' in the
          formula.

 neg.out: Not implemented in R.

keep.order: a logical value indicating whether the terms should keep
          their positions. If 'FALSE' the terms are reordered so that
          main effects come first, followed by the interactions, all
          second-order, all third-order and so on.  Effects of a given
          order are kept in the order specified.

simplify: should the formula be expanded and simplified, the pre-1.7.0
          behaviour?

     ...: further arguments passed to or from other methods.

allowDotAsName: normally '.' in a formula refers to the remaining
          variables contained in 'data'.  Exceptionally, '.' can be
          treated as a name for non-standard uses of formulae.

_D_e_t_a_i_l_s:

     Not all of the options work in the same way that they do in S and
     not all are implemented.

_V_a_l_u_e:

     A 'terms.object' object is returned.  The object itself is the
     re-ordered (unless 'keep.order = TRUE') formula.  In all cases
     variables within an interaction term in the formula are re-ordered
     by the ordering of the '"variables"' attribute, which is the order
     in which the variables occur in the formula.

_S_e_e _A_l_s_o:

     'terms', 'terms.object'

