quasipoissonff             package:VGAM             R Documentation

_Q_u_a_s_i-_P_o_i_s_s_o_n _F_a_m_i_l_y _F_u_n_c_t_i_o_n

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

     Fits a generalized linear model to a Poisson response, where the
     dispersion parameter is unknown.

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

     quasipoissonff(link = "loge", onedpar = FALSE,
                    parallel = FALSE, zero = NULL)

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

    link: Link function. See 'Links' for more choices.

 onedpar: One dispersion parameter? If the response is a matrix,  then
          a separate dispersion parameter will be computed for each
          response (column), by default. Setting 'onedpar=TRUE' will
          pool them so that there is only one dispersion parameter to
          be estimated.

parallel: A logical or formula. Used only if the response is a matrix.

    zero: An integer-valued vector specifying which linear/additive
          predictors are modelled as intercepts only.  The values must
          be from the set {1,2,...,M}, where M is the number of columns
          of the matrix response.

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

     M defined above is the number of linear/additive predictors.

     If the dispersion parameter is unknown, then the resulting
     estimate is not fully a maximum likelihood estimate.

     A dispersion parameter that is less/greater than unity corresponds
     to under-/over-dispersion relative to the Poisson model. 
     Over-dispersion is more common in practice.

     When fitting a Quadratic RR-VGLM, the response is a matrix of M,
     say, columns (e.g., one column per species). Then there will be M
     dispersion parameters (one per column of the response matrix).

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

     An object of class '"vglmff"' (see 'vglmff-class'). The object is
     used by modelling functions such as 'vglm', 'vgam', 'rrvglm',
     'cqo', and 'cao'.

_N_o_t_e:

     This function will handle a matrix response automatically.

     The call 'poissonff(dispersion=0, ...)' is equivalent to
     'quasipoissonff(...)'.  The latter was written so that R users of
     'quasipoisson()' would only need to add a  ``'ff''' to the end of
     the family function name.

     Regardless of whether the dispersion parameter is to be estimated
     or not, its value can be seen from the output from the 'summary()'
     of the object.

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

     Thomas W. Yee

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

     McCullagh, P. and Nelder, J. A. (1989) _Generalized Linear
     Models_, 2nd ed. London: Chapman & Hall.

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

     'poissonff', 'loge', 'rrvglm', 'cqo', 'cao', 'binomialff',
     'quasibinomialff', 'quasipoisson'.

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

     quasipoissonff()

     ## Not run: 
     n = 200; p = 5; S = 5
     mydata = rcqo(n, p, S, fam="poisson", EqualTol=FALSE)
     myform = attr(mydata, "formula")
     p1 = cqo(myform, fam=quasipoissonff, EqualTol=FALSE, data=mydata)
     sort(p1@misc$deviance.Bestof) # A history of all the iterations
     lvplot(p1, y=TRUE, lcol=1:S, pch=1:S, pcol=1:S)
     summary(p1)  # The dispersion parameters are estimated
     ## End(Not run)

