plot_recruitment: Plots the recruitment over time for 'secuTrialdata' objects

In secuTrialR: Handling of Data from the Clinical Data Management System 'secuTrial'

Plots the recruitment over time for secuTrialdata objects

Description

secuTrial exports inherently contain the information on which participant was registered at which point in time. This function makes use of this property to plot recruitment over time. Centers indicated with a black line in the legend did not recruit at all.

Usage

plot_recruitment(
  x,
  return_data = FALSE,
  show_centres = TRUE,
  cex = 1,
  rm_regex = ""
)

Arguments

x	a secuTrialdata object
return_data	logical - return the data used to produce the plot instead of the plot
show_centres	logical - subset the data into centres
cex	double - specifies font size in legend
rm_regex	character - specifies a regular expression to be removed from the centre names in the legend. e.g. rm_regex = "\\(.*\\)$" will remove trailing brackets and their contents.

Value

a simple line plot showing recruitment over time or a list of data.frames if return_data is set to TRUE

Examples

# export location
expot_loc <- system.file("extdata", "sT_exports", "lnames",
                         "s_export_CSV-xls_CTU05_long_ref_miss_en_utf8.zip",
                         package = "secuTrialR")
# read export
sT_export <- read_secuTrial(expot_loc)

# plot recruitment
plot_recruitment(sT_export)

# plot without trailing bracket
plot_recruitment(sT_export, rm_regex = "\\(.*\\)$")

secuTrialR documentation built on March 7, 2023, 5:35 p.m.