flowio
Читает, проверяет и записывает файлы Flow Cytometry Standard (FCS) 2.0, 3.0, 3.1 через FlowIO. Подходит для низкоуровневого анализа метаданных, извлечения данных в NumPy и экспорта таблиц. Для компенсации и гейтинга используйте FlowKit.
Что делает навык
FlowIO — легковесный инструмент для чтения, проверки и записи файлов стандарта Flow Cytometry Standard (FCS) версий 2.0, 3.0 и 3.1. Он предназначен для низкоуровневого извлечения метаданных, получения событий в виде массивов NumPy и экспорта таблиц, но не выполняет компенсацию, гейтинг или трансформации.
Когда применять
- Инвентаризация метаданных (HEADER, TEXT, ANALYSIS) и проверка структуры файла без загрузки полных данных событий.
- Извлечение данных событий в двумерный массив NumPy с применением или без применения масштабирования (gain/log/time) из метаданных FCS.
- Чтение устаревших файлов FCS, содержащих несколько наборов данных (multiple datasets).
- Создание новых файлов FCS 3.1 (list-mode, single-precision float) из массивов NumPy.
- Копирование или переименование существующих файлов FCS с сохранением или изменением метаданных.
Как работает
- Установить пакет flowio==1.4.0 в окружение Python (поддерживаются версии 3.9–3.13).
- Для чтения метаданных использовать класс FlowData с параметром only_text=True, обращаясь к ключам в нижнем регистре без символа '$'.
- Для получения данных событий вызвать метод as_array() с параметром preprocess=True (для масштабирования) или preprocess=False (для сырых значений).
- При записи использовать функцию create_fcs() с открытым бинарным файлом, плоским массивом событий и списками названий каналов (PnN/PnS).
- Валидировать результат записи, повторно открывая созданный файл и сравнивая количество событий, каналов и значения.
- Для файлов с несколькими наборами данных использовать вспомогательную функцию read_multiple_data_sets().
Примеры запросов агенту
Что понадобится
- Python 3.9–3.13
- Пакет flowio==1.4.0
Описание составлено по SKILL.md навыка, сверено 08.10.2026.
Как подключить
SKILL.md к навыкам ассистентаНавык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.