|
a |
|
b/man/plot-methods.Rd |
|
|
1 |
% Generated by roxygen2: do not edit by hand |
|
|
2 |
% Please edit documentation in R/eventPrediction_package.R, R/eventData.R, R/dataResults.R, R/eventModel.R, R/fromParameterPlot.R |
|
|
3 |
\docType{methods} |
|
|
4 |
\name{plot} |
|
|
5 |
\alias{plot} |
|
|
6 |
\alias{plot,AnalysisResults,missing-method} |
|
|
7 |
\alias{plot,EventData,missing-method} |
|
|
8 |
\alias{plot,EventModel,missing-method} |
|
|
9 |
\alias{plot,FromDataResults,missing-method} |
|
|
10 |
\title{The plot methods for EventPrediction package} |
|
|
11 |
\usage{ |
|
|
12 |
plot(x, y, ...) |
|
|
13 |
|
|
|
14 |
\S4method{plot}{EventData,missing}(x, xlab = "log(t)", |
|
|
15 |
ylab = "log(-log(S(t)))", main = "", ...) |
|
|
16 |
|
|
|
17 |
\S4method{plot}{FromDataResults,missing}(x, |
|
|
18 |
title = getFromDataResultsSummaryText(x, round.method = round.method, |
|
|
19 |
text.width = text.width, show.predictions = show.predictions), |
|
|
20 |
show.title = FALSE, text.width = 80, show.obs = FALSE, |
|
|
21 |
round.method = "None", show.predictions = TRUE, pred.to.present = FALSE, |
|
|
22 |
xlim = c(0, -1), ylim = NULL, include.dropouts = TRUE, |
|
|
23 |
legend.position = "bottomright", custom.dates = NULL) |
|
|
24 |
|
|
|
25 |
\S4method{plot}{EventModel,missing}(x, units = "Days", |
|
|
26 |
xlab = paste("Time in study [", units, "]", sep = ""), ylab = "", |
|
|
27 |
main = "", ylim = NULL, xlim = NULL, ...) |
|
|
28 |
|
|
|
29 |
\S4method{plot}{AnalysisResults,missing}(x, text = getFromParameterText(x, |
|
|
30 |
options = options), options = DisplayOptions(text.width = 110), |
|
|
31 |
show.title = TRUE, show.separate.arms = !isSingleArm(x@study), |
|
|
32 |
ylim = NULL) |
|
|
33 |
} |
|
|
34 |
\arguments{ |
|
|
35 |
\item{x}{Standard arguments to plot generic} |
|
|
36 |
|
|
|
37 |
\item{y}{Standard arguments to plot generic} |
|
|
38 |
|
|
|
39 |
\item{...}{Additional arguments for the plot function} |
|
|
40 |
|
|
|
41 |
\item{xlab}{X axis label.} |
|
|
42 |
|
|
|
43 |
\item{ylab}{Y axis label.} |
|
|
44 |
|
|
|
45 |
\item{main}{Plot title} |
|
|
46 |
|
|
|
47 |
\item{title}{The title text, by default it is \code{summary(x)}} |
|
|
48 |
|
|
|
49 |
\item{show.title}{Logical, if TRUE, will show title in plot.} |
|
|
50 |
|
|
|
51 |
\item{text.width}{Number of characters to wrap title text by.} |
|
|
52 |
|
|
|
53 |
\item{show.obs}{If TRUE, add a line and points displaying the observed events.} |
|
|
54 |
|
|
|
55 |
\item{round.method}{If the string "toMonths" then dates are rounded |
|
|
56 |
to the nearest month. For the lower confidence interval value |
|
|
57 |
the date 15 days earlier than the given value is rounded to the nearest |
|
|
58 |
month and for the upper confidence intervalvalue the |
|
|
59 |
date 15 dats later than the given value is rounded to the nearest month} |
|
|
60 |
|
|
|
61 |
\item{show.predictions}{If TRUE show brown dashed lines at the user specified prediction |
|
|
62 |
times/number of events.} |
|
|
63 |
|
|
|
64 |
\item{pred.to.present}{If TRUE, move all predictions from past to present. Beware.} |
|
|
65 |
|
|
|
66 |
\item{xlim}{X axis limits. If \code{x} is \code{FromDataResults} object then |
|
|
67 |
c(2,10) will display from 2 to 10 months after the first |
|
|
68 |
subject was recruited. Using c(0,-1) will show the entire graph} |
|
|
69 |
|
|
|
70 |
\item{ylim}{The y-axis range for the plot} |
|
|
71 |
|
|
|
72 |
\item{include.dropouts}{Include the cumulative dropouts on the graph (logical)} |
|
|
73 |
|
|
|
74 |
\item{legend.position}{The position of the graph legend} |
|
|
75 |
|
|
|
76 |
\item{custom.dates}{A vector of dates (in string or Date format) to be output on the x-axis |
|
|
77 |
if NULL then default dates will be used} |
|
|
78 |
|
|
|
79 |
\item{units}{Scale for the x-axis. "Days", "Months" or "Years"} |
|
|
80 |
|
|
|
81 |
\item{text}{Text to display be in title, e.g. output |
|
|
82 |
from the getSummaryText() function.} |
|
|
83 |
|
|
|
84 |
\item{options}{Use this to customize the output.} |
|
|
85 |
|
|
|
86 |
\item{show.separate.arms}{Logical, if TRUE (and if x is a two arm study) the expected event |
|
|
87 |
curves for the separate arms are displayed on the graph, otherwise do not show the curves.} |
|
|
88 |
} |
|
|
89 |
\description{ |
|
|
90 |
For \code{x} an \code{EventData} object, this method will plot |
|
|
91 |
a cloglog survival curve of the data. If \code{x} is an \code{EventModel} |
|
|
92 |
object, this method will plot a KM curve of the data overlaid with the |
|
|
93 |
survival function from the model fit. |
|
|
94 |
} |
|
|
95 |
|