Skip to contents

A cell group is a set of deconvolution features with a similar biological activity: features related to the same TF module to the same degree (similar correlation with the module score). The features of a cell group do not need to vary together across samples. The cell groups are built in three steps:

  1. each TF module is correlated with every deconvolution feature (compute.modules.relationship());

  2. for each module, the significantly correlated features are clustered on their correlation with the module (identify.cell.groups());

  3. each dendrogram is cut into cell groups, and each cell group gets one score per sample from a CCA with the score of its TF module (cell.groups.computation()).

The deconvolution matrix and network must have the same samples (matched by name; their order can differ): the module scores of network are put in the sample order of the deconvolution matrix.

Usage

construct_cell_groups(
  network,
  dt,
  batch = NULL,
  pval = 0.05,
  padj = FALSE,
  corr_type = "spearman",
  clustering_method = "ward.D2",
  file_name = NULL,
  return = TRUE,
  min_cluster_size = 3
)

Arguments

network

A TF module network as returned by compute.WTCNA() (its module scores are used).

dt

Deconvolution subgroups as returned by multideconv::compute.deconvolution.analysis(); its element Deconvolution matrix (samples x features) is used. It must have the same samples as network.

batch

Optional vector with the cohort of each sample: in the row order of the deconvolution matrix, or named by sample. Required when network was built with compute.WTCNA() with batch. With two or more cohorts, correlations and scores are corrected for cohort.

pval

Numeric. P-value threshold used to select the deconvolution features significantly correlated with each TF module (adjusted p-value with padj = TRUE). Default: 0.05.

padj

Logical. If TRUE, the p-values of each TF module are corrected for multiple testing across the deconvolution features (Benjamini-Hochberg, see compute.modules.relationship()) before selecting the significant features. Default: FALSE.

corr_type

Correlation used between the TF modules and the deconvolution features (passed to compute.modules.relationship()): "spearman" (default) or "pearson". It is used to select the significant features and to cluster them.

clustering_method

Linkage method of the hierarchical clustering of the deconvolution features of each module on their correlation with it (see identify.cell.groups()). Default: "ward.D2".

file_name

Optional character. Suffix of the output file names (see return).

return

Logical. If TRUE (default), saves a PDF of the colored cell-group dendrograms (Results/Dendrogram_color_clusters_<file_name>.pdf) and the composition and the scores of the cell groups (Results/Cell.groups.composition_<file_name>.csv and Results/Cell.groups.scores_<file_name>.csv).

min_cluster_size

Integer. Minimum number of features of a cell group (minimum cluster size of the dynamic tree cut of each dendrogram). Default is 3.

Value

A named list of 3 elements:

Cell_groups

A data frame with the projected cell group scores (samples x groups). A positive score means that the sample is on the active side of the TF module of that cell group, a negative score that it is on the inactive side.

Composition

A named list where each element is a character vector of the deconvolution features in each group.

Weights

A named list of CCA projection parameters (xcoef, train_means, train_sds) for each group. With batch, only xcoef is kept: test data are z-scored on their own means and SDs, as each training cohort was.

Cell groups are named Dendrogram_<module>_group_<n>, where n is the cluster number shown in the dendrogram PDF of that module. Features that the tree cut does not assign to any cluster are not part of any cell group (a message reports how many).

Examples

data("network.tuto")
data("deconv_subgroups.tuto")
cell_groups <- construct_cell_groups(network.tuto, deconv_subgroups.tuto)
#> Warning: Length of color vector was shorter than the number of clusters - color vector was recycled
#> Warning: Length of color vector was shorter than the number of clusters - color vector was recycled
#> Warning: Length of color vector was shorter than the number of clusters - color vector was recycled
#> Warning: Length of color vector was shorter than the number of clusters - color vector was recycled
#> Warning: Length of color vector was shorter than the number of clusters - color vector was recycled
#> Warning: Length of color vector was shorter than the number of clusters - color vector was recycled
#> Warning: Length of color vector was shorter than the number of clusters - color vector was recycled
#> Warning: Length of color vector was shorter than the number of clusters - color vector was recycled
#> Dendrogram plots saved to: Results/Dendrogram_color_clusters.pdf
#> 44 of 897 features were not assigned to any cluster by the tree cut and are not part of any cell group (pink: 2, yellow: 8, red: 2, blue: 6, brown: 4, turquoise: 12, black: 4, green: 6)
cell_groups$Cell_groups[1:3, 1:3]
#>                 Dendrogram_pink_group_1 Dendrogram_pink_group_2
#> SAM7f0d9cc7f001             -0.14044970             -0.05427430
#> SAM4305ab968b90              0.05344901              0.06916341
#> SAMcf018fee2acd             -0.10579244             -0.06208404
#>                 Dendrogram_pink_group_3
#> SAM7f0d9cc7f001             -0.09753325
#> SAM4305ab968b90              0.05193819
#> SAMcf018fee2acd             -0.17637402