https://github.com/cran/fBasics
Tip revision: 944271d20ffa4fb36a171791c34afaae5325f74a authored by Rmetrics Core Team on 08 February 2010, 00:00:00 UTC
version 2110.79
version 2110.79
Tip revision: 944271d
dist-ghFit.Rd
\name{ghFit}
\alias{ghFit}
\title{GH Distribution Fit}
\description{
Estimates the distrinbutional parameters for a
generalized hyperbolic distribution.
}
\usage{
ghFit(x, alpha = 1, beta = 0, delta = 1, mu = 0, lambda = -1/2,
scale = TRUE, doplot = TRUE, span = "auto", trace = TRUE,
title = NULL, description = NULL, \dots)
}
\arguments{
\item{x}{
a numeric vector.
}
\item{alpha, beta, delta, mu, lambda}{
The parameters are \code{alpha}, \code{beta}, \code{delta},
\code{mu}, and and \code{lambda}:\cr
shape parameter \code{alpha};
skewness parameter \code{beta}, \code{abs(beta)} is in the
range (0, alpha);
scale parameter \code{delta}, \code{delta} must be zero or
positive;
location parameter \code{mu}, by default 0;
and lambda parameter \code{lambda}, by default -1/2.
}
\item{scale}{
a logical flag, by default \code{TRUE}. Should the time series
be scaled by its standard deviation to achieve a more stable
optimization?
}
\item{doplot}{
a logical flag. Should a plot be displayed?
}
\item{span}{
x-coordinates for the plot, by default 100 values
automatically selected and ranging between the 0.001,
and 0.999 quantiles. Alternatively, you can specify
the range by an expression like \code{span=seq(min, max,
times = n)}, where, \code{min} and \code{max} are the
left and right endpoints of the range, and \code{n} gives
the number of the intermediate points.
}
\item{trace}{
a logical flag. Should the parameter estimation process be
traced?
}
\item{title}{
a character string which allows for a project title.
}
\item{description}{
a character string which allows for a brief description.
}
\item{\dots}{
parameters to be parsed.
}
}
\value{
returns a list with the following components:
\item{estimate}{
the point at which the maximum value of the log liklihood
function is obtained.
}
\item{minimum}{
the value of the estimated maximum, i.e. the value of the
log liklihood function.
}
\item{code}{
an integer indicating why the optimization process terminated.\cr
1: relative gradient is close to zero, current iterate is probably
solution; \cr
2: successive iterates within tolerance, current iterate is probably
solution; \cr
3: last global step failed to locate a point lower than \code{estimate}.
Either \code{estimate} is an approximate local minimum of the
function or \code{steptol} is too small; \cr
4: iteration limit exceeded; \cr
5: maximum step size \code{stepmax} exceeded five consecutive times.
Either the function is unbounded below, becomes asymptotic to a
finite value from above in some direction or \code{stepmax}
is too small.
}
\item{gradient}{
the gradient at the estimated maximum.
}
\item{steps}{
number of function calls.
}
}
\details{
The function \code{\link{nlm}} is used to minimize the "negative"
maximum log-likelihood function. \code{nlm} carries out a minimization
using a Newton-type algorithm.
}
\examples{
## ghFit -
# Simulate Random Variates:
set.seed(1953)
s = rgh(n = 1000, alpha = 1.5, beta = 0.3, delta = 0.5, mu = -1.0)
## ghFit -
# Fit Parameters:
ghFit(s, alpha = 1, beta = 0, delta = 1, mu = mean(s), doplot = TRUE)
}
\keyword{distribution}