plot.pencopula: Plot the estimated copula density or copula distribution.

Description Usage Arguments Details Value Author(s) References

View source: R/plot.pencopula.R

Description

The function plots the estimated copula density or the copula distrubtion, using the R-package 'lattice'.

Usage

1
2
3
4
5
## S3 method for class 'pencopula'
plot(x, val = NULL, marg = TRUE, plot = TRUE, int = FALSE,
main.txt = NULL, sub.txt = NULL, contour = FALSE, cond = NULL, cuts =
20, cex = 1, cex.axes = 1, cex.contour=1, xlab = NULL, ylab = NULL,
zlab=NULL, biv.margin=NULL, show.observ=FALSE,...)

Arguments

x

object of class 'pencopula'.

val

Default val = NULL, one can calculate the estimated density in for p-dimensional vector, e.g. val=c(0.5,1) for the two dimensional case.

marg

Default = TRUE, plotting the marginal densities.

plot

Default = TRUE, if 'FALSE' no plot is shown, e.g. for calculations with val != NULL.

int

Default = FALSE, if TRUE, the integral, i.e. the distribution of the copula density is plotted.

main.txt

Default = NULL shows 'd', 'D', the values of lambda, the penalty order and the degree of the B-splines.

sub.txt

Default = NULL shows the log-likelihood, the penalized log-likelihood and the AIC-value of the estimation.

contour

If TRUE, a contour plot is shown. Default = FALSE.

cond

Default = NULL, if the dimension of data 'p' is higher than 2, one can plot a two-dimensional conditional plot. The user specifies p-2 values for the plot, indicating with '-1'. So for a three-dimensional plot, cond=c(0,-1,-1) shows the density/distribution ith fixed first covariate and the second and third covariates vary.

cuts

Number of cuts for the contour plots, if contour=TRUE.

cex

Default = 1, determing the size of the main of the plot.

cex.axes

Default = 1, determing the size of the labels at the axes.

cex.contour

Default = 1, determing the size of the labels at the cuts of the contourplot.

xlab

Default = NULL and no text is printed at the xlab

ylab

Default = NULL and no text is printed at the ylab

zlab

Default = NULL and 'density' is printed at the zlab for int=FALSE and 'distribution' for int=TRUE.

biv.margin

Determines for which parameter the bivariate marginal distribution/density is presented.

show.observ

Default = FALSE. If TRUE, plotting the original observation into a contourplot. For multivariate copulas the data corresponding to 'biv.margin' is plotted. Show.observ is not possible in combination with option 'cond'.

...

further arguments

Details

For the two dimensional plots, a equidistant grid of 21 values between 0 and 1 is constructed. The plot consists of the density or distribution values in this grid points. For plots of high dimensional data (p>2), one has to fix p-2 covariates (see 'cond').

Value

If 'val' is not NULL, the function returns a matrix with the calculated density or distribution values for the set 'val'.

Author(s)

Christian Schellhase <cschellhase@wiwi.uni-bielefeld.de>

References

Flexible Copula Density Estimation with Penalized Hierarchical B-Splines, Kauermann G., Schellhase C. and Ruppert, D. (2013), Scandinavian Journal of Statistics 40(4), 685-705.


pencopula documentation built on May 2, 2019, 7:21 a.m.