LCMSConfirmationQualityChecker

LC-MS Confirmation

LabEx laboratory QC CSV→JSON URS & FS chromatography elemental impurities spectroscopy utilities / cleanroom
Open selection
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

IDRequirementCriticalityAcceptance criterion
URS-001The utility shall accept input.csv with approved columns: BatchNumber, ObservedMass, TheoreticalMass, MassErrorPPM, IsoMatch%, PurityScore.HighThe CSV file is processed without manual header editing.
URS-002The utility shall perform deterministic evaluation for “LC-MS Confirmation” without machine learning.HighThe same input data produce the same JSON result.
URS-003The utility shall validate mandatory fields, numeric formats, flags, ranges and domain plausibility.HighSchema and conversion errors are explicitly reported.
URS-004The utility shall generate output.json with PASS / WARNING / FAIL statuses, source values, warnings and failures.HighThe JSON result is suitable for review, deviation investigation and integration.
URS-005The documentation shall support IQ/OQ/PQ or CSV/CSA verification.MediumURS/FS, CSV/JSON contract and test scenarios are supplied with the utility.

input.csv contract

#FieldSamplePurpose
1BatchNumberLCMS-CONF-2026-001Input parameter for deterministic QC evaluation.
2ObservedMass325.1234Input parameter for deterministic QC evaluation.
3TheoreticalMass325.1230Input parameter for deterministic QC evaluation.
4MassErrorPPM1.2Input parameter for deterministic QC evaluation.
5IsoMatch%98.5Input parameter for deterministic QC evaluation.
6PurityScore0.99Input parameter for deterministic QC evaluation.

FS — Functional Specification

IDFunctionImplementation
FS-001CSV importRead input.csv; validate header, column count and encoding.
FS-002Schema validationCheck required fields and permitted input values.
FS-003Rule engineApply domain rules, limits and system suitability/specification checks described in the source utility description.
FS-004Status aggregationProduce final status: FAIL for critical failure, WARNING for non-critical deviation, PASS for conformance.
FS-005JSON exportWrite 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 FAIL or 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.

Open

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.

Open

Infectious Diseases QC Suite

QC utility package for infectious diseases: antibacterial, antiviral, antifungal and antiparasitic products, microbiology, sterility, endotoxins, viral safety and vaccine release checks.

Open

LabEx QC Suite

LabEx package for laboratory QC methods: chromatography, spectroscopy, microbiology, sterility, endotoxins, particles, dissolution, water, cleanrooms and sample preparation.

Open

Radiology QC Suite

QC package for radiology and diagnostic imaging: radiopharmaceuticals, PET/SPECT, contrast media, iodinated and gadolinium products, plus particle, sterility and endotoxin checks.

Open

Toxicology 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