ResidualSolventsGCQualityChecker
Residual Solvents GC
Residual Solvents GC Quality Checker — Residual Solvents Control (GC)
ℹ️ Utility checks residual solvent content according to ICH Q3C guidelines:
• Class 1 (Avoid): Benzene (≤2 ppm) — carcinogen
• Class 2 (Limit): Methanol (≤3000 ppm), Acetonitrile (≤410 ppm), Dichloromethane (≤600 ppm), Hexane (≤290 ppm)
• Class 3 (Low Toxicity): Ethyl Acetate (≤5000 ppm), Acetone (≤5000 ppm)
• Total Solvents (≤5000 ppm or 0.5%)
⚠️ CRITICAL: Benzene exceedance (>2 ppm) is unacceptable due to high carcinogenicity!
Exceedance of total solvents indicates insufficient drying or purification.
Usage:
ResidualSolventsGCQualityChecker.exe → demo mode (console output)
ResidualSolventsGCQualityChecker.exe input.csv output.json → evaluate your data
Input format:
BatchNumber,ProductName,MethanolPPM,AcetonitrilePPM,DichloromethanePPM,HexanePPM,EthylAcetatePPM,AcetonePPM,BenzenePPM,TotalSolventsPPM
Example:
API-2026-RS-001,Active Ingredient X,1500.0,200.0,300.0,100.0,2500.0,1000.0,0.5,5600.5
— WHY IS THIS NEEDED?
Residual solvents may be present in Active Pharmaceutical Ingredients (APIs) and excipients after synthesis or purification.
According to ICH Q3C, they are classified by toxicity:
• Class 1: Solvents to be avoided (known carcinogens or environmental toxins).
• Class 2: Solvents to be limited (non-genotoxic animal carcinogens or causing other irreversible toxic effects).
• Class 3: Solvents with low potential toxicity to humans.
⚠️ CRITICAL:
• Benzene ≤2 ppm — strict limit due to carcinogenicity. Even trace amounts are dangerous.
• Total Solvents ≤5000 ppm (0.5%) — standard limit for most APIs unless justified otherwise.
• Methanol ≤3000 ppm — often used in synthesis but toxic upon accumulation.
• Dichloromethane ≤600 ppm — potential carcinogen, requires strict control.
Key features:
• Check of solvents from all three ICH Q3C classes
• Strict control of Benzene (Class 1)
• Calculation and check of total solvents
• Generation of reports compatible with LIMS LabWare
• Support for multiple samples in one file
Critical parameters:
• Benzene: ≤2 ppm (Class 1)
• Methanol: ≤3000 ppm (Class 2)
• Acetonitrile: ≤410 ppm (Class 2)
• Dichloromethane: ≤600 ppm (Class 2)
• Hexane: ≤290 ppm (Class 2)
• Ethyl Acetate: ≤5000 ppm (Class 3)
• Acetone: ≤5000 ppm (Class 3)
• Total Sum: ≤5000 ppm
💡 Usage tips:
1. Analysis method: Gas Chromatography with Flame Ionization Detector (GC-FID) or Mass Spectrometry (GC-MS).
2. Sample preparation: Usually direct solution injection or HeadSpace method.
3. If the sum of individual solvents exceeds 5000 ppm, the batch is rejected, even if each individual solvent is within limits.
4. For Class 3 solvents, the limit may be higher if justified by the manufacturing process, but 5000 ppm is used by default.
5. Benzene must be determined with high sensitivity due to its low limit.
⚠️ Note: The presence of Class 1 solvents (e.g., benzene) should be completely excluded from the manufacturing process if possible. If their presence is unavoidable, they must be controlled using validated analytical procedures with detection limits appropriate to the level of toxicity.
input.csv
BatchNumber,ProductName,MethanolPPM,AcetonitrilePPM,DichloromethanePPM,HexanePPM,EthylAcetatePPM,AcetonePPM,BenzenePPM,TotalSolventsPPM API-2026-RS-001,Active Pharmaceutical Ingredient X,1500.0,200.0,300.0,100.0,2500.0,1000.0,0.5,5600.5 API-2026-RS-002,Intermediate Compound Y,2800.0,400.0,550.0,280.0,4800.0,4900.0,1.8,4900.0
URS & FS — Residual Solvents GC
This document describes the user requirements and functional specification for ResidualSolventsGCQualityChecker. 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, MethanolPPM, AcetonitrilePPM, DichloromethanePPM, HexanePPM, EthylAcetatePPM, AcetonePPM, BenzenePPM, TotalSolventsPPM. | High | The CSV file is processed without manual header editing. |
| URS-002 | The utility shall perform deterministic evaluation for “Residual Solvents GC” 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 | API-2026-RS-001 | Input parameter for deterministic QC evaluation. |
| 2 | ProductName | Active Pharmaceutical Ingredient X | Input parameter for deterministic QC evaluation. |
| 3 | MethanolPPM | 1500.0 | Input parameter for deterministic QC evaluation. |
| 4 | AcetonitrilePPM | 200.0 | Input parameter for deterministic QC evaluation. |
| 5 | DichloromethanePPM | 300.0 | Input parameter for deterministic QC evaluation. |
| 6 | HexanePPM | 100.0 | Input parameter for deterministic QC evaluation. |
| 7 | EthylAcetatePPM | 2500.0 | Input parameter for deterministic QC evaluation. |
| 8 | AcetonePPM | 1000.0 | Input parameter for deterministic QC evaluation. |
| 9 | BenzenePPM | 0.5 | Input parameter for deterministic QC evaluation. |
| 10 | TotalSolventsPPM | 5600.5 | 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
Addiction Medicine & Controlled Substances QC Suite
QC utility package for addiction medicine and regulated medicinal products: addiction-treatment medicines, opioids, benzodiazepines, stimulants, sedatives, volatile impurities, assay/identity/dissolution/release checks.
OpenBiopharmaceuticals Extended QC Suite
Extended QC utility coverage for mAbs, biosimilars, proteins, insulins, vaccines, mRNA/LNP, HCP, sterile release, microbiology, water, cleanroom and stability workflows.
OpenDental & 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.
OpenInfectious Diseases QC Suite
QC utility package for infectious diseases: antibacterial, antiviral, antifungal and antiparasitic products, microbiology, sterility, endotoxins, viral safety and vaccine 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