Polymorph_Screening_NIR_FTIR
Polymorph Screening NIR/FTIR
Utility description: Polymorph Screening NIR/FTIR
Polymorph Screening NIR/FTIR — Identification of Polymorphic Forms (IR/NIR) ℹ️ Utility checks critical parameters of polymorph identification: • Correlation with reference spectrum of form: ≥0.99 • Specificity (difference from nearest form): >0.05 • Presence and position of key spectral peaks ⚠️ CRITICAL: Low specificity → possible form mixture or amorphization! Incorrect polymorphic form can lead to changes in dissolution rate and bioequivalence. Usage: Polymorph_Screening_NIR_FTIR.exe → demo mode (console output) Polymorph_Screening_NIR_FTIR.exe input.csv output.json → evaluate your data Input format: BatchNumber,ExpectedForm,CorrelationExpected,CorrelationNearestNeighbor,KeyPeakPosition,KeyPeakIntensity Example: API-POLY-2026-001,Form_I,0.998,0.850,1650.0,0.8 — WHY IS THIS NEEDED? Many active pharmaceutical ingredients (APIs) exist in various crystalline forms (polymorphs). • Different polymorphs have different physicochemical properties (solubility, melting point, stability). • Regulators (FDA, EMA) require strict control of polymorphic purity as it is a Critical Quality Attribute (CQA). • IR spectroscopy (FTIR) and Near-Infrared spectroscopy (NIR) are rapid, non-destructive methods for form identification. • Lumex InfraLUM instruments allow express analysis of raw materials and finished products. ⚠️ CRITICAL: • Correlation ≥0.99 ensures high similarity to the reference standard of the form. • Difference from the nearest form (Specificity Delta) must be sufficient to exclude misidentification. • Amorphous phase often has broader and less intense peaks, reducing correlation with crystalline reference. • Quantitative assessment of impurity form content requires calibration model (PLS/PCR), not just qualitative screening. Key features: • Rapid screening of polymorphic purity. • Assessment of identification specificity. • Support for FTIR and NIR spectrometer data. Critical parameters: • Correlation to Expected Form: >= 0.99 • Specificity Delta: > 0.05 • Key Peak Presence: Detected 💡 Usage tips: 1. Create a library of reference spectra for all known polymorphs and amorphous form. 2. Use spectral pretreatment methods (SNV, Derivative) to improve peak resolution. 3. Control sample temperature, as some polymorphs are thermolabile. 4. For NIR, account for particle size influence on spectrum (use SNV). 5. If form mixture is detected, confirm result by X-ray Powder Diffraction (XRPD). ⚠️ Note: NIR is more sensitive to physical state (particle size, packing) than FTIR, but allows analysis through transparent packaging, which is convenient for incoming QC.
input.csv
BatchNumber,ExpectedForm,CorrExpected,CorrNeighbor,KeyPeakPos,KeyPeakInt API-POLY-2026-001,Form_I,0.998,0.850,1650.0,0.8 API-POLY-2026-002,Form_II,0.995,0.920,1665.0,0.75 API-FAIL-MIX-003,Form_I,0.950,0.940,1650.0,0.6
Utility description
Polymorph Screening NIR/FTIR — Identification of Polymorphic Forms (IR/NIR) ℹ️ Utility checks critical parameters of polymorph identification: • Correlation with reference spectrum of form: ≥0.99 • Specificity (difference from nearest form): >0.05 • Presence and position of key spectral peaks ⚠️ CRITICAL: Low specificity → possible form mixture or amorphization! Incorrect polymorphic form can lead to changes in dissolution rate and bioequivalence. Usage: Polymorph_Screening_NIR_FTIR.exe → demo mode (console output) Polymorph_Screening_NIR_FTIR.exe input.csv output.json → evaluate your data Input format: BatchNumber,ExpectedForm,CorrelationExpected,CorrelationNearestNeighbor,KeyPeakPosition,KeyPeakIntensity Example: API-POLY-2026-001,Form_I,0.998,0.850,1650.0,0.8 — WHY IS THIS NEEDED? Many active pharmaceutical ingredients (APIs) exist in various crystalline forms (polymorphs). • Different polymorphs have different physicochemical properties (solubility, melting point, stability). • Regulators (FDA, EMA) require strict control of polymorphic purity as it is a Critical Quality Attribute (CQA). • IR spectroscopy (FTIR) and Near-Infrared spectroscopy (NIR) are rapid, non-destructive methods for form identification. • Lumex InfraLUM instruments allow express analysis of raw materials and finished products. ⚠️ CRITICAL: • Correlation ≥0.99 ensures high similarity to the reference standard of the form. • Difference from the nearest form (Specificity Delta) must be sufficient to exclude misidentification. • Amorphous phase often has broader and less intense peaks, reducing correlation with crystalline reference. • Quantitative assessment of impurity form content requires calibration model (PLS/PCR), not just qualitative screening. Key features: • Rapid screening of polymorphic purity. • Assessment of identification specificity. • Support for FTIR and NIR spectrometer data. Critical parameters: • Correlation to Expected Form: >= 0.99 • Specificity Delta: > 0.05 • Key Peak Presence: Detected 💡 Usage tips: 1. Create a library of reference spectra for all known polymorphs and amorphous form. 2. Use spectral pretreatment methods (SNV, Derivative) to improve peak resolution. 3. Control sample temperature, as some polymorphs are thermolabile. 4. For NIR, account for particle size influence on spectrum (use SNV). 5. If form mixture is detected, confirm result by X-ray Powder Diffraction (XRPD). ⚠️ Note: NIR is more sensitive to physical state (particle size, packing) than FTIR, but allows analysis through transparent packaging, which is convenient for incoming QC.
URS & FS — User Requirements and Functional Specification
This document describes the controlled interface, user requirements and functional behaviour of Polymorph_Screening_NIR_FTIR. The utility is intended for automated verification of laboratory, pharmacopoeial, analytical or manufacturing QC parameters using input.csv and producing a structured output.json result.
Domain limits and critical parameters
- • Correlation with reference spectrum of form: ≥0.99
- • Specificity (difference from nearest form): >0.05
- • Presence and position of key spectral peaks
- • Different polymorphs have different physicochemical properties (solubility, melting point, stability).
- • Regulators (FDA, EMA) require strict control of polymorphic purity as it is a Critical Quality Attribute (CQA).
- • IR spectroscopy (FTIR) and Near-Infrared spectroscopy (NIR) are rapid, non-destructive methods for form identification.
- • Lumex InfraLUM instruments allow express analysis of raw materials and finished products.
- • Correlation ≥0.99 ensures high similarity to the reference standard of the form.
- • Difference from the nearest form (Specificity Delta) must be sufficient to exclude misidentification.
- • Amorphous phase often has broader and less intense peaks, reducing correlation with crystalline reference.
- • Quantitative assessment of impurity form content requires calibration model (PLS/PCR), not just qualitative screening.
- • Rapid screening of polymorphic purity.
- • Assessment of identification specificity.
- • Support for FTIR and NIR spectrometer data.
- • Correlation to Expected Form: >= 0.99
- • Specificity Delta: > 0.05
URS — User Requirements Specification
| ID | Requirement | Criticality | Acceptance criterion |
|---|---|---|---|
| URS-001 | The utility shall accept an input.csv file with exact headers defined in the data contract. | High | The file is processed without manual header editing. |
| URS-002 | The utility shall perform deterministic evaluation for Polymorph Screening NIR/FTIR using input values, approved limits and domain rules. | High | Each row receives a PASS / WARNING / FAIL status. |
| URS-003 | The utility shall validate mandatory fields, data types, numeric ranges, units and domain plausibility. | High | Schema, format and conversion errors are explicitly reported. |
| URS-004 | The utility shall identify critical deviations for parameters stated in the method description and specification. | High | A critical deviation causes FAIL or a dedicated critical finding. |
| URS-005 | The utility shall generate output.json with machine-readable results, source values, warnings and failures. | High | JSON is suitable for LIMS/ELN/MES integration, QA/QC review and archival. |
| URS-006 | The result shall not depend on machine learning or undocumented heuristics. | Medium | All decisions are based on explicit rules, thresholds and input values. |
| URS-007 | The system shall preserve traceability between batch/sample, input data, applied rules and final status. | High | The output contains the batch/sample identifier and checked parameters. |
| URS-008 | The documentation shall support IQ/OQ/PQ preparation and inspection discussion. | Medium | URS, FS, CSV/JSON contract and test scenarios are supplied with the utility. |
| URS-009 | The utility shall support batch processing of multiple input.csv rows. | Medium | Each row is evaluated independently; errors in one row do not mask errors in others. |
| URS-010 | The utility shall support a simple operating model: demo mode and execution with input/output files. | Medium | The CLI scenario is reproducible in test and production environments. |
input.csv contract
| # | Field | Type | Sample | Purpose |
|---|---|---|---|---|
| 1 | BatchNumber | string | API-POLY-2026-001 | Batch or lot identifier used for traceability, review and deviation investigation. |
| 2 | ExpectedForm | string / decimal | Form_I | Controlled input parameter used by deterministic QC rules and traceable result generation. |
| 3 | CorrExpected | string / decimal | 0.998 | Controlled input parameter used by deterministic QC rules and traceable result generation. |
| 4 | CorrNeighbor | string / decimal | 0.850 | Controlled input parameter used by deterministic QC rules and traceable result generation. |
| 5 | KeyPeakPos | string / decimal | 1650.0 | Controlled input parameter used by deterministic QC rules and traceable result generation. |
| 6 | KeyPeakInt | string / decimal | 0.8 | Controlled input parameter used by deterministic QC rules and traceable result generation. |
BatchNumber,ExpectedForm,CorrExpected,CorrNeighbor,KeyPeakPos,KeyPeakInt API-POLY-2026-001,Form_I,0.998,0.850,1650.0,0.8 API-POLY-2026-002,Form_II,0.995,0.920,1665.0,0.75 API-FAIL-MIX-003,Form_I,0.950,0.940,1650.0,0.6
FS — Functional Specification
| ID | Function | Implementation |
|---|---|---|
| FS-001 | CSV import | Read input.csv in UTF-8/CSV-compatible format and validate the header and expected columns. |
| FS-002 | Schema validation | Check mandatory fields, column count, critical missing values and row structure. |
| FS-003 | Type conversion | Convert numeric, flag and text values; invalid formats are recorded as row-level errors. |
| FS-004 | Domain rule engine | Apply domain rules for Polymorph Screening NIR/FTIR, including limits from the utility description and approved specification. |
| FS-005 | Status aggregation | Produce final status: FAIL for critical failure, WARNING for non-critical deviation, PASS for conformance. |
| FS-006 | JSON export | Write output.json with detailed checks, source values, warnings, failures and critical findings. |
| FS-007 | Audit support | Keep the result structure suitable for review, deviation investigation, calculation reproduction and IQ/OQ/PQ preparation. |
| FS-008 | Integration contract | Support the production scenario: LIMS/ELN/MES creates input.csv, the utility returns output.json, and the portal displays description and documentation. |
| FS-009 | Error handling | Report errors unambiguously and do not substitute missing values with calculated values unless the rule is explicitly defined. |
| FS-010 | Version control support | Document the utility version, input contract, executable checksum and rule application date. |
Example output.json
{
"utilityId": "polymorph-screening-nir-ftir",
"utilityName": "Polymorph_Screening_NIR_FTIR",
"overallStatus": "PASS|WARNING|FAIL",
"sourceFile": "input.csv",
"checks": [
{
"parameter": "BatchNumber",
"value": "API-POLY-2026-001",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "ExpectedForm",
"value": "Form_I",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "CorrExpected",
"value": "0.998",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "CorrNeighbor",
"value": "0.850",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "KeyPeakPos",
"value": "1650.0",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "KeyPeakInt",
"value": "0.8",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
}
],
"criticalFindings": [],
"warnings": [],
"generatedFor": "QA/QC review and LIMS integration"
}
Traceability matrix
| URS | FS | OQ/PQ coverage |
|---|---|---|
| URS-001, URS-003 | FS-001, FS-002, FS-003 | OQ-001/OQ-002/OQ-003 |
| URS-002, URS-004 | FS-004, FS-005 | OQ-004/PQ-001 |
| URS-005, URS-007 | FS-006, FS-007 | OQ-005/PQ-002 |
| URS-008, URS-010 | FS-008, FS-010 | IQ-001/OQ-006 |
OQ/PQ test scenarios
| ID | Scenario | Expected result |
|---|---|---|
| OQ-001 | Valid sample row | PASS or acceptable WARNING according to the rules. |
| OQ-002 | Mandatory column missing | Schema error or FAIL. |
| OQ-003 | Non-numeric value in numeric field | Type-conversion error. |
| OQ-004 | Critical parameter outside limit | FAIL and critical finding. |
| OQ-005 | Multiple rows with different statuses | Independent row-level evaluation. |
| PQ-001 | User real batch/sample | Reviewed result with retained input/output files. |
QA/QC and change control
- Do not rename columns without updating the validator, documentation and test set.
- Retain
input.csv,output.json, executable version, documentation and checksum. - Before production use, perform IQ/OQ/PQ or equivalent CSV/CSA verification.
- Critical limits must be verified against the approved specification, local SOPs and registration dossier.
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.
OpenLumex QC Suite
A single Lumex package combining the former Lumex and Lumex2 sets: instrumental and general pharmaceutical QC, AAS/ICP, CE, HPLC, NIR/PAT, stability, dissolution, content uniformity, system suitability and statistical control.
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.
Open