subjectProfileTextPlot: Visualize text-information in subject profiles.

In patientProfilesVis: Visualization of Patient Profiles

Visualize text-information in subject profiles.

Description

There are two ways to specify the variables of interest to include:

• by specifying column(s) of interest containing parameter values, passed to the paramValueVar parameter.
  In this case, variable value is displayed in the plot area, and variable name in the label of the y-axis, as:
  variable 1 | value 1 - value 2 - ...
  variable 2 | value 1 - value 2 - ...

• by specifying column(s) of interest containing parameter values, displayed as a table.
  In this case, variable are displayed in columns in the plot area. Variable names are displayed on top of table, and associated values below, as:
  | variable 1 variable 2
  | value 1 value 1 | ...

• by specifying a combination of a variable containing the parameter name (paramNameVar), coupled with a variable containing the parameter values (paramValueVar).
  In this case, parameter values (if multiple) are concatenated and displayed in the plot area for each parameter name, displayed in the label of the y-axis, as:
  variable name 1 | variable value 1 - variable value 2 - ...
  variable name 2 | variable value 1 - ...

Usage

subjectProfileTextPlot(
  data,
  paramValueVar,
  paramValueLab = getLabelVar(paramValueVar, labelVars = labelVars),
  paramNameVar = NULL,
  paramGroupVar = NULL,
  subsetData = NULL,
  subsetVar = NULL,
  subsetValue = NULL,
  subjectVar = "USUBJID",
  subjectSubset = NULL,
  subjectSample = NULL,
  seed = 123,
  xLab = "",
  yLab = "",
  title = "Subject information",
  label = title,
  labelVars = NULL,
  paramVarSep = " - ",
  formatReport = subjectProfileReportFormat(),
  paging = TRUE,
  table = FALSE,
  colWidth = NULL
)

Arguments

data	Data.frame with data.
paramValueVar	Character vector, either: vector with names of variable(s) (multiple are possible) of data of interest. The values are displayed in the plot area and variable name in the labels of the y-axis. Multiple variables can be concatenated in the same line by specifying them, as an unique string separated by a 'pipe', e.g 'SEX|AGE'. Variable label(s) are concatenated (with ', ') and displayed in the y-axis. if paramNameVar is specified: character vector with names of variable(s) (multiple possible) of data with values to represent in the plot area. function taking data as input and returning a new variable (of length equal to number of rows in data) with parameter value to represent
paramValueLab	(optional) Named character vector with labels for paramValueVar.
paramNameVar	(optional) Character vector of length 1 with variable of data with parameter name. This is displayed in the labels of the y-axis.
paramGroupVar	(optional) Character vector with variable(s) of data based on which the data will be grouped and sorted (in the y-axis) in the plot.
subsetData	(optional) Data.frame with extra dataset to filter on. This dataset is filtered, and only records from data with common subject IDs will be retained. If not specified, data is used.
subsetVar	(optional) String with variable of subset data to filter on. subsetValue should be specified too. If not specified, all records from the subset data are retained.
subsetValue	(optional) Character vector with value(s) of interest to retain in the filtered data. These values should be available in subsetVar. Missing values in the subject variable are not retained in the filtered data.
subjectVar	String, variable of data with subject ID
subjectSubset	(optional) Character vector with subjects of interest (available in subjectVar), NULL by default.
subjectSample	(optional) Integer of length 1 with number of random subject(s) that should be considered, e.g. to check the created patient profiles for a subset of the data. By default, all specified subjects are considered (set to NULL).
seed	(optional) Integer of length 1 with seed used to select random subjects if subjectSample is specified (123 by default).
xLab	String, label for the x-axis.
yLab	String, label for the y-axis.
title	String with title, 'Subject information' by default.
label	String, label for the visualization. This label is stored as attributes of the output from the subjectProfile[]Plot function. This label is displayed in the final profile report, in case no data is available for for a specific patient, as: 'No [label] available.'
labelVars	Named character vector with variable labels (names are the variable code)
paramVarSep	String (' - ' by default) with character(s) used to concatenate multiple variables for the same record in the plot area.
formatReport	list with parameters used to specify the format of the report, e.g. output of the subjectProfileReportFormat function
paging	Logical, if TRUE (by default), automatic paging is enabled, so patient profiles module too big to fit in one page will span multiple pages. Please note that the size of the graphic window (or report page) may need to be re-sized in order that the plot fits. If FALSE, the entire plot is included in one single page.
table	Logical, if TRUE (FALSE by default) the information contained in the variables: paramValueVar is displayed as a table. Otherwise, the values of the different variables are concatenated in the same line.
colWidth	Numeric vector with approximate width of each parameter value column for a table layout. For example in case two parameters are specified: c(0.8, 0.2)) such as the first column takes 80% of plot area, and the second column 20%. Note: columns can be slightly bigger if their content is larger than the specified width. If not specified, column width is optimized based on the max length of the character in each column.

Value

list of (across subjects) of list (across modules) of ggplot2 objects, also of class subjectProfileTextPlot, with additional metaData attributes containing 'label' and 'timeLim'.

Author(s)

Laure Cougnaud

See Also

Other patient profiles plotting function: subjectProfileEventPlot(), subjectProfileIntervalPlot(), subjectProfileLinePlot()

patientProfilesVis documentation built on Nov. 18, 2022, 5:12 p.m.