Skip to content

AlAtiat/beelisa

Repository files navigation

BeELISA



Author: Aun Al Atiat

BeELISA is a cross-platform desktop application for the standardized and reproducible analysis of enzyme-linked immunosorbent assay (ELISA) data in biomedical research.

Goal of the project

This software was developed as part of the Bachelor thesis:

Statistical Evaluation of Glycoprotein Biomarkers in Cancer Using an Analytical Application for ELISA Data Processing and Biomarker Pattern Recognition (not public)

Aun Al Atiat Brandenburg University of Technology Cottbus-Senftenberg Faculty 2 (Environment and Natural Sciences), Institute of Biotechnology. 2026

Overview

BeELISA provides a structured workflow for quantifying protein biomarkers from 96-well plate ELISA experiments. It covers the complete analytical pipeline: raw optical density (OD) import, standard curve fitting, concentration back-calculation, quality control assessment, and correlation with clinical metadata.

The application was developed with reproducibility as a primary objective. All analytical parameters — including curve model selection, clinical metadata parsers (e.g., TNM, UICC), and detection threshold definitions — are dataset-specific yet designed to remain reusable across different datasets. Clinical metadata parsers are applied only when the corresponding columns (e.g., “TNM” or “UICC”) are present in the dataset.

All you need

BeELISA requires at least three input tables/files: one plate OD file, the corresponding plate ID file, and one metadata file. The plate OD and plate ID files should follow the same 96-well plate layout and can be provided as .csv or .xlsx files. The plate ID file defines which sample is located in each well, while the plate OD file contains the corresponding optical density measurement for each well. The metadata file is a normal table with a header row and columns describing the samples; it must contain a sample ID column that matches the IDs used in the plate ID file. The plate design itself is configured inside the software.

Plate ID file
123456789101112
ASTD1STD1S001S002S003S004S005S006S007S008S009S010
BSTD2STD2S011S012S013S014S015S016S017S018S019S020
CSTD3STD3S021S022S023S024S025S026S027S028S029S030
DSTD4STD4S031S032S033S034S035S036S037S038S039S040
ESTD5STD5S041S042S043S044S045S046S047S048S049S050
FNEGNEGS051S052S053S054S055S056S057S058S059S060
GS061S062S063S064S065S066S067S068S069S070S071S072
HS073S074S075S076S077S078S079S080S081S082S083S084

The ID file contains the sample or calibrator identifier assigned to each well.

resources/synthetic_data_1/plates/PLATE_001_ID.xlsx

Plate OD file
123456789101112
A2.1022.0870.8120.7431.0310.6550.9121.2230.5340.6890.7710.845
B1.7421.7350.6210.5830.7110.9020.4880.5570.6320.7840.8460.923
C1.2031.1900.4450.5120.6010.7340.8210.9440.3770.4250.5030.588
D0.7420.7550.3890.4670.5290.6120.7030.8120.3560.4410.5320.608
E0.3320.3410.2880.3550.4020.4810.5520.6240.2980.3440.4210.509
F0.0910.0870.2510.3160.3890.4560.5180.5870.2460.3090.3760.462
G0.2710.3350.4120.5060.5770.6430.7250.8090.2860.3590.4210.498
H0.3120.3840.4560.5290.6040.6810.7590.8330.3370.4080.4920.561

The OD file contains the optical density reading for each well in the same layout.

resources/synthetic_data_1/plates/PLATE_001_OD.xlsx

Metadata file
sample_idgroupagesexstage
S001PDAC61FII
S002PDAC57MIII
S003Control45FNA
S004PDAC69MIV
S005Control52FNA

The metadata file contains additional information for each sample. The sample ID column must match the IDs in the plate ID file.

resources/synthetic_data_1/metadata.xlsx

Scientific Methodology

Standard Curve Fitting

Calibrant OD measurements are fitted to the following models:

  • Linear regression
  • Log-linear regression
  • Exponential regression
  • Four-parameter logistic (4PL)
  • Five-parameter logistic (5PL)

Model selection is performed automatically using the Bayesian Information Criterion (BIC), which penalizes model complexity. The model with the lowest BIC is applied to back-calculate unknown concentrations via the inverse curve function.

Standard curve fit Model comparison

Limits of Detection and Quantification

The limit of detection (LOD) and limit of quantification (LOQ) are calculated from blank or negative control replicates:

  • LOD = mean(blank) + 3 * SD(blank)
  • LOQ = mean(blank) + 10 * SD(blank)

When per-plate blank replicates are insufficient, a global estimate pooled across all plates is used as a fallback.

Inter-Plate Factor Correction

When multiple plates are analyzed together, systematic differences in signal intensity between plates (e.g., due to different reagent lots, incubation conditions, or plate reader variation) can bias concentration estimates. BeELISA implements a multiplicative inter-plate factor correction based on calibrant wells, analogous to the ΔΔCt normalisation used in qPCR. (Ruijter et al., 2015 — Between-run correction for multi-plate qPCR experiments. Biomolecular Detection and Quantification.) (https://doi.org/10.1016/j.bdq.2015.07.001)

For each calibrant dilution level k, the across-plate median OD of all plates is used as a reference r_k. A plate-specific correction factor is then computed as:

F_plate = exp( median_k( log( m_{p,k} / r_k ) ) )

where m_{p,k} is the median OD of calibrant replicates for plate p at level k, and the outer median is taken over all valid calibrant levels (those with r_k > 0). Corrected ODs are obtained by dividing all wells on the plate by F_plate. LOD and LOQ thresholds are scaled by the same factor.

If plates are assigned to groups, correction factors are computed independently within each group so that between-group biological differences are preserved.

Quality Control

Replicate agreement is assessed by the coefficient of variation (CV):

  • Calibrant replicates: warning threshold > 15%
  • Sample and control replicates: warning threshold > 20%
OD heatmap QC report PCA batch analysis

Clinical Correlation

Quantified biomarker concentrations are correlated with ordinal clinical staging variables (TNM classification, UICC stage) using Spearman rank correlation. Multiple testing correction is applied using the Benjamini-Hochberg false discovery rate (FDR) procedure. Pattern visualization uses locally weighted scatterplot smoothing (LOWESS). Batch effects across plates are assessed by principal component analysis (PCA) of plate-level QC metrics.

LOWESS pattern grid Correlation heatmap

ROC / Diagnostic Performance Analysis

When a binary clinical outcome is available (e.g. disease vs control), BeELISA evaluates the diagnostic performance of the biomarker using Receiver Operating Characteristic (ROC) analysis.

The ROC curve is generated by varying the decision threshold of the selected score variable (e.g. concentration or OD value) and calculating the corresponding sensitivity (true positive rate) and false positive rate (1 − specificity).

Overall classification performance is summarized by the area under the ROC curve (AUC):

  • AUC = 0.5 indicates random classification
  • AUC = 1.0 indicates perfect discrimination

The optimal cutoff value is determined using the Youden index (sensitivity + specificity − 1), which identifies the threshold that maximizes the combined sensitivity and specificity.

The ROC plot reports:

  • AUC with 95% confidence interval
  • Optimal cutoff value
  • Sensitivity and specificity at the cutoff
  • Sample sizes of the positive and negative groups

Uncertainty of the ROC curve is estimated using bootstrap resampling to generate a 95% confidence band.

ROC curve

Features

  • Import of raw plate reader data (CSV, Excel) for standard 96-well plates
  • Configurable well classification: calibrant, sample, blank, negative control, positive control
  • Automatic standard curve model selection via BIC
  • Per-plate and global LOD/LOQ calculation
  • CV-based replicate QC with configurable thresholds
  • Dilution factor correction
  • per group Multiplicative inter-plate factor correction of standard curves
  • Result classification: below detection, borderline, quantifiable
  • TNM/UICC clinical staging integration
  • Spearman correlation with Benjamini-Hochberg FDR correction
  • Plate-level PCA for batch effect visualization
  • ROC-based diagnostic performance analysis with AUC estimation, optimal cutoff determination (Youden index), and sensitivity/specificity reporting
  • Session save and restore (.beelisa format)
  • Cross-platform: Windows, macOS, Linux
ELISA import view Data view
Analysis configuration Results table

Download

Windows

Download for Windows

Windows 10 / 11 · MSI Installer
Run the installer

macOS

Download for macOS ARM64
Download for macOS Intel

macOS 12+ · DMG · Open the DMG and drag BeELISA to Applications.

Linux (AppImage)

Download AppImage for Linux

All distributions · No install needed:
chmod +x BeELISA.AppImage && ./BeELISA.AppImage

Linux (Flatpak)

Download for Linux

All distributions · Install via:
flatpak install BeELISA.flatpak

Links above always point to the latest release. All releases and release notes are on the Releases page.

Framework and Build System

BeELISA is implemented in Python and built as a native desktop application using the BeeWare ecosystem.

The graphical user interface (GUI) is developed with:

  • BeeWare Toga — a native, cross-platform GUI toolkit for Python.

Application packaging and distribution are handled using:

  • BeeWare Briefcase — a tool for building standalone installers for Windows, macOS, and Linux.

The BeeWare project enables Python applications to run as fully native desktop software without requiring users to install Python separately.

For more information, see:

Development Dependencies

Python 3.11+

Core libraries:
pandas>=2.2,<2.4 numpy>=1.26,<2.0 scipy==1.13.1 scikit-learn>=1.4,<1.6 matplotlib>=3.8,<3.11 seaborn==0.13.2 openpyxl>=3.1,<4.0 toga

License

Copyright (C) 2026 Aun Al Atiat.

This software is distributed under the terms of the GNU General Public License v3.0 (GPLv3) or any later version. See the LICENSE file for the full license text.

Citation

If you use BeELISA in research, please cite as:

Al Atiat, A. (2026). BeELISA: A Software Framework for ELISA Data Analysis (Version 1.0.7) [Computer software]. GitHub. https://github.com/AlAtiat/beelisa

About

BeELISA is a cross-platform desktop application for the standardized and reproducible analysis of enzyme-linked immunosorbent assay (ELISA) data in biomedical research.

Topics

Resources

License

Code of conduct

Stars

1 star

Watchers

0 watching

Forks

Contributors

Languages