Skip to content

High: [Kinetics] Ratio supersaturation disables dissolution and shifts growth driving force #32

Description

@bernalde

Maintainer triage (June 29, 2026)

  • Status: Verified bug against the current master source in this fork.
  • Severity: High.
  • Area labels: area:kinetics, area:crystallizers.
  • Tackle batch: P4 - high-impact numerical/model correctness.

The source review confirmed that the cited code path and failure mode are still present. The original audit details are preserved below for reproduction notes and suggested fixes.


Original audit details

Part of the model-correctness audit — see #17.

Severity: high | Category: logic | Location: Kinetics.py lines 838-839, 850-858, 884-885

What's wrong

For sup_sat_type='ratio', sup_sat = (c-csat)/csat + 1 = c/csat, which is >0 even under undersaturation (0<S<1). The dissolution/growth switch keys off the sign of this same sup_sat (line 853 if sup_sat >= 0), so dissolution can never trigger under 'ratio', and the growth driving force differs from the 'relative' case.


Verification: 2/2 adversarial reviewers confirmed (refuted: 0).

Metadata

Metadata

Assignees

Labels

area:crystallizersCrystallizer models and slurry crystallization behaviorarea:kineticsReaction and crystallization kineticsbugSomething isn't workingcorrectnessModel/numerical correctness defectrefactor:mpvOverlaps the MultiPhaseVessel refactor; revalidate after mergeseverity:highConfirmed bug with major correctness impact or broken documented workflowstatus:verifiedSource-reviewed against the current codebase

Type

No type

Projects

Status
No status

Relationships

None yet

Development

No branches or pull requests

Issue actions