FlowKit: 流式细胞术分析和可视化的Python工具包入门指南

FlowKit: 流式细胞术分析和可视化的Python工具包入门指南

FlowKitA Python toolkit for flow cytometry analysis supporting GatingML and FlowJo workspaces项目地址:https://gitcode.com/gh_mirrors/flo/FlowKit

一、项目介绍

概览

FlowKit是一款用于流式细胞仪数据（flow cytometry）分析和可视化的Python工具包，支持GatingML 2.0标准以及部分FlowJo 10工作空间文件的支持。该工具包由Whiteside等人开发维护，在学术界和工业界都获得了广泛应用。

核心特性

• 读写FCS文件：支持FCS版本2.0至3.1。
• 事件补偿：使用spillover矩阵进行补偿处理，来源包括$SPILL或$SPILLOVER关键字值、FlowJo文本、NumPy数组等。
• 转换功能：Logicle、反双曲正弦（ArcSinh）、Bi-exponential、Hyperlog、对数、通道比率和线性转换。
• 门控操作：完全遵循GatingML 2.0规格进行导入导出门控策略。
• 可视化能力：结合Python强大的绘图库提供高级的数据可视化解决方案。

二、项目快速启动

为了能够立即上手并体验FlowKit的强大功能，我们从安装开始说起：

pip install flowkit

完成安装后，我们将通过一个简单的示例来熟悉其基本操作流程。首先，我们需要加载样本来展示数据读取过程：

import flowkit as fk

sample = fk.Sample.from_fcs('path/to/your/sample.fcs')
print(sample.data.shape)

接着，让我们创建一个门控策略并对样本进行门控分析：

comp_matrix = fk.transforms.SpillOverMatrix.from_excel('path/to/spill/excel/file.xlsx')

gs = fk.GatingStrategy()
gate = fk.gates.RectangularGate(name='MyGate', x1=100, x2=200, y1=1000, y2=2000)

gs.add_gates([gate])
gs.set_transforms(fk.transforms.LogicleTransform(xform_id='logicle'))

gated_sample = gs.apply_gating(sample)
print(gated_sample.gating_results)

以上就是快速启动的基本步骤，你已具备了使用FlowKit进行初步数据分析的能力。

三、应用案例和最佳实践

应用案例

• 单域抗体选择优化：Justine Mortelecque 等人在《Journal of Biological Chemistry》中描述如何利用FlowKit筛选和优化针对PHF6线性肽在Tau蛋白内部的单域抗体。
• 人病毒特异性CD8+T细胞深度分析：Florian Schmidt 等人的研究展示了如何使用FlowKit进行复杂的人类免疫系统细胞类型识别和表型标记物筛选。

最佳实践

数据预处理阶段

确保所有数据经过适当的补偿，使用fk.transforms.SpillOverMatrix进行补偿处理。

分析设计

构建合理的门控策略，考虑使用门控模板或者参考文献中的标准策略以保证结果的一致性和可重复性。

可视化与结果解释

充分利用FlowKit的可视化功能，例如散点图、热力图等，帮助理解复杂的多维数据关系。

四、典型生态项目

• Leiden vs DBSCAN聚类对比：FlowKit不仅限于传统的门控分析，它还整合了多种聚类算法供研究人员探索未知的细胞群集模式。

生态项目的存在丰富了FlowKit的应用场景，也促进了社区内的知识共享和技术交流。

---

以上是基于FlowKit开源项目提供的基础入门指南，希望有助于你理解和掌握这一强大的流式细胞术数据处理工具包。随着你的深入学习和实践，将发现更多高级特性和技巧，进而推动自己科研工作的创新与发展。

FlowKitA Python toolkit for flow cytometry analysis supporting GatingML and FlowJo workspaces项目地址:https://gitcode.com/gh_mirrors/flo/FlowKit