subset                 package:base                 R Documentation

_S_u_b_s_e_t_t_i_n_g _V_e_c_t_o_r_s _a_n_d _D_a_t_a _F_r_a_m_e_s

_D_e_s_c_r_i_p_t_i_o_n:

     Return subsets of vectors or data frames which meet conditions.

_U_s_a_g_e:

     subset(x, ...)

     ## Default S3 method:
     subset(x, subset, ...)

     ## S3 method for class 'data.frame':
     subset(x, subset, select, drop = FALSE, ...)

_A_r_g_u_m_e_n_t_s:

       x: object to be subsetted.

  subset: logical expression.

  select: expression, indicating columns to select from a data frame.

    drop: passed on to '[' indexing operator.

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

_D_e_t_a_i_l_s:

     For ordinary vectors, the result is simply 'x[subset &
     !is.na(subset)]'.

     For data frames, the 'subset' argument works similarly on the
     rows.  Note that 'subset' will be evaluated in the data frame, so
     columns can be referred to (by name) as variables.

     The 'select' argument exists only for the method for data frames.
     It works by first replacing names in the selection expression with
     the corresponding column numbers in the data frame and then using
     the resulting integer vector to index the columns.  This allows
     the use of the standard indexing conventions so that for example
     ranges of columns can be specified easily.

     The 'drop' argument is passed on to the indexing method for data
     frames.

_V_a_l_u_e:

     An object similar to 'x' contain just the selected elements (for a
     vector), rows and columns (for a data frame), and so on.

_A_u_t_h_o_r(_s):

     Peter Dalgaard

_S_e_e _A_l_s_o:

     '[',  'transform'

_E_x_a_m_p_l_e_s:

     data(airquality)
     subset(airquality, Temp > 80, select = c(Ozone, Temp))
     subset(airquality, Day == 1, select = -Temp)
     subset(airquality, select = Ozone:Wind)

     with(airquality, subset(Ozone, Temp > 80))

