ContentUniformityQualityChecker
Content Uniformity
LabEx laboratory QC CSV→JSON URS & FS chromatography solid dosage forms utilities / cleanroom
Open selectionContent Uniformity Quality Checker — Calculation of AV for Uniformity of Dosage Units
ℹ️ Utility calculates Acceptance Value (AV) according to USP <905> and Ph. Eur. 2.9.40:
• Input: 10 individual active substance contents (% of Label Claim).
• Formula: AV = |M - x̄| + k * s
- x̄: mean content
- s: sample standard deviation
- k: 2.4 (for n=10)
- M: reference value (100.0 if 98.5 ≤ x̄ ≤ 101.5; otherwise boundary)
• Passing Criteria (Stage 1): AV ≤ 15.0 AND all units within 75.0–125.0%.
⚠️ CRITICAL: AV > 15.0 → batch fails uniformity requirements!
Any unit outside 75-125% results in automatic failure.
Usage:
ContentUniformityQualityChecker.exe → demo mode (console output)
ContentUniformityQualityChecker.exe input.csv output.json → evaluate your data
Input format:
BatchNumber,Unit1,Unit2,Unit3,Unit4,Unit5,Unit6,Unit7,Unit8,Unit9,Unit10
Example:
TAB-CU-2026-001,98.5,101.2,99.0,100.5,97.8,102.1,99.5,100.0,98.9,101.5
— WHY IS THIS NEEDED?
Content Uniformity (CU) ensures that each tablet or capsule contains the correct amount of active ingredient.
• This is a critical quality attribute for solid dosage forms with low API potency.
• USP <905> and Ph. Eur. 2.9.40 use a statistical approach (Acceptance Value) to assess variability.
• AV calculation accounts for both bias (accuracy) and spread (precision).
• Automation eliminates manual calculation errors for standard deviation and AV.
⚠️ CRITICAL:
• For Stage 1 (n=10), the AV limit is 15.0.
• If AV > 15.0 but ≤ 25.0, testing of additional 20 units may be required (Stage 2).
• Any unit outside 75.0–125.0% of Label Claim leads to batch failure at Stage 1.
• M value adjusts if mean deviates from 98.5–101.5%, penalizing for bias.
Key features:
• Automatic AV calculation per USP/Ph.Eur. formula.
• Check of individual limits (75-125%).
• Generation of LIMS-compatible JSON report.
Critical parameters:
• Acceptance Value (AV): <= 15.0
• Individual Limits: 75.0% - 125.0%
💡 Usage tips:
1. Ensure input data is expressed as % of Label Claim.
2. Use precise analytical methods (HPLC) to determine content in each unit.
3. If batch fails Stage 1, investigate process variability causes (mixing, compression).
4. This utility implements Stage 1 logic. Stage 2 (n=30) requires extended logic (not included in this version).
⚠️ Note: The calculation of M (reference value) is a key difference of the AV method from simple RSD calculation. It penalizes batches where the mean content significantly deviates from 100%, even if the spread (SD) is small.input.csv
BatchNumber,Unit1%,Unit2%,Unit3%,Unit4%,Unit5%,Unit6%,Unit7%,Unit8%,Unit9%,Unit10% TAB-CU-2026-001,98.5,101.2,99.0,100.5,97.8,102.1,99.5,100.0,98.9,101.5 TAB-CU-2026-002,95.0,105.0,92.0,108.0,96.0,104.0,93.0,107.0,94.0,106.0 TAB-FAIL-2026-003,80.0,120.0,85.0,115.0,82.0,118.0,83.0,117.0,81.0,119.0
URS & FS — Content Uniformity
This document describes the user requirements and functional specification for ContentUniformityQualityChecker. 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, Unit1%, Unit2%, Unit3%, Unit4%, Unit5%, Unit6%, Unit7%, Unit8%, Unit9%, Unit10%. | High | The CSV file is processed without manual header editing. |
| URS-002 | The utility shall perform deterministic evaluation for “Content Uniformity” 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 | TAB-CU-2026-001 | Input parameter for deterministic QC evaluation. |
| 2 | Unit1% | 98.5 | Input parameter for deterministic QC evaluation. |
| 3 | Unit2% | 101.2 | Input parameter for deterministic QC evaluation. |
| 4 | Unit3% | 99.0 | Input parameter for deterministic QC evaluation. |
| 5 | Unit4% | 100.5 | Input parameter for deterministic QC evaluation. |
| 6 | Unit5% | 97.8 | Input parameter for deterministic QC evaluation. |
| 7 | Unit6% | 102.1 | Input parameter for deterministic QC evaluation. |
| 8 | Unit7% | 99.5 | Input parameter for deterministic QC evaluation. |
| 9 | Unit8% | 100.0 | Input parameter for deterministic QC evaluation. |
| 10 | Unit9% | 98.9 | Input parameter for deterministic QC evaluation. |
| 11 | Unit10% | 101.5 | 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
Dental & Dental Materials QC Suite
QC utility package for dental medicinal products, oral-care products and dental materials: anaesthetics, antiseptics, analgesic/anti-infective products, polymers/minerals, resins, bonding workflows, microbiology, stability and material QC.
OpenLabEx QC Suite
LabEx package for laboratory QC methods: chromatography, spectroscopy, microbiology, sterility, endotoxins, particles, dissolution, water, cleanrooms and sample preparation.
Open