MDTransport Terminal
1. Parser
2. Files
3. Analysis
4. Parameters
5. Advanced
MDTransport: Python Tool for Computing Transport Properties from GROMACS and LAMMPS Simulations
🚀 Quick Guest Access
Start instantly with a temporary session — no account required.
How it works: A secure session lasts up to 20 minutes. You can load sample files or upload your own. Data is deleted after the session ends.
Verify you are human to start a session:
💬 Ask MDTransport AI
Have questions about running simulations, configuring parameters, or using MDTransport? Ask our virtual assistant directly.
Hi there! Ask me anything about MDTransport.
🛡️ Private Local Mode
Analysis is performed entirely in your browser, and your files are never uploaded to our servers.
Limitations:
- Advanced libraries like MDAnalysis, Chemfiles, and Ovito are not available
- Best suited for standard GROMACS *.pdb and LAMMPS *.lammpstrj files
- Advanced libraries like MDAnalysis, Chemfiles, and Ovito are not available
- Best suited for standard GROMACS *.pdb and LAMMPS *.lammpstrj files
🔓 Login
⚠️ Please login or create an account to download files.
🔑 Forgot Password?
👤 Forgot Username?
⚠️ Security Alert
You are using a temporary password. You must change your password before continuing to your workspace.
👤 Create Account
📧 Email Verification
📥 Secure Downloads
Note: Downloads are only available to registered users.
Source Code
Source code & docs
Mac OS
Installer for macOS
Windows
Executable setup file
Linux
Compatible build
📚 Documentation
Installation Guide
Argument Flags
Commands Usage
Required Dependencies:
python >=3.9
matplotlib >=3.6
pandas >=2.0
numpy >=1.20
scipy >=1.10
tqdm >=4.60MDAnalysis Requirements
MDAnalysis is required only if you intend to use the --mda option.
# Recommended if using Conda
conda install -c conda-forge mdanalysis
# Alternative using pip
pip install MDAnalysisChemfiles Requirements
Chemfiles is required only if you intend to use the --chem option.
# Recommended if using Conda (Anaconda/Miniconda)
conda install -c conda-forge chemfiles
# Alternative using pip
pip install chemfilesOvito Requirements
Ovito is required only if you intend to use the --ovito option.
# Recommended if using Conda (Anaconda/Miniconda)
conda install -c conda-forge ovito
# Alternative using pip
pip install ovitoCreate a Virtual Environment and Run MDTransport Directly
git clone https://github.com/ShahResearchGroup/MDTransport.git
cd MDTransport
conda env create -f environment.yml
conda activate mdt_env
chmod +x mdt.pyBuild From Sources
MDTransport is available on GitHub and can be installed using pip:
pip install git+https://github.com/ShahResearchGroup/MDTransport.git
# or alternatively:
git clone https://github.com/ShahResearchGroup/MDTransport.git
cd MDTransport
pip install -e .Installation via Package Managers
MDTransport is available as a pre-compiled package for Linux, macOS, and Windows. It can be installed through the Python Package Index (PyPI) or the Conda-forge channel.
To install the package via PyPI, use:
pip install MDTransportAlternatively, MDTransport can be installed via Conda-forge:
conda install -c conda-forge mdtransportGeneral Analysis Modes
[--gro] : Run GROMACS analysis.
[--lam] : Run LAMMPS analysis.GROMACS Analysis Modes
[--pdb] : Use PDB file to extract species data (e.g., --pdb).
[--exe] : Use gmx to extract species data from GROMACS files (e.g., --exe gmx).
[--chem] : Use Chemfiles to extract species data from GROMACS files (e.g., --chem).
[--mda] : Use MDAnalysis to extract species data from GROMACS files (e.g., --mda).
[--ovito] : Use Ovito to extract species data from GROMACS files (e.g., --ovito).LAMMPS Analysis Modes
[--lamp] : Use lammpstrj file to extract species data (e.g., --lamp).
[--com] : Use LAMMPS generated com.txt to extract species data (e.g., --com /path/to/com/file).
[--chem] : Use Chemfiles to extract species data from LAMMPS files (e.g., --chem).
[--mda] : Use MDAnalysis to extract species data from LAMMPS files (e.g., --mda).
[--ovito] : Use Ovito to extract species data from LAMMPS files (e.g., --ovito).File & Path Arguments
[--in] : Path to MDTransport input file (e.g., --in /path/to/input/file).
[--itp] : Directory containing GROMACS ITP files (e.g., --itp /path/to/itp/directory).
[--tpr] : Path to GROMACS TPR file (e.g., --tpr /path/to/tpr/file).
[--traj] : Path to trajectory file (e.g., --traj /path/to/trajectory/file).
[--data] : Path to LAMMPS data file (e.g., --data /path/to/data/file).
[--lam_in] : Path to LAMMPS input file (e.g., --lam_in /path/to/input/file).
[--gro_path] : Path to GROMACS files directory (e.g., --gro_path /path/to/gromacs/files).
[--lam_path] : Path to LAMMPS files directory (e.g., --lam_path /path/to/lammps/files).General Parameters
[--temp] : Temperature in Kelvin (e.g., --temp 298.0).
[--t_steps] : Time steps in ps (e.g., --t_steps 2).
[--n_delta] : Time window for time origins shifting in ps (e.g., --n_delta 1000).
[--t_window] : Time window for slope calculations in ps (e.g., --t_window 1000).
[--min_window] : Minimum time window for diffusivity calculations in ps (e.g., --min_window 1000).
[--n_steps] : Snapshots range in ps (e.g., --n_steps 0 20000).
[--fit_method] : MSD fitting method for diffusion calculations (e.g., --fit_method gls).
[--msd_fit] : MSD fitting window in ps (e.g., --msd_fit 10000 40000).
[--steps] : Steps for time origin shifting (e.g., --steps 20).
[--dir] : Specify directions for msd/diffusion (e.g., --dir x y z).
[--n] : process every N-th frame (e.g., --n 5).
[--dump_frame] : LAMMPS trajectory dumping frame (e.g., --dump_frame 1000).
[--n_cores] : Number of CPU cores to use for parallel processing (e.g., --n_cores 8).
[--mp_mode] : Multi-processing initialization (e.g., --mp_mode fork).Properties Calculations
[--msd] : Compute mean squared displacement and diffusion (e.g., --msd).
[--corr] : Calculate ion-ion correlations and Einstein conductivity (e.g., --corr).
[--onsg] : Calculate Onsager transport coefficients (e.g., --onsg).
[--spda] : Spatial decomposition of ion-ion correlations (e.g., --spda).
[--en] : Calculate Einstein conductivity (e.g., --en).
[--ne] : Calculate Nernst-Einstein conductivity (e.g., --ne).
[--smd] : Run Stefan-Maxwell diffusivity analysis (e.g., --smd).
[--pcl] : Calculate pair correlation lifetime (e.g., --pcl).
[--cage_p] : Cage population analysis (e.g., --cage_p).
[--cage] : Calculate cage correlation lifetime (e.g., --cage).
[--veh] : Run transport mechanism analysis (e.g., --veh).
[--rdf] : Calculate radial distribution functions (e.g., --rdf).
[--get_csv] : Parse and save trajectories data. (e.g., --get_csv).Analysis-Specific Parameters
[--species] : Define species names and counts for LAMMPS (e.g., --species EMI 500 BF4 500)
[--resname] : Define species names (e.g., --resname EMI BF)
[--skip_species] : Exclude Resnames from COM generation (e.g., --skip_species SOL).
[--rcut] : Cutoff radius for analysis (e.g., --rcut 7.6).
[--rbin] : RDF bin size (e.g., --rbin 0.2)
[--ref_species] : Reference species for cage correlation (e.g., --ref_species EMI).
[--cage_species] : Cage species for cage correlation (e.g., --cage_species BF).
[--ana] : Run optional RDFs analysis (e.g., --ana).
[--eh] : Enable Einstein-Helfand for TRA and ONSG analysis (e.g., --eh).
[--rdf_mode] : Specify the RDF calculation mode (e.g., --rdf_mode com com)
[--rdf_pairs] : Specify the RDF pairs.
(e.g., --rdf_pairs resname EMI type HR resname BF type F)
(e.g., --rdf_pairs type 1-6 type 7-12)
[--msd_mode] : Specify the MSD calculation mode (e.g., --msd_mode com)
[--msd_species] : Specify the MSD species.
(e.g., --msd_species resname EMI type HR resname BF type F)
(e.g., --msd_species type 1-6 type 7-12)
[--shell] : Solvation shell choice for SPDA (e.g., --shell first).
[--species_charges] : Override net charges on each species (e.g., --species_charges 1 or --species_charges EMI 0.8).Common GROMACS Parsers
[Parser] :[--pdb / --exe <gmx or gmx_mpi> / --mda / --chem / --ovito]Common LAMMPS Parsers
[Parser] :[--lamp / --com <com file> / --mda / --chem / --ovito]MSD and Diffusion Analysis
COM-based MSD for Species
GROMACSmdt [--gro] [--msd] [Parser]
[--t_steps <time steps>] [--skip_species <resname>] [--dir <x, y, z>]
[--n_steps <start frame> <end frame>] [--min_window <min. time window>]mdt [--lam] [--msd] [Parser]
[--t_steps <time steps>] [--dir <x, y, z>] [--n <frame stride>] [--dump_frame <steps>]
[--min_window <min. time window>] [--n_steps <start frame> <end frame>]COM-based MSD for Selected Groups
GROMACSmdt [--gro] [--msd] [Parser]
[--t_steps <time steps>] [--min_window <min. time window>] [--dir <x, y, z>]
[--msd_mode com --msd_species resname <resname> type <atom type> <atom type>]
[--n_steps <start frame> <end frame>]
mdt [--gro] [--msd] [Parser]
[--t_steps <time steps>] [--min_window <min. time window>] [--dir <x, y, z>]
[--msd_mode com --msd_species resname <resname> name <atom name> <atom name>]
[--n_steps <start frame> <end frame>]
mdt [--gro] [--msd] [Parser]
[--t_steps <time steps>] [--min_window <min. time window>] [--dir <x, y, z>]
[--msd_mode com --msd_species resname <resname> type <atom type> <atom type>
resname <resname> type <atom type> <atom type>] [--n_steps <start frame> <end frame>]
mdt [--gro] [--msd] [Parser]
[--t_steps <time steps>] [--min_window <min. time window>] [--dir <x, y, z>]
[--msd_mode com --msd_species resname <resname> name <atom name> <atom name>
resname <resname> name <atom name> <atom name>] [--n_steps <start frame> <end frame>]mdt [--lam] [--msd] [Parser]
[--dump_frame <steps>] [--t_steps <time steps>] [--n <frame stride>] [--dir <x, y, z>]
[--n_steps <start frame> <end frame>] [--min_window <min. time window>]
[--msd_mode com --msd_species resname <resname> type 1 2]
mdt [--lam] [--msd] [Parser]
[--dump_frame <steps>] [--t_steps <time steps>] [--n <frame stride>] [--dir <x, y, z>]
[--n_steps <start frame> <end frame>] [--min_window <min. time window>]
[--msd_mode com --msd_species resname <resname> type <atom type> <atom type> resname <resname>]
mdt [--lam] [--msd] [Parser]
[--dump_frame <steps>] [--t_steps <time steps>] [--n <frame stride>] [--dir <x, y, z>]
[--n_steps <start frame> <end frame>] [--min_window <min. time window>]
[--msd_mode com --msd_species resname <resname> type <atom type> <atom type>
resname <resname> type <atom type> <atom type>]
mdt [--lam] [--msd] [Parser]
[--dump_frame <steps>] [--t_steps <time steps>] [--n <frame stride>] [--dir <x, y, z>]
[--n_steps <start frame> <end frame>] [--min_window <min. time window>]
[--msd_mode com --msd_species resname <resname> resname <resname>]Atom-based MSD for Selected Atoms
GROMACSmdt [--gro] [--msd] [Parser]
[--t_steps <time steps>] [--min_window <min. time window>] [--dir <x, y, z>]
[--msd_mode atom --msd_species resname <resname> type <atom type>]
[--n_steps <start frame> <end frame>]
mdt [--gro] [--msd] [Parser]
[--t_steps <time steps>] [--min_window <min. time window>] [--dir <x, y, z>]
[--msd_mode atom --msd_species resname <resname> name <atom name>]
[--n_steps <start frame> <end frame>]
mdt [--gro] [--msd] [Parser]
[--t_steps <time steps>] [--min_window <min. time window>] [--dir <x, y, z>]
[--msd_mode atom --msd_species resname <resname> type <atom type>
resname <resname> type <atom type>] [--n_steps <start frame> <end frame>]
mdt [--gro] [--msd] [Parser]
[--t_steps <time steps>] [--min_window <min. time window>] [--dir <x, y, z>]
[--msd_mode atom --msd_species resname <resname> name <atom name>
resname <resname> name <atom name>] [--n_steps <start frame> <end frame>]mdt [--lam] [--msd] [Parser]
[--dump_frame <steps>] [--t_steps <time steps>] [--n <frame stride>] [--dir <x, y, z>]
[--n_steps <start frame> <end frame>] [--min_window <min. time window>]
[--msd_mode atom --msd_species resname <resname> type <atom type>]
mdt [--lam] [--msd] [Parser]
[--dump_frame <steps>] [--t_steps <time steps>] [--n <frame stride>] [--dir <x, y, z>]
[--n_steps <start frame> <end frame>] [--min_window <min. time window>]
[--msd_mode atom --msd_species resname <resname> type <atom type> <atom type>]
mdt [--lam] [--msd] [Parser]
[--dump_frame <steps>] [--t_steps <time steps>] [--n <frame stride>] [--dir <x, y, z>]
[--n_steps <start frame> <end frame>] [--min_window <min. time window>]
[--msd_mode atom --msd_species resname <resname> type <atom type> <resname> type <atom type>]
mdt [--lam] [--msd] [Parser]
[--dump_frame <steps>] [--t_steps <time steps>] [--n <frame stride>] [--dir <x, y, z>]
[--n_steps <start frame> <end frame>] [--min_window <min. time window>]
[--msd_mode atom --msd_species resname <resname> <resname>]Nernst-Einstein Conductivity
GROMACS
mdt [--gro] [--ne] [Parser]
[--t_steps <time steps>] [--skip_species <resname>] [--temp <temperature>]
[--n_steps <start frame> <end frame>] [--min_window <min. time window>]mdt [--lam] [--ne] [Parser]
[--t_steps <time steps>] [--dump_frame <steps>] [--n <frame stride>] [--temp <temperature>]
[--n_steps <start frame> <end frame>] [--min_window <min. time window>]Ion-Ion Correlations
GROMACS
mdt [--gro] [--corr] [Parser]
[--t_steps <time steps>] [--n_delta <window for time origin shifting>] [--temp <temperature>]
[--n_steps <start frame> <end frame>] [--t_window <time window for slope>]mdt [--lam] [--corr] [Parser]
[--t_steps <time steps>] [--dump_frame <steps>] [--n_delta <window for time origin shifting>]
[--n <frame stride>] [--n_steps <start frame> <end frame>] [--temp <temperature>]
[--t_window <time window for slope>]Spatial Decomposition Analysis of Ion-Ion Correlations
GROMACS
mdt [--gro] [--spda] [Parser]
[--t_steps <time steps>] [--n_delta <window for time origin shifting>] [--temp <temperature>]
[--n_steps <start frame> <end frame>] [--t_window <time window for slope>]mdt [--lam] [--spda] [Parser]
[--t_steps <time steps>] [--dump_frame <steps>] [--n_delta <window for time origin shifting>]
[--n <frame stride>] [--n_steps <start frame> <end frame>] [--temp <temperature>]
[--t_window <time window for slope>]Onsager Transport Coefficients
GROMACS
mdt [--gro] [--onsg] [Parser]
[--t_steps <time steps>] [--t_window <time window for slope>] [--temp <temperature>]
[--n_steps <start frame> <end frame>] [--n_delta <window for time origin shifting>]mdt [--lam] [--onsg] [Parser]
[--t_steps <time steps>] [--dump_frame <steps>] [--temp <temperature>]
[--n <frame stride>] [--t_steps <time steps>] [--t_window <time window for slope>]
[--n_steps <start frame> <end frame>] [--n_delta <window for time origin shifting>]Ionic Conductivity Using Stefan-Maxwell Diffusivity
GROMACS
mdt [--gro] [--smd] [Parser]
[--t_steps <time steps>] [--temp <temperature>]
[--n_steps <start frame> <end frame>] [--min_window <min. time window>]mdt [--lam] [--smd] [Parser]
[--t_steps <time steps>] [--dump_frame <steps>] [--n <frame stride>] [--temp <temperature>]
[--n_steps <start frame> <end frame>] [--min_window <min. time window>]Einstein Conductivity Using Einstein-Helfand Equation
GROMACS
mdt [--gro] [--en] [Parser]
[--t_steps <time steps>] [--t_window <time window for slope>]
[--n_steps <start frame> <end frame>] [--temp <temperature>]mdt [--lam] [--en] [Parser]
[--t_steps <time steps>] [--dump_frame <steps>] [--t_window <time window for slope>]
[--n <frame stride>] [--n_steps <start frame> <end frame>] [--temp <temperature>]Cluster Analysis
GROMACS
mdt [--gro] [--cage_p] [Parser]
[--t_steps <time steps>] [--n_steps <start frame> <end frame>] [--rcut <first solvation>]
[--resname <reference species> <target species>]mdt [--lam] [--cage_p <reference species> <cage species>] [Parser]
[--n <frame stride>] [--dump_frame <steps>] [--species <resname> <numbers>]
[--rcut <first solvation>] [--n_steps <start frame> <end frame>] [--t_steps <time steps>]
[--resname <reference species> <target species>]Cage Correlation Lifetime
GROMACS
mdt [--gro] [--cage] [Parser]
[--ref_species <resname>] [--cage_species <resname>] [--n_steps <start frame> <end frame>]
[--t_steps <time steps>] [--rcut <first solvation>] [--steps <time origin steps>]mdt [--lam] [--cage] [Parser]
[--t_steps <time steps>] [--dump_frame <steps>] [--ref_species <resname>]
[--cage_species <resname>] [--n_steps <start frame> <end frame>] [--rcut <first solvation>]
[--steps <time origin steps>] [--n <frame stride>]Pair Correlation Lifetime
GROMACS
mdt [--gro] [--pcl] [Parser]
[--t_steps <time steps>] [--n_steps <start frame> <end frame>] [--steps <time origin steps>]
[--resname <reference species> <target species>]mdt [--lam] [--pcl] [Parser]
[--dump_frame <steps>] [--t_steps <time steps>] [--species <resname> <numbers>]
[--n <frame stride>] [--n_steps <start frame> <end frame>] [--steps <time origin steps>]
[--resname <reference species> <target species>]Transport Mechanism of Species
GROMACS
mdt [--gro] [--veh] [Parser]
[--t_steps <time steps>] [--min_window <min. time window>] [--rcut <first solvation>]
[--temp <temperature>] [--steps <time origin steps>] [--n_steps <start frame> <end frame>]
[--resname <reference species> <target species>]mdt [--lam] [--veh] [Parser]
[--t_steps <time steps>] [--dump_frame <steps>] [--min_window <min. time window>]
[--n <frame stride>] [--n_steps <start frame> <end frame>] [--temp <temperature>]
[--rcut <first solvation>] [--steps <time origin steps>]
[--resname <reference species> <target species>]Radial Distribution Function Calculation
COM-COM RDF
GROMACSmdt [--gro] [--rdf] [Parser]
[--t_steps <time steps>] [--n_steps <start frame> <end frame>] [--steps <time origin steps>]
mdt [--gro] [--rdf] [Parser]
[--rdf_mode com com --rdf_pairs resname <resname> type <atom type> <atom type> resname
<resname> type <atom type> <atom type>] [--t_steps <time steps>] [--n_steps <start frame>
<end frame>]
mdt [--gro] [--rdf] [Parser]
[--rdf_mode com com --rdf_pairs resname <resname> name <atom name> <atom name> resname
<resname> name <atom name> <atom name>] [--t_steps <time steps>] [--n_steps <start frame>
<end frame>]mdt [--lam] [--rdf] [Parser]
[--n <frame stride>] [--t_steps <time steps>] [--n_steps <start frame> <end frame>]
[--dump_frame <steps>] [--steps <time origin steps>]
mdt [--lam] [--rdf] [Parser]
[--dump_frame <steps>] [--t_steps <time steps>] [--n_steps <start frame> <end frame>]
[--n <frame stride>] [--rdf_mode com com --rdf_pairs resname <resname>
type <atom type> <atom type> resname <resname> type <atom type> <atom type>]ATOM-COM RDF
GROMACSmdt [--gro] [--rdf] [Parser]
[--rdf_mode atom com --rdf_pairs resname <resname> type <atom type> resname <resname> type
<atom type> <atom type>] [--t_steps <time steps>] [--n_steps <start frame> <end frame>]
mdt [--gro] [--rdf] [Parser]
[--rdf_mode atom com --rdf_pairs resname <resname> name <atom name> resname <resname> name
<atom name> <atom name>] [--t_steps <time steps>] [--n_steps <start frame> <end frame>]mdt [--lam] [--rdf] [Parser]
[--dump_frame <steps>] [--t_steps <time steps>] [--n_steps <start frame> <end frame>]
[--n <frame stride>] [--rdf_mode atom com --rdf_pairs resname <resname> type <atom type>
resname <resname> type <atom type> <atom type>]ATOM-ATOM RDF
GROMACSmdt [--gro] [--rdf] [Parser]
[--rdf_mode atom atom --rdf_pairs resname <resname> type <atom type> resname <resname> type
<atom type>] [--t_steps <time steps>] [--n_steps <start frame> <end frame>]
mdt [--gro] [--rdf] [Parser]
[--rdf_mode atom atom --rdf_pairs resname <resname> name <atom name> resname <resname> type
<atom name>] [--t_steps <time steps>] [--n_steps <start frame> <end frame>]mdt [--lam] [--rdf] [Parser]
[--dump_frame <steps>] [--t_steps <time steps>] [--n_steps <start frame> <end frame>]
[--n <frame stride>] [--rdf_mode atom atom --rdf_pairs resname <resname> type <atom type>
resname <resname> type <atom type>]⏳ Session Timer
--:--
📂 Sample Data
📂 Data Upload
🔒 All session data and terminal logs are deleted permanently after session end. Upload Files (xtc, trr, itp, tpr, pdb, lammpstrj, etc.)
📁 Workspace
🔑 Change Password
Tutorials & Educational Resources
Comprehensive software workflows, molecular dynamics guides, and educational materials.
Loading educational materials...
Open Positions
Join Shah Research Group at OSU. Explore active academic, doctoral, and postdoctoral opportunities.
Scanning active listings...