plot.frag.nma: Plot Method for "frag.nma" Objects

In fragility: Assessing and Visualizing Fragility of Clinical Results with Binary Outcomes

Plot Method for "frag.nma" Objects

Description

Visualizes the iterative process of event status modifications for deriving the fragility index/quotient of a network meta-analysis with a binary outcome.

Usage

## S3 method for class 'frag.nma'
plot(x, tid1, tid2, xlab, ylab, xlim, ylim, ybreaks = NULL,
     study.marker = TRUE, cex.marker, offset.marker, col.line, lwd,
     legend, x.legend, y.legend, cex.legend, ...)

Arguments

x	an object of class "frag.nma" produced by the function frag.nma.
tid1	the first treatment of the comparison of interest; if not specified, the first comparison in x$tid.f will be used.
tid2	the second treatment of the comparison of interest. Only one comparison can be specified by tid1 and tid2 at one time for plotting.
xlab	a label for the x axis.
ylab	a label for the y axis.
xlim	the x limits c(x1, x2) of the plot.
ylim	the y limits c(y1, y2) of the plot.
ybreaks	a vector of the two numeric values for breaking the y axis or NULL (the default, not breaking the y axis). The two values should be between the total event counts in the two treatment groups specified by tid1 and tid2, and the first value should be less than the second value. It is useful when the total event counts in the two groups differ a lot, leading to a large distance between the two lines representing the event status modifications in the two groups.
study.marker	a logical value indicating whether study labels involved in event status modifications are presented in the plot (the default is TRUE). When using the default, an asterisk represents that the study with an event status modification remains the same as in the previous iteration.
cex.marker	the size of study labels (when study.marker = TRUE) with the default 0.8.
offset.marker	a numeric value controlling the distance between study labels from the lines (the default is 0.2). It is passed to the function text.
col.line	a vector of the two colors for two lines representing the event status modifications in the two treatment groups. The default includes "blue" (for tid1) and "red" (for tid2).
lwd	the width of the lines (the default is 1).
legend	the legend of plot. The default gives the two groups.
x.legend	the x co-ordinate or a keyword, such as "right" (the default), to be used to position the legend. It is passed to legend.
y.legend	the y co-ordinate to be used to position the legend (the default is NULL).
cex.legend	the size of legend text (the default is 1).
...	other arguments that can be passed to plot.default.

Details

A plot showing the iterative process of event status modifications is generated for a specific treatment comparison. The x axis presents the iterations, and the y axis gives the group-specific total event counts.

Value

None.

References

Lin L, Chu H (2022). "Assessing and visualizing fragility of clinical results with binary outcomes in R using the fragility package." PLOS ONE, 17(6), e0268754. <doi: 10.1371/journal.pone.0268754>

See Also

frag.nma

fragility documentation built on Aug. 30, 2022, 1:10 a.m.