Tutorial

Guided use of ProMICA

Follow three visual walkthroughs: the single-cell explorer, the spatial explorer, and the LLM skill.

01

Single-cell transcriptomics

Open the explorer, colour the UMAP, plot a gene, then run contrast, correlation, or differential analysis.

02

Spatial transcriptomics

Open the explorer, map cell-type annotation on a pathology section, plot a gene, then run contrast or colocalization.

03

LLM-assisted exploration

Explore the atlas through an AI-assisted approach.

Walkthrough 01

Single-cell transcriptomics

Start from the home page, colour the atlas by annotation, search a gene, and continue into contrast, correlation, or differential analysis.

10 steps

Step 1

Open the single-cell explorer

Use Single-cell in the top navigation, or the Single-cell transcriptomics card on the home page.

Home page with two marked entry points for the single-cell explorer
Step 2

Colour the UMAP by category

On the Category tab, choose an annotation level, show or hide clusters in the filter tree, and use the map tools as needed.

Category tab with color-by, cluster filter, and map tools marked
Step 3

Plot a gene of interest

Open the Expression tab, enter a gene symbol, then continue into expression contrast when two annotated groups are to be compared.

Expression tab with gene search and expression contrast marked
Step 4

Run expression contrast

Restrict the comparison if needed, define the two conditions from annotation categories, then plot the contrast.

Expression contrast form with restriction, conditions, and plot marked
Step 5

Open expression correlation

From the Expression tab, continue into correlation analysis to pair the plotted gene with a second gene.

Expression tab with the expression correlation card marked
Step 6

Plot pairwise expression correlation

Enter the second gene, optionally restrict the cohort, choose cell- or sample-level units, then plot the correlation.

Expression correlation form with second gene, restriction, unit, and plot marked
Step 7

Open differential expression analysis

Compare two groups of cells and rank genes by differential expression, with optional pathway enrichment on the ranked list.

Differential tab with the differential analysis card marked
Step 8

Define the two groups

Optionally split cells by gene expression, restrict the cohort, assign categories to Group 1 and Group 2, then run the test.

Differential analysis form with gene split, restriction, groups, and run marked
Step 9

Run gene-set enrichment analysis

On the result page, choose a gene-set collection and run GSEA on the ranked contrast.

Differential result page with gene-set collection and Run GSEA marked
Step 10

Inspect selected pathways

Select one or more enriched sets and plot the running-score curves.

GSEA results with pathway selection and plot marked

Walkthrough 02

Spatial transcriptomics

Map cell-type annotation or gene expression on a pathology section, then run expression contrast or spatial colocalization.

7 steps

Step 1

Open the spatial explorer

Use Spatial in the top navigation, or the Spatial transcriptomics card on the home page.

Home page with two marked entry points for the spatial explorer
Step 2

Select a pathology section

Specify the spatial transcriptomic assay, the physiological or disease state, and the pathology section, in that order.

Spatial explorer with technology, type, and sample selectors marked
Step 3

Colour the section by cell-type annotation

Select the annotation layer, show or hide cell types, and use the map tools as needed.

Spatial category tab with color-by, cluster list, and tools marked
Step 4

Plot a gene of interest

Open the Expression tab, enter a gene symbol, then continue into expression contrast to compare two regions on the section.

Spatial expression tab with gene search and expression contrast marked
Step 5

Run expression contrast

Draw two regions, optionally restrict each cluster to a cell type, then plot the contrast.

Spatial expression contrast with cluster lassos, cell-type filter, and plot marked
Step 6

Open spatial colocalization

From the Expression tab, continue into colocalization to compare the plotted gene with a second gene across sections.

Spatial expression tab with the colocalization card marked
Step 7

Plot colocalization

Enter the exploratory gene, restrict by disease state if needed, choose sections and colours, then plot.

Spatial colocalization form with gene, type, sections, colours, and plot marked

Walkthrough 03

LLM-assisted exploration

Start from the home page, download the archive, and provide the complete folder to an AI assistant that can issue HTTP requests.

3 steps

Step 1

Download the skill

On the home page, use Download Skill on the ProMICA Skill card to obtain the archive.

Home page with Download Skill marked on the ProMICA Skill card
Step 2

Install in a coding assistant

Extract the archive and place the promica-skill folder in the assistant’s skills directory.

Skills directory containing the extracted promica-skill folder
Step 3

Upload to an HTTP-capable model

Extract the archive and upload all four files to a language model that can issue HTTP requests.

Chat interface with the extracted skill files attached