FastMDXplora

Molecular dynamics from a PDB code to a finished study — in one command.

Documentation · Quick start · GUI · Cite

fastmdx explore --system 181L

setup  →  simulation  →  analysis  →  report

Four characters of PDB ID as input. FastMDXplora fetches T4 lysozyme, parameterises the benzene bound in its cavity, runs the dynamics, analyses the trajectory, works out which residues hold the ligand in place, and writes the whole study up as a PDF.

Or configure the whole MD study in the GUI:

fastmdx gui

Install

conda create -n fastmdxplora -c conda-forge fastmdxplora
conda activate fastmdxplora

fastmdx info lists every backend and how to get anything missing:

fastmdx info

What you can study


A protein on its own	Fold, flexibility, secondary structure, native contacts, conformational clustering — from a PDB code. Fluctuations can be set against the crystal's own B-factors, and backbone order parameters against what NMR relaxation measures.
A protein with a ligand	The ligand is found, its chemistry resolved, its protonation settled in the binding site. Eight interaction types against published criteria tell you what holds it, not just what it touches.
A membrane protein	Embedded in one of seven bilayers, with the orientation checked rather than assumed and pressure coupling that suits a lipid system.
Free energy along a coordinate	Umbrella sampling, metadynamics and steered MD from a named collective variable — nine of them, one or two at a time — without writing PLUMED input. Each says what its output is and is not: a surface if the bias converged, a pathway and the work along it, a potential of mean force if the windows overlap.
A trajectory from another engine	Skip the simulation and analyse what you already have — GROMACS `.xtc` and `.trr`, Amber `.nc`, NAMD and CHARMM `.dcd`, LAMMPS `.lammpstrj`, or `.pdb`, `.cif` and `.h5` that carry their own topology.
Many systems at once	Mutants against wild type — named as `L99A`, and checked against the residue actually there — a sweep across a setting, runs pinned one per GPU, and a comparison report across all of them. Where the members differ only by seed, the spread of their means is set against the error each run claimed for itself.

It refuses rather than guesses. An ambiguous ligand charge, a protein backwards in its membrane, a free-energy surface that never converged — each stops the run and is named, not papered over. Biased averages are corrected to equilibrium where the bias allows and labelled where it does not. Every step explains itself and cites the paper worth reading. What comes out, you can defend; what you cannot is marked.

The config is the study

A FastMDXplora config is the whole description of a molecular dynamics study: the system, how it is prepared, how it is simulated, what is measured, and how it is written up. Capture that, and the four phases — setup, simulation, analysis, report — run themselves.

systems:
  - system: 181L
simulation:
  duration_ns: 100

That is a complete study. Everything unnamed takes a documented default, and every run writes resolved_config.yml with defaults, file and command line merged, so the exact study can be run again by anyone holding that one file.

Three ways to build a config, and each of them also runs all four phases:


The GUI	`fastmdx gui`. A form generated from the schema, so every system and every setting is reachable. Worth using even for a command-line or Python workflow: build the study where the options are visible and explained, then take the file away.
The CLI	`fastmdx explore --config study.yml`, or `fastmdx init-config` for a commented template, or a flag for any setting.
The Python API	`FastMDXplora(config="study.yml").explore()`, or the same blocks passed as options.

None of these is the primary interface and none is a subset of another — form, flags and API are generated from one declaration — and a study designed in the GUI on a laptop runs unchanged on a cluster, because what travels is the config.

Documentation

Start here — Install · Your first run · The GUI · The four phases

Going further — Restraints, membranes, enhanced sampling · Production and GPUs · Protein-ligand interactions

Reference — CLI · Configuration · Examples · Python API

Citation

Aina, A.; Kwan, D. FastMDAnalysis: Software for Automated Analysis of Molecular Dynamics Trajectories. J. Comput. Chem. 2026, 47, e70350. DOI: 10.1002/jcc.70350

@article{aina2026fastmd,
  author  = {Aina, Adekunle and Kwan, Derrick},
  title   = {FastMDAnalysis: Software for Automated Analysis of Molecular Dynamics Trajectories},
  journal = {Journal of Computational Chemistry},
  volume  = {47},
  number  = {8},
  pages   = {e70350},
  year    = {2026},
  doi     = {10.1002/jcc.70350},
}

Contributing

Contributions welcome — see CONTRIBUTING.md. FastMDXplora follows the Contributor Covenant.

License

MIT. See LICENSE.

Built in the AAI Research Lab at California State University Dominguez Hills, on MDTraj, OpenMM, PDBFixer, OpenFF, RDKit, NumPy, SciPy, scikit-learn and Matplotlib.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fastmdxplora-2.5.4.tar.gz (1.4 MB view details)

Uploaded Aug 18, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

fastmdxplora-2.5.4-py3-none-any.whl (862.5 kB view details)

Uploaded Aug 18, 2026 Python 3

File details

Details for the file fastmdxplora-2.5.4.tar.gz.

File metadata

Download URL: fastmdxplora-2.5.4.tar.gz
Upload date: Aug 18, 2026
Size: 1.4 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for fastmdxplora-2.5.4.tar.gz
Algorithm	Hash digest
SHA256	`cd20e2dd6335e2481592a653dcb3b50b87d289cb6164f4bf10312f97e77c99e6`
MD5	`8849ccc855b45dac60b445f689df7ec3`
BLAKE2b-256	`514a34c7e2e71b447f8a80fa20acedaee51dffb2b22a18288d2a5caa2d56a4c9`

See more details on using hashes here.

Provenance

The following attestation bundles were made for fastmdxplora-2.5.4.tar.gz:

Publisher: publish.yml on aai-research-lab/FastMDXplora

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: fastmdxplora-2.5.4.tar.gz
- Subject digest: cd20e2dd6335e2481592a653dcb3b50b87d289cb6164f4bf10312f97e77c99e6
- Sigstore transparency entry: 2503432577
- Sigstore integration time: Aug 18, 2026
Source repository:
- Permalink: aai-research-lab/FastMDXplora@de13e16e7c341ecec448b5b2bda41a064646d0df
- Branch / Tag: refs/tags/v2.5.4
- Owner: https://github.com/aai-research-lab
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@de13e16e7c341ecec448b5b2bda41a064646d0df
- Trigger Event: push