Scanpy实战：从10x Genomics原始数据到发表级图表，一篇就够了

Scanpy实战：从10x Genomics原始数据到发表级图表全流程解析

单细胞测序技术正在重塑我们对生命系统的理解方式。想象一下，你手中握着来自10x Genomics平台的原始数据，这些数据可能蕴含着疾病机制的关键线索或发育过程的未知规律。如何将这些看似杂乱无章的基因表达矩阵转化为具有生物学意义的发现，并最终呈现为期刊编辑认可的科研图表？这正是Scanpy赋予我们的能力——一个基于Python的生态系统，将单细胞分析的每个环节无缝衔接。

1. 环境配置与数据加载

工欲善其事，必先利其器。在开始分析前，我们需要搭建稳定的计算环境。推荐使用conda创建独立环境以避免依赖冲突：

conda create -n sc_analysis python=3.8 conda activate sc_analysis pip install scanpy leidenalg matplotlib==3.5.1 seaborn==0.11.2

对于刚从实验室获得的数据，Scanpy支持多种输入格式。以10x Genomics输出的标准目录结构为例：

import scanpy as sc adata = sc.read_10x_mtx( 'path/to/filtered_feature_bc_matrix/', # 包含matrix.mtx.gz的目录 var_names='gene_symbols', # 使用基因符号而非ID cache=True # 加速后续读取 )

关键参数解析：

• var_names: 建议优先选择gene_symbols便于后续注释
• cache: 对大型数据集(>50,000细胞)建议设为False避免内存溢出

初次加载数据后，建议立即检查基本指标：

2. 数据质控与预处理策略

质控环节直接决定后续分析的可靠性。我们需要从三个维度评估数据质量：

1. 细胞层面过滤：
   • 去除基因检出数过少的细胞（可能为空液滴）
   • 排除基因数异常的细胞（可能为双细胞或多细胞）

sc.pp.filter_cells(adata, min_genes=200) # 每个细胞至少检出200基因 sc.pp.filter_genes(adata, min_cells=3) # 每个基因至少在3个细胞中表达

2. 线粒体基因监控： 线粒体基因占比是评估细胞活性的金标准。计算时需要根据物种调整前缀：

# 人类样本使用MT-，小鼠样本使用mt- adata.var['mt'] = adata.var_names.str.startswith('MT-') sc.pp.calculate_qc_metrics(adata, qc_vars=['mt'], percent_top=None, inplace=True)

3. 可视化质控指标： 通过组合图表全面评估数据质量：

# 三联图展示关键指标 sc.pl.violin(adata, ['n_genes_by_counts', 'total_counts', 'pct_counts_mt'], jitter=0.4, multi_panel=True)

常见质控陷阱及解决方案：

• 双细胞效应：使用scrublet算法检测
• 批次效应：建议使用harmony或bbknn校正
• 基因检出率差异：考虑技术因素如测序深度不均

3. 数据标准化与特征选择

经过质控的数据需要标准化处理以消除技术噪音。Scanpy采用分步处理策略：

1. 文库大小校正：

   sc.pp.normalize_total(adata, target_sum=1e4) # CPM标准化 sc.pp.log1p(adata) # 对数转换

2. 高变基因筛选：

   sc.pp.highly_variable_genes( adata, min_mean=0.0125, max_mean=3, min_disp=0.5 ) adata = adata[:, adata.var.highly_variable] # 保留高变基因

3. 数据缩放：

   sc.pp.regress_out(adata, ['total_counts', 'pct_counts_mt']) # 回归干扰因素 sc.pp.scale(adata, max_value=10) # Z-score标准化

注意：高变基因数量通常控制在2,000-5,000之间，过多会引入噪音，过少会丢失信号

4. 降维与细胞聚类

进入分析的核心环节，我们将揭示数据背后的生物学结构：

4.1 主成分分析(PCA)

sc.tl.pca(adata, svd_solver='arpack') sc.pl.pca_variance_ratio(adata, log=True) # 碎石图确定主成分数

4.2 邻域图与UMAP可视化

sc.pp.neighbors(adata, n_neighbors=15, n_pcs=40) # 构建KNN图 sc.tl.umap(adata) # 非线性降维 sc.pl.umap(adata, color=['CD3D', 'CD79A']) # 标记基因可视化

4.3 Leiden聚类

sc.tl.leiden(adata, resolution=0.5) # 分辨率参数调控聚类粒度 sc.pl.umap(adata, color=['leiden']) # 聚类结果展示

参数优化建议：

• n_neighbors: 通常设为细胞数的平方根左右
• resolution: 从0.1开始逐步上调，直到获得合理分群
• random_state: 固定随机种子保证结果可重复

5. 差异分析与细胞注释

聚类结果的生物学解释需要系统的差异表达分析：

5.1 标记基因鉴定

sc.tl.rank_genes_groups( adata, 'leiden', method='wilcoxon', # 推荐使用Wilcoxon检验 pts=True # 计算表达比例 )

5.2 结果可视化

# 热图展示top标记基因 sc.pl.rank_genes_groups_heatmap( adata, n_genes=5, groupby='leiden', show_gene_labels=True ) # 点图展示关键标记基因 marker_genes = ['CD3D', 'CD79A', 'CST3', 'FCGR3A', 'NKG7'] sc.pl.dotplot(adata, marker_genes, groupby='leiden')

5.3 细胞类型注释

建立注释字典并映射到聚类结果：

cluster_annotation = { '0': 'Naive CD4 T', '1': 'Memory CD4 T', '2': 'CD14+ Mono', '3': 'B cells', '4': 'CD8 T', '5': 'NK cells' } adata.obs['cell_type'] = adata.obs['leiden'].map(cluster_annotation)

6. 发表级图表制作

最终成果的视觉呈现需要符合期刊要求：

6.1 UMAP主题定制

import matplotlib.pyplot as plt with plt.style.context('seaborn-whitegrid'): # 设置绘图风格 sc.pl.umap( adata, color='cell_type', legend_loc='on data', frameon=False, palette='Set2', # 使用ColorBrewer配色 size=20, # 调整点大小 title='', # 去除默认标题 save='_celltype.pdf' # 矢量图输出 )

6.2 组合图表排版

使用plt.subplots创建多面板图：

fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(12, 5)) sc.pl.umap(adata, color='cell_type', ax=ax1, show=False) sc.pl.violin(adata, 'n_genes_by_counts', groupby='cell_type', ax=ax2) plt.tight_layout() fig.savefig('combined_plot.png', dpi=300, bbox_inches='tight')

6.3 图表格式检查清单

7. 分析流程自动化

对于需要重复分析的项目，建议构建标准化流程：

def single_cell_pipeline(input_path, output_prefix): """标准化单细胞分析流程""" # 1. 数据加载 adata = sc.read_10x_mtx(input_path) # 2. 质控过滤 qc_filter(adata) # 3. 预处理 preprocess(adata) # 4. 聚类分析 cluster_analysis(adata) # 5. 结果保存 adata.write(f'{output_prefix}.h5ad') return adata

实际项目中，我们常遇到三类典型挑战：当UMAP出现过度分群时，适当降低resolution参数；当标记基因不显著时，检查标准化是否充分；当图表出现元素重叠时，调整plt.rcParams中的字体大小参数。