diff --git a/vignettes/gDRcore.Rmd b/vignettes/gDRcore.Rmd index 3ff9515c..189fe280 100644 --- a/vignettes/gDRcore.Rmd +++ b/vignettes/gDRcore.Rmd @@ -39,7 +39,11 @@ a series or the same number of elements, the attributes (columns of the table) s ## Drug processing For drug response data, the input files need to be merged such that each measurement (data) is associated with the right metadata (cell line properties and treatment definition). Metadata can be added with the function `cleanup_metadata` if the right reference databases are in place. -When the data and metadata are merged into a long table, the wrapper function `runDrugResponseProcessingPipeline` can be used to generate an MAE with processed and analyzed data. In practice runDrugResponseProcessingPipeline does the following steps: +When the data and metadata are merged into a long table, the wrapper function `runDrugResponseProcessingPipeline` can be used to generate an MAE with processed and analyzed data. + +![Figure 1. The overview of the runDrugResponseProcessingPipeline. ](https://raw.githubusercontent.com/gdrplatform/gDRcore/GDR-2419/inst/images/pipeline2.png). + +In practice runDrugResponseProcessingPipeline does the following steps: * `create_SE` creates the structure of the MAE and the associated SEs by assigning metadata into the row and column attributes. The assignment is performed in the function split_SE_components (see details below for the assumption made when building SE structures). create_SE also dispatches the raw data and controls into the right nested tables. Note that data may be duplicated between different SEs to make them self-contained. @@ -48,6 +52,8 @@ create_SE also dispatches the raw data and controls into the right nested tables * `fit_SE` fits the dose-response curves and calculates response metrics for each normalization type. * `fit_SE.combinations` calculates synergy scores for drug combination data and, if the data is appropriate, fits along the two drugs and matrix-level metrics (e.g. isobolograms) are calculated. This is also performed for each normalization type independently. +![Figure 2. Detailed overview of the drug processing pipeline. ](https://raw.githubusercontent.com/gdrplatform/gDRcore/GDR-2419/inst/images/pipeline.png). + The functions to process the data have parameters for specifying the names of the variables and assays. Additional parameters are available to personalize the processing steps such as force the nesting (or not) of an attribute, specify attributes that should be considered as technical replicates or not. # Use Cases