RheologyProfileValidator
Rheology Profile Validator
Rheology Profile Validator — Filler Rheology Validation (G', G'', tan δ) (ISO 13485) ℹ️ The utility checks G', tan δ, yield stress, data quality (R²), suitability for injection zone. ℹ️ Does not use machine learning — rheology rules only. ⚠️ CRITICAL! G' must match injection zone. Tan δ < 0.5 (elasticity). Data in LVE region! Usage: RheologyProfileValidator.exe → demo mode RheologyProfileValidator.exe input.csv output.json → evaluate data Input format: BatchNumber,G_Prime_Pa,G_DoublePrime_Pa,Complex_Viscosity_Pa_s,Tan_Delta,Crossover_Frequency_Hz,Yield_Stress_Pa,Frequency_Sweep_R2,Temperature_C,Gap_mm,Strain_Percent,Reference_G_Prime_Min,Reference_G_Prime_Max,Target_Application,SterilityTest,Endotoxin_EU_ml Example (Target: 1=Deep, 2=Mid, 3=Superficial): RHEO-HA-2026-001,450.0,150.0,25.0,0.33,15.0,25.0,0.995,25.0,1.0,0.5,400.0,600.0,1,0,0.1 — WHY IS THIS NEEDED? Rheology determines clinical behavior of filler: • G' (Elastic Modulus) — ability to restore shape, "lifting capacity". High G' for deep zones, low for superficial. • G'' (Loss Modulus) — viscous component, resistance to flow. • Tan δ (G''/G') — ratio of viscosity to elasticity. For fillers preferably < 0.5 (elasticity dominance). • Yield Stress — force required to start flow. Important for needle extrusion and tissue stability. • Crossover Frequency — point where gel transitions from elastic to viscous behavior. ⚠️ CRITICAL: • G' Match to Injection Zone — error leads to product migration or lumps. • Tan δ < 0.5 — ensures longevity and resistance to deformation by facial muscles. • Data Quality (R² ≥ 0.98) — guarantee that measurements performed in Linear Viscoelastic Region (LVE). • Temperature 25°C (or 37°C) — standardization mandatory as viscosity highly depends on T. • Sterility and Endotoxins — mandatory for any injectable forms. ⚠️ Note: Utility not just compares numbers but assesses product suitability for intended purpose (Deep/Mid/Superficial). E.g., filler with G'=100 Pa unsuitable for cheek augmentation (need >400 Pa) but ideal for lips or fine lines. Checking frequency sweep R² guarantees operator did not exceed linear deformation region where moduli are constant.
input.csv
BatchNumber,G_Prime_Pa,G_DoublePrime_Pa,Complex_Viscosity_Pa_s,Tan_Delta,Crossover_Frequency_Hz,Yield_Stress_Pa,Frequency_Sweep_R2,Temperature_C,Gap_mm,Strain_Percent,Reference_G_Prime_Min,Reference_G_Prime_Max,Target_Application,SterilityTest,Endotoxin_EU_ml RHEO-HA-2026-001,450.0,150.0,25.0,0.33,15.0,25.0,0.995,25.0,1.0,0.5,400.0,600.0,1,0,0.1
URS & FS — user requirements and functional specification
This document defines user requirements and functional specification for the quality-control utility. It supports deployment discussion, IQ/OQ preparation and QC workflow integration.
1. Scope
The Rheology Profile Validator utility is used for Rheology Profile Validator. The actual input.csv is the source of truth for the input structure; control criteria are defined by the executable and the domain description.
The utility does not use machine learning; decisions are produced by deterministic rules.
Categories: Dermal fillers
Tags: dermal fillers, endotoxins, hyaluronic acid, injectables, particles, rheology, sterility
2. Execution modes
RheologyProfileValidator.exe → demo mode RheologyProfileValidator.exe input.csv output.json → evaluate data
3. Key controlled areas
- microbiology and pathogens
- pH and physicochemical parameters
4. Domain limits and critical parameters
- ⚠️ CRITICAL! G' must match injection zone. Tan δ < 0.5 (elasticity). Data in LVE region!
- Tan δ (G''/G') — ratio of viscosity to elasticity. For fillers preferably < 0.5 (elasticity dominance).
- ⚠️ CRITICAL:
- G' Match to Injection Zone — error leads to product migration or lumps.
- Tan δ < 0.5 — ensures longevity and resistance to deformation by facial muscles.
- Data Quality (R² ≥ 0.98) — guarantee that measurements performed in Linear Viscoelastic Region (LVE).
- Temperature 25°C (or 37°C) — standardization mandatory as viscosity highly depends on T.
- Sterility and Endotoxins — mandatory for any injectable forms.
- ⚠️ Note: Utility not just compares numbers but assesses product suitability for intended purpose (Deep/Mid/Superficial). E.g., filler with G'=100 Pa unsuitable for cheek augmentation (need >400 Pa) but ideal for lips or fine lines. Checking frequency sweep R² guarantees operator did not exceed linear deformation region where moduli are constant.
5. URS — user requirements
| ID | Requirement | Criticality | Acceptance criterion |
|---|---|---|---|
| URS-001 | The system shall accept an input.csv file for Rheology Profile Validator with the exact columns listed in the “Input data contract” section. | High | A file with the correct header is processed without manual editing; missing mandatory columns produce FAIL/import error. |
| URS-002 | The system shall support execution without arguments in demo mode and execution with input.csv output.json for user data. | Medium | Both execution scenarios produce a predictable result or clear diagnostic error. |
| URS-003 | The system shall perform rule-based controls for: microbiology and pathogens, pH and physicochemical parameters. | High | Each controlled parameter receives a status and message; the result does not depend on hidden Excel formulas or ML. |
| URS-004 | The system shall preserve traceability between batch/lot, source values, applied rules and final verdict. | High | Output includes batch identifier, source values, parameter statuses and critical findings. |
| URS-005 | The system shall generate machine-readable output.json for LIMS/ELN/MES, batch record and QA/QC review. | High | JSON contains overall status, check array, warnings, failures and source-file reference. |
| URS-006 | The system shall support use in the client validation package: URS/FS, IQ/OQ preparation, installation and operational scenario checks. | High | The document, test scenarios and reproducible CSV/JSON flow are suitable for audit and internal approval. |
| URS-007 | The system shall clearly separate technical data errors from specification nonconformities. | Medium | Schema/type errors are not mixed with pharmacopoeial deviations and are reported separately. |
6. input.csv data contract
The source of truth for the input schema is the actual input.csv header. Column names are technical identifiers and are not translated.
| # | Column | Type | Unit | Description | Sample | Control rule |
|---|---|---|---|---|---|---|
| 1 | BatchNumber | identifier | as specified | Batch Number | RHEO-HA-2026-001 | mandatory field; used for batch/lot traceability |
| 2 | G_Prime_Pa | decimal | as specified | G Prime Pa | 450.0 | mandatory numeric value; rule comparison is performed by the utility |
| 3 | G_DoublePrime_Pa | decimal | as specified | G Double Prime Pa | 150.0 | mandatory numeric value; rule comparison is performed by the utility |
| 4 | Complex_Viscosity_Pa_s | decimal | as specified | Complex Viscosity Pa s | 25.0 | mandatory numeric value; rule comparison is performed by the utility |
| 5 | Tan_Delta | decimal | as specified | Tan Delta | 0.33 | mandatory numeric value; rule comparison is performed by the utility |
| 6 | Crossover_Frequency_Hz | decimal | as specified | Crossover Frequency Hz | 15.0 | mandatory numeric value; rule comparison is performed by the utility |
| 7 | Yield_Stress_Pa | decimal | as specified | Yield Stress Pa | 25.0 | mandatory numeric value; rule comparison is performed by the utility |
| 8 | Frequency_Sweep_R2 | decimal | as specified | Frequency Sweep R2 | 0.995 | mandatory numeric value; rule comparison is performed by the utility |
| 9 | Temperature_C | decimal | °C | Temperature C | 25.0 | mandatory numeric value; rule comparison is performed by the utility |
| 10 | Gap_mm | decimal | as specified | Gap mm | 1.0 | mandatory numeric value; rule comparison is performed by the utility |
| 11 | Strain_Percent | decimal | % | Strain % | 0.5 | mandatory numeric value; rule comparison is performed by the utility |
| 12 | Reference_G_Prime_Min | decimal | min | Reference G Prime Min | 400.0 | mandatory numeric value; rule comparison is performed by the utility |
| 13 | Reference_G_Prime_Max | decimal | as specified | Reference G Prime Max | 600.0 | mandatory numeric value; rule comparison is performed by the utility |
| 14 | Target_Application | decimal | as specified | Target Application | 1 | mandatory numeric value; rule comparison is performed by the utility |
| 15 | SterilityTest | boolean / flag | 0/1 | Sterility Test | 0 | valid flag required; prohibited organisms and growth are normally expected as 0 / absent |
| 16 | Endotoxin_EU_ml | decimal | as specified | Endotoxin EU ml | 0.1 | numeric value; critical safety attribute compared with endotoxin limit |
CSV example
BatchNumber,G_Prime_Pa,G_DoublePrime_Pa,Complex_Viscosity_Pa_s,Tan_Delta,Crossover_Frequency_Hz,Yield_Stress_Pa,Frequency_Sweep_R2,Temperature_C,Gap_mm,Strain_Percent,Reference_G_Prime_Min,Reference_G_Prime_Max,Target_Application,SterilityTest,Endotoxin_EU_ml RHEO-HA-2026-001,450.0,150.0,25.0,0.33,15.0,25.0,0.995,25.0,1.0,0.5,400.0,600.0,1,0,0.1
7. FS — functional specification
| ID | Function | Implementation description |
|---|---|---|
| FS-001 | CLI entry point | The executable RheologyProfileValidator.exe supports demo mode and input.csv output.json processing mode. |
| FS-002 | CSV parser | The import module reads CSV, validates header, column presence/order, value count and encoding. Decimal values are expected with a dot separator. |
| FS-003 | Field conversion | Each column is converted to the expected type: identifier, text, decimal number, date/time or boolean flag. |
| FS-004 | Domain rule engine | For Rheology Profile Validator, explicit rules are applied: range, minimum, maximum, absence of prohibited flag, data completeness or calculation-based check. |
| FS-005 | Criticality handling | Critical violations produce FAIL; non-critical deviations and incomplete data produce WARNING; full conformance produces PASS. |
| FS-006 | JSON writer | output.json stores overall status, per-parameter results, source values, warnings, failures and diagnostic messages. |
| FS-007 | Integration contract | The CSV → JSON format is stable for invocation from LIMS/ELN/MES, scheduled task or wrapper service. |
| FS-008 | Error handling | Schema error, missing file, non-numeric value or JSON write failure returns diagnosable error without silent PASS. |
8. output.json contract
The output file must be suitable for automated processing, audit review and correlation with the source input.csv row.
{
"utility": "RheologyProfileValidator",
"api": "Rheology Profile Validator",
"batchNumber": "RHEO-HA-2026-001",
"overallStatus": "PASS|WARNING|FAIL",
"checkedAtUtc": "2026-05-18T00:00:00Z",
"checks": [
{
"parameter": "BatchNumber",
"value": "RHEO-HA-2026-001",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "G_Prime_Pa",
"value": "450.0",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "G_DoublePrime_Pa",
"value": "150.0",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "Complex_Viscosity_Pa_s",
"value": "25.0",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "Tan_Delta",
"value": "0.33",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "Crossover_Frequency_Hz",
"value": "15.0",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "Yield_Stress_Pa",
"value": "25.0",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "Frequency_Sweep_R2",
"value": "0.995",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
}
],
"criticalFindings": [],
"sourceFile": "input.csv"
}9. OQ/PQ test scenarios
| ID | Scenario | Expected result |
|---|---|---|
| TC-001 | Valid CSV with expected header and sample row | All rows are processed; output contains PASS/WARNING/FAIL and parameter-level detail. |
| TC-002 | A mandatory input.csv column is missing | Import is rejected or the row receives FAIL with schema reference. |
| TC-003 | A numeric field contains text or a blank value | Type conversion error is recorded; the result is not hidden as PASS. |
| TC-004 | A parameter is outside specification or critical limit | Critical parameters produce FAIL; non-critical deviations produce WARNING according to the rule. |
| TC-005 | Positive pathogen/microbiological flag or microbiological limit excursion | Critical FAIL is produced with the offending parameter. |
10. QA/QC, CSV and change control
- Before production use, the client records executable version, checksum, specification/monograph version, test CSV, expected JSON and IQ/OQ results.
- Column names must not be changed without updating the validator and test scenarios.
- The source CSV, output.json and utility version should be stored together as an evidence package.
- Any change in control rules must go through change control and repeated OQ scenario verification.
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.
OpenDermal Fillers QC Suite
Package for injectable implants and dermal fillers: hyaluronic acid, CaHA, PLLA, PMMA, collagen and related tests.
Open