mtrank (version 0.1-1)

forest.tcc: Forest plot showing study-specific preferences or ties according to treatment choice criterion

Description

This function produces a forest plot for all (or selected) study specific comparisons and visualizes the treatment preference or ties which are defined from the treatment choice criterion in tcc.

Usage

# S3 method for tcc
forest(
  x,
  treat = NULL,
  backtransf = FALSE,
  leftcols = "studlab",
  leftlabs = NULL,
  rightcols = c("effect", "ci"),
  lty.equi = gs("lty.equi"),
  col.equi = gs("col.equi"),
  fill.equi = gs("fill.equi"),
  fill.lower.equi = fill.equi,
  fill.upper.equi = rev(fill.equi),
  header.line = TRUE,
  col.subgroup = "black",
  ...
)

Value

A forest plot is plotted in the active graphics device.

Arguments

x

An object of class tcc.

treat

A treatment of interest. If specified it returns a forest plot for all study specific effects related to treat. If NULL (default), it generates a forest plot for all study-specific effects in the network.

backtransf

A logical indicating whether results should be back transformed. If backtransf = TRUE (default), results for sm = "OR" are printed as odds ratios rather than log odds ratios, for example.

leftcols

A character vector specifying columns to be printed on the left side of the forest plot (see forest.meta).

leftlabs

A character vector specifying labels for columns on left side of the forest plot.

rightcols

A character vector specifying columns to be printed on the right side of the forest plot (see forest.meta).

lty.equi

Line type (limits of equivalence).

col.equi

Line colour (limits of equivalence).

fill.equi

Colour(s) for area between limits of equivalence or more general limits.

fill.lower.equi

Colour of area between lower limit(s) and reference value. Can be equal to the number of lower limits or the number of limits plus 1 (in this case the the region between minimum and smallest limit is also filled).

fill.upper.equi

Colour of area between reference value and upper limit(s). Can be equal to the number of upper limits or the number of limits plus 1 (in this case the region between largest limit and maximum is also filled).

header.line

A logical value indicating whether to print a header line or a character string ("both", "below", "").

col.subgroup

The colour to print information on subgroups, i.e., pairwise comparisons.

...

Additional arguments (passed on to forest.meta).

Details

This function produces forest plots for the study specific treatment effects in the network. The color indicates whether treatment effects show a preference (red color) or tie (black color). Additionally, the respective range of equivalence defined at the function tcc is visualized for the forest plot.

Argument treat is optional. By default ( treat = NULL), all study-specific treatment effects in the network are shown. If specified, only study-specific treatment effects related to the specified treat are shown which is useful in busy networks with many direct comparisons.

References

Evrenoglou T, Nikolakopoulou A, Schwarzer G, Rücker G, Chaimani A (2024): Producing treatment hierarchies in network meta-analysis using probabilistic models and treatment-choice criteria. https://arxiv.org/abs/2406.10612

Examples

data(diabetes)
#
ranks <- tcc(treat = t, studlab = study, event = r, n = n, data = diabetes,
  mcid = 1.20, sm = "OR", small.values = "desirable")
#
forest(ranks)
forest(ranks, treat = "ARB")