BiologicAggregateSizeQualityChecker
Biologic Aggregate Size
Biologic Aggregate Size Quality Checker — Control of Aggregation and Particle Size of Biologics ℹ️ Utility checks critical quality parameters of biological products: • HMW Aggregates (High Molecular Weight): ≤1.0% • Main Peak (Monomer): ≥98.0% • Particle Size (Z-Average): <15.0 nm (for mAb) • Polydispersity Index (PDI): <0.2 ⚠️ CRITICAL: High aggregate level (>1.0%) → immunogenicity risk (ADA)! Increase in particle size and PDI indicates denaturation or formulation instability. Usage: BiologicAggregateSizeQualityChecker.exe → demo mode (console output) BiologicAggregateSizeQualityChecker.exe input.csv output.json → evaluate your data Input format: BatchNumber,HmwAggregatesPercent,LmwFragmentsPercent,MainPeakPercent,ZAverageSizeNm,PolydispersityIndex Example: BIO-AGG-2026-001,0.5,0.8,98.7,10.5,0.12 — WHY IS THIS NEEDED? For therapeutic proteins (monoclonal antibodies, recombinant enzymes), aggregation is a Critical Quality Attribute (CQA). • Aggregates can trigger unwanted immune responses in patients (formation of anti-drug antibodies, ADA). • SEC-HPLC (Size Exclusion Chromatography) and DLS (Dynamic Light Scattering) are standards for size and aggregation control. • USP <1053> and ICH Q6B regulate methods for characterization of biotechnological products. • Control is necessary at all stages: from formulation development to batch release. ⚠️ CRITICAL: • HMW Aggregates must be minimal. Even small changes (by 0.1-0.2%) can be significant. • PDI < 0.2 indicates that the sample is monodisperse (homogeneous in size). • Growth of Z-Average size beyond the native protein value (e.g., >12-13 nm for IgG) signals onset of oligomerization. • Storage conditions (temperature, shaking) strongly affect aggregation. Key features: • Comprehensive assessment of aggregation (SEC) and size (DLS). • Immunogenic risk control via HMW limits. • Support for analytical instrument data for biopharma. Critical parameters: • HMW Aggregates: <= 1.0% • Main Peak (Monomer): >= 98.0% • Z-Average Size: < 15.0 nm • PDI: < 0.2 💡 Usage tips: 1. Use filtered buffers to exclude dust during DLS measurements. 2. Perform SEC-HPLC measurements at controlled column temperature. 3. Compare results with the Reference Standard of the specific molecule. 4. For viscous products, account for concentration effects on size (interaction effects). 5. Regularly calibrate instruments using standard proteins (BSA, Ovalbumin) or latex spheres. ⚠️ Note: Aggregation can be reversible (weak bonds) or irreversible (covalent cross-links). This utility assesses the total content of enlarged particles, regardless of bond nature, which is important for overall safety.
input.csv
BatchNumber,HMW%,LMW%,Main%,ZAvg_nm,PDI BIO-AGG-2026-001,0.5,0.8,98.7,10.5,0.12 BIO-AGG-2026-002,0.8,1.0,98.2,11.2,0.15 BIO-FAIL-AGG-003,2.5,1.5,96.0,18.5,0.35
URS & FS — Biologic Aggregate Size
This document describes the user requirements and functional specification for BiologicAggregateSizeQualityChecker. The utility is intended for QC laboratory use as a rule-based check of data prepared from an instrument, LIMS, ELN, MES or an approved input.csv.
URS — User Requirements Specification
| ID | Requirement | Criticality | Acceptance criterion |
|---|---|---|---|
| URS-001 | The utility shall accept input.csv with approved columns: BatchNumber, HMW%, LMW%, Main%, ZAvg_nm, PDI. | High | The CSV file is processed without manual header editing. |
| URS-002 | The utility shall perform deterministic evaluation for “Biologic Aggregate Size” without machine learning. | High | The same input data produce the same JSON result. |
| URS-003 | The utility shall validate mandatory fields, numeric formats, flags, ranges and domain plausibility. | High | Schema and conversion errors are explicitly reported. |
| URS-004 | The utility shall generate output.json with PASS / WARNING / FAIL statuses, source values, warnings and failures. | High | The JSON result is suitable for review, deviation investigation and integration. |
| URS-005 | The documentation shall support IQ/OQ/PQ or CSV/CSA verification. | Medium | URS/FS, CSV/JSON contract and test scenarios are supplied with the utility. |
input.csv contract
| # | Field | Sample | Purpose |
|---|---|---|---|
| 1 | BatchNumber | BIO-AGG-2026-001 | Input parameter for deterministic QC evaluation. |
| 2 | HMW% | 0.5 | Input parameter for deterministic QC evaluation. |
| 3 | LMW% | 0.8 | Input parameter for deterministic QC evaluation. |
| 4 | Main% | 98.7 | Input parameter for deterministic QC evaluation. |
| 5 | ZAvg_nm | 10.5 | Input parameter for deterministic QC evaluation. |
| 6 | PDI | 0.12 | Input parameter for deterministic QC evaluation. |
FS — Functional Specification
| ID | Function | Implementation |
|---|---|---|
| FS-001 | CSV import | Read input.csv; validate header, column count and encoding. |
| FS-002 | Schema validation | Check required fields and permitted input values. |
| FS-003 | Rule engine | Apply domain rules, limits and system suitability/specification checks described in the source utility description. |
| FS-004 | Status aggregation | Produce final status: FAIL for critical failure, WARNING for non-critical deviation, PASS for conformance. |
| FS-005 | JSON export | Write machine-readable output.json for LIMS/ELN/MES and QA/QC review. |
OQ/PQ scenarios
- OQ-001: a valid sample row shall be processed without schema error.
- OQ-002: a missing mandatory column shall produce a schema error.
- OQ-003: a non-numeric value in a numeric field shall produce a conversion error.
- OQ-004: a critical parameter outside the limit shall produce
FAILor a critical finding. - PQ-001: user real batches shall be checked with retention of
input.csv,output.json, utility version and checksum.
Included in packages
Biopharmaceuticals Core QC Suite
Focused QC utility package for biologic products: HCP, mAbs, biosimilars, proteins/peptides, sterility, endotoxins and key release checks.
OpenBiopharmaceuticals Extended QC Suite
Extended QC utility coverage for mAbs, biosimilars, proteins, insulins, vaccines, mRNA/LNP, HCP, sterile release, microbiology, water, cleanroom and stability workflows.
OpenImmunology QC Suite
QC utility package for immunology: monoclonal antibodies, biosimilars, immunomodulators, immunosuppressants, ELISA/SPR, HCP, protein characterization, sterility and pyrogen/release checks.
OpenLabEx QC Suite
LabEx package for laboratory QC methods: chromatography, spectroscopy, microbiology, sterility, endotoxins, particles, dissolution, water, cleanrooms and sample preparation.
Open