NIR_Blend_Uniformity_Checker

NIR Blend Uniformity Checker

Lumex QC URS & FS input.csv output.json rule-based LIMS-ready NIR
Open selection

Utility description: NIR Blend Uniformity Checker

NIR Blend Uniformity Checker — Assessment of Blend Homogeneity via Near-Infrared Spectroscopy

ℹ️  Utility checks critical parameters of powder blend homogeneity:
   • Mean API Content: 95.0–105.0%
   • Relative Standard Deviation (RSD): ≤5.0%
   • Maximum single point deviation: ≤10.0%
   • Minimum number of scans/samples: ≥30

⚠️  CRITICAL: RSD >5.0% → blend is non-homogeneous! Risk of segregation during tableting.
   Large maximum deviation → presence of "pockets" of pure API or excipient.

Usage:
 NIR_Blend_Uniformity_Checker.exe                            → demo mode (console output)
 NIR_Blend_Uniformity_Checker.exe input.csv output.json      → evaluate your data

Input format:
BatchNumber,MeanContentPercent,StdDevPercent,NumberOfScans,MaxDeviationPercent,RSD_Percent

Example:
 BLEND-NIR-2026-001,100.2,1.5,60,4.5,1.5

— WHY IS THIS NEEDED?
Blend Uniformity control is a key step before tableting or encapsulation.
• NIR allows in-line or at-line analysis without sampling (non-destructive).
• Scanning multiple points (mapping) provides a statistically significant picture of API distribution.
• Early detection of non-uniformity prevents scrapping the entire tablet batch.
• Compliance with ASTM E2709 / ASTM E2810 and USP <1033>.

⚠️  CRITICAL:
• RSD ≤5.0% — generally accepted criterion for good homogeneity in dry blends.
• Mean content must match formulation (Target 100%).
• Maximum Deviation (Max Dev) shows the worst point in the blender. If high, local segregation exists.
• Number of scans (N) ≥30 is necessary for representativeness across the blender volume.

Key features:
• Statistical analysis of API distribution in blender volume.
• Automatic RSD calculation and outlier check.
• Support for PAT (Process Analytical Technology) processes.

Critical parameters:
• Mean API Content: 95.0–105.0%
• RSD: ≤5.0%
• Max Deviation: ≤10.0%
• Number of Scans: ≥30

💡 Usage tips:
1. Use an NIR probe immersed in the blender or scan through a view window.
2. Perform scanning at different rotation phases to exclude temporal fluctuations.
3. If RSD is high, increase blending time and re-analyze.
4. Calibration model should be built on blends with varied API content.
5. Account for powder bulk density effects on spectrum (use MSC or SNV spectral pretreatment).

⚠️ Note: NIR is sensitive to the powder surface. If segregation by particle size occurs (large particles float), NIR may show false non-uniformity. It is important to combine with particle size distribution data.

input.csv

BatchNumber,Mean%,StdDev,N,MaxDev,RSD%
BLEND-NIR-2026-001,100.2,1.5,60,4.5,1.5
BLEND-NIR-2026-002,99.8,2.1,45,6.2,2.1
BLEND-FAIL-2026-003,101.0,6.5,30,18.0,6.5

URS & FS — User Requirements and Functional Specification

This document defines the controlled interface, validation behaviour and expected output of NIR_Blend_Uniformity_Checker. The document is intended to reside inside the utility folder together with input.csv and the description file. Expected executable: NIR_Blend_Uniformity_Checker.exe.

Purpose: the utility performs deterministic verification of QC input data against approved limits, generates machine-readable output.json, and supports QC/QA review, LIMS/ELN/MES integration and CSV/CSA preparation.

Scope

Utility classIR spectroscopy / InfraLUM
Main object/methodAssessment of Blend Homogeneity via Near-Infrared Spectroscopy
Inputinput.csv with a fixed header and controlled data types.
Outputoutput.json with PASS, WARNING, FAIL statuses, detailed checks and critical findings.
ExclusionsThe utility does not replace the approved specification, analytical procedure, OOS/OOT investigation or Qualified Person / QA release decision.

Domain limits and critical parameters

Key fragments from the source description are listed below. Before production use, limits shall be verified against the approved specification, registration dossier, current pharmacopoeial edition and local SOPs.
  • • Mean API Content: 95.0–105.0%
  • • Relative Standard Deviation (RSD): ≤5.0%
  • • Maximum single point deviation: ≤10.0%
  • • Minimum number of scans/samples: ≥30
  • ⚠️ CRITICAL: RSD >5.0% → blend is non-homogeneous! Risk of segregation during tableting.
  • NIR_Blend_Uniformity_Checker.exe input.csv output.json → evaluate your data
  • BatchNumber,MeanContentPercent,StdDevPercent,NumberOfScans,MaxDeviationPercent,RSD_Percent
  • • NIR allows in-line or at-line analysis without sampling (non-destructive).
  • • Scanning multiple points (mapping) provides a statistically significant picture of API distribution.
  • • Early detection of non-uniformity prevents scrapping the entire tablet batch.
  • • Compliance with ASTM E2709 / ASTM E2810 and USP <1033>.
  • ⚠️ CRITICAL:
  • • RSD ≤5.0% — generally accepted criterion for good homogeneity in dry blends.
  • • Mean content must match formulation (Target 100%).
  • • Maximum Deviation (Max Dev) shows the worst point in the blender. If high, local segregation exists.
  • • Number of scans (N) ≥30 is necessary for representativeness across the blender volume.

Pharmacopoeial and regulatory references found in the description

#SourceNote
1USP <1033>Used as a source/context reference from the description; the current edition must be verified before implementation.

Production data flow

StepResponsible objectDescriptionControl
1LIMS/ELN/MES or QC analystCreates input.csv with measured values and batch identifier.Header, mandatory-field and unit checks.
2NIR_Blend_Uniformity_CheckerLoads CSV, converts data types, applies domain rules and produces the result.Deterministic rules; no ML/probabilistic conformance decision.
3QC reviewer / QAReviews output.json, warnings, critical deviations and source values.Review, deviation investigation and data-trail retention.
4Archive / eQMSRetains input, output, utility version, documentation and checksum.Data integrity: ALCOA+, reproducibility and change control.

URS — User Requirements Specification

IDRequirementCriticalityAcceptance criterion
URS-001The utility shall be supplied with NIR_Blend_Uniformity_Checker.documentation.html in the same folder as the description and sample input.csv.MediumThe documentation file exists in the NIR_Blend_Uniformity_Checker folder and opens locally in a browser.
URS-002The utility shall accept input.csv with the exact headers defined in the data contract.HighA CSV file with the correct header is processed without manual editing.
URS-003The utility shall validate mandatory fields, column count, data types and basic plausibility of values.HighSchema and conversion errors are explicitly reported.
URS-004The utility shall evaluate each critical and non-critical QC parameter against approved limits.HighEach checked parameter receives a status and explanatory message.
URS-005The utility shall produce a final record/batch status: PASS, WARNING or FAIL.HighA critical deviation causes FAIL; a non-critical deviation causes WARNING.
URS-006The utility shall generate output.json suitable for LIMS/ELN/MES integration and QA/QC review.HighJSON contains source values, rules, statuses, warnings and critical findings.
URS-007The utility shall preserve traceability between batch identifier, input values, applied rules and final status.HighThe output contains the batch/row identifier and list of checked parameters.
URS-008The utility shall not use machine learning or probabilistic interpretation for conformance decisions.MediumThe result is reproducible and based on explicit rules, thresholds and input values.
URS-009The utility shall support the CLI scenario: NIR_Blend_Uniformity_Checker.exe input.csv output.json.HighWith valid arguments, output.json is created; on error, a diagnostic message is returned.
URS-010The documentation shall support IQ/OQ/PQ or equivalent CSV/CSA verification.MediumThe document contains URS, FS, CSV contract, rules, test scenarios and traceability.
URS-011The utility shall distinguish data errors, method warnings and critical specification failures.Highoutput.json provides separate structures/fields for errors, warnings and critical findings.
URS-012The utility shall support archival retention of unchanged input and output data.Mediuminput.csv and output.json can be retained as a batch record or OQ/PQ evidence.

input.csv contract

#FieldTypeSamplePurpose
1BatchNumberstringBLEND-NIR-2026-001Batch or lot identifier used for traceability.
2Mean%decimal100.2Controlled input parameter used by the deterministic QC rules.
3StdDevdecimal1.5Controlled input parameter used by the deterministic QC rules.
4Ndecimal60Controlled input parameter used by the deterministic QC rules.
5MaxDevdecimal4.5Controlled input parameter used by the deterministic QC rules.
6RSD%decimal1.5Precision/repeatability parameter.
BatchNumber,Mean%,StdDev,N,MaxDev,RSD%
BLEND-NIR-2026-001,100.2,1.5,60,4.5,1.5
BLEND-NIR-2026-002,99.8,2.1,45,6.2,2.1
BLEND-FAIL-2026-003,101.0,6.5,30,18.0,6.5

Input validation rules

IDFieldTypeCheckCriticality
VR-001BatchNumberstringnot empty; unique within file where applicableMedium
VR-002Mean%decimalparse as invariant decimal; finite value; no NaN/Infinity; evaluate against approved numerical limitMedium
VR-003StdDevdecimalparse as invariant decimal; finite value; no NaN/Infinity; evaluate against approved numerical limitMedium
VR-004Ndecimalparse as invariant decimal; finite value; no NaN/Infinity; evaluate against approved numerical limitMedium
VR-005MaxDevdecimalparse as invariant decimal; finite value; no NaN/Infinity; evaluate against approved numerical limitMedium
VR-006RSD%decimalparse as invariant decimal; finite value; no NaN/Infinity; evaluate against approved numerical limitMedium

FS — Functional Specification

IDFunctionImplementationURS link
FS-001Local HTML documentationProvide a bilingual NIR_Blend_Uniformity_Checker.documentation.html file with RU/EN switch, source description, URS, FS, contracts and tests.URS-001, URS-010
FS-002CSV importRead input.csv in UTF-8/CSV-compatible format and identify the header row and data records.URS-002, URS-009
FS-003Schema validationCompare actual columns against the expected contract; missing key fields are recorded as schema errors.URS-002, URS-003
FS-004Type conversionConvert decimal, flag/boolean and controlled string values. Invalid values are recorded at row and field level.URS-003
FS-005Domain rule engineApply rules for NIR Blend Uniformity Checker, including critical limits from the description and approved specification.URS-004, URS-008
FS-006Status aggregationAggregate parameter statuses: FAIL for critical failure, WARNING for non-critical deviation, PASS for conformance.URS-005, URS-011
FS-007JSON exportWrite output.json with utility identifier, source values, check results, warnings and critical findings.URS-006, URS-007
FS-008Error handlingSeparate execution errors, schema errors, conversion errors and domain-limit failures.URS-003, URS-011
FS-009Audit supportKeep result structure suitable for review, OOS/OOT investigation, calculation reproduction and inspection discussion.URS-007, URS-012
FS-010Integration contractSupport the standard scenario: LIMS/ELN/MES creates input.csv, the utility returns output.json, and the portal displays description and documentation.URS-006, URS-009
FS-011Configuration/change controlAny change to limits, column names or rule logic requires versioning, review, regression tests and documentation update.URS-010, URS-012
FS-012Data integrityDo not modify the source input.csv; save results separately in output.json for archival retention.URS-007, URS-012

Example output.json structure

{
  "utilityId": "nir-blend-uniformity-checker",
  "utilityName": "NIR_Blend_Uniformity_Checker",
  "object": "NIR Blend Uniformity Checker",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "recordCount": 3,
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "BLEND-NIR-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-001"
    },
    {
      "parameter": "Mean%",
      "value": "100.2",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-002"
    },
    {
      "parameter": "StdDev",
      "value": "1.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-003"
    },
    {
      "parameter": "N",
      "value": "60",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-004"
    },
    {
      "parameter": "MaxDev",
      "value": "4.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-005"
    },
    {
      "parameter": "RSD%",
      "value": "1.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-006"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "metadata": {
    "executionMode": "CLI",
    "interface": "CSV to JSON",
    "documentationFile": "NIR_Blend_Uniformity_Checker.documentation.html"
  }
}

Traceability matrix URS → FS → OQ/PQ

URSFSVerificationExpected result
URS-001FS-001Check that NIR_Blend_Uniformity_Checker.documentation.html exists in the utility folder.The file exists, opens, and the RU/EN switch works.
URS-002/003FS-002/003/004Run the utility with a correct CSV, a CSV missing a mandatory column and a CSV with an invalid data type.Correct CSV is processed; schema and type errors are explicit.
URS-004/005FS-005/006Submit values within limits, at warning level and beyond a critical limit.PASS, WARNING and FAIL are produced according to rules.
URS-006/007FS-007/009/012Verify output.json structure and batch traceability.JSON contains batch identifier, values, rules, statuses and critical findings.
URS-008FS-005Repeat execution with the same input.csv.The result is identical; no probabilistic behaviour is present.
URS-009/010/012FS-010/011/012Execute the CLI scenario and archive input/output/version.Artefacts are suitable for OQ/PQ and change-control records.

OQ/PQ test scenarios

IDScenarioInput dataExpected result
OQ-001Positive pathSample CSV with valid values.output.json is created; final status is PASS or acceptable WARNING according to rules.
OQ-002Mandatory column missingRemove one key column from the header.Schema error; the row shall not be treated as passed.
OQ-003Invalid typePut text into a numeric field.Type-conversion error with field and row identification.
OQ-004Critical limitCritical parameter value outside the approved limit.FAIL and an entry in criticalFindings.
OQ-005WarningNon-critical deviation or unknown controlled category.WARNING without hiding the source value.
PQ-001User real batchReal input.csv from the QC process.Reviewed result with input.csv, output.json, version and checksum retained.

QA/QC, CSV/CSA and change control

  • Do not rename columns without updating the validator, test set and documentation.
  • Retain input.csv, output.json, executable version, checksum and a copy of the documentation.
  • Before production use, perform IQ/OQ/PQ or equivalent risk-based CSV/CSA verification.
  • Critical limits shall be approved by the process owner and verified against the registration dossier, pharmacopoeia and local SOPs.
  • Any change to rules, thresholds or status interpretation shall go through change control and regression testing.

Included in packages

Gastroenterology QC Suite

QC package for gastroenterology: PPIs, antiemetics, prokinetics, IBD medicines, laxatives, enzymes and GI anti-infectives.

Open

Lumex 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.

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