XRPDPolymorphQualityChecker

XRPD Polymorph

LabEx laboratory QC CSV→JSON URS & FS utilities / cleanroom
Open selection

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

IDRequirementCriticalityAcceptance criterion
URS-001The utility shall accept input.csv with approved columns: BatchNumber, ProductName, IdentifiedForm, PeakPos1_2Theta, PeakPos2_2Theta, PeakPos3_2Theta, CrystallinityIndex, FWHM_Degrees.HighThe CSV file is processed without manual header editing.
URS-002The utility shall perform deterministic evaluation for “XRPD Polymorph” 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
1BatchNumberXRPD-2026-API-001Input parameter for deterministic QC evaluation.
2ProductNameRitonavir APIInput parameter for deterministic QC evaluation.
3IdentifiedFormForm IInput parameter for deterministic QC evaluation.
4PeakPos1_2Theta12.5Input parameter for deterministic QC evaluation.
5PeakPos2_2Theta18.2Input parameter for deterministic QC evaluation.
6PeakPos3_2Theta24.1Input parameter for deterministic QC evaluation.
7CrystallinityIndex98.5Input parameter for deterministic QC evaluation.
8FWHM_Degrees0.15Input 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

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.

Open

LabEx QC Suite

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

Open