2026.09v2

2026.09v2

---

Adds a Linux build and fixes several bugs in 2026.09v1.

Windows and Linux. A macOS build will follow.

Downloads

Platform	Asset
Windows 10/11 x64	BreakthroughSimulator-windows.exe
Linux x86_64	BreakthroughSimulator-linux-x86_64.tar.gz

Linux   tar -xzf BreakthroughSimulator-linux-x86_64.tar.gz
        cd BreakthroughSimulator-linux-x86_64
        ./run-breakthrough-simulator.sh     # starts it; your browser opens
        ./install.sh                        # optional: application-menu entry

The Linux build is a folder, not a single file — keep the extracted layout
intact, the launcher needs BreakthroughSimulator/_internal/ beside it. It is
built against the glibc of the build distribution; a newer distribution is
fine, an older one is not.

Fixed

• Isotherm mixture mode showed no selection. IAST is and always was the
  default, but the tab was left unhighlighted because the mass-transfer tab
  group cleared it on startup. Both tab groups are now scoped correctly, and
  loading a case saved before this release selects IAST rather than nothing.
• Exported report legends covered the data. Legends in the exported report
  and in exported chart PNGs are now laid out in a band above the plot instead
  of floating over a corner of it, so they cannot overlap a curve or a heatmap.
• "© Credits" in the footer did nothing. It is now a working link to the
  credits dialog, and reachable by keyboard.

Performance

• Numerical thread limits are pinned to 1 in the solve worker. The arrays at
  typical grid sizes are small enough that BLAS threading cost more than it
  saved; this is a measurable speed-up on Linux and a small one on Windows.
• On Linux the solve worker is forked rather than re-spawned, so a solve no
  longer re-initialises the whole runtime.
• The solver itself is unchanged: SUNDIALS CVODE, sparse linear solver, same
  tolerances. Results are identical to 2026.09v1 at identical inputs.

Diagnostics

The application log now records the exact environment (Python, NumPy, SciPy,
scikit-sundae, BLAS, thread limits) and per-solve CVODE statistics on the first
line of every run — useful when reporting an issue. Advanced Logs in the app
shows the same text.

Verifying your download

shasum -a 256 -c SHA256SUMS            # Linux/macOS
certutil -hashfile <file> SHA256       # Windows

GitHub attaches two "Source code" archives automatically. The repository holds
documentation only, so those are not the application source; the builds above
are the release.

2026.09v1 — first public 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.