NMRStructureQualityChecker
NMR Structure
NMR Structure Quality Checker — Control of NMR Spectrum Quality ℹ️ Utility checks critical parameters of Nuclear Magnetic Resonance spectra quality (USP <761> / Ph. Eur. 2.2.33): • Signal-to-Noise Ratio (S/N): ≥150:1 (for quantitative analysis) • Resolution: ≤0.55 Hz (at half height) • Linewidth: ≤1.0 Hz (at 0.55% height, shimming indicator) • Shift Calibration: standard deviation ≤0.01 ppm ⚠️ CRITICAL: Poor shimming (broad peaks) makes multiplet separation and accurate integration impossible! Low S/N hides minor impurities or spin-spin coupling. Usage: NMRStructureQualityChecker.exe → demo mode (console output) NMRStructureQualityChecker.exe input.csv output.json → evaluate your data Input format: BatchNumber,SignalToNoiseRatio,ResolutionHz,Linewidth055Hz,ReferenceShiftDeviation,PhaseCorrectionScore Example: NMR-STR-2026-001,250.0,0.45,0.8,0.002,98.0 — WHY IS THIS NEEDED? NMR is the most informative method for confirming structure of organic molecules and APIs. • Spectrum quality directly affects reliability of structure elucidation and quantitative calculations (qNMR). • Resolution and linewidth parameters reflect magnetic field homogeneity (shimming quality). • S/N determines impurity detection limit and signal integration reliability. • Automation of QC parameter check allows operator to immediately re-acquire spectrum if poor, saving time. ⚠️ CRITICAL: • Shimming must be optimized before each measurement. • Sample temperature must stabilize before acquisition. • Sample concentration must be sufficient for good S/N without detector saturation. • Solvent must be high-quality deuterated. Key features: • Assessment of spectrum suitability for structural identification. • Control of instrument technical parameters (magnet, probe). • Support for Bruker, Jeol, Agilent spectrometer data. Critical parameters: • S/N Ratio: >= 150 • Resolution: <= 0.55 Hz • Linewidth (0.55%): <= 1.0 Hz • Reference Shift: <= 0.01 ppm 💡 Usage tips: 1. Use standard sample (e.g., ethylbenzene in CDCl3) for daily resolution and sensitivity check. 2. Monitor cryogen levels (liquid nitrogen/helium) in magnet. 3. Avoid paramagnetic impurities (oxygen, metals) which broaden peaks. 4. For quantitative NMR (qNMR), use sufficient relaxation delay (D1 >= 5*T1). 5. Check phase and baseline correction before integration. ⚠️ Note: NMR requires high stability of external conditions. Vibrations and temperature fluctuations in the lab can significantly degrade spectrum resolution.
input.csv
BatchNumber,SN_Ratio,Resolution_Hz,Linewidth_055_Hz,RefShift_Dev_ppm,Phase_Score NMR-STR-2026-001,250.0,0.45,0.8,0.002,98.0 NMR-STR-2026-002,180.0,0.50,0.9,0.005,95.0 NMR-FAIL-SHIM-003,120.0,1.20,2.5,0.001,90.0
URS & FS — NMR Structure
This document describes the user requirements and functional specification for NMRStructureQualityChecker. 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, SN_Ratio, Resolution_Hz, Linewidth_055_Hz, RefShift_Dev_ppm, Phase_Score. | High | The CSV file is processed without manual header editing. |
| URS-002 | The utility shall perform deterministic evaluation for “NMR Structure” 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 | NMR-STR-2026-001 | Input parameter for deterministic QC evaluation. |
| 2 | SN_Ratio | 250.0 | Input parameter for deterministic QC evaluation. |
| 3 | Resolution_Hz | 0.45 | Input parameter for deterministic QC evaluation. |
| 4 | Linewidth_055_Hz | 0.8 | Input parameter for deterministic QC evaluation. |
| 5 | RefShift_Dev_ppm | 0.002 | Input parameter for deterministic QC evaluation. |
| 6 | Phase_Score | 98.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
Immunology QC Suite
QC utility package for immunology: monoclonal antibodies, biosimilars, immunomodulators, immunosuppressants, ELISA/SPR, HCP, protein characterization, sterility and pyrogen/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