Our pipeline, MICSQTL
, integrates RNA and protein
expressions to detect potential cell marker proteins and estimate cell
abundance in mixed proteomes without a reference signature matrix.
MICSQTL
enables cell-type-specific quantitative trait loci
(QTL) mapping for proteins or transcripts using bulk expression data and
estimated cellular composition per molecule type, eliminating the
necessity for single-cell sequencing. We use matched
transcriptome-proteome from human brain frontal cortex tissue samples to
demonstrate the input and output of our tool.
Load packages for making plots.
To conduct the analysis, the initiation involves the use of a
SummarizedExperiment
object that contains bulk protein
expression data, which can be rescaled using either log or MinMax
transformations, in the assays slot. The row metadata (rowData slot)
should contain information about the protein features. Additionally,
incorporation of bulk gene expression data, which can also be rescaled
using either log or MinMax transformations and needs to be consistent
with the bulk protein expression data, as well as a reference file
(depending on the chosen method), as integral elements within the
metadata slot, are imperative. For more accurate cell-type fraction
estimations, it’s recommended to include only marker genes.
For easier illustration purposes, we provide an example
SummarizedExperiment
object within this package, which
contains the following elements:
protein_data (assay): An example proteomics data (on log scale) with 2,242 rows (protein) and 127 columns (sample).
anno_protein (rowData): A data frame with 2,242 rows and 4
columns (Chr, Start, End, Symbol) as annotations of each protein from
protein_data
.
ref_protein (in metadata): A signature matrix with 2,242 rows (protein) and 4 columns (cell types), which serves as a reference of known cellular signatures (on log scale).
gene_data (in metadata): A data frame with 2,867 rows (genes) and 127 columns (sample) (on log scale).
ref_gene (in metadata): A signature matrix with 4,872 rows (genes) and 5 columns (cell types), which serves as a reference of known cellular signatures (on log scale).
prop_gene (in metadata): A pre-defined deconvoluted transcriptome proportion matrix.
SNP_data (in metadata): A sparse matrix with 2,000 rows (SNP),
which stores the information of genetic variants at each location from
one chromosome and 127 columns (sample, should match the sample in
protein_data
). Each matrix entry corresponds to the
genotype group indicator (0, 1 or 2) for a sample at a genetic
location.
anno_SNP (in metadata): A data frame with 2,000 rows and 3
columns (CHROM, POS, ID), which stores Annotations of each SNP from
SNP_data
.
meta (in metadata):A data frame with 127 rows (sample) and 2 columns (disease status and gender) as metadata.
cell_counts (in metadata): A matrix containing cell counts across multiple subjects, where subjects are represented as rows and cell types as columns. Each entry (i, j) in the matrix indicates the count of cells belonging to the ith subject and jth cell type.
This example data can be loaded by calling:
Below is an example code for building the
SummarizedExperiment
object from raw data frames or
matrices.
se <- SummarizedExperiment(
assays = list(protein = your_protein_data),
rowData = your_anno_protein
)
metadata(se) <- list(
gene_data = your_gene_data
)
Additional metadata can be incorporated using a command such as
metadata(se)$new_data <- new_data
if further information
is necessary for visualization or csQTL (cell-type specific quantitative
trait loci) analysis. For detailed instructions, please refer to the
following sections and the function documentation.
This step estimates the proportions of cell types for each molecule type.
In this current version, only nnls
is supported as a
single-source deconvolution method. Users can utilize other methods such
as CIBERSORT,
MuSiC,
etc., to obtain the proportion estimates. These estimates will be useful
as initial values in the subsequent deconvolution based on cross-source.
It is important to note that the samples used in the cell-type
proportion estimates must match the samples in the bulk protein
expression data.
The reference matrix for pure cell proteomics may be incomplete due to limitations inherent in single-cell proteomics technologies. To address this issue, we propose a novel cross-source cell-type fraction deconvolution method “Joint Non-negative Matrix Factorization” (JNMF) that capitalizes on matched bulk transcriptome-proteome data. In the following example, we illustrate the process of estimating protein proportions by integrating information from deconvoluted transcriptomes.
There are multiple options available for initializing cellular
fractions and purified proteomics on a sample-wise basis, each with
different input requirements. The following example illustrates using
the CIBERSORT method to estimate initial proportions
(pinit
), coupled with an external reference matrix
(ref_pnl
) containing gene expression profiles or molecular
signatures of different cell types. These references are typically
obtained from small-scale single-cell or flow cytometry experiments.
Please note that ref_pnl
should have the same rescaling
transformation as the bulk transcriptomes/proteomics and have be
non-negative.
It is recommended to use the ajive_decomp
function
(further discussed in the following section) with the
refactor_loading = TRUE
to enhance joint deconvolution.
This setting enables cross-source feature selection aimed at identifying
potential protein cell markers.
If the estimated cell-type proportions contain any invalid or non-finite values, consider adjusting the step size.
se <- ajive_decomp(se, use_marker = FALSE, refactor_loading = TRUE)
se <- deconv(se, source = "cross", method = "JNMF",
Step = c(10^(-9), 10^(-7)),
use_refactor = 1000,
pinit = se@metadata$prop_gene,
ref_pnl = se@metadata$ref_gene)
AJIVE (Angle based Joint and Individual Variation Explained) is useful when there are multiple data matrices measured on the same set of samples. It decomposes each data matrix as three parts: (1) Joint variation across data types (2) Individual structured variation for each data type and (3) Residual noise.
It is similar as principal component analysis (PCA), but principal component analysis only takes a single data set and decomposes it into modes of variation that maximize variation. AJIVE finds joint modes of variation from multiple data sources.
Common normalized scores are one of the desirable output to explore the joint behavior that is shared by different data sources. Below we show the visualization of common normalized scores. It is clear that the disease status of these samples are well separated by the first common normalized scores.
se <- ajive_decomp(se, plot = TRUE,
group_var = "disease",
scatter = TRUE, scatter_x = "cns_1", scatter_y = "cns_2")
metadata(se)$cns_plot
pca_res <- prcomp(t(assay(se)), rank. = 3, scale. = FALSE)
pca_res_protein <- data.frame(pca_res[["x"]])
pca_res_protein <- cbind(pca_res_protein, metadata(se)$meta$disease)
colnames(pca_res_protein)[4] <- "disease"
ggpairs(pca_res_protein,
columns = seq_len(3), aes(color = disease, alpha = 0.5),
upper = list(continuous = "points")
) + theme_classic()
pca_res <- prcomp(t(metadata(se)$gene_data), rank. = 3, scale. = FALSE)
pca_res_gene <- data.frame(pca_res[["x"]])
pca_res_gene <- cbind(pca_res_gene, metadata(se)$meta$disease)
colnames(pca_res_gene)[4] <- "disease"
ggpairs(pca_res_gene,
columns = seq_len(3), aes(color = disease, alpha = 0.5),
upper = list(continuous = "points")
) + theme_classic()
The feature filtering can be applied at both proteins/genes and SNPs.
This step is optional but highly recommended to filter out some features
that are not very informative or do not make much sense biologically.
Note that this function is required to run even no filtering is expected
to be done (just set filter_method = "null"
) to obtain a
consistent object format for downstream analysis.
To apply feature filtering, annotation files for protein/gene and
SNPs are required. The annotation file for proteins/genes should be
stored in rowData()
, where each row corresponds to a
protein/gene with it’s symbol as row names. The first column should be a
character vector indicating which chromosome each protein or gene is on.
In addition, it should contain at least a “Start” column with numeric
values indicating the start position on that chromosome, a “End” column
with numeric values indicating the end position on that chromosome and a
“Symbol” column as a unique name for each protein or gene.
head(rowData(se))
#> DataFrame with 6 rows and 4 columns
#> Chr Start End Symbol
#> <character> <integer> <integer> <character>
#> AAGAB 15 67202823 67254631 AAGAB
#> AARS2 6 44300549 44313323 AARS2
#> AASS 7 122076491 122133726 AASS
#> ABAT 16 8735739 8781427 ABAT
#> ABCA1 9 104784317 104903679 ABCA1
#> ABCA2 9 137007931 137028140 ABCA2
The information from genetic variants should be stored in a P (the
number of SNP) by N (the number of samples, should match the sample in
counts
slot) matrix contained as an element
(SNP_data
) in metadata
slot. Each matrix entry
corresponds to the genotype group indicator (0 for 0/0, 1 for 0/1 and 2
for 1/1) for a sample at a genetic location. The annotations of these
SNP should be stored as an element (anno_SNP
) in
metadata
slot. It should include at least the following
columns: (1) “CHROM” (which chromosome the SNP is on); (2) “POS”
(position of that SNP) and (3) “ID” (a unique identifier for each SNP,
usually a combination of chromosome and its position).
The example SNP data provided here were restricted to chromosome 9 only. In practice, the SNPs may from multiple or even all chromosomes.
head(metadata(se)$anno_SNP)
#> CHROM POS ID
#> 332373 9 137179658 9:137179658
#> 237392 9 104596634 9:104596634
#> 106390 9 28487163 9:28487163
#> 304108 9 126307371 9:126307371
#> 295846 9 122787821 9:122787821
#> 126055 9 33975396 9:33975396
For filtering at protein or gene level, only those symbols contained
in target_SNP
argument will be kept and if not provided,
all SNPs will be used for further filtering.
For filtering at SNP level, there are three options: (1) filter out
the SNPs that have minor allele frequency below the threshold defined by
filter_allele
argument
(filter_method = "allele"
); (2) filter out the SNPs that
the fraction of samples in the smallest genotype group below the
threshold defined by filter_geno
argument
(filter_method = "allele"
) and (3) restrict to
cis-regulatory variants (filter_method = "distance"
): the
SNPs up to 1 Mb proximal to the start of the gene. Both filtering
methods can be applied simultaneously by setting
filter_method = c("allele", "distance")
.
To simplify the analysis, we only test 3 targeted proteins from chromosome 9 as an example.
se <- feature_filter(se,
target_protein = target_protein,
filter_method = c("allele", "distance"),
filter_allele = 0.15,
filter_geno = 0.05,
ref_position = "TSS"
)
The results after filtering will be stored as an element
(choose_SNP_list
) in metadata
slot. It is a
list with the length of the number of proteins for downstream analysis.
Each element stores the index of SNPs to be tested for corresponding
protein. The proteins with no SNPs correspond to it will be removed from
the returned list.
In this example, the number of SNPs corresponding to each protein after filtering ranges from 7 to 26.
In this step, the TOAST
method is implemented for
cell-type-specific differential expression analysis based on samples’
genotype.
The result will be stored as an element (TOAST_output
)
in metadata
slot. It is a list with the same length as
tested proteins or genes where each element consists of a table
including protein or gene symbol, SNP ID and p-values from each cell
type. A significant p-value indicates that the protein or gene
expression is different among the sample from different genotype
groups.
We can check the results from csQTL analysis for one of target proteins:
method | citation |
---|---|
TCA | Rahmani, Elior, et al. “Cell-type-specific resolution epigenetics without the need for cell sorting or single-cell biology.” Nature communications 10.1 (2019): 3417. |
AJIVE | Feng, Qing, et al. “Angle-based joint and individual variation explained.” Journal of multivariate analysis 166 (2018): 241-265. |
TOAST | Li, Ziyi, and Hao Wu. “TOAST: improving reference-free cell composition estimation by cross-cell type differential analysis.” Genome biology 20.1 (2019): 1-17. |
#> R version 4.4.2 (2024-10-31)
#> Platform: x86_64-pc-linux-gnu
#> Running under: Ubuntu 24.04.1 LTS
#>
#> Matrix products: default
#> BLAS: /usr/lib/x86_64-linux-gnu/openblas-pthread/libblas.so.3
#> LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/libopenblasp-r0.3.26.so; LAPACK version 3.12.0
#>
#> locale:
#> [1] LC_CTYPE=en_US.UTF-8 LC_NUMERIC=C
#> [3] LC_TIME=en_US.UTF-8 LC_COLLATE=C
#> [5] LC_MONETARY=en_US.UTF-8 LC_MESSAGES=en_US.UTF-8
#> [7] LC_PAPER=en_US.UTF-8 LC_NAME=C
#> [9] LC_ADDRESS=C LC_TELEPHONE=C
#> [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C
#>
#> time zone: Etc/UTC
#> tzcode source: system (glibc)
#>
#> attached base packages:
#> [1] stats4 stats graphics grDevices utils datasets methods
#> [8] base
#>
#> other attached packages:
#> [1] MICSQTL_1.5.0 SummarizedExperiment_1.37.0
#> [3] Biobase_2.67.0 GenomicRanges_1.59.1
#> [5] GenomeInfoDb_1.43.2 IRanges_2.41.2
#> [7] S4Vectors_0.45.2 BiocGenerics_0.53.3
#> [9] generics_0.1.3 MatrixGenerics_1.19.0
#> [11] matrixStats_1.4.1 BiocStyle_2.35.0
#>
#> loaded via a namespace (and not attached):
#> [1] pbapply_1.7-2 formatR_1.14 rlang_1.1.4
#> [4] magrittr_2.0.3 ggridges_0.5.6 e1071_1.7-16
#> [7] compiler_4.4.2 gdata_3.0.1 vctrs_0.6.5
#> [10] quadprog_1.5-8 stringr_1.5.1 pkgconfig_2.0.3
#> [13] crayon_1.5.3 fastmap_1.2.0 backports_1.5.0
#> [16] XVector_0.47.0 rmarkdown_2.29 pracma_2.4.4
#> [19] UCSC.utils_1.3.0 nloptr_2.1.1 purrr_1.0.2
#> [22] xfun_0.49 zlibbioc_1.52.0 cachem_1.1.0
#> [25] jsonlite_1.8.9 EpiDISH_2.23.1 DelayedArray_0.33.3
#> [28] BiocParallel_1.41.0 gmodels_2.19.1 broom_1.0.7
#> [31] parallel_4.4.2 R6_2.5.1 bslib_0.8.0
#> [34] stringi_1.8.4 RColorBrewer_1.1-3 limma_3.63.2
#> [37] GGally_2.2.1 car_3.1-3 jquerylib_0.1.4
#> [40] Rcpp_1.0.13-1 iterators_1.0.14 knitr_1.49
#> [43] Matrix_1.7-1 nnls_1.6 splines_4.4.2
#> [46] tidyselect_1.2.1 abind_1.4-8 yaml_2.3.10
#> [49] doParallel_1.0.17 codetools_0.2-20 lattice_0.22-6
#> [52] tibble_3.2.1 plyr_1.8.9 evaluate_1.0.1
#> [55] lambda.r_1.2.4 futile.logger_1.4.3 ggstats_0.7.0
#> [58] proxy_0.4-27 ggpubr_0.6.0 pillar_1.10.0
#> [61] BiocManager_1.30.25 carData_3.0-5 foreach_1.5.2
#> [64] ggplot2_3.5.1 munsell_0.5.1 TOAST_1.21.0
#> [67] scales_1.3.0 gtools_3.9.5 class_7.3-22
#> [70] glue_1.8.0 maketools_1.3.1 tools_4.4.2
#> [73] sys_3.4.3 data.table_1.16.4 ggsignif_0.6.4
#> [76] buildtools_1.0.0 grid_4.4.2 dirmult_0.1.3-5
#> [79] tidyr_1.3.1 matrixcalc_1.0-6 colorspace_2.1-1
#> [82] GenomeInfoDbData_1.2.13 Formula_1.2-5 rsvd_1.0.5
#> [85] cli_3.6.3 futile.options_1.0.1 S4Arrays_1.7.1
#> [88] dplyr_1.1.4 corpcor_1.6.10 gtable_0.3.6
#> [91] rstatix_0.7.2 sass_0.4.9 digest_0.6.37
#> [94] SparseArray_1.7.2 htmltools_0.5.8.1 lifecycle_1.0.4
#> [97] httr_1.4.7 TCA_1.2.1 locfdr_1.1-8
#> [100] statmod_1.5.0 MASS_7.3-61