fitcbp {cpd} | R Documentation |
Maximum-likelihood fitting of the CBP distribution
Description
Maximum-likelihood fitting of the Complex Biparametric Pearson (CBP) distribution with parameters b
and \gamma
. Generic
methods are print
, summary
, coef
, logLik
, AIC
, BIC
and plot
.
Usage
fitcbp(x, bstart = NULL, gammastart = NULL, method = "L-BFGS-B", control = list(), ...)
Arguments
x |
A numeric vector of length at least one containing only finite values. |
bstart |
A starting value for the parameter |
gammastart |
A starting value for the parameter |
method |
The method to be used in fitting the model. See 'Details'. |
control |
A list of parameters for controlling the fitting process. |
... |
Additional parameters. |
Details
If the starting values of the parameters b
and \gamma
are omitted (default option),
they are computing by the method of moments (if possible; otherwise they must be entered).
The default method is "L-BFGS-B"
(see details in optim
function),
but non-linear minimization (nlm
) or those included in the optim
function ("Nelder-Mead"
,
"BFGS"
, "CG"
and "SANN"
) may be used.
Standard error (SE) estimates for b
and \gamma
are provided by the default method;
otherwise, SE for \gamma_0
where \gamma=exp{(\gamma_0})
is computed.
Value
An object of class 'fitCBP'
is a list containing the following components:
-
n
, the number of observations, -
initialValues
, a vector with the starting values used, -
coefficients
, the parameter ML estimates of the CTP distribution, -
se
, a vector of the standard error estimates, -
hessian
, a symmetric matrix giving an estimate of the Hessian at the solution found in the optimization of the log-likelihood function, -
cov
, an estimate of the covariance matrix of the model coefficients, -
corr
, an estimate of the correlation matrix of the model estimates, -
loglik
, the maximized log-likelihood, -
aic
, Akaike Information Criterion, minus twice the maximized log-likelihood plus twice the number of parameters, -
bic
, Bayesian Information Criterion, minus twice the maximized log-likelihood plus twice the number of parameters, -
code
, a code that indicates successful convergence of the fitter function used (see nlm and optim helps), -
converged
, logical value that indicates if the optimization algorithms succesfull, -
method
, the name of the fitter function used.
Generic functions:
-
print
: The print of a'fitCBP'
object shows the ML parameter estimates and their standard errors in parenthesis. -
summary
: The summary provides the ML parameter estimates, their standard errors and the statistic and p-value of the Wald test to check if the parameters are significant. This summary also shows the loglikelihood, AIC and BIC values, as well as the results for the chi-squared goodness-of-fit test and the Kolmogorov-Smirnov test for discrete variables. Finally, the correlation matrix between parameter estimates appears. -
coef
: It extracts the fitted coefficients from a'fitCBP'
object. -
logLik
: It extracts the estimated log-likelihood from a'fitCBP'
object. -
AIC
: It extracts the value of the Akaike Information Criterion from a'fitCBP'
object. -
BIC
: It extracts the value of the Bayesian Information Criterion from a'fitCBP'
object. -
plot
: It shows the plot of a'fitCBP'
object. Observed and theoretical probabilities, empirical and theoretical cumulative distribution functions or empirical cumulative probabilities against theoretical cumulative probabilities are the three plot types.
References
Jose Rodriguez-Avi J, Conde-Sanchez A, Saez-Castillo AJ (2003). “A new class of discrete distributions with complex parameters.” Stat. Pap., 44, 67–88. doi:10.1007/s00362-002-0134-7.
See Also
Plot of observed and theoretical frequencies for a CBP fit: plot.fitCBP
Maximum-likelihood fitting for the CTP distribution: fitctp
.
Maximum-likelihood fitting for the EBW distribution: fitebw
.
Examples
set.seed(123)
x <- rcbp(500, 1.75, 3.5)
fitcbp(x)
summary(fitcbp(x, bstart = 1.1, gammastart = 3))