Pathway & signature enrichment
Assess pathway and gene-signature enrichment in sample or single-cell expression profiles, or in ranked gene lists, using ssGSEA or preranked GSEA.
Assess pathway and gene-signature enrichment in sample or single-cell expression profiles, or in ranked gene lists, using ssGSEA or preranked GSEA.
ssGSEA — single-sample Gene Set Enrichment Analysis
Description
Analysis summary
Computes a single enrichment score per scoring unit (a sample, or an individual cell on single-cell data) for each gene signature, summarising how highly the signature's genes rank in that unit's expression profile. Scores are comparable across units; gene signatures can be supplied manually or drawn from a curated pathway database to score named pathways rather than only hand-picked gene lists.
Computation
Runs single-sample GSEA via the gseapy library (https://gseapy.readthedocs.io/en/latest/): for each scoring unit (a bulk sample, a pseudo-bulk group, or an individual cell), the genes are ranked by expression and a weighted Kolmogorov–Smirnov-like enrichment score is integrated for each gene set. Output: one row per (scoring unit, gene set [, stratum]) carrying the enrichment score, the signature's size and how many of its members were actually present in the expression matrix — when fewer were present, the score was computed on only that subset. Descriptive stats summarise the scores per signature (and per stratum when the data is stratified); pairwise statistical tests compare the scores between signatures, within each stratum when present.
When to use
Use for pathway/signature-activity questions per unit: is a cytotoxicity or interferon program higher in responders than non-responders, which immune signatures distinguish patient groups, or — scoring per cell — what a gene set's activity is within one cell type. For a supplied ranking (e.g. a differential-expression result) rather than raw expression, use the gsea mode instead.
Caveats
Per-cell scoring materialises a dense genes × units matrix and is refused beyond a size cap — score per cell type or pseudo-bulk instead of the whole tumour cell by cell. Signatures with no member in the expression matrix are skipped (reported); a signature covering the entire gene matrix has no ranking background and is also skipped. A gene missing for a unit counts as zero expression.
gseapy — the GSEA / pathway-enrichment Python toolkit this analysis runs through. Website: https://gseapy.com/ — documentation: https://gseapy.readthedocs.io/en/latest/ — paper: https://pmc.ncbi.nlm.nih.gov/articles/PMC9805564/.
Example questions
Input columns
Visualizations
violinHow to read: Each violin is one signature's distribution of enrichment scores across scoring units (side-by-side by the strata variable when the data is stratified). Significance brackets with stars mark groups with at least one significant pairwise comparison after multiple-testing correction (★ p<0.05, ★★ p<0.01, ★★★ p<0.001, ★★★★ p<0.0001). Higher scores mean the signature's genes rank more highly in that unit's expression profile.boxplotHow to read: Each box is one signature's distribution of enrichment scores across scoring units (the centre line is the median, the box the middle half); side-by-side boxes are keyed by the strata variable when the data is stratified. Significance brackets with stars mark groups with at least one significant pairwise comparison after multiple-testing correction (★ p<0.05, ★★ p<0.01, ★★★ p<0.001, ★★★★ p<0.0001). Higher scores mean the signature's genes rank more highly in that unit's expression profile.heatmapHow to read: Rows are scoring units, columns are signatures, and cell colour is the enrichment score (centred on 0 — see the colour bar); with sorting enabled the highest scores gather top-left. Read it as which unit carries which signature's activity; on single-cell data each row is one filtered cell population.
Example analysis 1
Name — ssGSEA Signature Enrichment in TCGA Bladder Patients by Gender
Analysis parameters
Visualization — violin

Output table
GSEA — classical preranked Gene Set Enrichment Analysis
Description
Analysis summary
Runs classical preranked GSEA on a single ranked gene list (genes ordered by any signed metric you provide — fold change, a statistic, a correlation) against gene-set signatures, returning one normalised enrichment score (NES) per signature with its significance. Positive NES = enriched at the top of the ranking, negative = at the bottom. Gene signatures can be supplied manually or drawn from a curated pathway database.
Computation
One ranked gene list — genes with a signed ranking metric the caller supplies — is scored against every gene set via the gseapy library's prerank implementation (https://gseapy.readthedocs.io/en/latest/); the analysis does not compute the ranking metric itself and is not tied to differential expression. Output: one row per gene set with the normalised enrichment score (or the raw one), its nominal permutation p-value and Benjamini–Hochberg FDR, the signature's size and how many of its members were present in the ranked list, and the leading edge — the members that drive the enrichment, i.e. those ranked up to the peak of the running enrichment score — with its size and two concentration diagnostics: how much of the matched membership falls in the leading edge, and where the enrichment-score peak sits along the ranking (a small percentage = the peak is near the top).
When to use
Use when the input is already a ranking — a tumour-vs-normal differential-expression result, a correlation profile — and the question is which pathways/signatures are enriched at its top or bottom. For scoring raw expression per sample or per cell, use the ssgsea mode instead.
Caveats
Provide a single ranking: several rankings in one call are rejected (per-comparison multi-ranking is not yet supported). Genes duplicated in the list are averaged, and genes absent from the list simply do not count toward a signature's matched members.
gseapy — the GSEA / pathway-enrichment Python toolkit this analysis runs through. Website: https://gseapy.com/ — documentation: https://gseapy.readthedocs.io/en/latest/ — paper: https://pmc.ncbi.nlm.nih.gov/articles/PMC9805564/.
Example questions
Input columns
Visualizations
forestHow to read: One row per gene set: the point is the enrichment score (NES by default) and the reference line is 0 — points right of it are enriched at the top of the ranking, points left of it at the bottom. Hover gives the gene-set size, the leading-edge gene count and the p-values; significance lives in the accompanying statistical table.
Example analysis 1
Name — Preranked GSEA of Signatures in TCGA Bladder Patients
Analysis parameters
Visualization — forest

Output table
Last updated
Was this helpful?