Skip to content

2026.09v1 — first public release

Choose a tag to compare

@Mk-learning-python07 Mk-learning-python07 released this 16 Sep 04:29
· 3 commits to main since this release

2026.09v1 — First public release


First public release of the Dynamic Column Breakthrough Simulator — a desktop
application that simulates two-component, non-isothermal adsorption
breakthrough in a packed column.

Windows only for now. macOS and Linux builds will follow.

What it does

Solves the coupled mass, momentum and energy balances along a packed bed for a
binary gas mixture, in adsorption or desorption mode. Six state variables per
cell, finite volume with WENO reconstruction, integrated by SUNDIALS CVODE.
Eleven isotherm models, IAST or extended-Langmuir mixture equilibrium, five
mass-transfer resistance models, and five validated adsorbent presets.

Charts, mass-balance closure, computed dimensionless groups, raw data export,
a formatted report, and overlay of your own measured breakthrough data with
RMSE / MAE / R².

Running it

Download BreakthroughSimulator-windows.exe and double-click it. Your browser
opens at 127.0.0.1:8000. Nothing is installed, no administrator rights are
requested, and closing the browser closes the app.

Windows will show "Windows protected your PC" — the build is unsigned. Click
More info → Run anyway. Verify the checksum first if you prefer:

certutil -hashfile BreakthroughSimulator-windows.exe SHA256

and compare against SHA256SUMS.

Privacy

It runs entirely on your machine, bound to 127.0.0.1. No accounts, no
analytics, no tracking. One optional weekly version check against
api.github.com, off unless you turn it on, which sends a version number and
nothing else.

Notes

  • Dry basis only — water vapour and humidity co-adsorption are not modelled yet.
  • Educational and exploratory use. Validate against your own data before
    applying results to design.
  • Source code is not published yet; it will follow once the underlying work is
    written up. requirements-lock.txt records the exact library versions this
    build was compiled from.

Licensed CC BY 4.0. Full documentation in the README.