starplotObserved           package:Ratings           R Documentation

_O_b_s_e_r_v_e_d _D_a_t_a _S_t_a_r_p_l_o_t_s _o_f _R_a_t_i_n_g_s _D_a_t_a

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

     Creates the observed data starplot discussed in Ho and Quinn
     (n.d.).

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

     starplotObserved(Y, catnames, starcol = "darkgray", starsize = 0.2, ...)

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

       Y: Matrix of data to be analyzed. Entries must be integers from 
          1, ..., C or 'NA' where C  is the number of ordinal
          categories. Raters are on the rows and  products are on the
          columns.

catnames: A character vector of names for the rating categories. Should
          have C elements. First element should give the name for a
          rating of 1, second element the names for a rating of 2, etc.

 starcol: Color of stars. 

starsize: Positive scalar that regulates the size of the stars in the
          plot. 

     ...: Other arguments to plotting functions. 

_R_e_f_e_r_e_n_c_e_s:

     Ho, Daniel E. and Kevin M. Quinn. forthcoming. "Improving the
     Presentation and Interpretation of Online Ratings Data with
     Model-based Figures." The American Statistician.

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

     'ordrating', 'starplotModelBased', 'barplotObserved'

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

     ## Not run: 
     ## Mondo Times example from Ho & Quinn (nd).

     data(Mondo)

     ## just the first 12 cols
     Mondo.sub <- Mondo[,1:12]

     starplotObserved(Mondo.sub, starcol="green",
                       catnames = c("Awful", "Poor", "Average", 
                                    "Very Good", "Great"))

     ## End(Not run)

