image.TPCmsm: image method for a TPCmsm object

View source: R/image.TPCmsm.R

image.TPCmsmR Documentation

image method for a TPCmsm object


image method for an object of class ‘TPCmsm’. Creates a grid of colored or gray-scale rectangles with colors corresponding to the values of the transition probabilities.


## S3 method for class 'TPCmsm'
image(x, image.type="tc", tr.choice, xlim, ylim, zlim=c(0, 1), col, xlab, ylab,
main, sub, key.title, key.axes, las=1,, legend=TRUE, curvlab,
contour=TRUE, nlevels=20, levels=pretty(zlim, nlevels), ...)



An object of class ‘TPCmsm’.


A character string specifying the type of image. If “tc” the image with time in the x axis, covariate in the y axis and transition probability in the z axis is drawn. If “ct” the image with covariate in the x axis, time in the y axis and transition probability in the z axis is drawn. Defaults to “tc”.


Character vector of the form ‘c(“from to”, “from to”)’ specifying which transitions should be plotted. Default, all the transition probabilities are plotted.


Limits of x-axis for the plot.


Limits of y-axis for the plot.


Limits of z-axis for the plot. Defaults to c(0, 1).


Vector of colour. Defaults to heat.colors(nlevels)[nlevels:1].


x-axis label. If image.type="tc" defaults to “Time”. If image.type="ct" defaults to “Covariate”.


y-axis label. If image.type="tc" defaults to “Covariate”. If image.type="ct" defaults to “Time”.


The main title for the plot. By default no main title is added.


A sub title for the plot. By default no sub title is added.


Statements which add titles for the plot key.


Statements which draw axes on the plot key. This overrides the default axis.


The style of labeling to be used. The default is to use horizontal labeling.

Logical. Whether to display images of confidence regions. Default is FALSE.


A logical specifying if a legend should be added.


A character or expression vector to appear in the legend. Default is the name of the transitions.


If TRUE contour lines are added to the image. Default is TRUE.


The number of levels to divide the range of z. Defaults to 20 levels.


Numeric vector of levels at which to draw contour lines. Defaults to pretty(zlim, nlevels). The breaks of image are set equal to levels.


Further arguments for image.


No value is returned.


The device is divided by the number of transitions specified by argument tr.choice. Being the number of columns equal to the number of transitions. If argument the device is further divided to make room for the confidence regions. In this case two rows are added, one for each side of the confidence region. So if the center row provides the image of the estimates. The upper row provides the upper side of the confidence region. And the lower row provides the lower side of the confidence region.


Artur Araújo, Javier Roca-Pardiñas and Luís Meira-Machado


Araújo A, Meira-Machado L, Roca-Pardiñas J (2014). TPmsm: Estimation of the Transition Probabilities in 3-State Models. Journal of Statistical Software, 62(4), 1-29. \Sexpr[results=rd]{tools:::Rd_expr_doi("10.18637/jss.v062.i04")}

Meira-Machado L., de Uña-Álvarez J., Datta S. (2011). Conditional Transition Probabilities in a non-Markov Illness-death Model. Discussion Papers in Statistics and Operation Research n 11/03. Department of Statistics and Operations Research, University of Vigo (ISSN: 1888-5756, Deposito Legal VG 1402-2007).

See Also

contour, image.


# Set the number of threads
nth <- setThreadsTP(2);

# Create survTP object
heartTP_obj <- with( heartTP, survTP(time1, event1, Stime, event, age=age) );

# Compute LIN conditional transition probabilities with confidence band
TPCmsm_obj <- transLIN(heartTP_obj, s=57, t=310, x=0, conf=TRUE, n.boot=100,

# Plot image with Time in the x-axis
image(TPCmsm_obj, image.type="tc", tr.choice=c("1 1", "1 2", "2 2"),, ylab="Age");

# Plot image with Time in the y-axis
image(TPCmsm_obj, image.type="ct", tr.choice=c("1 1", "1 2", "1 3"),, xlab="Age");

# Restore the number of threads

TPmsm documentation built on May 29, 2024, 10:43 a.m.