Tutorials
Learn spatial transcriptomics analysis through hands-on tutorials and examples.
Table of contents
- Tutorial Categories
- How to Use These Tutorials
- Getting Started
- Tutorial Data
- Common Workflows
- Tips for Success
- Getting Help
Welcome to the ChatSpatial tutorials! This section provides comprehensive guides for performing spatial transcriptomics analysis using natural language commands.
Tutorial Categories
๐ Core Analysis
Essential spatial analysis techniques that every user should know:
- Basic Spatial Analysis - Load data, quality control, clustering
- Spatial Statistics - Moranโs I, spatial autocorrelation
- Visualization Tutorial - Creating compelling spatial plots
๐ฌ Analysis Methods
In-depth guides for specific analysis techniques:
- Cell Type Annotation - Marker-based and reference-based annotation
- Spatial Enrichment - Gene set enrichment in spatial context
- Cell Communication Analysis - LIANA, CellPhoneDB workflows
๐ฏ Advanced Methods
Cutting-edge spatial analysis techniques:
- Trajectory Analysis - RNA velocity and pseudotime
- Spatial Registration - Multi-section alignment
- Batch Integration - Multi-sample integration
๐ Learning Paths
Structured learning journeys for different skill levels:
- Beginner Path - Start here if youโre new to spatial transcriptomics
- Intermediate Path - Build on basic knowledge
- Advanced Path - Master cutting-edge techniques
How to Use These Tutorials
Prerequisites
Before starting any tutorial, ensure you have:
- ChatSpatial installed and configured
- Basic understanding of single-cell RNA-seq concepts
- Access to Claude Desktop or compatible MCP client
Tutorial Format
Each tutorial follows a consistent format:
- Learning Objectives - What youโll accomplish
- Prerequisites - Required knowledge and setup
- Step-by-Step Instructions - Detailed commands and explanations
- Expected Results - What to expect from each step
- Troubleshooting - Common issues and solutions
- Next Steps - Where to go from here
Interactive Examples
All tutorials use actual commands you can run in ChatSpatial:
# Example: Load and explore data
Load the mouse brain Visium dataset and show me basic statistics
# Example: Perform analysis
Identify spatial domains using SpaGCN and create visualization plots
Getting Started
New to Spatial Transcriptomics?
Start with the Beginner Learning Path which covers:
- Basic concepts and terminology
- Data loading and exploration
- Quality control and preprocessing
- Simple spatial analysis
Have Single-Cell Experience?
Jump to Core Analysis tutorials to learn spatial-specific techniques:
Ready for Advanced Methods?
Explore Advanced Methods for cutting-edge techniques:
Tutorial Data
Demo Datasets
All tutorials use standardized demo datasets included with ChatSpatial:
- Visium Mouse Brain - Classic 10X Visium dataset
- Slide-seq Cerebellum - High-resolution spatial data
- MERFISH Hypothalamus - Single-cell resolution spatial data
- SeqFish Embryo - Developmental spatial data
Loading Demo Data
# Load any demo dataset
Load the [dataset_name] demo data
# Examples:
Load the mouse brain Visium demo data
Load the cerebellum Slide-seq demo data
Load the hypothalamus MERFISH demo data
Common Workflows
Standard Spatial Analysis Pipeline
graph LR
A[Load Data] --> B[Quality Control]
B --> C[Clustering]
C --> D[Spatial Domains]
D --> E[Cell Annotation]
E --> F[Visualization]
Advanced Analysis Pipeline
graph LR
A[Load Data] --> B[Preprocessing]
B --> C[Spatial Domains]
C --> D[Cell Communication]
D --> E[Trajectory Analysis]
E --> F[Integration]
Tips for Success
Best Practices
- Start Simple - Begin with basic analysis before moving to advanced methods
- Understand Your Data - Always explore data characteristics first
- Validate Results - Cross-check findings with biological knowledge
- Document Parameters - Keep track of analysis parameters for reproducibility
Common Pitfalls
- Skipping Quality Control - Always perform QC before analysis
- Over-interpreting Results - Consider statistical significance and biological relevance
- Ignoring Spatial Context - Remember that spatial information is key
- Using Wrong Parameters - Understand method parameters and their effects
Getting Help
Within Tutorials
- Each tutorial includes troubleshooting sections
- Code examples are fully tested and verified
- Expected outputs are clearly described
Additional Resources
- API Reference - Detailed method documentation
- Troubleshooting Guide - Common issues and solutions
- Community Discussions - Ask questions and share experiences
Reporting Issues
Found an error in a tutorial? Please:
- Check the troubleshooting section
- Search existing issues
- Create a new issue with details
Ready to start learning? Choose your path:
Begin with Core Analysis Explore Learning Paths