OsmolalityQualityChecker
Osmolality
Osmolality Quality Checker — Control of Solution Osmolality ℹ️ Utility checks compliance of osmolality with specified limits (USP <785> / Ph. Eur. 2.2.35): • Measured value must be within [Lower Limit – Upper Limit]. • Typical ranges: 280–310 mOsm/kg (isotonic solutions). ⚠️ CRITICAL: Hypo- or hyper-osmolar solutions can be dangerous to the patient! Injections with incorrect osmolality cause hemolysis, pain, or phlebitis. Usage: OsmolalityQualityChecker.exe → demo mode (console output) OsmolalityQualityChecker.exe input.csv output.json → evaluate your data Input format: BatchNumber,MeasuredOsmolality,LowerLimit,UpperLimit Example: OSMO-INJ-2026-001,295.0,280.0,310.0 — WHY IS THIS NEEDED? Osmolality is a critical quality attribute for parenteral, ophthalmic, and nasal products. • Determines solution tonicity relative to blood plasma. • Measured by freezing point depression (cryoscopy) or vapor pressure methods. • USP <785> and Ph. Eur. 2.2.35 regulate measurement methods. • Control is necessary to ensure patient safety and comfort during drug administration. ⚠️ CRITICAL: • For injectables, osmolality should be close to physiological (~290 mOsm/kg). • High osmolality (>1000 mOsm/kg) requires administration only into large veins. • Osmometer calibration must be performed daily using standard solutions (NaCl). • Sample must be free of air bubbles. Key features: • Rapid specification compliance check. • Support for cryoscopic osmometer data. • Generation of PASS/FAIL status for LIMS. Critical parameters: • Measured Osmolality: Within [LL - UL] 💡 Usage tips: 1. Thoroughly mix sample before measurement. 2. Use clean tubes to exclude contamination. 3. Check freezing point of pure solvent (water) before series. 4. Account for influence of volatile components (alcohols) on result. 5. For viscous samples, ensure complete thermostating. ⚠️ Note: Osmolality (mOsm/kg) depends on the number of dissolved solute particles and not their nature, unlike osmolarity (mOsm/L), which depends on volume and temperature.
input.csv
BatchNumber,MeasuredOsmolality,LowerLimit,UpperLimit OSMO-INJ-2026-001,295.0,280.0,310.0 OSMO-EYE-2026-001,305.0,250.0,350.0 OSMO-FAIL-HYPO-001,260.0,280.0,310.0
URS & FS — Osmolality
This document describes the user requirements and functional specification for OsmolalityQualityChecker. 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, MeasuredOsmolality, LowerLimit, UpperLimit. | High | The CSV file is processed without manual header editing. |
| URS-002 | The utility shall perform deterministic evaluation for “Osmolality” 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 | OSMO-INJ-2026-001 | Input parameter for deterministic QC evaluation. |
| 2 | MeasuredOsmolality | 295.0 | Input parameter for deterministic QC evaluation. |
| 3 | LowerLimit | 280.0 | Input parameter for deterministic QC evaluation. |
| 4 | UpperLimit | 310.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
Biopharmaceuticals Extended QC Suite
Extended QC utility coverage for mAbs, biosimilars, proteins, insulins, vaccines, mRNA/LNP, HCP, sterile release, microbiology, water, cleanroom and stability workflows.
OpenDental & 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.
OpenENT 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.
OpenNeurology QC Suite
QC package for neurology and neuropsychiatry: antiepileptics, antiparkinsonian medicines, antidepressants, antipsychotics, analgesics and neurological diagnostic radiopharmaceuticals.
OpenOphthalmology QC Suite
QC package for ophthalmology: eye drops, antiglaucoma agents, antibiotics, sterile solutions, osmolality, pH, particles and preservatives.
Open