flowio

Читает, проверяет и записывает файлы Flow Cytometry Standard (FCS) 2.0, 3.0, 3.1 через FlowIO. Подходит для низкоуровневого анализа метаданных, извлечения данных в NumPy и экспорта таблиц. Для компенсации и гейтинга используйте FlowKit.

KDK-Dense official Данные ★ 47.7k

Что делает навык

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 с сохранением или изменением метаданных.

Как работает

  1. Установить пакет flowio==1.4.0 в окружение Python (поддерживаются версии 3.9–3.13).
  2. Для чтения метаданных использовать класс FlowData с параметром only_text=True, обращаясь к ключам в нижнем регистре без символа '$'.
  3. Для получения данных событий вызвать метод as_array() с параметром preprocess=True (для масштабирования) или preprocess=False (для сырых значений).
  4. При записи использовать функцию create_fcs() с открытым бинарным файлом, плоским массивом событий и списками названий каналов (PnN/PnS).
  5. Валидировать результат записи, повторно открывая созданный файл и сравнивая количество событий, каналов и значения.
  6. Для файлов с несколькими наборами данных использовать вспомогательную функцию read_multiple_data_sets().

Примеры запросов агенту

Прочитай метаданные файла sample.fcs, покажи версию, количество событий, названия каналов и дату регистрации.
Загрузи данные событий из файла flow_sample.fcs в массив NumPy, применив масштабирование, указанное в метаданных FCS.
Создай новый файл output.fcs версии 3.1 на основе массива NumPy с тремя каналами: FSC-A, SSC-A и FITC-A.

Что понадобится

  • Python 3.9–3.13
  • Пакет flowio==1.4.0

Описание составлено по SKILL.md навыка, сверено 08.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «flowio» из репозитория: # https://github.com/k-dense-ai/scientific-agent-skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r flowio/ ~/.claude/skills/flowio/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.