InhalationAPSDQualityChecker
Inhalation APSD
LabEx laboratory QC CSV→JSON URS & FS utilities / cleanroom
Open selectionInhalation APSD Quality Checker — Control of Aerodynamic Particle Size Distribution (APSD) ℹ️ Utility checks critical parameters of inhaler aerosol cloud (USP <601> / Ph. Eur. 2.9.18): • Fine Particle Dose (FPD): particles <5 µm • Mass Median Aerodynamic Diameter (MMAD): distribution median • Geometric Standard Deviation (GSD): distribution width ⚠️ CRITICAL: Large particles (>5 µm) deposit in the oropharynx and do not treat lungs! Too small particles (<1 µm) may be exhaled back. Usage: InhalationAPSDQualityChecker.exe → demo mode (console output) InhalationAPSDQualityChecker.exe input.csv output.json → evaluate your data Input format: BatchNumber,LargeParticleMassMcg,FineParticleDoseMcg,MMAD,GSD,TotalRecoveredDoseMcg Example: INHAL-APSD-2026-001,80.0,45.0,2.8,1.8,130.0 — WHY IS THIS NEEDED? For inhalation products (MDI, DPI), treatment efficacy depends on the fraction of dose reaching the lungs. • Impactors (Andersen Cascade Impactor, Next Generation Impactor) separate particles by aerodynamic diameter. • FPD (Fine Particle Dose) is the amount of drug with particle size <5 µm (or <2 µm for alveoli). • MMAD shows the average particle size. Optimal range is 1-5 µm. • GSD shows spray homogeneity. • These parameters are surrogate markers of clinical efficacy and are required by regulators (FDA/EMA). ⚠️ CRITICAL: • FPD must be within strictly established product specification limits. • MMAD must ensure deposition in the target respiratory zone. • Losses in the apparatus must be minimal, and total Recovery should be within 75-125% of labeled dose. • Test is performed at standard airflow (e.g., 60 L/min or 30 L/min depending on inhaler resistance). Key features: • Calculation and verification of FPD, MMAD, GSD. • Assessment of particle profile suitability for lung delivery. • Support for cascade impactor data. Critical parameters: • FPD: Within Specified Range (e.g., 40-50 mcg) • MMAD: Within Specified Range (e.g., 2.5-3.5 µm) • GSD: Typically < 2.5 💡 Usage tips: 1. Use appropriate impactor (ACI or NGI) depending on inhaler type. 2. Calibrate flow meters before each test. 3. Apply silicone coating to impactor cups to prevent particle bounce. 4. Perform at least 3-5 replicates for statistical reliability. 5. Analyze data using log-normal distribution method to calculate MMAD and GSD. ⚠️ Note: APSD does not measure chemical stability, but is a key Physical Critical Quality Attribute (CQA) directly affecting drug bioavailability in the lungs.
input.csv
BatchNumber,LargeParticleMass,FPD,MMAD,GSD,TotalRecovered INHAL-APSD-2026-001,80.0,45.0,2.8,1.8,130.0 INHAL-APSD-2026-002,75.0,42.0,3.0,1.9,125.0 INHAL-FAIL-COARSE-003,120.0,25.0,4.5,2.2,150.0
URS & FS — Inhalation APSD
This document describes the user requirements and functional specification for InhalationAPSDQualityChecker. 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, LargeParticleMass, FPD, MMAD, GSD, TotalRecovered. | High | The CSV file is processed without manual header editing. |
| URS-002 | The utility shall perform deterministic evaluation for “Inhalation APSD” 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 | INHAL-APSD-2026-001 | Input parameter for deterministic QC evaluation. |
| 2 | LargeParticleMass | 80.0 | Input parameter for deterministic QC evaluation. |
| 3 | FPD | 45.0 | Input parameter for deterministic QC evaluation. |
| 4 | MMAD | 2.8 | Input parameter for deterministic QC evaluation. |
| 5 | GSD | 1.8 | Input parameter for deterministic QC evaluation. |
| 6 | TotalRecovered | 130.0 | 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
ENT QC Suite
QC package for ENT: nasal sprays, ear drops, local antiseptics, corticosteroids, antibiotics and upper-airway medicines.
OpenLabEx QC Suite
LabEx package for laboratory QC methods: chromatography, spectroscopy, microbiology, sterility, endotoxins, particles, dissolution, water, cleanrooms and sample preparation.
Open