flowio

library1.4.0pypypi✓ verified 85d ago

FlowIO is a Python library for reading and writing Flow Cytometry Standard (FCS) files. Current version is 1.4.0. The library supports FCS 2.0, 3.0, and 3.1. Release cadence is irregular; last release was in 2023.

analytics

pip install flowio

github ↗homepage ↗

INSTALL

IMPORT

SIG · FLOWIO

flowio

analyticspythonv1.4.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

FlowData

✓ from flowio import FlowData

Correct import for reading FCS files.

Read an FCS file and access event data.

from flowio import FlowData # Replace with your FCS file path fcs = FlowData('example.fcs') print(f'Events: {fcs.event_count}') print(f'Channels: {fcs.channel_count}') # Access events as numpy array import numpy as np events = np.array(fcs.events).reshape(fcs.event_count, fcs.channel_count) print(events[:5])

Debug

Known issues

gotchaFlowData.events returns a flat Python list, not a numpy array. You must reshape using event_count and channel_count.

fix

Use np.array(fcs.events).reshape(fcs.event_count, fcs.channel_count)

affects: all

gotchaFlowIO does not support writing FCS files; it only reads them. For writing, consider other libraries like fcswrite.

fix

Use fcswrite or similar for writing.

affects: <=1.4.0

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'numpy'

FlowIO depends on numpy but it may not be installed automatically.

fix

pip install numpy

TypeError: 'NoneType' object is not iterable

FCS file may be corrupt or not properly read; FlowIO returns None for some fields if parsing fails.

fix

Check the FCS file integrity; try with a known valid file.

Upgrade

Version history

1.4.0latest on PyPI · released May 9, 2025

Audit

Dependencies

No dependency data recorded yet.

Agent activity

34 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/whitews/flowio ↗

homepagehttps://github.com/whitews/flowio ↗