SuperAPI AI 工具集

flowio-flow-cytometry

数据与分析

查看项目

更新于 10-15 22:39

技能介绍

用途:FlowIO 是轻量级 Python 库,用于读取和写入流式细胞术标准 FCS 文件,解析元数据、将事件数据提取为 NumPy 数组,并可创建新 FCS 文件,支持 FCS 2.0、3.0、3.1。依赖极少,适合数据管道及高级分析前的预处理。

主要能力:读取 FCS 文件并获取版本、事件数、通道数;通过 as_array() 获取事件矩阵(默认应用增益与对数预处理,preprocess=False 取原始值);读取通道元数据(pnn_labels 短名、pns_labels 描述名、pnr_values 范围、scatter/fluoro/time 索引);only_text=True 仅读元数据以加速批量扫描;支持多数据集文件(read_multiple_data_sets、nextdata_offset);可用 create_fcs 从 NumPy 数组生成 FCS 3.1 文件,并写入自定义元数据;可读取、过滤、修改后重新导出。

使用方式:安装 pip install flowio numpy pandas,需 Python 3.9+,无编译依赖。基本用法:from flowio import FlowData; flow = FlowData("experiment.fcs"); events = flow.as_array()。创建文件:create_fcs("output.fcs", events, channels)。

适用场景:批量解析 FCS 目录、导出 CSV/DataFrame、提取荧光通道、归一化事件、文件检查报告、多数据集拆分。

限制:不支持门控、补偿与 FlowJo 工作区,需改用 FlowKit;不支持原地修改 flow.events,须提取后修改再 create_fcs;修改数据时应使用 preprocess=False 的原始值;大文件可能内存不足,可仅读元数据;部分文件存在偏移不一致或多数据集错误,可用 ignore_offset_discrepancy、ignore_offset_error 等参数处理。