importance           package:randomForest           R Documentation

_E_x_t_r_a_c_t _v_a_r_i_a_b_l_e _i_m_p_o_r_t_a_n_c_e _m_e_a_s_u_r_e

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

     This is the extractor function for variable importance measures as
     produced by 'randomForest'.

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

     ## S3 method for class 'randomForest':
     importance(x, type=NULL, class=NULL, scale=TRUE, ...)

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

       x: an object of class 'randomForest'

    type: either 1 or 2, specifying the type of importance measure
          (1=mean decrease in accuracy, 2=mean decrease in node
          impurity).

   class: for classification problem, which class-specific measure to
          return.

   scale: For permutation based measures, should the measures be
          divided their ``standard errors''?

     ...: not used.

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

     Here are the definitions of the variable importance measures.  For
     each tree, the prediction accuracy on the out-of-bag portion of
     the data is recorded.  Then the same is done after permuting each
     predictor variable.  The difference between the two accuracies are
     then averaged over all trees, and normalized by the standard
     error.  For regression, the MSE is computed on the out-of-bag data
     for each tree, and then the same computed after permuting a
     variable.  The differences are averaged and normalized by the
     standard error.  If the standard error is equal to 0 for a
     variable, the division is not done (but the measure is almost
     always equal to 0 in that case).

     The second measure is the total decrease in node impurities from
     splitting on the variable, averaged over all trees.  For
     classification, the node impurity is measured by the Gini index. 
     For regression, it is measured by residual sum of squares.

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

     A (named) vector of importance measure, one for each predictor
     variable.

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

     'randomForest', 'varImpPlot'

