XRPDPolymorphQualityChecker
XRPD Polymorph
XRPD Polymorph Quality Checker — Polymorph Control (X-Ray Powder Diffraction)
ℹ️ Utility identifies polymorphic form and assesses crystallinity degree of active pharmaceutical ingredients by XRPD:
• Form Identification: Comparison of characteristic peak positions (2-Theta) with reference pattern
• Crystallinity Degree: Percentage of crystalline phase vs amorphous
• Peak Width (FWHM): Indicator of crystallite size and internal strain
• Detection of other polymorph impurities or amorphous phase
⚠️ CRITICAL: Presence of even trace amounts (1-2%) of metastable polymorph can lead to unpredictable changes in solubility, stability, and bioavailability!
Peak shift may indicate formation of solvates or solid solutions.
Usage:
XRPDPolymorphQualityChecker.exe → demo mode (console output)
XRPDPolymorphQualityChecker.exe input.csv output.json → evaluate your data
Input format:
BatchNumber,ProductName,IdentifiedForm,PeakPos1_2Theta,PeakPos2_2Theta,PeakPos3_2Theta,CrystallinityIndex,FWHM_Degrees
Example:
XRPD-2026-API-001,Ritonavir,Form I,12.5,18.2,24.1,98.5,0.15
— WHY IS THIS NEEDED?
Polymorphism is the ability of a substance to exist in different crystal structures.
Different polymorphs have different physicochemical properties (melting point, solubility, density).
For regulatory authorities (FDA, EMA), strict control of polymorphic form is a mandatory condition for drug registration.
⚠️ CRITICAL:
• Identification: At least 3-5 characteristic peaks must match within ±0.1-0.2° 2-Theta tolerance.
• Amorphous Phase: Appears as a "halo" on diffractogram and reduces peak intensity.
• Quantitative Analysis: Rietveld method or PLS regression is required for accurate determination of % impurity of another polymorph.
• Orientation: Preferred orientation effect can distort peak intensities but not their positions.
Key features:
• Polymorphic form identity check
• Crystal lattice quality control (FWHM)
• Overall crystallinity assessment
• Generation of reports for regulatory dossiers and LIMS LabWare
• Compliance with ICH Q6A and Pharmacopoeia requirements
Critical parameters:
• Peak Positions: Strict match with reference
• Identified Form: Strict compliance (e.g., Form I)
• Crystallinity: ≥ 95% (for highly crystalline forms)
• FWHM: ≤ 0.25° (depends on instrument and substance nature)
💡 Usage tips:
1. Sample Preparation: Avoid strong pressing of sample into holder, as it may cause polymorph transition or preferred orientation.
2. Calibration: Use external standard (e.g., silicon or corundum) for 2-Theta angle calibration.
3. Scan Speed: Slow scanning (e.g., 1-2°/min) improves peak resolution and signal-to-noise ratio.
4. Interpretation: If peaks match in position but differ in intensity, check for texture (orientation).
5. Storage: Some polymorphs are hygroscopic or unstable upon heating. Consider sample storage conditions.
⚠️ Note: XRPD is the "gold standard" for polymorph identification. Unlike DSC, it allows distinguishing forms with close melting points and quantitatively assessing amorphous phase.
input.csv
BatchNumber,ProductName,IdentifiedForm,PeakPos1_2Theta,PeakPos2_2Theta,PeakPos3_2Theta,CrystallinityIndex,FWHM_Degrees XRPD-2026-API-001,Ritonavir API,Form I,12.5,18.2,24.1,98.5,0.15 XRPD-2026-API-002,Ritonavir API,Form II,13.1,19.5,25.0,97.0,0.16 XRPD-2026-API-003,Carbamazepine,Form III,15.2,21.0,27.5,99.0,0.12
URS & FS — XRPD Polymorph
This document describes the user requirements and functional specification for XRPDPolymorphQualityChecker. 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, ProductName, IdentifiedForm, PeakPos1_2Theta, PeakPos2_2Theta, PeakPos3_2Theta, CrystallinityIndex, FWHM_Degrees. | High | The CSV file is processed without manual header editing. |
| URS-002 | The utility shall perform deterministic evaluation for “XRPD Polymorph” 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 | XRPD-2026-API-001 | Input parameter for deterministic QC evaluation. |
| 2 | ProductName | Ritonavir API | Input parameter for deterministic QC evaluation. |
| 3 | IdentifiedForm | Form I | Input parameter for deterministic QC evaluation. |
| 4 | PeakPos1_2Theta | 12.5 | Input parameter for deterministic QC evaluation. |
| 5 | PeakPos2_2Theta | 18.2 | Input parameter for deterministic QC evaluation. |
| 6 | PeakPos3_2Theta | 24.1 | Input parameter for deterministic QC evaluation. |
| 7 | CrystallinityIndex | 98.5 | Input parameter for deterministic QC evaluation. |
| 8 | FWHM_Degrees | 0.15 | 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
Dental & 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.
OpenLabEx QC Suite
LabEx package for laboratory QC methods: chromatography, spectroscopy, microbiology, sterility, endotoxins, particles, dissolution, water, cleanrooms and sample preparation.
Open