FASTVOLT

FASTVOLT is a lightweight local web application designed for researchers to quickly extract voltage and compensation data from Flow Cytometry Standard (FCS) files and generate professional, lab-ready A4 PDF reports.

Features

• Fast Parsing: Extract metadata from FCS files in seconds using flowio.
• Instrument Awareness: Automatically detects instrument model and serial numbers (optimized for BD & CytoFLEX).
• Channel Voltages: Displays all channel voltages with FSC threshold (Time channel auto-excluded).
• Compensation Matrix: Extracts and displays spillover compensation data.
• Panel Design Table: Editable fluorophore-sample mapping table with CSV paste support from Word/Excel.
• A4 PDF Reports: Generates professional PDF records with institutional headers and space for manual entry.
• Batch Export: Process multiple files at once and download them as a ZIP archive.
• Intuitive UI: Simple drag-and-drop web interface.
• LAN Access: Binds to 0.0.0.0 for local network sharing.

Prerequisites

• Python 3.10 or higher
• Chrome, Edge, or Safari browser

Installation

1. Clone the repository:

   git clone https://github.com/PanCodeInventory/FASTVOLT.git
   cd FASTVOLT

2. Install dependencies:

   pip install -r requirements.txt

Usage

Run the application using the following command:

python main.py

The application will start on http://0.0.0.0:8080. Access from any device on the same network.

1. Upload: Drag and drop your .fcs files into the blue drop zone.
2. Review: Check the extracted instrument info, channel voltages, compensation matrix, and panel table.
3. Panel Table: Click Paste CSV to paste tab-separated data from Word/Excel, or + 添加行 to manually add rows.
4. Export:
   • Click Export PDF on a specific file card for an individual report.
   • Click Export All (PDF ZIP) at the top to download reports for all loaded files.

Tech Stack

• Backend: FastAPI (Python)
• PDF Engine: ReportLab
• Parsing: flowio
• Frontend: Vue.js (CDN), Tailwind CSS

Changelog

v0.2.0 (2026-05-08)

• Fix: Black blocks appearing in PDF when pasting panel data from Word/Excel (stripped \r\n characters)
• Fix: CytoFLEX gain parser now uses Area-only channels to avoid H+A duplication
• Feat: Time channels automatically excluded from Channels & Voltages display
• Feat: Footer updated to "Generated by FASTVOLT, Developed by PCS"
• Feat: "Panel Design (Fluorophore-Sample)" renamed to "Panel Design"
• Chore: Server binds to 0.0.0.0:8080 for LAN access

v0.1.0 (2026-05-07)

• Initial release: FCS parsing, PDF export, batch ZIP, editable panel table, FSC threshold display

License

This project is developed for laboratory record enhancement.