Skip to contents

Draw a network plot with a strand for every study, colored by its judgment

Source: R/cinema_network.R
cinema_network.Rd

Draws the network of a network meta-analysis from arm level data, with every line drawn as one strand per study, so a comparison's width counts its studies and its colors show each study's risk of bias or indirectness instead of an average that would hide a mix of judgments. Node area follows the participants randomized to each treatment when n is given.

Usage

cinema_network(
  data,
  study,
  treatment,
  n = NULL,
  rob = NULL,
  indirectness = NULL,
  color = NULL,
  positions = NULL,
  title = NULL,
  caption = NULL,
  family = "Lato"
)

Arguments

data

A data frame with one row per study arm.

study, treatment

Bare column names identifying the study and the treatment of each arm.

n

Optional bare column with the number of participants in each arm; it sets node area and the counts in the panels.

rob, indirectness

Study level judgments of risk of bias and of indirectness, at least one of them: data frames with columns study, judgment and optionally reason, as in cinema_judge(), or the studies field of its result.

color

Which judgment colors the strands at first, "rob" or "indirectness". Defaults to risk of bias when it was given.

positions

Optional data frame placing the treatments by hand, with columns treatment, x and y and y pointing up, as in ggnma(). Defaults to a circle.

title, caption

Title above the plot and note below it. A caption you give is added above the default notes.

family

Font family. The package ships Lato and registers it on load.

Value

An object of class cinema_network, which prints as an interactive widget. Use graph_widget(), graph_plot() or graph_save() for the widget, a static ggplot or a file. The field edges lists each comparison with its studies and how many of them have each judgment.

Details

In the widget, a switch colors the strands by risk of bias or by indirectness, and a sentence under the plot counts the comparisons that rest only on studies with the most serious judgment, those that mix judgments and those that rest only on studies without concerns. Hovering over a strand names its study and judgments. Clicking a line or a treatment, or pressing Enter on it, opens a panel that lists the studies behind it with their judgments and the reasons for them.

Sources

Nikolakopoulou A, Higgins JPT, Papakonstantinou T, et al. CINeMA: an approach for assessing confidence in the results of a network meta-analysis. PLoS Medicine 2020;17(4):e1003082. doi:10.1371/journal.pmed.1003082

Papakonstantinou T, Nikolakopoulou A, Higgins JPT, Egger M, Salanti G. CINeMA: software for semiautomated assessment of the confidence in the results of network meta-analysis. Campbell Systematic Reviews 2020;16:e1080. doi:10.1002/cl2.1080

Papakonstantinou T, Nikolakopoulou A, Rucker G, et al. Estimating the contribution of studies in network meta-analysis: paths, flows and streams. F1000Research 2018;7:610.

Examples

# Illustrative judgments, invented for this example.
rob <- data.frame(
  study = c("CLEAR", "ERASURE", "FEATURE", "FIXTURE", "JUNCTURE"),
  judgment = c("high", "low", "some concerns", "low", "some concerns"),
  reason = "Illustrative only."
)
cinema_network(psoriasis_nma, study, treatment, n = n, rob = rob,
               caption = "Illustrative judgments, not published assessments.")