MSCinteract documentation

MSCinteract is an interactive explorer for mesenchymal stromal cell (MSC) expression datasets and the indications they are studied in. Every matrix is streamed from the server on demand, parsed and analysed inside your browser — nothing is uploaded, and results appear immediately.

What MSCinteract is

Quick start

The explorer runs directly in the browser: matrices are streamed from the server on demand and analysed on the fly. Three flows cover everything the site does — find a gene in the MSCs, find a gene in a disease cohort, and follow the talk between the MSCs and the immune cells.

A gene in the MSCs

1Open QuickCheck: MSCs 2Search TP53 or paste a list 3Load a panel 4Read bar · heatmap · scatter 5Click a row for exact numbers
The 20 culture conditions of UC-MSCs are ready to be asked. You can type a single symbol such as TP53, paste a whole gene list, or load a ready-made panel — the bar chart then shows the focus gene in every condition, the heatmap your whole selection at once, and the scatter tells you how strongly two conditions resemble each other. Clicking the row of a gene gives you its exact numbers in every sample.

A gene in a disease cohort

1Open QuickCheck: Diseases 2Pick a cohort — COVID-19 lung · GvHD · IBD · IPF · KOA 3The matrix downloads in the background 4Search or paste your genes 5Compare samples, read the numbers
Pick the cohort you care about — COVID-19 lung, GvHD, IBD, IPF or KOA — and the explorer becomes that cohort's explorer. You can search and paste genes exactly as in the MSCs tab, and the same charts and tables answer with the samples of the patients instead of the culture conditions.

MSC–immune cell talk

1Open Interaction: Immune Cells 2Pick the direction — MSCs → Immune or Immune → MSCs 3Pick a condition, or two for Comparison 4Read the dot plot — the signature genes 5Read the bubble plot — who can answer
Pick who talks to whom, and which culture condition to build the comparison on — or pick two and see what they share. The dot plot shows you which genes carry the signature of the condition, and the bubble plot shows you which of the 15 immune cell types are likely to answer the MSCs. Read the dot plot first, then the bubble plot.
Each matrix is fetched the first time you open a tab and then kept in memory, so searching and charting stay instantaneous afterwards. New datasets are added to the catalogue as they are released.

QuickCheck interface

QuickCheck is the expression explorer of the site. One matrix of genes × samples is open at a time — the 20-media culture of UC-MSCs in the MSCs tab, one of the five reference cohorts in the Diseases tab — and everything you do is a question to that matrix: which samples express this gene, how do two samples compare, which genes switch on together.

Open a matrix

The MSCs tab opens the 20 culture conditions of UC-MSCs. In the Diseases tab, the picker in the header card switches to COVID-19 lung, GvHD, IBD, IPF or KOA, and the matrix downloads in the background while you keep working. The chips in the header card tell you at any moment how large the open matrix is — how many genes, how many samples — and Reload fetches a fresh copy whenever you want one. Switching cohorts resets the gene selection, because every cohort has a gene index of its own.

Bring your genes in

Type a symbol such as TP53 into the search box of the sidebar: the dropdown suggests matches as you type and Enter takes the first hit. To bring a whole list, paste symbols separated by commas, spaces or line breaks and press Import list — symbols the matrix does not know are reported back to you instead of vanishing. Every selected gene appears as a removable chip, and the counter above tells you how many the selection carries. The ready-made panels — MSC biomarkers, Immunomodulatory and Receptors — load in one click and mix freely with your own list.

Reading the charts

Click the row of a gene in any chart or table to make it the focus: the statistics above the plots then show its mean, median, maximum, minimum and the number of samples that express it.

Bar chart — one gene across all samples

Each bar is one sample of the dataset and its height is the expression value of the focus gene. Use Bar order to switch between the natural sample order (which usually follows the experimental grouping) and a ranking by value.

Heatmap — genes × samples

The heatmap shows the selected genes (up to 60 at a time) across all samples. Rows are genes, columns are samples, and the colour scale is relative to the values of the current selection, which makes patterns — for instance a group of samples that switches a pathway on or off — easy to spot.

Scatter — correlation between two samples

The scatter plot compares two samples gene by gene and reports the Pearson correlation. By default all genes of the matrix are used; switch the scope to selected genes to correlate only the genes in your current selection. Because the correlation needs the complete matrix, the missing shards are fetched on demand when you open this chart.

Reading the tables

Per-sample expression lists every sample of the dataset with the value of the focused gene. Use it to read exact numbers for the samples that matter, for example a treated versus untreated pair.

Expression matrix shows the selection as a genes × samples table. Click a column header to sort by that gene, click a gene row to make it the focus gene, and use the pager to move through long selections.

Interaction interface

This tab asks how MSCs and immune cells talk to each other. The MSC side is the 20-media dataset of QuickCheck: MSCs; the immune side is the matrix of 15 immune cell types from the DICE database; and the pairs of ligands and receptors that connect the two sides come from OmniPath. The tab does not compute anything on a server — it reads the marker panels of the selected condition, streams the matching expression values and compares them in your browser.

Pick the direction and the condition

MSCs → Immune cells follows the factors the MSCs secrete to the receptors they act on in the immune cells; Immune cells → MSCs starts from the receptors of the MSCs and follows the immune ligands that reach them. The panel titles and the hint under them follow your choice. In Query mode you pick the one culture condition the interaction is built on; in Comparison mode you pick a second one, and the tab tells you gene by gene what the two conditions share and what belongs to only one of them.

Read the two plots

The dot plot draws every marker gene of the selected condition across all 20 media conditions (log2(TPM + 1)), with the selected condition highlighted; the chips in the legend mark the genes that top the condition and the ones unique to it — in Comparison mode, the ones the two panels share and the ones only one of them carries. Hover the name of a gene to see the partners it works with on the other side. The bubble plot puts the same genes against the 15 immune cell types: the bigger and darker the bubble, the stronger that cell type expresses the partners — that is, the more likely it hears the MSCs. In Comparison mode the rows are grouped into common, only in the first and only in the second condition, with one colour per group. Read the dot plot first — it tells which genes carry the signature — then the bubble plot, which tells who can answer.

Units and values

Data sources

Every matrix of the site is listed below with its content, its size, where the data lives and every publication to cite when you use it. The MSC media dataset runs in the QuickCheck: MSCs tab and the five cohorts in the QuickCheck: Diseases tab; the last two sources serve the Interaction tab.

UC-MSCs Cultured in Different Media

Sample names

Sample Full name Cat# Lot#
E6 DMEM/F-12 with insulin, selenium, L-ascorbic acid and transferrin — —
E63F E6 with EGF, FGF2 and PDGF — —
MDPF.LRa MesenDefinite ProliFast LRα — —
MDPF.LRa.hPL MesenDefinite ProliFast LRα with human platelet lysate — —
MDPF.LRav2 MesenDefinite ProliFast LRα, version 2 — —
Gibco.BRA-FBS Fetal bovine serum, Brazil origin (Gibco) A5256701 B2672837RP
Gibco.AUS-FBS Fetal bovine serum, Australia origin (Gibco) 10099-141 2458641RP
Gibco.USA-FBS Fetal bovine serum, United States origin (Gibco) 26140-099 2287059RP
Gibco.NBCS Newborn calf serum, New Zealand origin (Gibco) 16010-167 2685432
Gibco.BS Bovine serum, New Zealand origin (Gibco) 16170-086 2742078
Gibco.DBS Donor bovine serum, New Zealand origin (Gibco) 16030-074 2552999
QKP.FBS Fetal bovine serum (QKP) KY01002 20220801
QKP.NBCS Newborn calf serum (QKP) KY01009 20230203
RP.FBS Fetal bovine serum (Wizdom) — 20230629
RP.NBCS Newborn calf serum (Wizdom) — 20230605
RP.BS Bovine serum (Wizdom) — 20230630
absin.FBS Fetal bovine serum (absin) abs981 01022B01
absin.NBCS Newborn calf serum (absin) abs978 21J612
absin.BS Bovine serum (absin) abs991 191N23
hPL Human platelet lysate (Compass Biomedical) PLSGB —

COVID-19 Lung Lobes — GEO GSE150316

Sample names

GvHD Lymphocytes — GEO GSE182610

Sample names

IBD Colon and Ileum Explants — IBDome

Sample names

IPF and CHP Lung Tissue Biopsy — GEO GSE150910

Sample names

KOA Knee Synovium — GEO GSE283079

Sample names

Immune cells of the Interaction tab — DICE

Ligand–receptor pairs of the Interaction tab — OmniPath

We thank the authors and teams behind the databases above — the GEO depositors, IBDome, DICE and OmniPath — for making their data openly available. Their contribution to open science is what makes an explorer like this one possible.

Questions and corrections

Questions, corrections or requests for additional cohorts can be sent to data@macorigen.com.

FAQ

Which browsers are supported?

Any current version of Chrome, Edge, Firefox or Safari 16+. The explorer needs ES modules and fetch; no plugin or server-side computation is involved.

Why does the first opening of a tab take a moment?

The gene index has to be downloaded and parsed once. After that the matrix is cached in memory and further searches and charts are immediate.

A gene I searched for is not found — what should I try?

Check the spelling and try the symbol without the suffix (for example TP53 instead of TP53-AS1). When you import a list, the report next to the import button lists the symbols that could not be resolved.