User guide

User guide#

Harreman provides a series of formulas to perform spatial correlation and characterize the metabolic state of tissue using spatial transcriptomics. At the coarsest level, Harreman partitions the tissue into modules of different metabolic functions based on enzyme co-expression. At the following stage, Harreman formulates hypotheses about which metabolites are exchanged across the tissue or within each spatial zone. This is achieved by computing an aggregate spatial correlation that takes into account all gene pairs associated with the import or export of a given metabolite. Spatially co-localized metabolites can also be grouped together. Moving to a finer resolution, Harreman can also infer which specific cell subsets participate in the exchange of distinct metabolic activities inside each zone. In this case, the aggregate spatial correlation is calculated by considering cell-type–restricted expression patterns of import–export gene pairs. Beyond these central functionalities, which are the main focus of this work, Harreman also provides a range of aggregate spatial correlation statistics designed to capture diverse interaction scenarios.

In all the equations described in the sections below, for proteins composed of multiple subunits, we compute either an algebraic or a geometric mean of the expression values of the corresponding genes as done in SpatialDM (Li et al., Nature communications, 2023):

\[ X_{ai} = \frac{\sum_{l \in S_l}^{} X_{a_li}}{|S_l|}; X_{bj} = \frac{\sum_{r \in S_r}^{} X_{b_rj}}{|S_r|} \]
\[ X_{ai} = \left( \prod_{l \in S_l}^{} X_{a_li} \right)^{1/L}; X_{bj} = \left( \prod_{r \in S_r}^{} X_{b_rj} \right)^{1/R} \]

where l is a subunit for the protein encoded by gene a that belongs to the set of subunits \(S_L\), and r is a subunit for the protein encoded by gene b that belongs to the set of subunits \(S_R\). \(|S_l|\) and \(|S_r|\) denote the number of subunits for proteins encoded by genes a and b, respectively.

Test statistic 1: Is gene a spatially autocorrelated?
Test statistic 1: Is gene a spatially autocorrelated?
Test statistic 2: Are genes a and b spatially co-localized (or interacting with each other)?
Test statistic 2: Are genes a and b spatially co-localized (or interacting with each other)?
Test statistic 3: Is metabolite m spatially autocorrelated?
Test statistic 3: Is metabolite m spatially autocorrelated?
Test statistic 4: Are metabolites m1 and m2 spatially co-localized?
Test statistic 4: Are metabolites m_1 and m_2 spatially co-localized?
Test statistic 5: Do genes a and b interact when expressed by cell types t and u, respectively?
Test statistic 5: Do genes a and b interact when expressed by cell types t and u, respectively?
Test statistic 6: Is metabolite m exchanged by cell types t and u?
Test statistic 6: Is metabolite m exchanged by cell types t and u?
Test statistic 7: Do genes a and b interact when a is expressed by cell i and b by spatially nearby cells?
Test statistic 7: Do genes a and b interact when a is expressed by cell i and b by spatially nearby cells?
Test statistic 8: Is metabolite m exchanged by cell i and other spatially proximal cells?
Test statistic 8: Is metabolite m exchanged by cell i and other spatially proximal cells?
Test statistic 9: Do genes a and b interact when a is expressed by cell i (that belongs to cell type t) and b by spatially nearby cells (that belong to cell type u)?
Test statistic 9: Do genes a and b interact when a is expressed by cell i (that belongs to cell type t) and b by spatially nearby cells (that belong to cell type u)?
Test statistic 10: Is metabolite m exchanged by cell i (that belongs to cell type t) and other spatially proximal cells (that belong to cell type u)?
Test statistic 10: Is metabolite m exchanged by cell i (that belongs to cell type t) and other spatially proximal cells (that belong to cell type u)?