{"id":44980,"library":"flowio","title":"FlowIO","description":"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.","status":"active","version":"1.4.0","language":"python","source_language":"en","source_url":"https://github.com/whitews/flowio","tags":["fcs","flow cytometry","bioinformatics","scientific"],"install":[{"cmd":"pip install flowio","lang":"bash","label":"Install via pip"}],"dependencies":[],"imports":[{"note":"Correct import for reading FCS files.","symbol":"FlowData","correct":"from flowio import FlowData"}],"quickstart":{"code":"from flowio import FlowData\n\n# Replace with your FCS file path\nfcs = FlowData('example.fcs')\nprint(f'Events: {fcs.event_count}')\nprint(f'Channels: {fcs.channel_count}')\n# Access events as numpy array\nimport numpy as np\nevents = np.array(fcs.events).reshape(fcs.event_count, fcs.channel_count)\nprint(events[:5])","lang":"python","description":"Read an FCS file and access event data."},"warnings":[{"fix":"Use np.array(fcs.events).reshape(fcs.event_count, fcs.channel_count)","message":"FlowData.events returns a flat Python list, not a numpy array. You must reshape using event_count and channel_count.","severity":"gotcha","affected_versions":"all"},{"fix":"Use fcswrite or similar for writing.","message":"FlowIO does not support writing FCS files; it only reads them. For writing, consider other libraries like fcswrite.","severity":"gotcha","affected_versions":"<=1.4.0"}],"env_vars":null,"search_vec":"'1.4.0':19 '2.0':24 '2023':36 '3.0':25 '3.1':27 'bioinformat':40 'cadenc':29 'current':16 'cytometri':12,39 'fcs':14,23,37 'file':15 'flow':11,38 'flowio':1,2 'irregular':31 'last':32 'librari':6,21 'python':5 'read':8 'releas':28,33 'scientif':41 'standard':13 'support':22 'version':17 'write':10","created_at":"2026-06-07T12:52:46.735614+00:00","updated_at":"2026-06-07T12:52:46.735614+00:00","problems":[{"fix":"pip install numpy","cause":"FlowIO depends on numpy but it may not be installed automatically.","error":"ModuleNotFoundError: No module named 'numpy'"},{"fix":"Check the FCS file integrity; try with a known valid file.","cause":"FCS file may be corrupt or not properly read; FlowIO returns None for some fields if parsing fails.","error":"TypeError: 'NoneType' object is not iterable"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/whitews/flowio","github":"https://github.com/whitews/flowio","docs":null,"changelog":null,"pypi":null,"npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["analytics"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}