glioblastomaEHRsData (version 1.1.0)

plotTainan2020dataset: Plot variables from the tainan2020dataset

Description

This function creates a plot of one or two variables from the 'tainan2020dataset' dataframe. It automatically chooses the appropriate plot type based on the variable types and it can export and save the plot by specifying the directory, filename and extension. Provided variable names need to be in the dataset, otherwise an error will be launched. The function makes it easy to plot univariate and bivariate plots while offering a quick way to save and export them.

Usage

plotTainan2020dataset(name1, name2 = NA, savePath = NA)

Value

A 'ggplot2' object representing the generated plot. If the specified variables are not found in the dataset, returns a warning.

Arguments

name1

Character. The name of the first variable to plot.

name2

Character (optional). The name of the second variable for bivariate plots. Default is NA.

savePath

Character (optional). File path where the plot should be saved. Default is NULL which means no plot will be saved. To save a plot using all the default options put an empty string. The format must be: 'filepath/filename.extension' where:

• filepath is the directory (must already exist), default is the working directory;

• filename is the name of the file, default to 'plot_tainan2020dataset_var1_var2_timestamp.png';

• extension must be one of the supported 'ggsave' extensions and must be specified, unless using the default file name.

Details

The function supports the following plotting logic:

• If only 'name1' is provided:

  • Numeric/integer variable → Histogram.

  • Character/factor variable → Bar plot.

• If both 'name1' and 'name2' are provided:

  • One numeric/integer and one categorical → Boxplot.

  • Both categorical → Grouped bar plot.

See Also

DataExplorer::plot_bar(), DataExplorer::plot_histogram(), DataExplorer::plot_boxplot, savePlot()

Examples

# Univariate plot without saving
plotTainan2020dataset("TMZ_based_chemo_yes1_no0")

# Bivariate plot without saving
plotTainan2020dataset("PFS_months", "OS_months")

# \donttest{
# Bivariate plot saved in the specified directory with the chosen name and extension
plotTainan2020dataset("age_years", "chemo_yes1_no0", savePath = NA)

# Bivariate plot saved in the working directory with the chosen name and extension
plotTainan2020dataset("PFS_months", "OS_months", savePath = NA)

# Bivariate plot saved in a path directory with default name and extension
plotTainan2020dataset("PFS_months", "radiation_dose_Gy", savePath = NA)
# }