LCMSConfirmationQualityChecker
LC-MS Confirmation
LC-MS Confirmation Quality Checker — Structural Confirmation by LC-MS ℹ️ Utility checks critical parameters of substance identification by High Resolution Mass Spectrometry (HRMS): • Mass Error: ≤5.0 ppm • Isotope Pattern Match: ≥90.0% • Spectral Purity: ≥0.95 ⚠️ CRITICAL: Large mass deviation (>5 ppm) indicates incorrect elemental formula! Low spectral purity may indicate presence of co-eluting impurities. Usage: LCMSConfirmationQualityChecker.exe → demo mode (console output) LCMSConfirmationQualityChecker.exe input.csv output.json → evaluate your data Input format: BatchNumber,ObservedMass,TheoreticalMass,MassErrorPPM,IsotopeRatioMatchPercent,SpectralPurityScore Example: LCMS-CONF-2026-001,325.1234,325.1230,1.2,98.5,0.99 — WHY IS THIS NEEDED? LC-MS is the gold standard for confirming structure of Active Pharmaceutical Ingredients (APIs) and identifying unknown impurities. • High mass accuracy allows determination of elemental composition with high probability. • Isotope pattern (distribution of C13, N15, Cl37, etc.) is a unique "fingerprint" of the molecule. • Required by regulators (ICH Q3A, Q3B) for characterization of impurities above identification threshold. • Automation of criteria check eliminates subjectivity in interpreting complex spectra. ⚠️ CRITICAL: • Mass spectrometer calibration must be performed before each analysis series. • Accurate mass alone is insufficient for confident identification; isotope distribution match is required. • Co-elution can distort mass spectrum and lead to false conclusions. • Use of high-resolution instruments (QTOF, Orbitrap) is mandatory to achieve <5 ppm accuracy. Key features: • Verification of mass accuracy in ppm. • Assessment of theoretical vs experimental isotope pattern match. • Spectrum quality (purity) control. Critical parameters: • Mass Error: <= 5.0 ppm • Isotope Match: >= 90.0% • Spectral Purity: >= 0.95 💡 Usage tips: 1. Use internal standards to correct for mass drift over time. 2. Optimize collision energy (CID) to obtain informative fragments (MS/MS). 3. Check for adducts (Na, K, Formate) when interpreting spectra. 4. Use high-resolution chromatographic separation for complex matrices. 5. Save raw data (.raw/.d) for future reprocessing capabilities. ⚠️ Note: Unlike UV detection, MS provides information about mass and structure, allowing identification of substances without reference standards (when using mass spectral libraries).
input.csv
BatchNumber,ObservedMass,TheoreticalMass,MassErrorPPM,IsoMatch%,PurityScore LCMS-CONF-2026-001,325.1234,325.1230,1.2,98.5,0.99 LCMS-CONF-2026-002,450.2100,450.2095,1.1,97.0,0.98 LCMS-FAIL-2026-003,325.1500,325.1230,83.0,85.0,0.90
URS & FS — LC-MS Confirmation
This document describes the user requirements and functional specification for LCMSConfirmationQualityChecker. 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, ObservedMass, TheoreticalMass, MassErrorPPM, IsoMatch%, PurityScore. | High | The CSV file is processed without manual header editing. |
| URS-002 | The utility shall perform deterministic evaluation for “LC-MS Confirmation” 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 | LCMS-CONF-2026-001 | Input parameter for deterministic QC evaluation. |
| 2 | ObservedMass | 325.1234 | Input parameter for deterministic QC evaluation. |
| 3 | TheoreticalMass | 325.1230 | Input parameter for deterministic QC evaluation. |
| 4 | MassErrorPPM | 1.2 | Input parameter for deterministic QC evaluation. |
| 5 | IsoMatch% | 98.5 | Input parameter for deterministic QC evaluation. |
| 6 | PurityScore | 0.99 | 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
Addiction Medicine & Controlled Substances QC Suite
QC utility package for addiction medicine and regulated medicinal products: addiction-treatment medicines, opioids, benzodiazepines, stimulants, sedatives, volatile impurities, assay/identity/dissolution/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.
OpenInfectious Diseases QC Suite
QC utility package for infectious diseases: antibacterial, antiviral, antifungal and antiparasitic products, microbiology, sterility, endotoxins, viral safety and vaccine release checks.
OpenLabEx QC Suite
LabEx package for laboratory QC methods: chromatography, spectroscopy, microbiology, sterility, endotoxins, particles, dissolution, water, cleanrooms and sample preparation.
OpenRadiology QC Suite
QC package for radiology and diagnostic imaging: radiopharmaceuticals, PET/SPECT, contrast media, iodinated and gadolinium products, plus particle, sterility and endotoxin checks.
OpenToxicology QC Suite
QC utility package for toxicologically relevant risks: genotoxic impurities, residual solvents, elemental impurities, heavy metals, mercury, mycotoxins, pesticides, extractables/leachables and degradation impurities.
Open