~ubuntu-branches/ubuntu/trusty/r-cran-sn/trusty

« back to all changes in this revision

Viewing changes to man/msn.conditional.Rd

  • Committer: Package Import Robot
  • Author(s): Dirk Eddelbuettel
  • Date: 2014-01-14 06:28:00 UTC
  • mfrom: (1.1.11)
  • Revision ID: package-import@ubuntu.com-20140114062800-yntgbps6kq5et10c
Tags: 1.0-0-1
* New upstream release

* debian/control: Add (Build-)Depends on r-cran-numderiv nomnormt (>= 1.3-1)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
\name{msn.conditional}
2
 
\alias{msn.conditional}
3
 
\title{
4
 
Cumulants and distribution of a skew-normal variate after conditioning
5
 
}
6
 
\description{
7
 
Finds cumulants up to 3rd order of a multivariate skew-normal
8
 
distribution conditionally on the values taken on by some of
9
 
its components, and finds a multivariate skew-normal distribution
10
 
with the same cumulants.
11
 
}
12
 
 
13
 
\usage{
14
 
msn.conditional(xi = rep(0, length(alpha)), Omega, alpha, fixed.comp, 
15
 
                fixed.values, dp = NULL) }
16
 
 
17
 
\arguments{
18
 
\item{xi}{
19
 
a numeric vector of length \code{d}, say, giving the location parameter.
20
 
}
21
 
\item{Omega}{
22
 
a covariance matrix of dimension \code{(d,d)}.
23
 
}
24
 
\item{alpha}{
25
 
a numeric vector of length \code{d}, which regulates the shape of the density.
26
 
}
27
 
\item{fixed.comp}{
28
 
a vector containing a subset of \code{1:d} which selects the components
29
 
whose values are to be fixed; it must be of length \code{d-2}.
30
 
}
31
 
\item{fixed.values}{
32
 
a numeric vector of values taken on by the components \code{fixed.comp};
33
 
it must be of the same length of \code{fixed.comp}.
34
 
}
35
 
\item{dp}{
36
 
    a list containing the components \code{xi}, \code{Omega},
37
 
  \code{alpha}, contaning quantities as described above
38
 
  }}
39
 
\value{
40
 
A list containing the following elements:
41
 
 
42
 
\item{cumulants}{
43
 
a list containing mean vector, variance matrix, and indices of 
44
 
skewness of the conditional distribution.
45
 
}
46
 
\item{fit}{
47
 
a list containing the parameters of the fitted skew-normal
48
 
distribution in the \code{(xi,Omega,alpha)} parametrization, plus
49
 
the vector \code{delta}.
50
 
}}
51
 
\details{Typical usages are
52
 
\preformatted{%
53
 
msn.conditional(xi, Omega, alpha, fixed.comp, fixed.values)
54
 
msn.conditional(dp=, fixed.comp, fixed.values)
55
 
}
56
 
See the reference below for details and background.
57
 
}
58
 
\references{
59
 
Azzalini, A. and Capitanio, A. (1999).
60
 
Statistical applications of the multivariate skew-normal distribution.
61
 
\emph{J. Roy. Statist. Soc. B}
62
 
\bold{61}, 579--602.
63
 
}
64
 
\seealso{
65
 
\code{\link{msn.cond.plot}}, \code{\link{msn.marginal}}
66
 
}
67
 
\examples{
68
 
Omega <- diag(3)+0.5*outer(rep(1,3),rep(1,3))
69
 
a<- msn.conditional(rep(0,3), Omega, 1:3, 3, -0.75)
70
 
}
71
 
\keyword{multivariate}
72
 
\keyword{distribution}