bio-machine-learning-atlas-mapping

Maps query single-cell data to reference atlases using scArches transfer learning.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/stellaromics/fast-bioinfo --skill bio-machine-learning-atlas-mapping
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bio-machine-learning-atlas-mapping
Source: https://github.com/stellaromics/fast-bioinfo/tree/main/.claude/agents/spatial-analysis/skills/bio-machine-learning-atlas-mapping
Command: npx skills add https://github.com/stellaromics/fast-bioinfo --skill bio-machine-learning-atlas-mapping

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Map query single-cell data to reference atlases using transfer learning with scArches.

Core Features & Use Cases

  • Transfer latent representations between query and reference scVI models
  • Label transfer via scANVI with confidence scores
  • Visualization of integration quality between datasets

Quick Start

Provide a pre-trained reference model and a query dataset, then map your data to the reference atlas using scArches surgery.

Frequently Asked Questions about bio-machine-learning-atlas-mapping

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I map query scRNA-seq data to a reference atlas?

You can map query scRNA-seq data to a reference atlas by using transfer learning with scArches to transfer latent representations and cell type labels from pre-trained scVI references.

What is the best way to annotate new single-cell datasets using a pre-trained reference?

The best way to annotate new single-cell datasets is by transferring latent representations and cell type labels via scANVI, which provides confidence scores for each transferred label.

Do I need to match genes between query and reference data for scArches surgery?

Yes, you must match genes between your query and reference data before performing scArches surgery to ensure accurate latent representation transfer during the mapping process.

Can I use scvi-tools and scanpy to visualize integration quality between datasets?

Yes, you can use scvi-tools and scanpy to visualize integration quality between datasets after mapping your query data to the reference atlas using transfer learning.

Why does scArches use surgical fine-tuning with controlled weight decay?

ScArches uses surgical fine-tuning with controlled weight decay to preserve the reference structure while adapting the model to the new query scRNA-seq dataset.

What are the limitations of transferring cell type labels to query scRNA-seq data?

Label transfer limitations depend on confidence scores generated by scANVI, as preserving the reference structure during surgical fine-tuning may restrict mapping novel cell types absent from the reference.