MATLAB applications for adsorption isotherm analysis and fixed-bed breakthrough simulation.
AIM (Adsorption Integrated Modules) is an open-source suite of MATLAB graphical applications developed by the Chung Research Group at Pusan National University. It connects the main stages of an adsorption workflow: fitting pure-component isotherms, estimating isosteric heat, predicting mixture adsorption, and simulating multicomponent fixed-bed breakthrough.
| Module | Purpose | Selected capabilities |
|---|---|---|
| IsoFit | Fit pure-component adsorption isotherms | Langmuir-family, BET, Sips, Toth, Temkin, Dubinin–Astakhov, Klotz, Do–Do, and related models |
| HeatFit | Estimate isosteric heat from multi-temperature data | Clausius–Clapeyron and virial methods |
| MixPred | Predict mixture adsorption equilibria | Extended dual-site Langmuir (EDSL) and ideal adsorbed solution theory (IAST) |
| BreakLab | Simulate fixed-bed breakthrough | Up to five components, axial dispersion, linear driving force kinetics, pressure drop, and nonisothermal operation |
All modules provide graphical data import, model or simulation selection, interactive plots, and export of results and figures.
- Download
bin/AIM_Installer_v_1.0.exe. - Run the installer and follow its prompts.
- Install the matching MATLAB Runtime when prompted. A MATLAB license is not required to run the compiled application.
The bundled installer is Windows-only. Treat executables downloaded from GitHub with the same care as any third-party binary and verify that this repository is the source.
Running the application from source requires MATLAB R2024a or newer.
git clone https://github.com/Chung-Research-Group/AIM.git
cd AIMOpen AIM_Build.prj in MATLAB, then run Main_app.mlapp from the src directory. Building a redistributable standalone application additionally requires MATLAB Compiler; see the build guide.
Reproducibility inputs used in the associated publication are in manuscript_data. They include IsoFit and HeatFit datasets, saved isotherm parameters, mixture-prediction inputs, and BreakLab case configurations.
The supported development baseline is MATLAB R2024a or newer. From the repository root, run:
buildtool check
buildtool testPull requests run repository hygiene checks, MATLAB Code Analyzer on R2024a/Linux, and numerical tests on both R2024a/Linux and the latest MATLAB release/Windows. Reports include static-analysis, JUnit, and coverage artifacts. See the CI policy for the merge gate and exact checks.
Documentation is built with Sphinx and Read the Docs:
python -m pip install -r docs/requirements.txt
sphinx-build -W --keep-going -b html docs/source docs/_build/html- User documentation on Read the Docs
- GitHub Pages mirror
- Video tutorials for all four modules
- Input/output formats and metadata tags
- Technical references: IsoFit, HeatFit, MixPred, and BreakLab
- Report a bug or request a feature
- Maintainer: Muhammad Hassan
When reporting a numerical issue, include the AIM module, MATLAB or Runtime version, operating system, input files, and the smallest reproducible case that demonstrates the problem.
If AIM contributes to published work, cite:
M. Hassan et al., “AIM: A user-friendly GUI workflow program for isotherm fitting, mixture prediction, isosteric heat of adsorption estimation, and breakthrough simulation,” Computer Physics Communications 319 (2026), 109944. https://doi.org/10.1016/j.cpc.2025.109944
Machine-readable citation metadata is available in CITATION.cff.
AIM is distributed under the GNU General Public License v2.0.