Plot QC plots and calculate statistics for bound data
Source:R/get_QC_plots_and_stats.R
get_QC_plots_parsed_merged_data.RdThis function creates quality control plots and calculates basic statistics for microscopy data. The plots provide visual insights into marker expression patterns and data quality.
Usage
get_QC_plots_parsed_merged_data(
.data,
list_of_columns_to_plot = NULL,
save_plots = FALSE,
saving_plots_folder = NULL,
save_plots_in_patient_specific_subfolders = TRUE,
fill_color_variable = NULL,
PID_column_name = "PID",
isolate_specific_drug = NULL,
isolate_specific_patient = NULL,
drug_column_name = "Treatment",
save_list_of_plots = TRUE,
p_height = 10,
p_width = 10,
verbose = TRUE
)Arguments
- .data
The preprocessed data frame to analyze (either raw bound data from
data_binding()or long-format count data fromchange_data_format_to_longer()).- list_of_columns_to_plot
Columns to include in plots. If NULL, all numeric columns are used.
- save_plots
Logical, whether to save plots to files. Defaults to FALSE.
- saving_plots_folder
Directory for saving plots. If NULL and save_plots=TRUE, uses a subdirectory of tempdir().
- save_plots_in_patient_specific_subfolders
Logical, whether to create patient subdirectories. Defaults to TRUE.
- fill_color_variable
Variable name for plot color filling
- PID_column_name
Column name for patient IDs. Defaults to "PID".
- isolate_specific_drug
Drug name to subset data
- isolate_specific_patient
Patient ID to subset data
- drug_column_name
Column name for drug information. Defaults to "Treatment".
- save_list_of_plots
Logical, whether to return list of plot objects. Defaults to TRUE.
- p_height
Plot height in inches. Defaults to 10.
- p_width
Plot width in inches. Defaults to 10.
- verbose
Logical, whether to show progress messages. Defaults to TRUE.
Value
If save_list_of_plots=TRUE, returns a named list of ggplot objects. Otherwise returns invisible(NULL).
Examples
# \donttest{
# First load and process example data
example_path <- system.file("extdata/to_merge/", package = "drugsens")
raw_data <- data_binding(path_to_the_projects_folder = example_path)
#> Reading file: /Users/flalom/Library/R/arm64/4.6/library/drugsens/extdata/to_merge//A8759_drug1..conc2.csv
#> Reading file: /Users/flalom/Library/R/arm64/4.6/library/drugsens/extdata/to_merge//A8759_drug1__conc1.csv
#> Reading file: /Users/flalom/Library/R/arm64/4.6/library/drugsens/extdata/to_merge//B36_Ascites_rep_cont.csv
#> Reading file: /Users/flalom/Library/R/arm64/4.6/library/drugsens/extdata/to_merge//B37_Ascites_Pacli.csv
#> Reading file: /Users/flalom/Library/R/arm64/4.6/library/drugsens/extdata/to_merge//B38_Ascites_GP.csv
#> Reading file: /Users/flalom/Library/R/arm64/4.6/library/drugsens/extdata/to_merge//B39_Ascites_REP_nir.csv
count_data <- make_count_dataframe(raw_data)
processed_data <- change_data_format_to_longer(count_data)
# Basic usage - create plots for all patients
plots <- get_QC_plots_parsed_merged_data(processed_data)
#> Processing patient: A8759
#> Processing patient: B36
#> Processing patient: B37
#> Processing patient: B38
#> Processing patient: B39
# Save plots to a temporary directory
temp_dir <- file.path(tempdir(), "qc_plots")
plots <- get_QC_plots_parsed_merged_data(
processed_data,
save_plots = TRUE,
saving_plots_folder = temp_dir
)
#> Processing patient: A8759
#> Saved plot to: /var/folders/t6/78b91bxn6txf3zfdbjyxvpqm0000gn/T//RtmplAOhLx/qc_plots/A8759/20261114_A8759_all_marker_positivity_ratio.pdf
#> Processing patient: B36
#> Saved plot to: /var/folders/t6/78b91bxn6txf3zfdbjyxvpqm0000gn/T//RtmplAOhLx/qc_plots/B36/20261114_B36_all_marker_positivity_ratio.pdf
#> Processing patient: B37
#> Saved plot to: /var/folders/t6/78b91bxn6txf3zfdbjyxvpqm0000gn/T//RtmplAOhLx/qc_plots/B37/20261114_B37_all_marker_positivity_ratio.pdf
#> Processing patient: B38
#> Saved plot to: /var/folders/t6/78b91bxn6txf3zfdbjyxvpqm0000gn/T//RtmplAOhLx/qc_plots/B38/20261114_B38_all_marker_positivity_ratio.pdf
#> Processing patient: B39
#> Saved plot to: /var/folders/t6/78b91bxn6txf3zfdbjyxvpqm0000gn/T//RtmplAOhLx/qc_plots/B39/20261114_B39_all_marker_positivity_ratio.pdf
# Focus on a specific patient
plots <- get_QC_plots_parsed_merged_data(
processed_data,
isolate_specific_patient = "B39"
)
#> Processing patient: B39
# Color plots by tissue type
plots <- get_QC_plots_parsed_merged_data(
processed_data,
fill_color_variable = "Tissue"
)
#> Processing patient: A8759
#> Processing patient: B36
#> Processing patient: B37
#> Processing patient: B38
#> Processing patient: B39
# }