ION-Logic introduces the first physics-informed AI framework for quantitative characterization and prediction of ion transport dynamics in complex electrochemical and biological ion-conducting environments — the Lambda-Flow Index (LFI). Built on six orthogonal physico-informational descriptors spanning Nernst-Planck neural transport dynamics, Debye-Hückel coupling efficiency, Butler-Volmer redox kinetics, membrane selectivity, ion concentration fractal topology, and noise-transport inhibition.
GitHub Repository Live Dashboard DOI: 10.5281/zenodo.19702569LFI = 0.26·NIFP* + 0.22·DHCT* + 0.20·RKT* + 0.16·MSC* + 0.10·ICFD* + 0.06·NTII*
LFI_adj = σ(LFI_raw + β_conc + β_therm + β_em)
from ion_logic import LFIParameters, compute_lfi
params = LFIParameters(
nifp=0.26,
dhct=0.22,
rkt=0.20,
msc=0.16,
icfd=1.71,
ntii=0.37
)
result = compute_lfi(params, environment='battery_electrolyte')
# Clone repository
git clone https://gitlab.com/gitdeeper11/ION-Logic.git
cd ION-Logic
# Install package
pip install -e .
# Run analysis
python bin/analyze_eis.py --file your_data.csv
# Verify installation
python -c "from ion_logic import __version__; print(__version__)"
# PINN penalty layer constraints (from paper)
# • Nernst-Planck compliance: ion flux must satisfy electrochemical potential gradient equation
# • Charge electroneutrality: local sum of ionic charges must be zero at equilibrium
# • Thermodynamic consistency: activity coefficients must satisfy extended Debye-Hückel at observed ionic strength
# Python implementation
from ion_logic import IONLogicPredictor
predictor = IONLogicPredictor()
result = predictor.predict(eis_spectrum, current_params)
@software{baladi2026ionlogic,
author = {Samir Baladi},
title = {ION-Logic: Neural Ion-Kinetic Intelligence for Electrochemical Flow Prediction and Redox Dynamics Control},
year = {2026},
version = {1.0.0},
publisher = {Zenodo},
doi = {10.5281/zenodo.19702569},
url = {https://doi.org/10.5281/zenodo.19702569},
note = {Physics-Informed AI Framework for Ion Transport Dynamics}
}