Skip to content

EuropeanIFCBGroup/ClassiPyR

Repository files navigation

ClassiPyR ClassiPyR website

Lifecycle: experimental License: MIT R-CMD-check codecov DOI

A Shiny application for manual (human) image classification and validation of Imaging FlowCytobot (IFCB) plankton images. Built for researchers who need to validate automated classifications or create training datasets for machine learning classifiers.

Full documentation: europeanifcbgroup.github.io/ClassiPyR

Background

ClassiPyR was created to provide a lightweight, standalone annotation and validation tool that is fully compatible with the ifcb-analysis toolbox and custom classifiers (e.g. a CNN). The primary design goals were user-friendliness and portability—enabling researchers to work with IFCB data without complex setup requirements or dependencies on specific computing environments (other than Python and R). To achieve these goals efficiently, Claude Code was used for development.

Features

  • Dual Mode: Validate existing classifications or annotate from scratch
  • Multiple Formats: Load from CSV or MATLAB classifier output
  • Efficient Workflow: Drag-select, batch relabeling, class filtering
  • MATLAB Compatible: Export for ifcb-analysis toolbox
  • CNN Training Ready: Organized PNG output by class
  • Measure Tool: Built-in ruler for image measurements

Installation

install.packages("remotes")
remotes::install_github("EuropeanIFCBGroup/ClassiPyR")

ClassiPyR depends on iRfcb for IFCB data handling, which is installed automatically.

Python Setup

Python is required for reading and writing MATLAB .mat files. If you only work with CSV files, this step is optional.

library(iRfcb)
ifcb_py_install()

Quick Start

library(ClassiPyR)
run_app()

See the Getting Started guide for detailed setup instructions.

Documentation

Citation

citation("ClassiPyR")

License

MIT License - see LICENSE file.

Disclaimer

This software is provided for research and educational purposes. Users are responsible for their data and annotations. Always maintain backups of your original data.

This package was partly developed with the assistance of Claude Code, an AI programming assistant by Anthropic.