flowio

Parse FCS 2.0-3.1 cytometry files into event arrays and metadata.

Updated Jul 1, 2026
One-click install
npx skills add https://github.com/jasrajtulsi/GRAD-SCOPE --skill flowio-jasrajtulsi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: flowio
Source: https://github.com/jasrajtulsi/GRAD-SCOPE/tree/main/.claude/skills/flowio
Command: npx skills add https://github.com/jasrajtulsi/GRAD-SCOPE --skill flowio-jasrajtulsi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

FlowIO removes the friction of working with Flow Cytometry Standard files by turning opaque FCS data into readable metadata, channel labels, and event arrays that can be used immediately in downstream analysis.

Core Features & Use Cases

It reads FCS 2.0, 3.0, and 3.1 files, extracts TEXT and ANALYSIS metadata, classifies scatter, fluorescence, and time channels, and converts events into NumPy arrays or pandas DataFrames. It also supports multi-dataset files, offset discrepancy handling, null channel filtering, and exporting modified data back to FCS or CSV workflows. A practical use case is reviewing a batch of cytometry acquisitions, checking channel structure and acquisition settings, and saving cleaned event data for preprocessing before compensation or gating.

Quick Start

Use the flowio skill to inspect an FCS file, summarize its metadata and channels, and convert the event data into an analysis-ready array.

Frequently Asked Questions about flowio

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

FAQPage Schema
How do I parse FCS flow cytometry files into a pandas DataFrame?

You can parse FCS cytometry files into analysis-ready pandas DataFrames or NumPy arrays by extracting structured event arrays and metadata, handling offset discrepancies and null channel filtering during conversion.

Can I extract metadata and classify channels from FCS files in batch?

Yes, batch preprocessing workflows support extracting TEXT and ANALYSIS metadata while classifying scatter, fluorescence, and time channels across multiple FCS datasets for efficient cytometry acquisition review.

Does this FCS parser handle offset discrepancies and null channels?

Yes, this FCS parser handles offset discrepancies, supports multi-dataset files, and performs null channel exclusion during preprocessing to ensure accurate event array extraction and metadata conversion.

What is the best way to convert FCS event data to CSV?

The best way to convert FCS event data to CSV is to parse cytometry files into structured NumPy arrays or pandas DataFrames and export the modified event data directly to CSV workflows.

Can I create new FCS files after modifying event data?

Yes, you can export modified event arrays back to new FCS files. This supports file validation, conversion, and batch preprocessing workflows after inspecting and altering the original cytometry data.

Why do I need to exclude null channels when preprocessing flow cytometry data?

Excluding null channels during flow cytometry preprocessing ensures empty or unused parameters do not skew event arrays, keeping the extracted NumPy arrays and DataFrames clean for downstream compensation or gating analysis.